X Signal — Investigación de X (Twitter) para ChatGPT y Codex

X Signal permite a ChatGPT o Codex investigar X a través de una cuenta que ya usas. Haz una pregunta normal y puede buscar en Top y Latest, seguir hilos, comparar feeds, encontrar cuentas y enlazar las publicaciones que respaldan su respuesta.

El servicio X Signal, el navegador y la investigación guardada se ejecutan en tu ordenador con Docker. Tu sesión de X se almacena en un perfil de navegador persistente. X Signal es de solo lectura: no publica, no da me gusta, no sigue ni envía mensajes. El uso local no necesita clave de API de OpenAI ni de X. ChatGPT web usa el transporte opcional Secure MCP Tunnel de OpenAI, descrito más abajo.

Usa X Signal para investigar qué dicen los desarrolladores sobre los agentes de voz locales esta semana. Revisa Top y Latest, sigue los hilos útiles y enlaza las publicaciones que importan.

Instalación · Conectar ChatGPT o Codex · Verlo funcionar · Cómo funciona

Qué puede investigar

• Ejecuta varias búsquedas de Top, Latest o Media juntas, con filtros de fecha, idioma, cuenta, interacción y contenido.

• Lee las cronologías exactas de Following, For You, marcadores, usuario, listas y comunidades.

• Abre una publicación, reconstruye el hilo del autor y separa las respuestas de las publicaciones con cita.

• Encuentra personas y organizaciones y luego lee sus cronologías.

• Deja que las búsquedas largas sigan ejecutándose, revisa los resultados guardados y profundiza en las partes útiles.

• Supervisa un tema o feed a lo largo del tiempo y exporta los resultados como Markdown, CSV, JSON o NDJSON.

El modelo elige la amplitud de la búsqueda y usa referencias directas cuando ayudan a la respuesta.

Related MCP server: TwitterAPI.io MCP Server

Instalación

Necesitas:

• Docker Engine 25.0 o superior con Docker Compose 2.20.2 o superior. Docker Desktop es la opción habitual en Windows y macOS; usa contenedores Linux en Windows.

• Una cuenta de X.

• Chrome solo si quieres sincronización automática de sesión desde un perfil de Chrome dedicado.

• Node.js 24.19 o superior solo para la configuración del túnel de ChatGPT, pruebas, MCP Inspector, copia de seguridad/restauración o stdio.

Clona el repositorio y abre su carpeta:

git clone https://github.com/anotb/x-signal.git
cd x-signal

También puedes descargar el código fuente más reciente como ZIP.

Deja que un agente de codificación lo configure

Si Codex u otro agente de codificación puede usar tu terminal, dale esto:

Configura X Signal desde este repositorio en mi ordenador. Detecta mi sistema operativo y comprueba primero los requisitos previos. Mantén todos los servicios en los puertos loopback predeterminados. Inicia la pila de Docker Compose, espera a que esté en buen estado y verifica /healthz y /readyz. Conecta mi cliente local de Codex a http://127.0.0.1:7345/mcp. Nunca me pidas que pegue cookies, tokens de sesión, claves de API o contraseñas en el chat. Para iniciar sesión en X, guíame a través del compañero de sesión en un perfil de Chrome dedicado o del navegador local noVNC. No eludas un desafío de X. Si pido soporte para ChatGPT web, usa el perfil chatgpt de Secure MCP Tunnel del repositorio y haz que introduzca su ID de túnel y la clave de runtime restringida directamente en el prompt de configuración local oculto. Nunca expongas el puerto 7345 ni pongas una credencial en la salida del shell. Dime cuándo un paso visible necesita mi intervención.

El repositorio también incluye instrucciones para agentes de codificación.

Windows

Copy-Item .env.example .env
docker compose up -d --build --wait
Invoke-RestMethod http://127.0.0.1:7345/readyz

macOS o Linux

cp .env.example .env
docker compose up -d --build --wait
curl -fsS http://127.0.0.1:7345/readyz

Ambos servicios deberían mostrar healthy en docker compose ps.

Inicia sesión en X

Recomendado: usa un perfil de Chrome dedicado

Esto mantiene tu cuenta de investigación separada de la cuenta de X que usas a diario.

1. Crea un perfil de Chrome e inicia sesión en la cuenta de X que quieres que use X Signal.

2. Abre chrome://extensions, activa el modo de desarrollador y elige Cargar descomprimida.

3. Selecciona extensions/x-signal-session-companion de este repositorio.

4. Abre la extensión, dale al perfil un nombre reconocible, deja la sincronización automática activada y haz clic en Usar este perfil una vez.

La sesión se actualiza cuando se inicia ese perfil de Chrome, cada cinco minutos mientras está abierto y cuando cambian sus cookies de X. Docker mantiene su propia copia con sesión iniciada entre actualizaciones y reinicios. Otros perfiles de Chrome no pueden reemplazar silenciosamente la cuenta seleccionada.

Consulta la guía del compañero de sesión para cambiar de cuenta y hacer transferencias únicas.

O inicia sesión dentro de Docker

Abre el navegador local e inicia sesión en X una vez. Copia la contraseña VNC generada en tu portapapeles:

# Windows
docker compose exec -T browser sh -lc 'cat /data/.vnc/password.txt' | Set-Clipboard

# macOS
docker compose exec -T browser sh -lc 'cat /data/.vnc/password.txt' | pbcopy

En Linux, canaliza el mismo comando a tu herramienta de portapapeles del escritorio: wl-copy en Wayland o xclip -selection clipboard en X11.

El perfil del navegador permanece en el volumen de Docker xsignal_browser.

Conectar ChatGPT o Codex

Codex

