TwitterAPI.io MCP Server

Acceso de solo lectura a datos de Twitter/X: tweets, perfiles, seguidores, búsqueda avanzada, tendencias, a través de 12 herramientas MCP respaldadas por twitterapi.io. API de pago por llamada, sin OAuth, clave instantánea.

GitHubPrueba este MCPPatrocinado

Documentación

twitterapi.io MCP Server

npm version MIT License MCP Spec 2025-11-25

Servidor oficial del Model Context Protocol para twitterapi.io — API de datos de Twitter / X para agentes y aplicaciones de IA.

Conecta Claude Desktop, Cursor, VS Code Copilot o cualquier cliente MCP a twitterapi.io y busca tweets, obtén perfiles de usuario, seguidores, respuestas, tendencias y más — todo desde lenguaje natural.

Características

12 herramientas de solo lectura mapeadas 1:1 a los endpoints de producción verificados de twitterapi.io:

HerramientaQué hace
search_tweetsBúsqueda avanzada con operadores de Twitter (from:, since:, lang:, has:, …)
get_user_infoInformación básica del perfil de usuario por nombre de pantalla
get_user_aboutPerfil extendido / página de información
get_user_followersSeguidores con metadatos completos del perfil (paginado)
get_user_followingsLista de seguidos con metadatos del perfil (paginado)
get_user_last_tweetsTweets recientes de un usuario (línea de tiempo)
get_user_mentionsTweets que mencionan a un usuario
get_tweets_by_idsObtener tweets por ID en lote (hasta 100)
get_tweet_repliesRespuestas a un tweet
get_tweet_quotesCitas de un tweet
get_tweet_retweetersUsuarios que retuitearon un tweet
get_trendsTemas de tendencia por ubicación (WOEID)

Inicio rápido

1. Obtén una clave de API

Regístrate en twitterapi.io — hay plan gratuito disponible.

2. Configura tu cliente MCP

Claude Desktop

Edita ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "twitterapi-io": {
      "command": "npx",
      "args": ["-y", "@twitterapi_io/mcp-server"],
      "env": {
        "TWITTERAPI_IO_API_KEY": "your_key_here"
      }
    }
  }
}

Reinicia Claude Desktop. Las 12 herramientas estarán disponibles en cualquier chat — Claude elegirá la correcta según tu mensaje.

Cursor

Abre Configuración → MCP → Añadir nuevo servidor MCP:

{
  "mcpServers": {
    "twitterapi-io": {
      "command": "npx",
      "args": ["-y", "@twitterapi_io/mcp-server"],
      "env": {
        "TWITTERAPI_IO_API_KEY": "your_key_here"
      }
    }
  }
}

VS Code (Copilot Chat with MCP)

Añádelo a la configuración de tus servidores MCP — misma forma que Claude Desktop / Cursor.

Claude Code

claude mcp add twitterapi-io npx -- -y @twitterapi_io/mcp-server -e TWITTERAPI_IO_API_KEY=your_key_here

3. Úsalo

En cualquier chat con MCP habilitado:

"Busca tweets recientes de @elonmusk sobre IA en la última semana"

"Obtén la lista de seguidores de @sama y muéstrame los 20 principales por número de seguidores"

"¿Cuáles son los temas de tendencia actuales en Japón?"

Claude (o tu cliente) elegirá automáticamente search_tweets / get_user_followers / get_trends y los llamará con los parámetros correctos.

Autenticación

La autenticación se realiza mediante la variable de entorno TWITTERAPI_IO_API_KEY, inyectada por tu cliente MCP. El servidor nunca almacena ni registra la clave. Cada llamada a una herramienta envía la clave en el encabezado X-API-Key a https://api.twitterapi.io.

Paginación

Las herramientas que devuelven listas (seguidores, respuestas, resultados de búsqueda, etc.) devuelven un campo next_cursor. Pásalo de nuevo como argumento cursor en la siguiente llamada para paginar. Cada página suele tener ~20 elementos.

Manejo de errores

  • Las respuestas 429 / 5xx se reintentan automáticamente con retroceso exponencial (3 intentos, 1s/2s/4s)
  • Tiempos de espera de red: 30s por solicitud
  • Los errores 4xx (excepto 429) se muestran inmediatamente al LLM con el mensaje original

Herramientas — especificación completa

El esquema de entrada de cada herramienta se expone a través de tools/list de MCP y sigue JSON Schema. Ejecuta npx @twitterapi_io/mcp-server con mcp-inspector para explorar interactivamente:

npx @modelcontextprotocol/inspector npx -y @twitterapi_io/mcp-server

Lo que NO está incluido

Por diseño, este servidor expone endpoints de solo lectura. Los siguientes están excluidos intencionalmente para mantener el servidor seguro para uso de agentes autónomos:

  • ❌ Publicar tweets, likes, retweets, seguir, mensajes directos
  • ❌ Inicio de sesión de cuenta / 2FA
  • ❌ Edición de perfil / banner / avatar
  • ❌ Subida de medios
  • ❌ Eliminación de cuenta
  • ❌ Configuración de stream en tiempo real / webhook (no se ajusta al modelo de solicitud/respuesta de MCP)

Estas funciones están disponibles en la API REST de twitterapi.io completa — úsala directamente si necesitas acceso de escritura.

Cumplimiento de especificaciones

  • Construido sobre @modelcontextprotocol/sdk v1
  • Apunta a la especificación MCP 2025-11-25 (la más reciente)
  • Transporte: stdio (Streamable HTTP planificado para v0.2+ para uso remoto/alojado)
  • Probado con: mcp-inspector, Claude Desktop, Cursor, Claude Code

Desarrollo

git clone https://github.com/kaitoInfra/twitterapi-io-mcp-server.git
cd twitterapi-io-mcp-server
npm install
npm run build
TWITTERAPI_IO_API_KEY=xxx npm run inspect  # opens mcp-inspector

Enlaces

Licencia

MIT © twitterapi.io