Si alguna vez quisiste leer X/Twitter sin abrir la aplicación, sin el algoritmo metiéndote anuncios en la cara, y sin tener que pagar $100 al mes por la API, twitter-cli es exactamente lo que buscabas. Es una herramienta de línea de comandos que te deja consumir y publicar en Twitter/X directo desde la terminal, usando las cookies de tu navegador como autenticación.
La creó jackwener, el mismo desarrollador detrás de herramientas similares para Xiaohongshu y Bilibili. En pocas semanas acumuló miles de estrellas en GitHub, lo que dice bastante del hambre que hay por una alternativa funcional al Twitter que se privatizó.
¿Cómo funciona sin necesitar la API de Twitter?
El secreto está en que twitter-cli no usa la API oficial de Twitter (la que costaba unos pocos dólares hasta 2023 y ahora arranca en $100 al mes para uso básico). En cambio, hace exactamente lo que haría tu navegador: extrae las cookies de Chrome, Firefox o Safari, y las usa para autenticarse ante los servidores de Twitter.
Para que no quede expuesto como un bot, implementa tres capas de evasión:
- TLS fingerprint impersonation: usa
curl_cffipara imitar exactamente la huella digital de conexión que tendría Chrome — el servidor no puede distinguir si el request viene de una persona o de la herramienta. - Request timing jitter: añade pequeñas variaciones aleatorias al tiempo entre requests, similar a como lo haría un humano.
- Write delays: cuando publicas tweets, likes o retweets, espera entre 1,5 y 4 segundos aleatorios — el ritmo de alguien que piensa antes de hacer clic.
La autenticación usa el header x-client-transaction-id que genera Twitter para identificar sesiones, y lo reconstruye por ingeniería inversa para pasar desapercibido.
¿Qué puedes hacer con ella?
twitter-cli cubre las operaciones más importantes de Twitter, tanto de lectura como de escritura:
- Lectura: tu timeline “Para ti” y “Siguiendo”, bookmarks, búsqueda de tweets (con pestañas Top/Recientes/Fotos/Videos), detalle de tweets con respuestas, timeline de listas, perfil de usuarios con tweets, likes y seguidores.
- Escritura: publicar tweets y respuestas, eliminar tus tweets, dar y quitar likes, retweetear, guardar en bookmarks.
- Exportación JSON: cualquier comando acepta
--jsonpara exportar datos, ideal para scripts que procesen tus bookmarks o tu historial. - Filtro de engagement: opcionalmente puedes pedir que ordene los tweets por combinación de likes + RTs + vistas — útil para sacar lo mejor de un timeline ruidoso.
La instalación es simple si tienes Python:
# Con uv (recomendado)
uv tool install twitter-cli
# O con pipx
pipx install twitter-cliY el primer uso:
# Ver tu timeline
twitter feed
# Ver solo quienes sigues
twitter feed -t following
# Tus bookmarks
twitter favorites --max 30
# Buscar tweets
twitter search "Claude Code" -t Latest¿Para quién es útil esto realmente?
Si no escribes código, igual puedes beneficiarte si alguien más te configura la herramienta. Los casos de uso más claros:
- Investigadores y analistas que quieren descargar grandes cantidades de tweets en JSON para análisis — sin pagar por la API.
- Desarrolladores que quieren integrar Twitter en scripts o workflows sin montarse una app OAuth.
- Power users hartos del feed algorítmico que quieren leer cronológicamente o por engagement real.
- Herramientas de IA que necesiten leer contexto de Twitter — la exportación JSON hace fácil pasarle los datos a un LLM.
También existe una variante del mismo autor para Xiaohongshu (小红书) y para Bilibili, con la misma filosofía: acceso sin API oficial, terminal-first, export en JSON.
¿Es esto “legal”?
La zona gris clásica del web scraping. Los Términos de Servicio de Twitter prohíben el acceso automatizado sin su API. Técnicamente, esta herramienta viola esos TOS. Dicho esto, la cuenta que asume el riesgo es la tuya propia — no hay acceso a datos de otros usuarios que ellos no hicieran públicos, y el modelo de uso es parecido al de leer tu feed con un adblocker.
Twitter ha tomado acciones legales contra scraping masivo y venta de datos, pero el uso personal para consumir tu propio contenido es algo que está en un limbo práctico. Como con cualquier herramienta de este tipo: úsala con criterio y sin sobrecargar los servidores.
Por qué importa
La historia de twitter-cli dice algo más grande que una simple herramienta. Desde que Elon Musk convirtió la API de Twitter en un servicio de pago, la comunidad de desarrolladores reaccionó construyendo alternativas que no la necesitan. El resultado es una carrera técnica constante: Twitter intenta detectar y bloquear accesos no autorizados, y herramientas como esta evolucionan para esquivar esas defensas.
Es el mismo patrón de siempre con plataformas que encierran datos: cuando cierras la puerta oficial, la gente construye ventanas. En este caso, ventanas que imitan tan bien el comportamiento de Chrome que los servidores no las distinguen.
Si ya usas la terminal para casi todo lo demás — Git, servidores, scraping, LLMs — tener Twitter ahí también tiene una coherencia natural. Y la capacidad de exportar cualquier cosa como JSON abre posibilidades para integrar tus bookmarks, tu historial, o tu feed directamente con herramientas de IA como las que hemos cubierto en la guía de agentes personales o proyectos como GPT-5.4 con computer use.
