x-signal

X Signal — Recherche auf X (Twitter) für ChatGPT und Codex

Mit X Signal kann ChatGPT oder Codex X über ein Konto recherchieren, das du bereits nutzt. Stelle eine normale Frage, und es kann Top und Latest durchsuchen, Threads nachverfolgen, Feeds vergleichen, Konten finden und die Beiträge hinter seiner Antwort verlinken.

Der Dienst, der Browser und die gespeicherten Recherchen von X Signal laufen in Docker auf deinem Computer. Deine X-Sitzung wird in einem persistenten Browserprofil gespeichert. X Signal ist schreibgeschützt: Es postet nicht, liket nicht, folgt nicht und sendet keine Nachrichten. Für die lokale Nutzung ist kein OpenAI- oder X-API-Schlüssel erforderlich. ChatGPT Web verwendet den optionalen Transport über den Secure MCP Tunnel von OpenAI, der unten beschrieben wird.

Verwende X Signal, um zu recherchieren, was Entwickler diese Woche über lokale Sprachagenten sagen. Prüfe Top und Latest, folge nützlichen Threads und verlinke die Beiträge, die zählen.

Installieren · ChatGPT oder Codex verbinden · In Aktion sehen · So funktioniert es

Was es recherchieren kann

• Mehrere Top-, Latest- oder Medien-Suchen zusammen ausführen, mit Datums-, Sprach-, Konto-, Interaktions- und Inhaltsfiltern.

• Exakte Following-, For-You-, Lesezeichen-, Benutzer-, Listen- und Community-Timelines lesen.

• Einen Beitrag öffnen, den Autoren-Thread rekonstruieren und Antworten von Zitat-Posts trennen.

• Personen und Organisationen finden und dann ihre Timelines lesen.

• Lange Suchen weiterlaufen lassen, die gespeicherten Ergebnisse überprüfen und tiefer in die nützlichen Teile eintauchen.

• Ein Thema oder einen Feed über einen längeren Zeitraum beobachten und Ergebnisse als Markdown, CSV, JSON oder NDJSON exportieren.

Das Modell entscheidet, wie breit es sucht, und verwendet direkte Referenzen, wenn sie der Antwort helfen.

Related MCP server: TwitterAPI.io MCP Server

Installieren

Du brauchst:

• Docker Engine 25.0 oder neuer mit Docker Compose 2.20.2 oder neuer. Docker Desktop ist die übliche Wahl unter Windows und macOS; verwende unter Windows Linux-Container.

• Ein X-Konto.

• Chrome nur, wenn du automatische Sitzungssynchronisierung aus einem dedizierten Chrome-Profil möchtest.

• Node.js 24.19 oder neuer nur für die Einrichtung des ChatGPT-Tunnels, Tests, MCP Inspector, Backup/Wiederherstellung oder stdio.

Klone das Repository und öffne seinen Ordner:

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

Du kannst auch den neuesten Quellcode als ZIP herunterladen.

Einen Coding-Agenten die Einrichtung übernehmen lassen

Wenn Codex oder ein anderer Coding-Agent dein Terminal verwenden kann, gib ihm Folgendes:

Richte X Signal aus diesem Repository auf meinem Computer ein. Erkenne zuerst mein Betriebssystem und prüfe die Voraussetzungen. Lasse alle Dienste auf den Standard-Loopback-Ports. Starte den Docker-Compose-Stack, warte, bis er den Status „healthy“ erreicht, und verifiziere /healthz und /readyz. Verbinde meinen lokalen Codex-Client mit http://127.0.0.1:7345/mcp. Bitte mich niemals, Cookies, Sitzungstokens, API-Schlüssel oder Passwörter in den Chat einzufügen. Für die X-Anmeldung führe mich entweder durch den Session Companion in einem dedizierten Chrome-Profil oder durch den lokalen noVNC-Browser. Umgehe keine X-Herausforderung. Wenn ich ChatGPT-Web-Support verlange, verwende das Profil chatgpt des Repositorys für den Secure MCP Tunnel und lasse mich seine Tunnel-ID und den eingeschränkten Runtime-Schlüssel direkt in die versteckte lokale Einrichtungsaufforderung eingeben. Mache Port 7345 niemals nach außen zugänglich und gib keine Anmeldedaten in der Shell-Ausgabe aus. Sag mir, wann ein sichtbarer Schritt mich braucht.