En la aplicación de escritorio de Codex o en la extensión del IDE, abre Configuración → Servidores MCP, añade un servidor Streamable HTTP y usa:

http://127.0.0.1:7345/mcp

O añade esto a ~/.codex/config.toml:

[mcp_servers.x-signal]
url = "http://127.0.0.1:7345/mcp"
tool_timeout_sec = 900

Reinicia el cliente después de guardar. El tiempo de espera más largo del host es para lecturas profundas de feeds; las búsquedas amplias usan trabajos duraderos y se pueden consultar sin empezar de nuevo. La documentación de MCP de Codex cubre la configuración compartida de escritorio, CLI e IDE.

El repositorio también es un plugin local de Codex con cuatro habilidades opcionales. El plugin incluye la misma conexión MCP, así que instálalo en lugar de añadir el servidor dos veces. Consulta configuración del cliente.

ChatGPT web

ChatGPT no puede acceder directamente a localhost. X Signal incluye el Secure MCP Tunnel de OpenAI como servicio opcional y supervisado de Compose. Mantiene privado el servidor MCP, da a la conexión una identidad estable y se reconecta después de reinicios de Docker o del equipo.

1. En configuración de túneles de la plataforma, crea un túnel y asocia el espacio de trabajo de ChatGPT que lo usará.

2. Crea una clave de API de runtime dedicada. En Restringido, concede solo Túneles → Leer, Usar.

3. Ejecuta el comando de configuración local e introduce el ID del túnel y la clave cuando se te pida. La entrada de la clave está oculta; ambos valores se guardan solo en archivos locales ignorados.

npm run tunnel:secure:configure
docker compose --profile chatgpt up -d --build --wait

4. En ChatGPT, abre Configuración → Seguridad e inicio de sesión y activa el modo de desarrollador.

5. Abre Plugins, selecciona el botón de más y crea una aplicación llamada X Signal.

6. Elige Túnel, selecciona el túnel, revisa las herramientas descubiertas y crea la aplicación.

7. Añade X Signal desde el menú de herramientas en un chat nuevo.

La clave de runtime autentica solo el transporte privado del túnel. X Signal no llama a los modelos de OpenAI con ella, y el uso local de Codex sigue sin necesitar clave de OpenAI. El túnel permanece disponible mientras Docker se está ejecutando; docker compose --profile chatgpt ps y su página de disponibilidad local muestran su estado.

El modo de desarrollador y el acceso al túnel dependen de la política de la cuenta y del espacio de trabajo. Consulta la guía de Secure MCP Tunnel de OpenAI y la configuración del cliente detallada.

Verlo funcionar

Esta es una respuesta real de ChatGPT de una búsqueda en vivo de X Signal. La solicitud fue deliberadamente simple; ChatGPT eligió un escaneo amplio de Top + Latest, sintetizó aproximadamente 100 publicaciones recientes y enlazó las pruebas que ayudaron.

Usa X Signal para ver qué está pasando con los agentes de IA de código abierto en X ahora mismo.

La captura muestra solo resultados de búsqueda públicos y se revisó para excluir datos de cuenta, sesión y feeds privados. Consulta ejemplos en vivo para una segunda tarea de investigación diferente.

Indicaciones para probar

• "¿Qué está pasando con esta empresa en X hoy? Revisa varios ángulos y dime qué está confirmado, en disputa o simplemente se está repitiendo."

• "Compara cómo están discutiendo los desarrolladores estos dos productos durante los últimos siete días. Separa los anuncios de primera parte de los informes prácticos."

• "Encuentra las cuentas importantes en torno a este tema y luego investiga las afirmaciones sobre las que discrepan."

• "Lee mi feed exacto de Following de esta mañana, conserva las respuestas útiles y abre los hilos detrás de los cinco elementos que merecen mi tiempo."

• "Lee esta publicación, reconstruye el hilo del autor y separa las respuestas de apoyo de los contraargumentos de publicaciones con cita."

• "Crea un monitor diario para este tema y exporta el último cambio como Markdown."

Cómo funciona

flowchart LR
  C["ChatGPT or Codex"] -->|"MCP"| A["X Signal"]
  A --> B["persistent Chromium"]
  B -->|"read-only"| X["X"]
  A --> D["saved research"]
  B --> P["signed-in browser profile"]

La pila de Compose predeterminada tiene dos servicios: una pequeña aplicación Node/SQLite y un sidecar interactivo de Chromium. El perfil opcional chatgpt añade el cliente de túnel fijado de OpenAI. Las búsquedas usan un navegador persistente con concurrencia limitada, espaciado de solicitudes, caché y retroceso adaptativo. Los trabajos almacenados, las pruebas y el perfil del navegador sobreviven a los reinicios.

Privacidad y límites

La aplicación, el depurador del navegador y noVNC se vinculan a localhost por defecto. Los volúmenes y las copias de seguridad del navegador contienen estado de inicio de sesión reutilizable, así que trátalos como contraseñas. Los resultados normalizados se envían al cliente ChatGPT, Codex o MCP que elijas cuando llama a una herramienta. Los desafíos de X requieren inicio de sesión visible a través del navegador local; X Signal no los elude.

X Signal es una herramienta de investigación independiente para cuentas que controlas. No está afiliado a X ni a OpenAI y no está diseñado para eludir la API, la autenticación, los controles de acceso, los desafíos, los límites de velocidad u otras salvaguardas de X. Úsalo solo con contenido al que tu cuenta pueda acceder y sigue los términos de X.

Documentación del proyecto

• Configuración del cliente

• Operaciones y copias de seguridad

• Solución de problemas

• Arquitectura

• Seguridad

• Contribución

X Signal está disponible bajo la Licencia MIT.