twitter-cli: CLI de Twitter/X sin claves API
twitter-cli: Potencia Twitter/X desde tu terminal (sin necesidad de claves API)
En un mundo donde el acceso a la API de Twitter/X cuesta miles al mes, twitter-cli ofrece una alternativa gratuita y potente. Esta CLI de Python utiliza las cookies de tu navegador para la autenticación, haciendo que las solicitudes sean indistinguibles del tráfico real del navegador. Sin claves API, sin límites de tasa por restricciones oficiales—solo poder puro en la terminal.
🚀 Características clave
Operaciones de lectura
- Línea de tiempo: Feeds "para ti" y de seguidos (
twitter feed) - Marcadores: Lista tus tweets guardados (
twitter bookmarks) - Búsqueda: Búsqueda por palabras clave con pestañas Top/Último/Fotos
- Perfiles de usuario: Tweets, me gusta, seguidores, seguidos
- Detalles de tweet: Ver tweets + respuestas en hilo
- Exportación JSON: Perfecto para scripting/automatización
- Filtrado inteligente: Puntuación de tweets basada en engagement
Operaciones de escritura
- Publicar tweets y respuestas
- Eliminar tus tweets
- Dar me gusta/quitar me gusta, retuitear/de-retuitear
- Marcar/desmarcar tweets como favoritos
Magia anti-detección
- Reenvío completo de cookies: Todas las cookies del navegador extraídas
- Huella TLS: Imita Chrome dinámicamente
- Jitter de solicitudes: Temporización aleatoria para evadir patrones
- Soporte de proxy: Variable de entorno
TWITTER_PROXY - Límite de tasa: Retrasos y reintentos integrados
🎯 Inicio rápido
# Instalar (1 comando)
uv tool install twitter-cli
# Tu línea de tiempo
twitter feed
# Solo seguidos
twitter feed -t following
# Publicaciones recientes de Elon Musk
twitter user-posts elonmusk --max 20
# Búsqueda con filtro de ranking
twitter search "AI agents" --filter
# Exportar a JSON
twitter bookmarks --json > my_bookmarks.json
🔐 Autenticación (cero configuración)
Automática: Inicia sesión en tu navegador predeterminado (Chrome/Arc/Edge/Firefox/Brave)
Manual: Establece las variables de entorno TWITTER_AUTH_TOKEN + TWITTER_CT0
⚙️ Configuración
Crea config.yaml:
fetch:
count: 50
filter:
mode: "topN"
topN: 20
weights:
likes: 1.0
retweets: 3.0
bookmarks: 5.0
rateLimit:
requestDelay: 2.5
maxRetries: 3
🛡️ Mantente seguro (mejores prácticas anti-ban)
- ✅ Usa proxies:
export TWITTER_PROXY=socks5://127.0.0.1:1080 - ✅ Limita solicitudes:
--max 20en lugar de--max 500 - ✅ Cookies del navegador: Protección completa de huella
- ✅ Proxies residenciales > IPs de datacenter
- ✅ Retrasos aleatorios integrados
🤖 Integración con agentes de IA
Incluye SKILL.md para Claude Code, OpenClaw y otros frameworks de IA:
# Para Claude/Antigravity
mkdir -p .agents/skills
curl -o .agents/skills/twitter-cli/SKILL.md https://raw.githubusercontent.com/jackwener/twitter-cli/main/SKILL.md
📦 Opciones de instalación
# Más rápido: uv tool (recomendado)
uv tool install twitter-cli
# pipx
pipx install twitter-cli
# Desde fuente
git clone https://github.com/jackwener/twitter-cli.git
cd twitter-cli
uv sync
Por qué twitter-cli destaca
| Característica | twitter-cli | API oficial | Scrapers |
|---|---|---|---|
| Costo | Gratis | $100-5000/mes | Gratis |
| Límites de tasa | Como navegador | Cuotas estrictas | Bans frecuentes |
| Autenticación | Cookies | Claves API | Compleja |
| Soporte de escritura | ✅ Publicar/Eliminar/Me gusta | ✅ | ❌ Usualmente |
| Anti-detección | Avanzada | N/A | Básica |
Estrellas: 1.1k+ | Licencia Apache 2.0 | Mantenido activamente
Obtén twitter-cli hoy y recupera el control de tu experiencia en Twitter/X desde la terminal! 🚀