Das Repository enthält außerdem Anweisungen für Coding-Agenten.

Windows

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

macOS oder Linux

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

Beide Dienste sollten in docker compose ps den Status healthy anzeigen.

Bei X anmelden

Empfohlen: ein dediziertes Chrome-Profil verwenden

Dadurch bleibt dein Recherche-Konto getrennt von dem X-Konto, das du täglich verwendest.

1. Erstelle ein Chrome-Profil und melde dich mit dem X-Konto an, das X Signal verwenden soll.

2. Öffne chrome://extensions, aktiviere den Entwicklermodus und wähle Entpackte Erweiterung laden.

3. Wähle extensions/x-signal-session-companion aus diesem Repository aus.

4. Öffne die Erweiterung, gib dem Profil einen wiedererkennbaren Namen, lasse die automatische Synchronisierung aktiviert und klicke einmal auf Dieses Profil verwenden.

Die Sitzung wird aktualisiert, wenn dieses Chrome-Profil startet, alle fünf Minuten, solange es geöffnet ist, und wenn sich seine X-Cookies ändern. Docker behält zwischen den Aktualisierungen und über Neustarts hinweg eine eigene angemeldete Kopie. Andere Chrome-Profile können das ausgewählte Konto nicht stillschweigend ersetzen.

Siehe die Anleitung zum Session Companion zum Wechseln von Konten und für einmalige Übertragungen.

Oder in Docker anmelden

Öffne den lokalen Browser und melde dich einmal bei X an. Kopiere das erzeugte VNC-Passwort in deine Zwischenablage:

# 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

Unter Linux leitest du denselben Befehl an dein Desktop-Zwischenablage-Werkzeug weiter: wl-copy unter Wayland oder xclip -selection clipboard unter X11.

Das Browserprofil bleibt im Docker-Volume xsignal_browser erhalten.

ChatGPT oder Codex verbinden

Codex

Öffne in der Codex-Desktop-App oder der IDE-Erweiterung Einstellungen → MCP-Server, füge einen Streamable HTTP-Server hinzu und verwende:

http://127.0.0.1:7345/mcp

Oder füge dies zu ~/.codex/config.toml hinzu:

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

Starte den Client nach dem Speichern neu. Das längere Host-Timeout ist für tiefe Feed-Lesevorgänge gedacht; breite Suchen verwenden dauerhafte Jobs und können ohne Neustart abgefragt werden. Die MCP-Dokumentation von Codex behandelt die gemeinsame Konfiguration für Desktop, CLI und IDE.

Das Repository ist außerdem ein lokales Codex-Plugin mit vier optionalen Skills. Das Plugin bündelt dieselbe MCP-Verbindung, installiere es also, anstatt den Server zweimal hinzuzufügen. Siehe Client-Einrichtung.

ChatGPT Web

ChatGPT kann localhost nicht direkt erreichen. X Signal enthält den Secure MCP Tunnel von OpenAI als optionalen, überwachten Compose-Dienst. Er hält den MCP-Server privat, gibt der Verbindung eine stabile Identität und verbindet sich nach Neustarts von Docker oder des Rechners neu.

1. Erstelle in den Plattform-Tunnel-Einstellungen einen Tunnel und ordne den ChatGPT-Workspace zu, der ihn verwenden wird.

2. Erstelle einen dedizierten Runtime-API-Schlüssel. Erteile unter Eingeschränkt nur Tunnels → Lesen, Verwenden.

3. Führe den lokalen Einrichtungsbefehl aus und gib die Tunnel-ID und den Schlüssel ein, wenn du dazu aufgefordert wirst. Die Schlüsseleingabe ist verborgen; beide Werte werden nur in ignorierten lokalen Dateien gespeichert.

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

4. Öffne in ChatGPT Einstellungen → Sicherheit und Anmeldung und aktiviere den Entwicklermodus.

5. Öffne Plugins, wähle die Plus-Schaltfläche und erstelle eine App namens X Signal.

6. Wähle Tunnel, wähle den Tunnel aus, überprüfe die erkannten Tools und erstelle die App.

