Desata la investigación X/Twitter con un CLI rápido

Al crear agentes de IA o realizar investigaciones basadas en datos, necesitas una forma confiable de extraer conversaciones de X/Twitter. x‑research‑skill ofrece exactamente eso: una interfaz de línea de comandos de extremo a extremo escrita en TypeScript que se integra directamente con Claude Code o OpenClaw. Obtienes navegación instantánea, económica y consciente de costos de tuits, hilos y actividad del usuario, mientras tu agente puede mantenerse enfocado en razonamientos de alto nivel.

Por qué importa

• Bajas barreras – No interfaz pesada ni configuración de servidor; solo clona con Git, instala Bun y autentícate.
• Transparencia de costos – Después de cada consulta, el CLI muestra el costo exacto de la API X, permitiéndote mantenerte dentro del presupuesto.
• Ahorros impulsados por caché – Las consultas repetidas utilizan una caché de 15 minutos (1 hora en modo rápido), eliminando llamadas duplicadas a la API.
• Modo rápido – Una sola página con una comprobación de pulso de 10 resultados que mantiene los clics y créditos al mínimo.
• Monitoreo de listas de vigilancia – Sigue conversaciones alrededor de cualquier conjunto de cuentas, alertándote automáticamente cuando aparece nueva actividad.

Empezando

A continuación, el mapa paso a paso desde clonar el repositorio hasta ejecutar tu primera búsqueda.

Requisitos previos

1. Obtén un Token X Bearer del Portal de Desarrolladores de X (el acceso solo de lectura es suficiente).
2. Exporta a tu shell export X_BEARER_TOKEN="tu-token-aquí" o agrega X_BEARER_TOKEN=tu-token-aquí a ~/.config/env/global.env.
3. Instala Bun (el entorno de ejecución ligero de JavaScript que impulsa el CLI).

Clonar en tu espacio de trabajo

# For Claude Code
mkdir -p .claude/skills && cd .claude/skills
git clone https://github.com/rohunvora/x-research-skill.git x-research

# For OpenClaw
mkdir -p skills && cd skills
git clone https://github.com/rohunvora/x-research-skill.git x-research

Ejecuta una búsqueda de ejemplo

cd skills/x-research
bun run x-search.ts search "OpenAI" --sort likes --limit 5

El terminal mostrará el texto del tuite, el autor, la fecha, métricas de participación y, finalmente, el costo de la solicitud (por ejemplo, $0.50).

Características clave explicadas

Búsqueda y clasificación

Usa lenguaje natural o banderas avanzadas:

bun run x-search.ts search "AI agents" --sort impressions --since 1d

Opciones incluyen:

• --sort – likes, impressions, retweets, o recent
• --since – 1h, 3h, 12h, 1d, 7d
• --min-likes, --min-impressions – filtrado post‑baja participación
• --quick – límite a 10 resultados, ocultar automáticamente retweets y respuestas

Extracción de hilos

bun run x-search.ts thread <tweet_id>

Devuelve el hilo completo con cada mensaje etiquetado y formateado para markdown o JSON.

Perfil de usuario y tuits recientes

bun run x-search.ts profile @username

Muestra las últimas publicaciones públicas del usuario, respetando los mismos filtros.

Tablero de listas de vigilancia

bun run x-search.ts watchlist add alice "Crypto analyst"
bun run x-search.ts watchlist check

Mantiene un watchlist.json local; check revisa cada handle y reporta nueva actividad.

Gestión de costos

El modelo de pago por uso de X se aplica a cada llamada a la API. Las tarifas predeterminadas (a Feb 2026) son:

• Post read: $0.005
• User lookup: $0.010
• Search page (100 tweets): ~$0.50 (quick mode), $1.50 for 3 pages.
• Cached repeat queries are free.
• 24‑hour deduplication protects against double‑charging the same post.

El CLI muestra un resumen conciso de costos cada ejecución, para que siempre sepas en qué estás gastando. Si superas un umbral, simplemente recarga tus créditos prepagados desde la consola de desarrolladores.

Seguridad y gestión de tokens

Nunca expongas tu token en los registros:

• El script lee X_BEARER_TOKEN del entorno o de ~/.config/env/global.env.
• No incorpore el token en líneas de comando o scripts accesibles por otros.
• Usa únicamente tokens solo de lectura para mínimas privilegios.
• Rota tokens inmediatamente si sospechas exposición.

Limitaciones y hoja de ruta futura

• Solo se utiliza el punto final de búsqueda “reciente”; la búsqueda de archivo completo está disponible pero aún no está integrada.
• No hay permisos de escritura – la herramienta es solo de lectura.
• Las próximas versiones planean soportar consultas de archivo completo, filtrado avanzado y visualizaciones gráficas opcionales de estructuras de hilos.

Conclusiones finales

Ya seas un científico de datos construyendo chatbots de IA, un investigador que agrupa insights de redes sociales, o un entusiasta que automatiza la ingestión de tuits, x‑research‑skill te brinda una interfaz poderosa y sin fricción al API X. Su caché interno, informes de costos y modo rápido mantienen el presupuesto bajo control mientras escalas tus flujos de trabajo de investigación desde cero.

Clona el repositorio, configura tu token bearer y comienza a hackear. ¡Feliz investigación!