CommunityRecherche & Datenanalysegithub.com

vahnxu/signalradar

Überwache Polymarket-Prognosemärkte auf Wahrscheinlichkeitsänderungen. KI, Krypto, Geopolitik. Keine Abhängigkeiten.

Was ist signalradar?

SignalRadar ist ein KI-Agenten-Tool, das kontinuierlich Polymarket-Prognosemärkte auf Wahrscheinlichkeitsänderungen überwacht und Benachrichtigungen sendet, wenn wichtige Schwellenwerte überschritten werden. Es ist speziell für KI-Agenten-Plattformen wie Claude Code, Cursor oder Codex konzipiert und benötigt keine externen Abhängigkeiten. Die Benachrichtigungen können über Webhook (empfohlen, plattformunabhängig), lokale Dateiausgabe oder die OpenClaw-Plattform zugestellt werden. Durch die Integration mit systemeigener `crontab`-Planung arbeitet SignalRadar vollständig LLM-kostenfrei – der Agent muss nur gelegentlich die Ausgabe prüfen oder bei Bedarf eingreifen. Die Nutzung erfolgt ausschließlich über CLI-Befehle (`signalradar.py`); der Agent darf und soll keine Konfigurationsdateien direkt bearbeiten.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add vahnxu/signalradar

Installed? Explore more Recherche & Datenanalyse skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht signalradar?

Zustellungskanäle

SignalRadar unterstützt drei Zustellungsadapter für das Senden von Alarmen:

  • webhook (empfohlen, portabel) — HTTP-POST an einen beliebigen Endpunkt (Slack-Webhook, Telegram Bot API, Discord usw.). Funktioniert auf jeder Plattform. In Kombination mit der crontab-Planung werden Benachrichtigungen ohne LLM-Kosten und ohne Plattformabhängigkeit zugestellt.
  • file — Alarme an eine lokale JSONL-Datei anhängen. Gut für lokale Protokollierung oder benutzerdefinierte Verarbeitung.
  • openclaw (nur OpenClaw) — Nachrichtenübermittlung auf der OpenClaw-Plattform. Nur verfügbar, wenn über ClawHub installiert. Nicht auf andere Plattformen übertragbar.

Standardzustellungskanal ist webhook. Lege deine Webhook-URL fest mit:

python3 scripts/signalradar.py config delivery webhook https://deine-webhook-url

Zustellungspfad (technisches Detail): crontab → signalradar.py run --yes --output json → HIT erkannt → deliver_hit() → HTTP-POST an Webhook-URL → Nachricht zugestellt. Keine Plattformabhängigkeit, keine LLM-Kosten.

Absichtszuordnung

Nach Erhalt einer Benutzernachricht wähle einen Befehl aus dieser Tabelle. Wenn keine Absicht passt, führe KEINEN Befehl aus – chatte einfach normal.

Benutzerabsicht (deutsch)Englische AbsichtBefehl
„Was überwache ich gerade?“ / „Meine Liste“ / „Welche Märkte tracke ich?“„list my monitors“ / „what am I tracking“list
„Gibt es Änderungen?“ / „Überprüfe“ / „Führe einen Check durch“„any changes?“ / „run a check“run
„Füge [URL] hinzu“ / „Überwache diesen Link“„add this market“ / „monitor this“add <url>
„Füge ein paar Märkte hinzu“ / „Möchte überwachen, aber habe keinen Link“„add markets“ (no URL)add (kein Argument) → leere Watchlist gibt ONBOARD_NEEDED zurück, Agent startet onboard-Ablauf
„Entferne den N-ten“ / „Überwache diesen nicht mehr“„remove #N“ / „stop monitoring“remove <N>
„Ändere den Schwellenwert auf X“ / „Erhöhe die Empfindlichkeit“„change threshold“ / „more sensitive“config threshold.abs_pp <X>
„Wie oft wird geprüft?“ / „Ändere auf 30 Minuten“„check frequency“ / „every 30 min“schedule / schedule 30
„Läuft die automatische Überwachung noch?“ / „Cron-Status“„is auto-monitoring running?“schedule (Status anzeigen)
„Was sind die aktuellen Einstellungen?“ / „Wie hoch ist der Schwellenwert?“„what are current settings?“config (muss den tatsächlichen Wert überprüfen)
„Gesundheitscheck“ / „Funktioniert es?“„health check“ / „is it working?“doctor --output json
„Wochenbericht“ / „Zusammenfassung“ / „Erstelle einen Digest“„weekly digest“ / „summary report“digest
„Richte Benachrichtigungen ein“ / „Konfiguriere den Zustellungskanal“„set up notifications“ / „configure delivery“Führe den Benutzer dazu, eine Webhook-URL bereitzustellen, dann config delivery webhook <url>
„Benachrichtigungen auf Deutsch“ / „Sprache auf Deutsch umstellen“„switch to Chinese notifications“config profile.language de
„OK“ / „In Ordnung“ / „Alles klar“ / „Verstanden“casual chatFühre KEINEN Befehl aus
„Wie hoch ist die Wahrscheinlichkeit für X?“„what's the probability of X?“show <nummer|keyword>