7. Füge X Signal in einem neuen Chat über das Tools-Menü hinzu.

Der Runtime-Schlüssel authentifiziert nur den privaten Tunnel-Transport. X Signal ruft damit keine OpenAI-Modelle auf, und für die lokale Codex-Nutzung ist weiterhin kein OpenAI-Schlüssel erforderlich. Der Tunnel bleibt verfügbar, solange Docker läuft; docker compose --profile chatgpt ps und seine lokale Bereitschaftsseite zeigen seinen Status.

Der Entwicklermodus und der Tunnelzugriff hängen von der Konto- und Workspace-Richtlinie ab. Siehe den Leitfaden zum Secure MCP Tunnel von OpenAI und die ausführliche Client-Einrichtung.

In Aktion sehen

Dies ist eine echte ChatGPT-Antwort aus einer Live-X-Signal-Suche. Die Anfrage war bewusst einfach gehalten; ChatGPT wählte einen breiten Top-+-Latest-Scan, fasste etwa 100 aktuelle Beiträge zusammen und verlinkte die Belege, die geholfen haben.

Verwende X Signal, um zu sehen, was gerade mit Open-Source-KI-Agenten auf X los ist.

Die Aufnahme zeigt nur öffentliche Suchergebnisse und wurde geprüft, um Daten von Konten, Sitzungen und privaten Feeds auszuschließen. Siehe Live-Beispiele für eine zweite, andere Rechercheaufgabe.

Prompts zum Ausprobieren

• „Was passiert heute mit diesem Unternehmen auf X? Prüfe mehrere Blickwinkel und sag mir, was bestätigt, umstritten oder nur wiederholt wird.“

• „Vergleiche, wie Entwickler in den letzten sieben Tagen über diese beiden Produkte diskutieren. Trenne Ankündigungen aus erster Hand von Erfahrungsberichten.“

• „Finde die wichtigen Konten zu diesem Thema und recherchiere dann die Behauptungen, über die sie uneins sind.“

• „Lies meinen exakten Following-Feed von heute Morgen, behalte nützliche Antworten und öffne die Threads hinter den fünf Einträgen, die meine Zeit wert sind.“

• „Lies diesen Beitrag, rekonstruiere den Thread des Autors und trenne unterstützende Antworten von Gegenargumenten in Zitat-Posts.“

• „Erstelle einen täglichen Monitor für dieses Thema und exportiere die letzte Änderung als Markdown.“

So funktioniert es

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"]

Der standardmäßige Compose-Stack besteht aus zwei Diensten: einer kleinen Node/SQLite-App und einem interaktiven Chromium-Sidecar. Das optionale chatgpt-Profil fügt den festgepinnten Tunnel-Client von OpenAI hinzu. Suchen verwenden einen persistenten Browser mit begrenzter Parallelität, Anfrageabständen, Caching und adaptivem Backoff. Gespeicherte Jobs, Belege und das Browserprofil überstehen Neustarts.

Datenschutz und Grenzen

Die App, der Browser-Debugger und noVNC binden standardmäßig an localhost. Browser-Volumes und Backups enthalten wiederverwendbaren Anmeldestatus, behandle sie daher wie Passwörter. Normalisierte Ergebnisse werden an den von dir gewählten ChatGPT-, Codex- oder MCP-Client gesendet, wenn dieser ein Tool aufruft. X-Herausforderungen erfordern eine sichtbare Anmeldung über den lokalen Browser; X Signal umgeht sie nicht.

X Signal ist ein unabhängiges Recherche-Werkzeug für Konten, die du kontrollierst. Es ist nicht mit X oder OpenAI verbunden und nicht dazu gedacht, die API, Authentifizierung, Zugriffskontrollen, Herausforderungen, Ratenlimits oder andere Schutzmaßnahmen von X zu umgehen. Verwende es nur mit Inhalten, auf die dein Konto zugreifen darf, und befolge die Bedingungen von X.

Projekt-Dokumentation

• Client-Einrichtung

• Betrieb und Backups

• Fehlerbehebung

• Architektur

• Sicherheit

• Mitwirken

X Signal ist unter der MIT-Lizenz verfügbar.