API de Twitter/X para agentes de IA y herramientas de código (2026)

Por Sorsa Editorial

Actualizado en julio de 2026: agrega el servidor MCP alojado oficial de X (lanzado el 30 de junio de 2026) y refresca las tarifas de lectura de pago por uso de la API de X contra el cambio del 20 de abril de 2026.

Conclusión clave: Los agentes de IA y las herramientas de código alcanzan datos públicos de X/Twitter de tres formas: un servidor MCP que expone herramientas de lectura a clientes de chat, una skill de agente que enseña los endpoints a las herramientas de código y una API REST simple llamada desde código generado. El acceso de solo lectura mantiene a los agentes autónomos fuera de las cuentas de usuario, y el cobro de tarifa plana por solicitud evita los costos por recurso.

La mayoría de las guías sobre una API de Twitter para agentes de IA asumen que el agente va a publicar. Vigilar un feed, redactar una respuesta, publicar. Ese es un trabajo, y la API oficial de X es su dueña. El trabajo más grande y de crecimiento más rápido es leer: un agente que busca conversaciones, extrae un perfil, revisa quién sigue a quién, o recolecta tweets para que un modelo los resuma. Leer es donde una capa de datos administrada y de solo lectura gana a conectar un agente autónomo a una cuenta con capacidad de escritura.

Esa es la brecha que Sorsa API, una API alternativa de Twitter/X construida para acceso intensivo en lecturas, llena para quienes construyen con IA. Expone 40 endpoints de lectura entre perfiles, tweets, búsqueda, seguidores, Listas, Comunidades y comprobaciones de verificación, con una sola clave API en un encabezado ApiKey (sin OAuth, sin revisión de app), cobro de tarifa plana por solicitud desde $0.02 por cada 1,000 tweets y 20 solicitudes por segundo en todos los planes. Las cuentas nuevas reciben 100 solicitudes gratis, por única vez, sin tarjeta de crédito, en los 40 endpoints, suficiente para conectar un agente a datos reales antes de pagar nada.

Esta guía cubre las tres vías de conexión, cómo el modo de solo lectura cambia la ecuación de seguridad para los agentes autónomos, cómo las piezas mapean a las herramientas que la gente usa de verdad (Claude Desktop, Cursor, Claude Code, Codex, Windsurf y constructores de vibe coding), y lo que cuestan los datos a escala de agente.

En esta página

Por qué los agentes de IA y las herramientas de código necesitan una API de Twitter/X
Tres formas de conectar datos de Twitter/X a herramientas de IA
Solo lectura o acceso de escritura: qué necesita un agente autónomo
La API oficial de X y su servidor MCP alojado
Qué cuestan los datos de Twitter/X para un agente de IA
Qué vía encaja con qué herramienta
Cómo un equipo pequeño conectó un agente a datos de X en vivo
Preguntas frecuentes
Cómo empezar

