Saltar al contenido
Ver la documentación

Agentes de IA

Usa xscraper desde agentes de IA

El servidor MCP da a Claude, Codex, Muse Code, Cursor, VS Code y a cualquier otro cliente MCP nueve herramientas de solo lectura para datos de X. Las habilidades enseñan al agente qué herramienta encaja con una tarea y cómo gastar tan pocos tokens como necesite la respuesta. Ambos usan tu clave de API, y cada llamada a una herramienta cuesta lo mismo que la llamada REST que tiene detrás.

Servidor MCP

MCPhttps://mcp.xscraper.online/mcp

Streamable HTTP, con tu clave en el encabezado x-api-key. Para los clientes que solo inician servidores locales, las mismas herramientas se ejecutan desde el paquete npm xscraper-mcp. Los resultados son una línea por publicación o cuenta de forma predeterminada, con los ID que necesita la siguiente llamada; pide response_format: detailed para obtener todos los campos.

x_search_tweets
Busca publicaciones con operadores de X, las más nuevas o las de más interacción.Búsqueda de tuits 6–14 tokens
x_search_users
Encuentra cuentas por nombre o biografía.Búsqueda de usuarios 4–6 tokens
x_get_user
El perfil de una cuenta, de forma opcional con sus publicaciones o respuestas recientes.Perfil por nombre de usuario 1 tokenTuits del usuario 3–7 tokensÚltimo tuit 1 token
x_get_tweet
Una publicación por ID o enlace, con una página de respuestas o citas.Tuit por ID 1 tokenRespuestas del tuit 4 tokensCitas del tuit 4 tokens
x_get_followers
Los seguidores de una cuenta, o a quién sigue.Seguidores 4 tokensSiguiendo 4 tokens
x_get_user_likes
Publicaciones a las que una cuenta dio me gusta.Tuits con me gusta 4–8 tokens
x_get_list_tweets
Publicaciones de una lista de X.Tuits de una lista 3–7 tokens
x_get_trends
Lo que es tendencia ahora.Tendencias 2 tokens
x_get_balance
Los tokens que quedan en tu clave.Saldo de tokens 0 tokens

Conectar un cliente

Crea una clave en el panel, luego añade el servidor a tu cliente.

Ejecútalo una vez en una terminal. El servidor se añade para tu usuario; usa --scope project para compartirlo mediante .mcp.json.

Claude Code
claude mcp add --transport http xscraper \
  https://mcp.xscraper.online/mcp \
  --header "x-api-key: $XSCRAPER_API_KEY"

Habilidades

Las Agent Skills son instrucciones que un agente carga cuando una tarea coincide. Siguen el formato abierto Agent Skills, así que Claude Code, Codex, Muse Code, Cursor, Copilot y otros agentes pueden usarlas. El código fuente está en GitHub.

xscraper-api
Qué herramienta responde a cada pregunta, los operadores de búsqueda de X, las reglas de gasto y la referencia REST para agentes sin MCP.
x-account-research
Quién es una cuenta, qué publica y si su interacción parece real, en un informe breve con fuentes.
x-topic-research
Qué dice X de un tema, una marca, un lanzamiento o un ticker: temas, quejas y elogios, con enlaces.
x-thread-digest
Una publicación con sus respuestas y sus citas, resumida en argumentos y voces destacadas.
x-monitor
Vigila cuentas o palabras clave según un horario e informa solo de las publicaciones nuevas, con una búsqueda por ejecución.

Instala las habilidades y el servidor MCP a la vez. Define XSCRAPER_API_KEY en tu shell primero.

Claude Code plugin
/plugin marketplace add ensp1re/xscraper-agent-kit
/plugin install xscraper@xscraper

Aplicaciones de Claude: descarga una carpeta de habilidad desde GitHub, comprímela en un zip y súbela en Ajustes → Capabilities → Skills.

Costos y límites

  • Cada herramienta indica su precio, y cada resultado termina con los tokens que gastó y el saldo que queda.
  • x_get_balance es gratis. Las habilidades le dicen al agente que empiece con una página y que te pregunte antes de una tarea que costaría más de unos 50 tokens.
  • Las llamadas fallidas se reembolsan, excepto una respuesta de no encontrado. Una llamada que agota el tiempo de espera puede haberse cobrado igual, así que el agente comprueba el saldo antes de reintentar.
  • El límite de solicitudes es el mismo que en REST: 100 solicitudes por minuto por clave.