Kritische Regeln

KR-01 Bei Ereignissen mit mehreren Märkten zuerst die Anzahl melden Wenn ein Ereignis mehrere Märkte (>3) hat, gibt die CLI zwangsweise die Anzahl, eine Typzusammenfassung und die Marktliste aus, bevor sie auf Bestätigung wartet; --yes kann dies nicht überspringen. Der Agent muss dennoch die Anzahl und Typen erklären, bevor add ausgeführt wird.

KR-02 Niemals Märkte automatisch hinzufügen Der Benutzer muss explizit eine Polymarket-URL angeben oder aus Voreinstellungen wählen. Nicht automatisch hinzufügen.

KR-03 Der Agent darf keine Datendateien direkt bearbeiten Der Agent darf ~/.signalradar/cache/, ~/.signalradar/config/watchlist.json oder Baseline-Dateien nicht mit Schreib-/Bearbeitungswerkzeugen bearbeiten. Nur CLI-Befehle verwenden. Normale Ausführungen schreiben diese automatisch – das ist erwartetes Verhalten. (Hinweis: Der menschliche Benutzer kann watchlist.json von Hand bearbeiten – das System toleriert dies. Diese Regel schränkt nur den Agenten ein.)

KR-04 Kein --yes in Gesprächen mit Menschen Bei der Interaktion mit einem menschlichen Benutzer darf der Agent das Flag --yes NICHT verwenden. Das Flag --yes ist nur für automatisierte/CI-Pipelines vorgesehen (Smoke-Tests, Cron-Jobs, Prepublish-Gates). Lasse die eingebaute Bestätigung die Benutzerinteraktion übernehmen.

KR-05 Immer die tatsächlichen Konfigurationswerte überprüfen Wenn der Benutzer nach aktuellen Einstellungen fragt, führe IMMER zuerst signalradar.py config aus. Nicht raten oder aus dem Gedächtnis wiedergeben. Fehlt ein Wert, melde den Standardwert und gib an: „Dies ist der Standardwert.“

KR-06 Automatische Überwachung nach dem ersten Hinzufügen aktivieren (crontab zuerst, mit Routenprüfung) Nach dem ersten add oder onboard finalize versucht die Hintergrundüberwachung, sich automatisch zu aktivieren (10-Minuten-Intervall). Bevorzugt systemeigene crontab; fällt auf openclaw cron nur zurück, wenn crontab nicht verfügbar ist. Routenprüfung: Wenn delivery.primary.channel == openclaw + crontab-Treiber + keine erfasste Antwortroute, aktiviert die CLI die Überwachung, gibt aber eine route_missing-Warnung aus, da Prüfungen laufen können, während die Hintergrund-Chat-Zustellung nicht bereit ist. Der Agent darf NICHT fragen „Soll ich Cron einrichten?“ und darf NICHT manuell Jobs erstellen. Überprüfe delivery_status in schedule --output json und berichte ehrlich, ob Überwachung und Zustellung aktiv sind. Empfohlene Kombination: crontab-Planung + webhook-Zustellung = null LLM-Kosten + keine Plattformabhängigkeit.

KR-07 CLI zum Verwalten von Einstellungen und Zeitplan verwenden Verwende signalradar.py config [key] [value] für Einstellungen (Schwellenwert, Zustellungskanal usw.). Verwende signalradar.py schedule [N|disable] [--driver auto|openclaw|crontab] für die Überwachungshäufigkeit. JSON-Konfigurationsdateien NICHT von Hand bearbeiten.

