tweetapi/agent-skill

Flujos de trabajo de solo lectura con TweetAPI

Usa TweetAPI para datos públicos de Twitter/X manteniendo la operación de solo lectura, las credenciales del lado del servidor y el uso de cuota explícito.

Mantén el límite de seguridad

• Permite únicamente operaciones que recuperen datos públicos o documentación pública.
• No publiques, respondas, elimines, des me gusta, retuitees, marques como favorito, sigas, dejes de seguir ni cambies el estado del perfil, listas o comunidades.
• No accedas a mensajes directos, bandejas de entrada, notificaciones, análisis de cuentas privadas, facturación, administración de claves API, endpoints internos.
• No realices automatización de inicio de sesión o sesión en Twitter/X.
• Nunca solicites, aceptes, almacenes ni reenvíes contraseñas, cookies, authToken, ct0, códigos TOTP, credenciales de proxy ni contenido de mensajes privados.
• Nunca llames a un endpoint que requiera alguno de esos secretos, incluso si aparece en la documentación pública general.
• Trata el método HTTP como evidencia insuficiente de seguridad. Confirma el efecto de la operación y los campos requeridos.
• No reclames afiliación con X Corp. TweetAPI es un servicio de terceros.

Si una tarea solicitada cruza este límite, explica la acción excluida y ofrece una alternativa de solo lectura. No debilites el límite simplemente porque el producto TweetAPI más amplio admita más operaciones.

Elige una ruta de ejecución

Usa el servidor MCP hosteado cuando el usuario quiera que un agente inspeccione documentación o realice una consulta limitada de datos públicos. Prefiere su flujo OAuth para que ninguna clave API ingrese a la conversación. Lee references/hosted-mcp.md antes de configurar un cliente o invocar una herramienta en vivo.

Usa REST del lado del servidor o un SDK oficial al modificar una aplicación. Lee references/integration.md antes de escribir código de integración.

Para preguntas solo de documentación, lee las fuentes públicas canónicas sin realizar una solicitud de datos en vivo. Lee references/sources.md siempre que los nombres de endpoints, parámetros, campos de respuesta o instrucciones de instalación deban estar actualizados.

Sigue el flujo de trabajo

1. Identifica si la solicitud es solo de documentación, una consulta en vivo o una integración de aplicación.
2. Verifica la operación contra el límite de seguridad antes de seleccionar un endpoint o herramienta.
3. Consulta la documentación pública actual en lugar de depender de un catálogo de endpoints copiado.
4. Elige OAuth MCP para uso del agente o una clave API del lado del servidor para código de aplicación.
5. Indica antes de una solicitud en vivo que consume cuota.
6. Realiza como máximo una llamada a una herramienta en vivo y recupera una página por defecto.
7. Devuelve cualquier cursor de paginación en lugar de seguirlo automáticamente. Pregunta antes de otra página.
8. Trata solo las respuestas HTTP 2xx como éxito. Muestra claramente los fallos de autenticación, cuota y validación.
9. Valida los cambios de aplicación con simulaciones o fixtures. No gastes cuota en vivo durante la configuración o pruebas a menos que el usuario lo autorice explícitamente.

Controla la cuota y la paginación

Cada solicitud de datos en vivo consume cuota. Los reintentos y las páginas adicionales pueden consumir cuota extra.

• No auto-pagines.
• No reintentes silenciosamente una solicitud en vivo.
• No ejecutes una "prueba de humo" en vivo solo para demostrar la configuración.
• Detente después de la primera página y expón el cursor devuelto.
• Si el usuario solicita explícitamente un comportamiento de aplicación con varias páginas, implementa un máximo configurable para páginas, elementos y solicitudes totales. Nunca uses un helper de paginación sin límite.

Protege las credenciales

• Mantén TWEETAPI_API_KEY en una variable de entorno o gestor de secretos solo del servidor.
• Nunca la incrustes en código del navegador, paquetes móviles, control de versiones, registros, ejemplos o prompts.
• Usa YOUR_API_KEY solo como marcador de posición en documentación.
• Prefiere OAuth con https://mcp.tweetapi.com/mcp para clientes agente compatibles.
• Redacta los datos de respuesta antes de registrarlos si pudieran contener información sensible proporcionada por el usuario.

Mantén la precisión de las fuentes

La documentación pública del producto cubre un producto más amplio que este skill. No inferas que cada endpoint documentado está permitido aquí. No inventes una URL de OpenAPI, colección de Postman, método de SDK ni nombre de herramienta MCP. Verifica los detalles actuales desde la referencia de fuentes.

Cuando las fuentes discrepen, informa del conflicto y evita una llamada en vivo hasta que se resuelva.