X (Twitter)
Conecta X (Twitter) a Claude Code
Pega un prompt. Claude te pregunta qué quieres hacer en X, elige la herramienta por coste y riesgo y te guía paso a paso por la API oficial.
Abre Claude Code
Tú haces esto- 1Abre Claude Desktop
- 2Haz clic en la pestaña Claude Code
- 3Elige cualquier carpeta para trabajar
Pega este prompt
Claude CodeClaude te preguntará qué quieres hacer, revisará tu ordenador y te dirá exactamente qué pulsar en developer.x.com. Solo tienes que seguirle.
Después, prueba con estos
Cuando Claude confirme que está conectado, pídele cosas como:
Léeme este tweet: https://x.com/.../status/...
Enséñame mis últimos 15 bookmarks de X
Qué hay en mi lista de X 'Awesome AI'
Resume el hilo de este tweet: <url>
Las cuatro herramientas en detalle
Lo que el prompt sopesa por ti, para quien prefiera montarlo a mano.
Empieza por la pregunta correcta: no todos necesitan acceso a su cuenta. Hay tres intenciones distintas, y la herramienta correcta depende de cuál sea la tuya.
Las 4 herramientas, por intención
Pagas solo la API por uso (la herramienta es gratis); a volumen personal son céntimos al mes. Precios y límites oficiales en la documentación de la X API.
Casos de uso: ¿cuál uso?
Busca lo que quieres hacer y ve directo a la herramienta. La columna del medio te dice si hace falta acceso a tu propia cuenta.
Paso a paso: la vía oficial (xurl)
Tú haces dos cosas en el portal de X (crear la app y fondearla). El resto lo hace Claude Code.
Instalar xurl
La CLI oficial de la X API. Un binario, sin dependencias. Claude Code lo instala por ti.
brew install --cask xdevplatform/tap/xurl
Crear la app en developer.x.com
En tu app, sección User authentication settings: permisos Read and write, tipo Web App, y callback http://localhost:8080/callback. Luego, en Keys and tokens, copia el OAuth 2.0 Client ID y Client Secret (no las Consumer Keys ni el Bearer: esos no sirven para bookmarks ni publicar).
Fondear la cuenta (pay-per-use)
En developer.x.com → Billing/Usage, añade método de pago o créditos. Sin saldo, X rechaza toda llamada, incluso leer, con el error CreditsDepleted. Es el paso que más sorprende.
Registrar y autenticar
Guardas el Client ID y el Secret como variables de entorno (nunca en el chat). Claude Code registra la app y lanza el login OAuth2, que abre tu navegador una vez para que pulses Authorize. Los tokens quedan en ~/.xurl.
xurl auth apps add main \ --client-id TU_CLIENT_ID \ --client-secret TU_CLIENT_SECRET \ --redirect-uri http://localhost:8080/callback xurl auth oauth2 --app main xurl /2/users/me # verifica: devuelve tu cuenta
Usar con lenguaje natural
Ya está. Háblale a Claude Code en español normal y se encarga de los endpoints correctos. Prueba con los ejemplos de arriba.
Lo que seguramente te preguntas
¿Lee un tweet si le paso la URL?
Sí. Extrae el ID de la URL y te devuelve el texto completo (no se corta en 280) más las fotos y vídeos.
¿Qué significa "leer mis bookmarks"?
Te devuelve los tweets guardados enteros (texto, autor, fecha, media), no solo una lista de enlaces. Es lectura owned, la más barata.
¿Saca también imágenes y vídeos?
Sí, como URLs: la foto es un enlace directo; el vídeo viene como variantes mp4 + miniatura. El binario se descarga aparte, la API no lo incrusta.
¿Y si es un hilo?
Se reconstruye por conversation_id. En pay-per-use solo cubre hilos de los últimos 7 días; los más viejos requieren tier Pro/Enterprise.
¿Tengo que pagar o montar algo?
Sí: una cuenta de desarrollador en pay-per-use, fondeada. Sin saldo todo da CreditsDepleted. La herramienta xurl es gratis; pagas solo la API por uso.
¿Me pueden banear?
Con la API oficial (xurl), no: es la vía sancionada, riesgo cero. Con scraping (twitter-cli), sí: usa tus cookies y X banea en oleadas en 2026.
¿Qué credenciales necesito exactamente?
El OAuth 2.0 Client ID + Secret. Las Consumer Keys (OAuth 1.0a) y el Bearer no sirven para bookmarks ni publicar: ese es el error nº1 al montarlo.
Límites de la API oficial (no son bugs)
- El feed "Para ti" no existe en la API oficial (el home timeline algorítmico se retiró).
- Listas que sigues (
followed_lists) no están disponibles en pay-per-use; las tuyas sí. - Hilos de más de 7 días requieren full-archive search (Pro/Enterprise).
- La media llega como URLs, nunca como binario; se descarga aparte.