RebundleRebundle Stack
Claude Code Hub

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.

Necesitas tu cuenta de X y una cuenta de desarrollador en developer.x.com con saldo (pago por uso; a volumen personal son céntimos al mes). Claude empieza en modo solo lectura y nunca te pedirá que pegues una clave en el chat.
1

Abre Claude Code

Tú haces esto
  1. 1Abre Claude Desktop
  2. 2Haz clic en la pestaña Claude Code
  3. 3Elige cualquier carpeta para trabajar
2

Pega este prompt

Claude Code

Claude te preguntará qué quieres hacer, revisará tu ordenador y te dirá exactamente qué pulsar en developer.x.com. Solo tienes que seguirle.

dile esto a claude
Quiero conectar X (Twitter) a Claude Code para que puedas leer tweets, mis bookmarks y mis listas, y publicar cuando yo te lo pida. No soy técnico: guíame paso a paso, un paso cada vez, y espera a que te confirme antes de seguir. CONTEXTO PARA TI - Hay cuatro vías, según lo que quiera hacer: 1. xurl (la recomendada): la CLI oficial de la X API v2, con OAuth. Opera mi cuenta (bookmarks, listas, publicar y responder) y lee un tweet público por su URL (texto completo y media). Pago por uso, de 0,001 a 0,015 $ por acción; la herramienta es gratis. Riesgo de baneo cero. 2. Apify (actors): scraping gestionado en su infraestructura para datos públicos a volumen (miles de tweets de un tema o hashtag, vigilar qué publican ciertas cuentas). No usa mi cuenta. De 0,15 a 0,40 $ por 1.000 tweets. 3. Grok API (xAI): un LLM con búsqueda en X integrada, para preguntar o resumir qué se dice sobre un tema. Busca y resume, pero no da datos crudos. 1,25/2,50 $ por millón de tokens más 5 $ por 1.000 búsquedas. 4. twitter-cli: scraping con las cookies de mi sesión de X. Es la única vía para el feed "Para ti", pero pone mi cuenta en juego: X banea en oleadas en 2026. Solo con una cuenta secundaria, nunca con la principal. - Montar xurl: a. Instalar: brew install --cask xdevplatform/tap/xurl b. Crear una app en developer.x.com (lo hago yo). En User authentication settings: permisos "Read and write", tipo "Web App" y callback http://localhost:8080/callback. Después, en Keys and tokens, copiar el OAuth 2.0 Client ID y el Client Secret. Las Consumer Keys (OAuth 1.0a) y el Bearer no sirven para bookmarks ni para publicar: es el error número 1 al montarlo. c. Fondear la cuenta (lo hago yo): en developer.x.com, Billing/Usage, añadir un método de pago o créditos. Sin saldo, X rechaza toda llamada, incluso leer, con el error CreditsDepleted. d. Registrar y autenticar: "xurl auth apps add main --client-id ... --client-secret ... --redirect-uri http://localhost:8080/callback" y luego "xurl auth oauth2 --app main", que abre el navegador una vez para pulsar Authorize. Los tokens quedan en ~/.xurl. Se verifica con "xurl /2/users/me", que devuelve mi cuenta. - Límites de la API oficial (no son bugs): no expone el feed "Para ti"; las listas que sigo (followed_lists) no están en pay-per-use, las mías sí; un hilo se reconstruye por conversation_id y en pay-per-use solo si es de los últimos 7 días (los más viejos piden Pro o Enterprise); la media llega como URLs (la foto como enlace directo, el vídeo como variantes mp4 con miniatura) y se descarga aparte. QUÉ QUIERO QUE HAGAS 1. ENTENDER: pregúntame, de una en una y con opciones para elegir: qué quiero hacer (operar mi cuenta: bookmarks, listas, publicar; leer un tweet suelto; bajar tweets públicos a volumen; saber qué se dice sobre un tema; o leer mi feed "Para ti") y si es algo puntual o recurrente. 2. RECOMENDAR: dime en dos frases qué vía encaja y por qué. Por defecto, xurl. Apify solo si quiero datos públicos a volumen y Grok si quiero un resumen de lo que se dice. Si te pido el feed "Para ti", explícame antes el riesgo de baneo y que solo se use con una cuenta secundaria. 3. REVISAR: comprueba tú mismo lo que puedas (si hay Homebrew, si xurl ya está instalado y si ya hay una app registrada en ~/.xurl). Instala lo que falte pidiéndome permiso antes. 4. GUIARME EN DEVELOPER.X.COM: dime exactamente qué pulsar para crear la app, configurar la autenticación, copiar el Client ID y el Client Secret correctos y añadir saldo, un paso cada vez. Si algo no coincide con lo que veo, pídeme una captura de pantalla. 5. CLAVES: nunca me pidas que te pegue el Client ID ni el Client Secret en el chat; basta con que los copie. Hazlo así, un dato cada vez: dime exactamente qué copiar y de dónde; cuando te diga «OK», léelo tú del portapapeles (pbpaste en Mac; Get-Clipboard de PowerShell en Windows) y guárdalo directamente donde toque, sin mostrarlo, repetirlo ni escribirlo en el chat. Comprueba solo que no está vacío y después vacía el portapapeles. Guárdalos como variables de entorno de usuario (en Mac, una línea export en ~/.zshrc; en Windows, [Environment]::SetEnvironmentVariable con ámbito User): X_CLIENT_ID y X_CLIENT_SECRET, y léelos desde ahí al registrar la app con xurl. Cuando lances el login, avísame de que se abrirá el navegador para que pulse Authorize. 6. PROBAR: haz una prueba pequeña de solo lectura (xurl /2/users/me y, por ejemplo, mis últimos 5 bookmarks) y enséñame el resultado. Si sale CreditsDepleted, recuérdame que falta añadir saldo. 7. RECORDAR: crea una skill personal con cómo usar xurl, los límites de arriba y la regla de no publicar sin mi OK. Así la próxima vez me basta con preguntarte. Reglas: solo lectura por defecto. No publiques, respondas ni cambies nada en mi cuenta de X sin que yo lo pida de forma explícita, y enséñame antes el texto exacto que vas a enviar. Si algo falla, explícamelo en lenguaje sencillo antes de intentar arreglarlo. CÓMO TRABAJAR CONMIGO - Explícame cada paso como a un niño de 10 años: frases cortas, sin jerga y, si usas una palabra técnica, dime en una línea qué es. Si te digo que soy técnico, ve al grano. - Cuando tengas que preguntarme algo, hazlo de una pregunta en una y con opciones para elegir (usa la herramienta de preguntas con opciones si la tienes), con una línea que explique cada opción. - Si hay que instalar algo, dime en una línea qué es y para qué sirve, y ofrécete a instalarlo tú con mi permiso. Si algo falla, cuéntame en palabras sencillas qué ha pasado y cuál es el siguiente intento, antes de probarlo. - Lo que te cuento arriba puede haberse quedado viejo. Antes de empezar, comprueba en la documentación oficial que sigue vigente; si algo no coincide, manda la documentación y dime qué ha cambiado. - Si tienes navegador (el navegador integrado de la app de Claude o Claude in Chrome), hazlo tú todo lo que puedas en vez de mandarme a una web: ábrela tú, navega hasta la pantalla exacta, rellena lo que no sea secreto y léeme lo que haga falta. Si arriba pone que yo vaya a una página o pulse algo, tómalo como lo que hay que conseguir y hazlo tú con el navegador. Pídeme a mí, de un paso en uno, solo lo que no puedes hacer: iniciar sesión, aprobar permisos, pagar o copiar una clave; tú no escribes contraseñas ni claves en ninguna web. Si no tienes navegador, entonces guíame con instrucciones. - Si hacen falta claves o algo más para conectarte (scripts, configuración), guárdalo en un sitio fijo de mi usuario, fuera de esta carpeta y de cualquier repositorio, que solo yo pueda leer. Nunca en el chat ni dentro de una skill. - La skill de RECORDAR, hazla personal (que funcione desde cualquier carpeta) y apunta en ella: cómo conectarte, con qué cuenta o usuario, dónde están las claves (el sitio, nunca el valor), qué suelo pedirte, las reglas de arriba y la fecha en que comprobaste la documentación. Si algo deja de funcionar porque el servicio cambió, mira la documentación, arréglalo y actualiza la skill. - Mis preferencias y lo que haya fallado van en un LEARNINGS.md aparte, en la misma carpeta de esa skill (una línea por aprendizaje, con fecha y el porqué). El primer paso de la skill es leerlo y aplicarlo. Para que nunca se te olvide proponer aprendizajes nuevos al terminar, añade al frontmatter de su SKILL.md este hook, cambiando <nombre-de-la-skill> por su nombre (inyecta un recordatorio una vez por uso; no lo cambies por un bloqueo, que entra en bucle): hooks: Stop: - hooks: - type: command once: true command: | grep -q '"stop_hook_active":true' && exit 0 echo '{"hookSpecificOutput":{"hookEventName":"Stop","additionalContext":"Antes de terminar: si en este uso de la skill <nombre-de-la-skill> el usuario corrigió algo, algo falló o mostró una preferencia, propón de 0 a 3 aprendizajes para su LEARNINGS.md (fecha, una línea y el porqué), enséñalos y pide OK antes de escribirlos. Si ya propusiste aprendizajes en este turno, no los repitas. Si no hay nada que aprender, termina sin añadir nada."}}'

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