Por qué los agentes de IA y las herramientas de código necesitan una API de Twitter/X {#why}

Los agentes de IA y las herramientas de código necesitan una API de Twitter/X porque un modelo de lenguaje no tiene acceso en vivo a la plataforma por sí solo: sus datos de entrenamiento están congelados, y X bloquea el scraping no autenticado. Una API convierte "qué está diciendo la gente sobre esto" en una llamada estructurada que el modelo puede hacer, recibir JSON limpio y razonar sobre él, sin que el modelo invente una respuesta.

La demanda no es de nicho. En la Encuesta de Desarrolladores 2025 de Stack Overflow, con más de 49,000 desarrolladores, el 84% de quienes respondieron usa o planea usar herramientas de IA en su proceso de desarrollo, arriba del 76% en 2024, y el 51% de quienes desarrollan de forma profesional usa herramientas de IA a diario. Esas herramientas cada vez más alcanzan fuera de su propio contexto por datos reales, y la conversación social pública es una de las fuentes más solicitadas.

Dos lectores distintos aparecen en la práctica. El primero es un agente en tiempo de ejecución: un agente de monitoreo, un asistente de investigación, un bot de soporte que necesita revisar una cuenta pública. El segundo es la herramienta de código en sí en tiempo de construcción, donde Cursor o Claude Code escribe el código de integración y necesita conocer los endpoints, la autenticación y las formas de respuesta para acertar en las llamadas. Las tres vías de abajo sirven a ambos.

Tres formas de conectar datos de Twitter/X a herramientas de IA {#three-ways}

Hay tres formas de darle a las herramientas de IA datos de Twitter/X: un servidor MCP para clientes de chat, una skill de agente para herramientas de código y la API REST llamada directamente desde código generado. No son competidoras; encajan con herramientas distintas, y la misma clave API funciona en las tres.

Opción 1: un servidor MCP para clientes de chat

Un servidor MCP es la vía más rápida para un cliente estilo chat. El Model Context Protocol es un estándar abierto, introducido por Anthropic a finales de 2024, que deja a una aplicación de IA llamar herramientas externas de una forma uniforme. Un servidor MCP expone un conjunto de herramientas; el cliente habla el protocolo; el modelo elige la herramienta correcta para cada solicitud. El servidor MCP de Sorsa envuelve los endpoints de lectura para que cualquier cliente compatible con MCP gane herramientas nativas para buscar tweets y leer perfiles, seguidores, respuestas, menciones y tendencias.

Corre en local a través de npx, así que no hay nada que clonar ni construir. Apúntalo a tu clave y reinicia el cliente:

json

{
  "mcpServers": {
    "sorsa": {
      "command": "npx",
      "args": ["-y", "sorsa-mcp"],
      "env": {
        "SORSA_API_KEY": "YOUR_KEY"
      }
    }
  }
}

Ese mismo bloque funciona en Claude Desktop, Cursor, VS Code con GitHub Copilot, Windsurf y cualquier otro cliente MCP. El servidor expone una herramienta por endpoint (40 en total), todas de solo lectura. El código fuente del servidor MCP está en GitHub bajo licencia MIT. Para el recorrido completo cliente por cliente, revisa la guía dedicada del servidor MCP de Twitter; esta sección es la versión corta.

Opción 2: una skill de agente para herramientas de código

Para agentes de código que construyen y corren flujos de trabajo, una skill de agente encaja mejor que una herramienta de chat. Una skill en el formato abierto SKILL.md es una carpeta de instrucciones que un agente lee para aprender una capacidad: cómo autenticarse, qué endpoint corresponde a qué objetivo y cómo paginar y agrupar en lotes. A diferencia de un servidor MCP, que el modelo llama en tiempo de chat, una skill enseña a un agente de código a escribir código de API correcto por sí mismo y luego correrlo dentro de un proyecto real.

La skill SKILL.md abierta para la API de Sorsa funciona con cualquier agente que lea el formato: Claude Code, Cursor, Codex CLI y otros. La instalación manual es una copia al directorio de skills del agente:

bash

git clone https://github.com/Sorsa-io/sorsa-x-api-skill ~/.claude/skills/sorsa-x-api
export SORSA_API_KEY=your_key

Después de eso, un prompt como "obtén los 100 seguidores más recientes de @elonmusk" o "busca en X posts populares que mencionen Solana esta semana" es suficiente. La skill le dice al agente que se autentique con el encabezado ApiKey, elija el endpoint (/followers para seguidores, /search-tweets para búsqueda) y pagine los resultados. Viene con ejemplos ejecutables de Python y curl más un cliente pequeño que maneja el reintento y la paginación, así que el agente reutiliza la mecánica de solicitudes en lugar de reescribirla.

La vía de la skill es la que la mayoría de las páginas de la competencia se salta, y es el encaje natural para el lado de lectura de un flujo con agentes: el agente decide cuándo se necesitan datos de X y los trae por su cuenta.

Opción 3: la API REST y docs legibles por IA para vibe coding

Cuando construyes la app tú mismo y dejas que una IA escriba la integración, llama a la API REST directamente. El vibe coding, construir software describiéndolo en lenguaje natural, fue la palabra del año 2025 del Collins Dictionary, y herramientas como Cursor, Bolt, Lovable y Replit ahora entregan apps funcionales a partir de prompts. El cuello de botella para cualquier API externa en ese flujo es si el modelo conoce la API lo bastante bien para escribir llamadas correctas.

Eso es lo que resuelve la documentación legible por IA. Junto a los docs para humanos, Sorsa publica una versión legible por IA de la documentación: una referencia en texto plano que un agente puede jalar a su contexto y parsear sin pelear con HTML ni renderizado. Pegarla o enlazarla en Cursor o Claude Code le da al modelo la lista de endpoints, los parámetros y los campos de respuesta, así que las solicitudes generadas coinciden con la API real al primer intento.

La API en sí se mantiene simple, lo que hace corto el código generado. Una consulta de perfil es un GET autenticado:

python

import os, requests

r = requests.get(
    "https://api.sorsa.io/v3/info",
    headers={"ApiKey": os.environ["SORSA_API_KEY"]},
    params={"username": "elonmusk"},
)
r.raise_for_status()
print(r.json()["followers_count"])

La búsqueda es un POST con un cuerpo JSON que acepta operadores de búsqueda avanzada de Twitter a través de el endpoint de búsqueda de tweets:

bash

curl -X POST "https://api.sorsa.io/v3/search-tweets" \
  -H "ApiKey: $SORSA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "from:elonmusk min_faves:1000", "order": "popular"}'

De ahí, el endpoint de seguidores devuelve hasta 200 perfiles por llamada, los endpoints por lotes admiten hasta 100 tweets o perfiles por solicitud, y la misma clave cubre todo. Para una orientación más completa, la guía de construir con IA y el inicio rápido de la API recorren el montaje de principio a fin.

Solo lectura o acceso de escritura: qué necesita un agente autónomo {#read-only}

Para la mayoría de los casos de uso de IA, un agente necesita leer datos públicos de X, no escribir en una cuenta, y el acceso de solo lectura elimina toda una clase real de riesgo. Un agente que solo puede leer no puede publicar, borrar, seguir ni enviar un DM sin importar lo que una inyección de prompt en una respuesta scrapeada le diga que haga. Ese es un límite significativo cuando el agente corre por su cuenta.

Los datos de confianza respaldan la cautela. La misma encuesta de Stack Overflow 2025 encontró una brecha marcada entre uso y confianza: solo el 29% de quienes respondieron en 2025 dijo confiar en la IA, 11 puntos porcentuales menos que en 2024, y la mayor frustración, citada por dos tercios de quienes desarrollan, fue una salida de IA que está casi bien pero no del todo. Cuando los errores de un agente se confinan a lecturas, una acción casi correcta devuelve datos equivocados que puedes atrapar, no un post equivocado en una cuenta en vivo que no puedes deshacer.

Esta es también la concesión honesta. Si el trabajo de tu agente es publicar, dar like o enviar DMs, la API oficial de X es la vía conforme para acciones de escritura en una cuenta de usuario, y ningún proveedor de solo lectura la reemplaza. Algunas APIs de terceros sí venden acciones de escritura; ese es otro intercambio, porque pone escrituras automatizadas en cuentas reales. Sorsa es de solo lectura por diseño, lo que mantiene el uso de la API fuera de las cuentas de usuario por completo. Para un agente intensivo en lecturas, 20 solicitudes por segundo y el precio de tarifa plana por solicitud importan más que los endpoints de escritura que el agente nunca llamará. Para la autenticación de una sola clave de solo lectura, el montaje es una clave en un encabezado, no un flujo OAuth por usuario.

La API oficial de X y su servidor MCP alojado {#official-x}

La API oficial de X es la fuente de primera parte, y a mediados de 2026 agregó su propia capa MCP. Según el anuncio para desarrolladores de X, la plataforma lanzó un servidor MCP alojado el 30 de junio de 2026, que deja a Grok, Cursor, Claude o cualquier cliente MCP leer y escribir en X con las propias credenciales del desarrollador, con un servidor MCP separado para la documentación de desarrolladores. Es de primera parte, con alcance OAuth, y enruta cada llamada a través del plan de API de X de la cuenta.

El detalle que surgió de inmediato fue el costo. El MCP alojado no cambia el precio; se apoya en el modelo de pago por uso, así que cada llamada de herramienta cobra por recurso consultado, y quienes lo observaron señalaron la factura por llamada como la mayor sorpresa del primer día. Para un agente que dispara muchas lecturas, eso suma de una forma en que un plan de tarifa plana no.

Para un agente de solo lectura, las diferencias que importan son el montaje y el costo: la API oficial necesita una app OAuth y cobra por recurso, mientras que un plan de tarifa plana de solo lectura necesita una clave y cobra por solicitud.

Eje	API oficial de X	Sorsa API
Montaje para un agente	App OAuth 2.0, revisión, refresco de token por usuario	una sola clave API en el encabezado `ApiKey`
Opción MCP	MCP alojado de primera parte (30 de junio de 2026), con alcance OAuth, lectura y escritura	servidor MCP de solo lectura, local vía `npx`, sin OAuth
Modelo de acceso	pago por recurso consultado	de tarifa plana: 1 llamada = 1 solicitud
Costo de lectura	$0.005 por post, $0.010 por perfil	desde $0.02 por cada 1,000 tweets, desde $0.01 por cada 1,000 perfiles
Acciones de escritura	publicar, DMs, borradores (vía conforme)	ninguna (solo lectura por diseño)
Arranque gratuito	sin nivel gratuito; compra créditos primero	100 solicitudes gratis, sin tarjeta

Una solicitud de Sorsa devuelve hasta 100 tweets o 200 perfiles, así que las cifras por cada 1,000 usan esa base por lotes. Las tarifas de lectura de la API oficial de X son las del precio del 20 de abril de 2026.

Qué cuestan los datos de Twitter/X para un agente de IA {#cost}

Para un agente de IA intensivo en lecturas, un plan de tarifa plana por solicitud es mucho más barato que el cobro por recurso, porque los agentes hacen muchas lecturas chicas y reutilizan los mismos datos. La API oficial de X cobra por recurso consultado: $0.005 por lectura de post y $0.010 por lectura de usuario, así que un solo tweet devuelto con su perfil de autor cuesta $0.015, o unos $15 por cada 1,000. Los datos de autor incrustados en un resultado de búsqueda se cobran como una lectura de usuario separada.

Un plan de tarifa plana invierte eso. En Sorsa, 1 llamada a la API es 1 solicitud contra tu cuota mensual sin importar cuántos elementos devuelva, y el perfil del autor dentro de cada respuesta de tweet es gratis. Los planes son $49 al mes por 10,000 solicitudes (Starter), $199 por 100,000 (Pro) y $899 por 500,000 (Enterprise), cada uno a 20 solicitudes por segundo. En cargas intensivas en lecturas eso sale hasta 50 veces más barato que la API oficial en cuanto el volumen pasa unas 10,000 lecturas de posts al mes.

Lee el número por tweet de dos formas. Una consulta masiva por ID a través de /tweet-info-bulk devuelve 100 tweets por solicitud y aterriza en la base desde $0.02 por cada 1,000 tweets en Pro. Una búsqueda interactiva a través de /search-tweets devuelve unos 20 tweets por solicitud, así que sale más cerca de $0.10 por cada 1,000 en el mismo plan, porque cada llamada devuelve menos elementos. Ambas quedan muy por debajo de los $15 por cada 1,000 del modelo por recurso, y ninguna carga el tope mensual de 2 millones de lecturas de posts de la API oficial. Recortar el número de solicitudes con llamadas por lotes se cubre en cómo optimizar el uso de la API; el precio oficial completo está en el desglose de precios de la API de X de 2026.

Qué vía encaja con qué herramienta {#which-path}

La vía correcta depende de la herramienta y del trabajo, no de cuál es la más nueva. Una lista corta de decisión:

Claude Desktop, Cursor o VS Code como cliente de chat: el servidor MCP, porque suma herramientas de lectura con un bloque de configuración y sin código de conexión.

Claude Code, Codex o Cursor construyendo un flujo: la skill de agente, que le enseña al agente de código los endpoints, la autenticación y la paginación contra los que escribe.

Una app propia o hecha con vibe coding: la API REST llamada desde código generado, con los docs legibles por IA para que el modelo escriba solicitudes correctas.

Un agente que publica, da like o envía DMs: la API oficial de X, la vía conforme para acciones de escritura en una cuenta de usuario.

Recolección de datos de alto volumen e intensiva en lecturas: un plan de tarifa plana de Sorsa, donde 1 llamada es 1 solicitud y los perfiles de autor vienen gratis dentro de las respuestas de tweet.

Muchas implementaciones mezclan vías: un servidor MCP para explorar mientras prototipas, y luego la API REST en la app lanzada. Recolectar tweets para entrenar o hacer fine-tuning de un modelo es su propio flujo, cubierto en cómo construir un dataset de Twitter para machine learning.

Cómo un equipo pequeño conectó un agente a datos de X en vivo {#case}

Un equipo pequeño de analítica social, de unas cinco personas, corría un agente de rastreo de menciones en la API oficial de X y veía la factura por recurso trepar a medida que la cobertura crecía por más marcas. Cada mención rastreada significaba una lectura de post más una lectura de usuario para el autor, y el código de refresco de token OAuth había que mantenerlo por separado para cada entorno.

Mover la carga de lectura a un plan de tarifa plana y conectar el agente a través del servidor MCP recortó su gasto en datos de Twitter en más de un 90%, y les dejó borrar el manejo de tokens por entorno a favor de una clave en una variable de entorno. Como cada herramienta que el agente podía llamar era de solo lectura, una inyección de prompt enterrada en una respuesta scrapeada no podía hacerlo publicar ni seguir nada, lo que eliminó un paso de revisión que el equipo había agregado por cautela. El patrón se generaliza a cualquier agente de lectura siempre encendido; la mecánica del sondeo continuo está en monitoreo en tiempo real con la API REST.

Preguntas frecuentes {#faq}

¿Pueden los agentes de IA acceder a datos de Twitter/X sin una cuenta de desarrollador?

Sí. Una API de datos de Twitter/X administrada como Sorsa necesita solo una clave API en un encabezado ApiKey, sin cuenta de desarrollador de X, flujo OAuth ni revisión de app. Un agente se autentica con una clave y llama a endpoints de lectura para perfiles, tweets, búsqueda y seguidores. Las cuentas nuevas reciben 100 solicitudes gratis, sin tarjeta de crédito, así que un agente puede extraer datos en vivo a minutos de registrarse.

¿Deberías usar el servidor MCP de Sorsa o la skill de agente para herramientas de código?

Usa el servidor MCP para clientes de chat como Claude Desktop y Cursor, donde el modelo llama herramientas de lectura directamente durante una conversación. Usa la skill de agente SKILL.md para agentes de código como Claude Code y Codex que escriben y corren código de integración, porque la skill les enseña los endpoints, la autenticación y la paginación. Ambas usan la misma clave API de Sorsa, y muchos constructores corren ambas.

¿Puede un agente de IA publicar tweets a través de la API de Sorsa?

No. Sorsa es de solo lectura por diseño y no tiene endpoints de escritura, así que un agente no puede publicar, responder, dar like, seguir ni enviar DMs a través de ella. Eso es intencional: el acceso de solo lectura mantiene a los agentes autónomos fuera de las cuentas de usuario. Para acciones de escritura en una cuenta, la API oficial de X es la vía conforme; Sorsa cubre el lado de lectura, que es lo que la mayoría de los flujos de agentes y herramientas de código realmente necesita.

¿Cuánto cuestan los datos de Twitter/X para un agente de IA?

La API oficial de X cobra por recurso consultado, $0.005 por post y $0.010 por perfil, así que un tweet con su autor sale en unos $15 por cada 1,000. Sorsa usa cobro de tarifa plana por solicitud: $49, $199 o $899 al mes por 10,000, 100,000 o 500,000 solicitudes. Las consultas masivas aterrizan cerca de $0.02 por cada 1,000 tweets y las búsquedas cerca de $0.10 por cada 1,000, con los perfiles de autor incluidos gratis.

¿Qué es el servidor MCP oficial de X y en qué se diferencia?

X lanzó un servidor MCP alojado de primera parte el 30 de junio de 2026, que deja a los clientes de IA leer y escribir en X con las propias credenciales OAuth del desarrollador, enrutadas a través de su plan de API de X. Admite acciones de escritura, que los servidores de solo lectura no. El intercambio es el costo: cobra sobre el modelo de pago por uso por llamada, mientras que el servidor MCP de solo lectura de Sorsa corre en local y cobra por solicitud contra un plan de tarifa plana.

¿Qué herramientas de código con IA funcionan con la skill de Twitter/X de Sorsa?

La skill usa el formato abierto SKILL.md, así que funciona con cualquier agente que lea ese formato, incluidos Claude Code, Cursor y Codex CLI. El servidor MCP funciona con cualquier cliente compatible con MCP: Claude Desktop, Claude Code, Cursor, VS Code con GitHub Copilot y Windsurf, entre otros. En cualquier caso, el montaje es la misma configuración estándar y una sola clave API de Sorsa.

Cómo empezar {#getting-started}

Puedes probar los datos antes de escribir código. Empieza en el playground del navegador para correr endpoints desde una interfaz sin registro, y luego reclama 100 solicitudes gratis para apuntar un agente real a datos en vivo. Las 100 solicitudes son por única vez, no necesitan tarjeta de crédito, nunca vencen y cubren los 40 endpoints, suficiente para probar el servidor MCP, la skill o una llamada directa de principio a fin.

De ahí, elige una vía. Agrega el bloque de configuración MCP para un cliente de chat, clona la skill para un agente de código o pega los docs legibles por IA en tu editor y deja que escriba la integración. La documentación completa y las 20 solicitudes por segundo cubren los detalles operativos, y los equipos que mueven un agente existente de la API oficial pueden seguir la guía de migración. Si primero estás sopesando proveedores, la comparación de alternativas a la API de Twitter expone las opciones con números reales.

Revisado por Keksich, fundador de Sorsa, especialista en marketing e investigador de la API de X.

Esta guía se apoya en la operación directa de la API de Sorsa, sus endpoints en vivo y sus repositorios públicos de MCP y skill, y la documentación v3 vigente. Las cifras externas se verificaron el 11 de julio de 2026 contra la Encuesta de Desarrolladores 2025 de Stack Overflow para la adopción y confianza en herramientas de IA, y contra el propio anuncio para desarrolladores de X sobre el servidor MCP alojado (30 de junio de 2026) y la actualización de precios de la API de X del 20 de abril de 2026 para la comparación de costos. La API oficial de X es el punto de comparación principal a lo largo del texto.