KR-08 Leere Watchlist löst Onboarding aus Wenn die Watchlist leer ist und der Agent add/run --output json ausführt, lautet die Antwort ONBOARD_NEEDED. Der Agent muss dann den 3-schrittigen onboard-Ablauf starten, nicht vorschlagen, eine URL bereitzustellen.

KR-09 Onboarding ist ein 3-Schritt-Ablauf + Webhook-Anleitung (Schmale-Brücke-Prinzip) Im Bot-/Agentenmodus durchläuft das Onboarding neuer Benutzer den onboard-Unterbefehl in drei Schritten:

  1. onboard --step preview --output json → vordefinierte Ereignisliste anzeigen + Begriffserklärung (Ereignis/Markt) → Benutzer fragen „welche entfernen?“
  2. onboard --step confirm --keep <user-selection> --output json → Details zu Untermärkten anzeigen + Begriffserklärung (Kategorie/Baseline) → „Hinzufügen bestätigen?“ fragen
  3. onboard --step finalize --output json → Watchlist schreiben + automatische Überwachung aktivieren → Abschluss + nächste Schritte anzeigen Jeder Schritt muss auf die Antwort des Benutzers warten, bevor fortgefahren wird. Die 3 Schritte NICHT zu einem zusammenfassen.

Webhook-Anleitung (nach finalize): Das JSON ONBOARD_COMPLETE enthält das Feld webhook_setup. Wenn webhook_setup.needed == true ist, sollte der Agent den Benutzer proaktiv anleiten, eine Webhook-URL für die Hintergrund-Push-Zustellung zu konfigurieren. Beispiele für Telegram Bot API / Slack / Discord-URLs bereitstellen. Nachdem der Benutzer die URL bereitgestellt hat, führe config delivery webhook <URL> aus.

KR-10 Hintergrund-Push erfordert eine erfasste Antwortroute Hintergrund---push auf dem crontab-Pfad erfordert eine gespeicherte Antwortroute (~/.signalradar/cache/openclaw_reply_route.json). Fehlt diese, behaupte NICHT, dass die Hintergrundzustellung funktioniert. Für die openclaw-Zustellung prüfe schedule --output json auf delivery_status und route_ready.

KR-11 Tatsächlichen Status überprüfen, bevor Push-Bereitschaft behauptet wird (kanalabhängig) Bevor du dem Benutzer mitteilst, dass der Hintergrund-Push funktioniert, prüfe schedule --output json → Feld delivery_status:

  • "ready" → Push funktioniert für den aktuellen Zustellungskanal
  • "webhook_url_missing" → Führe den Benutzer zur Eingabe von config delivery webhook <URL>
  • "route_missing" → nur für den openclaw-Kanal relevant; wenn der Benutzer Webhook verwendet, erscheint dieses Feld nicht
  • "file_target_missing" → Führe den Benutzer zur Festlegung eines Dateiziels

Diagnose NICHT kanalübergreifend mischen. Wenn der Zustellungskanal webhook ist, prüfe NICHT route_ready und melde es auch nicht – es ist irrelevant. Das Feld delivery_status berücksichtigt bereits den aktiven Kanal.

Bekannte KI-Fehler (NICHT wiederholen)

Diese Fehler sind tatsächlich in der Produktion aufgetreten. Der Agent muss sie vermeiden.

Fehler 1: 28 Märkte hinzufügen, ohne die Anzahl zuerst zu melden

  • FALSCH: Benutzer sendet Bitcoin-URL → Agent führt add aus und fügt 28 Märkte stillschweigend hinzu
  • RICHTIG: Melde „Dieses Ereignis hat 28 Untermärkte (14 Aufwärts- + 14 Abwärts-Chancen). Alle hinzufügen oder auswählen?“ → auf Antwort warten

Fehler 2: Benutzer sagt „OK“ → Agent löst run aus und gibt NO_REPLY aus

  • FALSCH: Benutzer sagt „OK“ → Agent führt signalradar.py run aus → antwortet „NO_REPLY“
  • RICHTIG: „OK“ ist eine beiläufige Bestätigung. Antworte normal, ohne einen Befehl auszuführen.