Cómo accede
Operar mi cuenta
Leer X público
Feed "Para ti"
Coste
Riesgo
1 · Recomendado
xurl (oficial)
API oficial v2, OAuth
bookmarks, listas, publicar
tweet por URL (texto+media)
no expuesto
Pay-per-use · 0,001-0,015 $/acción
Cero
2 · Solo leer público
Apify (actors)
Scraping gestionado en su infra
no es tu cuenta
datos públicos a volumen
—
0,15-0,40 $ / 1.000 tweets
Cero para ti
3 · Preguntar/resumir
Grok API (xAI)
LLM + X Search integrada
—
busca/resume, no da datos crudos
—
1,25/2,50 $ por M tokens + 5 $/1.000 búsquedas
Cero
Solo para el feed
twitter-cli (scraping)
Scraping con tus cookies de sesión
todo
—
único que lo da
Gratis
Alto

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.

Sobre el scraping (twitter-cli y similares): usa las cookies de tu sesión de X, así que pone tu cuenta en juego. X banea en oleadas en 2026. Es la única vía para el feed "Para ti", pero úsalo solo con una cuenta secundaria, nunca con tu cuenta principal.

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.

Quiero…
¿Mi cuenta?
Mejor opción
Por qué
Leer un tweet que me pasaron (URL)
No
xurl (o Grok)
1 lectura, céntimos; texto + media
Procesar / analizar mis bookmarks o listas
Sí
xurl
endpoint owned, 0,001 $
Publicar o responder (terminal / agente)
Sí
xurl
único con escritura sin riesgo
Reconstruir un hilo reciente (<7 días)
No
xurl
por conversation_id
Bajar miles de tweets de un tema/hashtag
No
Apify
barato a volumen, sin tu cuenta, sin riesgo
Vigilar qué publican ciertas cuentas
No
Apify / Grok
datos crudos (Apify) o resumen (Grok)
"¿Qué se dice en X sobre el tema Z?"
No
Grok API
LLM + búsqueda en X integrada
Leer mi feed "Para ti" en terminal
Sesión
twitter-cli
única vía; cuenta secundaria, riesgo

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.

0

Instalar xurl

Claude Code

La CLI oficial de la X API. Un binario, sin dependencias. Claude Code lo instala por ti.

terminal
brew install --cask xdevplatform/tap/xurl
1

Crear la app en developer.x.com

Tú haces esto

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).

2

Fondear la cuenta (pay-per-use)

Tú haces esto

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.

3

Registrar y autenticar

Claude Code

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.

terminal
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
4

Usar con lenguaje natural

Claude Code

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.

Rebundle · 2026