Fehler 3: --yes in menschlichen Gesprächen verwenden

  • FALSCH: signalradar.py add <url> --yes (überspringt Bestätigung im menschlichen Chat)
  • RICHTIG: signalradar.py add <url> (eingebaute Bestätigung verwenden; CLI zeigt große Batches vorab an)

Fehler 4: Bearbeiten von watchlist.json mit Schreib-/Bearbeitungswerkzeugen

  • FALSCH: Bearbeite ~/.signalradar/config/watchlist.json mit Schreib-/Bearbeitungswerkzeugen
  • RICHTIG: Verwende die CLI-Befehle signalradar.py add, remove, config

Fehler 5: Konfigurationswerte aus dem Gedächtnis raten

  • FALSCH: „Der Standard-Schwellenwert ist 5 PP“ (ohne Überprüfung)
  • RICHTIG: Führe zuerst signalradar.py config threshold.abs_pp aus, dann antworte mit dem tatsächlichen Wert.

Fehler 6: Kompensationsskripte außerhalb des Skills schreiben

  • FALSCH: Schreibe Hilfsskripte außerhalb des Skills, wie send_alerts_to_telegram.py, um fehlendes Verhalten zu kompensieren
  • RICHTIG: Behalte Überwachung, Planung und Zustellung innerhalb des Skills/Runtime-Vertrags. Wenn eine Lücke real ist, repariere den Skill selbst, anstatt Nebenskripte zu erfinden.

Fehler 7: ClawHub-Update als Neuinstallation behandeln, ohne Daten zu prüfen

  • FALSCH: Nach clawhub update annehmen, der Benutzer habe alle Daten verloren, und die Installation als neu behandeln, ohne das Runtime-Datenverzeichnis zu prüfen
  • RICHTIG: Lese zuerst das tatsächliche Benutzerdatenverzeichnis (~/.signalradar/ oder SIGNALRADAR_DATA_DIR) und entscheide dann, ob Migration oder Wiederherstellung erforderlich ist.

Fehler 8: Push-Bereitschaft behaupten, ohne die Webhook-URL zu prüfen

  • FALSCH: „Hintergrundüberwachung ist aktiv und Benachrichtigungen werden zugestellt!“ (wenn Webhook-URL leer ist)
  • RICHTIG: Prüfe doctor --output json → wenn webhook_url_configured: false, führe den Benutzer zur Einrichtung der Webhook-URL.

Fehler 9: 3-Schritt-Onboarding zu einer einzigen Ausführung zusammenfassen

  • FALSCH: Führe alle 3 Onboarding-Schritte nacheinander aus, ohne dem Benutzer Ergebnisse anzuzeigen
  • RICHTIG: Zeige die Ausgabe jedes Schritts dem Benutzer an und warte auf seine Antwort, bevor du fortfährst.

Fehler 10: Push-Bereitschaft behaupten, ohne die Route zu prüfen

  • FALSCH: „Hintergrund-Push ist einsatzbereit!“ (ohne route_ready zu prüfen)
  • RICHTIG: Prüfe schedule --output json → wenn route_ready: false, teile dem Benutzer mit, dass die Zustellung noch nicht bereit ist.

Fehler 11: Push-Bereitschaft behaupten, ohne die Webhook-URL zu prüfen

  • FALSCH: „Hintergrundüberwachung ist aktiv und Benachrichtigungen werden zugestellt!“ (wenn Webhook-URL leer ist)
  • RICHTIG: Prüfe doctor --output json → wenn webhook_url_configured: false, führe den Benutzer zur Einrichtung der Webhook-URL.

Schnellstart

# Installation (OpenClaw-Benutzer)
clawhub install signalradar

# Oder direkt klonen
git clone https://github.com/vahnxu/signalradar.git && cd signalradar

# 1. Gesundheitscheck
python3 scripts/signalradar.py doctor --output json

# 2. Märkte hinzufügen (geführte Einrichtung oder per URL)
python3 scripts/signalradar.py add
python3 scripts/signalradar.py add https://polymarket.com/event/your-market-here

# 3. Überwachung startet automatisch nach dem ersten Hinzufügen (alle 10 Min)

# 4. Zeitplanstatus prüfen
python3 scripts/signalradar.py schedule

# 5. Manueller Check (Probelauf)
python3 scripts/signalradar.py run --dry-run --output json

Häufige Aufgaben

Markt hinzufügen

python3 scripts/signalradar.py add                              # Geführte Einrichtung
python3 scripts/signalradar.py add <polymarket-event-url> [--category <name>]

Ablauf: URL parsen → Polymarket-API abfragen → Marktfrage + aktuelle Wahrscheinlichkeit anzeigen → Benutzer bestätigt → Baseline aufzeichnen.

  • Wenn das Ereignis mehrere Märkte hat (z. B. verschiedene Datumsbereiche), zeigt die CLI alle Märkte mit ihren aktuellen Wahrscheinlichkeiten an, bevor sie hinzugefügt werden. Bei großen Ereignissen (>3 Märkte) wird auch eine Typzusammenfassung angezeigt und eine interaktive Bestätigung erzwungen, selbst wenn --yes übergeben wurde.
  • Wenn einige Märkte aus dem Ereignis bereits überwacht werden, werden nur neue hinzugefügt.
  • Wenn der Markt abgerechnet/abgelaufen ist, wird eine Warnung angezeigt, aber der Benutzer kann ihn trotzdem hinzufügen.
  • Die Kategorie standardmäßig auf default, wenn nicht angegeben. Der Benutzer wird nicht nach einer Kategorie gefragt.
  • Beim ersten Hinzufügen (leere Watchlist) wird eine kurze Erklärung des Baseline-Konzepts angezeigt.

Überwachte Märkte auflisten

python3 scripts/signalradar.py list [--category <name>] [--archived]

Zeigt alle Einträge gruppiert nach Kategorie mit globaler fortlaufender Nummerierung. Jeder Eintrag zeigt: Nummer, Frage, zuletzt bekannte Wahrscheinlichkeit (aus lokalem Baseline-Cache), Enddatum.

--archived zeigt zuvor entfernte Einträge an (für Export aufbewahrt).

Einen überwachten Markt anzeigen

python3 scripts/signalradar.py show <number-or-keyword> [--output json]

Sucht einen oder mehrere überwachte Märkte nach Listennummer oder Suchbegriff, ruft die aktuelle Wahrscheinlichkeit ab und gibt eine schreibgeschützte Momentaufnahme zurück, ohne Baselines zu aktualisieren.

Überwachung entfernen

python3 scripts/signalradar.py remove <number>

Zeigt den Eintragsnamen an und fragt vor dem Entfernen nach Bestätigung. Entfernte Einträge werden archiviert (in das Archiv-Array in ~/.signalradar/config/watchlist.json verschoben) mit vollständigem Verlauf.

Prüfung durchführen

python3 scripts/signalradar.py run [--dry-run] [--output json]

Überprüft alle aktiven Einträge gegen die Polymarket-API. Wenn die Wahrscheinlichkeitsänderung den Schwellenwert überschreitet, wird ein Alarm über den konfigurierten Zustellungskanal gesendet.

  • Abgerechnete/abgelaufene Einträge werden während des Durchlaufs übersprungen, mit einer Zusammenfassung am Ende: „N Einträge abgerechnet, Entfernen erwägen.“
  • Wenn in derselben Prüfung mehrere Märkte auslösen, werden sie in derselben Benachrichtigung nach Ereignis gruppiert aufgelistet.
  • Nachdem ein HIT gepusht wurde, aktualisiert sich die Baseline auf den neuen Wahrscheinlichkeitswert. Der Benachrichtigungstext enthält „Baseline auf XX% aktualisiert.“
  • --dry-run ruft ab und evaluiert, schreibt aber keinen Zustand.
  • --output openclaw ist für plattformgesteuerte Hintergrundläufe reserviert. Es gibt HEARTBEAT_OK bei leisen Prüfungen, benutzerfreundlichen HIT-Text bei Echtzeitwarnungen und Digest-Text aus, wenn ein geplanter Digest fällig ist und der primäre Zustellungskanal openclaw ist.

Zeitplan verwalten

python3 scripts/signalradar.py schedule                        # Aktuellen Status anzeigen
python3 scripts/signalradar.py schedule 10                     # Auto-Treiber (crontab zuerst)
pyth

Verwandte Skills