vahnxu/signalradar

Surveillez les marchés de prédiction Polymarket pour détecter les changements de probabilité. IA, crypto, géopolitique. Zéro dépendance.

Qu'est-ce que signalradar ?

SignalRadar est une compétence d'agent AI conçue pour surveiller les marchés de prédiction Polymarket et alerter l'utilisateur en cas de changements significatifs de probabilité. Elle est particulièrement utile pour les développeurs, traders et passionnés qui suivent des événements liés à l'IA, la crypto et la géopolitique. La compétence fonctionne sans dépendances externes, en utilisant un script Python unique (`signalradar.py`) qui peut être exécuté manuellement ou via `crontab` pour une surveillance automatisée. SignalRadar prend en charge plusieurs canaux de livraison : webhook (recommandé pour une portabilité maximale), fichier local et messagerie OpenClaw. La configuration et la gestion se font exclusivement via des commandes CLI, ce qui garantit qu'aucun fichier de configuration n'est modifié manuellement. Une série de règles critiques empêchent les erreurs courantes, comme l'ajout automatique de marchés ou l'utilisation du flag `--yes` dans les conversations humaines. L'intégration guide l'utilisateur à travers un processus d'intégration en trois étapes pour configurer sa liste de surveillance et son canal de notification.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add vahnxu/signalradar

Installed? Explore more Recherche et analyse de données skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait signalradar ?

Canaux de livraison

SignalRadar prend en charge trois adaptateurs de livraison pour envoyer des alertes :

  • webhook (recommandé, portable) — HTTP POST vers n'importe quel endpoint (webhook Slack, API Telegram Bot, Discord, etc.). Fonctionne sur toutes les plateformes. Associé à une planification crontab, délivre des notifications sans coût LLM et sans dépendance à une plateforme.
  • file — Ajoute les alertes à un fichier JSONL local. Idéal pour la journalisation locale ou une consommation personnalisée.
  • openclaw (OpenClaw uniquement) — Messagerie de la plateforme OpenClaw. Disponible uniquement lorsqu'il est installé via ClawHub. Non portable vers d'autres plateformes.

Le canal de livraison par défaut est webhook. Définissez l'URL de votre webhook avec :

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

Chemin de livraison (détail technique) : crontab → signalradar.py run --yes --output json → HIT détecté → deliver_hit() → HTTP POST vers l'URL du webhook → message livré. Zéro dépendance à une plateforme, zéro coût LLM.

Correspondance des intentions

Après avoir reçu un message de l'utilisateur, choisissez une commande dans ce tableau. Quand aucune intention ne correspond, n'exécutez AUCUNE commande — discutez normalement.

Intention utilisateur (expressions courantes en chinois)Intention en anglaisCommande
"看看我监控了啥" / "我的列表" / "在追踪哪些""list my monitors" / "what am I tracking"list
"有啥变化吗" / "检查一下" / "跑一下""any changes?" / "run a check"run
"帮我加一下 [URL]" / "监控这个链接""add this market" / "monitor this"add <url>
"帮我加几个市场" / "想监控但没链接""add markets" (no URL)add (sans argument) → une liste de surveillance vide renvoie ONBOARD_NEEDED, l'Agent démarre le flux onboard
"删掉第 N 个" / "不监控这个了""remove #N" / "stop monitoring"remove <N>
"阈值改成 X" / "灵敏度调高""change threshold" / "more sensitive"config threshold.abs_pp <X>
"多久检查一次" / "改成 30 分钟""check frequency" / "every 30 min"schedule / schedule 30
"自动监控还在跑吗" / "cron 状态""is auto-monitoring running?"schedule (voir le statut)
"现在设置是什么" / "阈值多少""what are current settings?"config (doit vérifier la valeur réelle)
"健康检查" / "能用吗""health check" / "is it working?"doctor --output json
"周报" / "本周总结" / "生成 digest""weekly digest" / "summary report"digest
"设置推送" / "配置通知渠道""set up notifications" / "configure delivery"Guidez l'utilisateur pour fournir une URL de webhook, puis config delivery webhook <url>
"通知改中文" / "语言改中文""switch to Chinese notifications"config profile.language zh
"好的" / "没事" / "OK" / "知道了"conversation informelleN'exécutez AUCUNE commande
"那个 GPT 概率多少了""what's the probability of X?"`show <number

Règles critiques

CR-01 Les événements à marchés multiples doivent d'abord signaler le nombre Si l'événement comporte plusieurs marchés (>3), le CLI force l'affichage du nombre, un résumé des types et la liste des marchés avant d'attendre la confirmation ; --yes ne peut pas ignorer cela. L'Agent doit quand même expliquer le nombre et les types avant d'exécuter add.

CR-02 Ne jamais ajouter automatiquement des marchés L'utilisateur doit fournir explicitement une URL Polymarket ou choisir parmi les préréglages. N'ajoutez pas automatiquement.

CR-03 L'Agent ne doit pas éditer directement les fichiers de données L'Agent ne doit pas éditer ~/.signalradar/cache/, ~/.signalradar/config/watchlist.json ou les fichiers de référence à l'aide d'outils Write/Edit. Utilisez uniquement les commandes CLI. Les exécutions normales écrivent automatiquement ces fichiers — c'est un comportement attendu. (Remarque : l'utilisateur humain peut modifier manuellement watchlist.json — le système le tolère. Cette règle ne restreint que l'Agent.)

CR-04 Pas de --yes dans les conversations humaines Lorsqu'il interagit avec un utilisateur humain, l'Agent ne doit PAS utiliser le flag --yes. Le flag --yes est réservé aux pipelines automatisés/CI (tests de fumée, tâches cron, gates de pré-publication). Laissez la confirmation intégrée gérer l'interaction utilisateur.

CR-05 Toujours vérifier les valeurs de configuration réelles Lorsque l'utilisateur demande les paramètres actuels, exécutez TOUJOURS signalradar.py config en premier. Ne devinez pas et ne vous souvenez pas de mémoire. Si une valeur est manquante, signalez la valeur par défaut et indiquez "c'est la valeur par défaut".

CR-06 Activer automatiquement la surveillance après le premier ajout (crontab en premier, avec porte de routage) Après le premier add ou onboard finalize, la surveillance en arrière-plan tente de s'activer automatiquement (intervalle de 10 minutes). Préfère le crontab système ; se rabat sur openclaw cron uniquement lorsque crontab n'est pas disponible. Porte de routage : lorsque delivery.primary.channel == openclaw + pilote crontab + aucune route de réponse capturée, le CLI active la surveillance mais renvoie un avertissement route_missing car les vérifications peuvent s'exécuter alors que la livraison par chat en arrière-plan n'est pas prête. L'Agent ne doit PAS demander "dois-je configurer cron?" et ne doit PAS créer manuellement des tâches. Vérifiez delivery_status dans schedule --output json et signalez honnêtement si la surveillance et la livraison sont actives. Combinaison recommandée : planification crontab + livraison webhook = zéro coût LLM + zéro dépendance à une plateforme.

CR-07 Utiliser le CLI pour gérer les paramètres et la planification Utilisez signalradar.py config [key] [value] pour les paramètres (seuil, canal de livraison, etc.). Utilisez signalradar.py schedule [N|disable] [--driver auto|openclaw|crontab] pour la fréquence de surveillance. NE modifiez PAS manuellement les fichiers de configuration JSON.

CR-08 Une liste de surveillance vide déclenche l'intégration Lorsque la liste de surveillance est vide et que l'Agent exécute add/run --output json, la réponse sera ONBOARD_NEEDED. L'Agent doit alors démarrer le flux onboard en 3 étapes, et non suggérer de fournir une URL.

CR-09 L'intégration est un flux en 3 étapes + guide webhook (principe du pont étroit) En mode Bot/Agent, l'intégration des nouveaux utilisateurs passe par la sous-commande onboard en trois étapes :

  1. onboard --step preview --output json → afficher la liste des événements prédéfinis + éducation à la terminologie (event/market) → demander à l'utilisateur "lesquels supprimer ?"
  2. onboard --step confirm --keep <sélection-utilisateur> --output json → afficher les détails des sous-marchés + terminologie (category/baseline) → demander "confirmer l'ajout ?"
  3. onboard --step finalize --output json → écrire la liste de surveillance + activer la surveillance automatique → afficher la complétion + les prochaines étapes Chaque étape doit attendre la réponse de l'utilisateur avant de continuer. Ne compressez PAS les 3 étapes en 1.

Guide webhook (après finalisation) : le JSON ONBOARD_COMPLETE contient le champ webhook_setup. Lorsque webhook_setup.needed == true, l'Agent doit guider proactivement l'utilisateur pour configurer une URL de webhook pour la livraison push en arrière-plan. Fournissez des exemples d'URL pour l'API Telegram Bot / Slack / Discord. Après que l'utilisateur a fourni l'URL, exécutez config delivery webhook <URL>.

CR-10 Le push en arrière-plan nécessite une route de réponse capturée Le --push en arrière-plan sur le chemin crontab nécessite une route de réponse stockée (~/.signalradar/cache/openclaw_reply_route.json). Si elle est manquante, ne prétendez PAS que la livraison en arrière-plan fonctionne. Pour la livraison openclaw, vérifiez schedule --output json pour delivery_status et route_ready.

CR-11 Vérifier le statut réel avant de prétendre que le push est prêt (conscient du canal) Avant de dire à l'utilisateur que le push en arrière-plan fonctionne, vérifiez schedule --output json → champ delivery_status :

  • "ready" → le push fonctionne pour le canal de livraison actuel
  • "webhook_url_missing" → guidez l'utilisateur pour exécuter config delivery webhook <URL>
  • "route_missing" → pertinent uniquement pour le canal openclaw ; si l'utilisateur est sur webhook, ce champ n'apparaîtra pas
  • "file_target_missing" → guidez l'utilisateur pour définir une cible de fichier

Ne mélangez PAS les diagnostics entre les canaux. Si le canal de livraison est webhook, ne vérifiez PAS et ne signalez PAS route_ready — ce n'est pas pertinent. Le champ delivery_status tient déjà compte du canal actif.

Erreurs connues de l'IA (À NE PAS répéter)

Ces erreurs se sont réellement produites en production. L'Agent doit les éviter.

Erreur 1 : Ajout de 28 marchés sans signaler le nombre d'abord

  • FAUX : L'utilisateur envoie une URL Bitcoin → l'Agent exécute add et ajoute 28 marchés silencieusement
  • CORRECT : Signaler "Cet événement a 28 sous-marchés (14 haussiers + 14 baissiers). Ajouter tout ou choisir ?" → attendre la réponse

Erreur 2 : L'utilisateur dit "好的" → L'Agent déclenche run et affiche NO_REPLY

  • FAUX : L'utilisateur dit "好的" → L'Agent exécute signalradar.py run → répond "NO_REPLY"
  • CORRECT : "好的" est un accusé de réception informel. Répondez normalement sans exécuter de commande.

Erreur 3 : Utilisation de --yes dans une conversation humaine

  • FAUX : signalradar.py add <url> --yes (ignore la confirmation dans un chat humain)
  • CORRECT : signalradar.py add <url> (laissez la confirmation intégrée gérer cela ; le CLI force la prévisualisation des lots volumineux)

Erreur 4 : Édition de watchlist.json avec des outils Write/Edit

  • FAUX : Éditer ~/.signalradar/config/watchlist.json avec des outils Write/Edit
  • CORRECT : Utilisez les commandes CLI signalradar.py add, remove, config

Erreur 5 : Deviner les valeurs de configuration de mémoire

  • FAUX : "Le seuil par défaut est de 5 pp" (sans vérification)
  • CORRECT : Exécutez d'abord signalradar.py config threshold.abs_pp, puis répondez avec la valeur réelle

Erreur 6 : Écrire des scripts compensatoires en dehors de la compétence

  • FAUX : Écrire des scripts d'aide en dehors de la compétence, comme send_alerts_to_telegram.py, pour compenser un comportement manquant
  • CORRECT : Gardez la surveillance, la planification et la livraison à l'intérieur du contrat compétence/runtime. Si une lacune est réelle, corrigez la compétence elle-même au lieu d'inventer des scripts parallèles

Erreur 7 : Traiter une mise à jour clawhub comme une nouvelle installation sans vérifier les données

  • FAUX : Après clawhub update, supposer que l'utilisateur a perdu toutes les données et traiter l'installation comme fraîche sans vérifier le répertoire de données runtime
  • CORRECT : Lisez d'abord le répertoire de données utilisateur réel (~/.signalradar/ ou SIGNALRADAR_DATA_DIR) et seulement ensuite décidez si une migration ou une récupération est nécessaire

Erreur 8 : Prétendre que le push est prêt sans vérifier l'URL du webhook

  • FAUX : "La surveillance en arrière-plan est active et les alertes seront livrées !" (alors que l'URL du webhook est vide)
  • CORRECT : Vérifiez doctor --output json → si webhook_url_configured: false, guidez l'utilisateur pour configurer l'URL du webhook

Erreur 9 : Compresser l'intégration en 3 étapes en une seule exécution

  • FAUX : Exécuter les 3 étapes d'intégration en séquence sans montrer aucun résultat à l'utilisateur
  • CORRECT : Montrez la sortie de chaque étape à l'utilisateur et attendez sa réponse avant de continuer

Erreur 10 : Prétendre que le push est prêt sans vérifier la route

  • FAUX : "Le push en arrière-plan est tout prêt !" (sans vérifier route_ready)
  • CORRECT : Vérifiez schedule --output json → si route_ready: false, dites à l'utilisateur que la livraison n'est pas encore armée

Erreur 11 : Prétendre que le push est prêt sans vérifier l'URL du webhook

  • FAUX : "La surveillance en arrière-plan est active et les alertes seront livrées !" (alors que l'URL du webhook est vide)
  • CORRECT : Vérifiez doctor --output json → si webhook_url_configured: false, guidez l'utilisateur pour configurer l'URL du webhook

Démarrage rapide

# Installer (utilisateurs OpenClaw)
clawhub install signalradar

# Ou cloner directement
git clone https://github.com/vahnxu/signalradar.git && cd signalradar

# 1. Vérification de santé
python3 scripts/signalradar.py doctor --output json

# 2. Ajouter des marchés (configuration guidée ou par URL)
python3 scripts/signalradar.py add
python3 scripts/signalradar.py add https://polymarket.com/event/votre-marche-ici

# 3. La surveillance démarre automatiquement après le premier ajout (toutes les 10 min)

# 4. Vérifier le statut de la planification
python3 scripts/signalradar.py schedule

# 5. Vérification manuelle (simulation)
python3 scripts/signalradar.py run --dry-run --output json

Tâches courantes

Ajouter un marché

python3 scripts/signalradar.py add                              # Configuration guidée
python3 scripts/signalradar.py add <url-evenement-polymarket> [--category <nom>]

Flux : analyser l'URL → interroger l'API Polymarket → afficher la question du marché + la probabilité actuelle → l'utilisateur confirme → enregistrer la référence.

  • Si l'événement a plusieurs marchés (par exemple, différentes tranches de dates), le CLI affiche tous les marchés avec leurs probabilités actuelles avant d'ajouter. Pour les grands événements (>3 marchés), il affiche également un résumé des types et force une confirmation interactive même si --yes a été passé.
  • Si certains marchés de l'événement sont déjà surveillés, seuls les nouveaux sont ajoutés.
  • Si le marché est réglé/expiré, un avertissement s'affiche mais l'utilisateur peut toujours l'ajouter.
  • La catégorie par défaut est default si elle n'est pas spécifiée. L'utilisateur n'est pas invité à saisir une catégorie.
  • Lors du tout premier ajout (liste de surveillance vide), une brève explication du concept de référence est affichée.

Lister les surveillances

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

Affiche toutes les entrées groupées par catégorie avec une numérotation séquentielle globale. Chaque entrée montre : numéro, question, dernière probabilité connue (à partir du cache de référence local), date de fin.

--archived affiche les entrées précédemment supprimées (conservées pour l'export).

Afficher un marché surveillé

python3 scripts/signalradar.py show <numéro-ou-mot-clé> [--output json]

Recherche un ou plusieurs marchés surveillés par numéro de liste ou mot-clé, récupère la probabilité actuelle et renvoie un instantané en lecture seule sans mettre à jour les références.

Supprimer une surveillance

python3 scripts/signalradar.py remove <numéro>

Affiche le nom de l'entrée et demande une confirmation avant de la supprimer. Les entrées supprimées sont archivées (déplacées vers le tableau archived dans ~/.signalradar/config/watchlist.json) avec tout l'historique conservé.

Exécuter une vérification

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

Vérifie toutes les entrées actives par rapport à l'API Polymarket. Si le changement de probabilité dépasse le seuil, envoie une alerte via le canal de livraison configuré.

  • Les entrées réglées/expirées sont ignorées lors de l'exécution, avec un résumé à la fin : "N entrées réglées, envisagez de les supprimer."
  • Lorsque plusieurs marchés déclenchent une alerte dans la même exécution, ils sont listés dans la même notification regroupée par événement.
  • Après qu'un HIT est poussé, la référence se met à jour avec la nouvelle valeur de probabilité. Le texte de la notification inclut "référence mise à jour à XX%."
  • --dry-run récupère et évalue mais n'écrit aucun état.
  • --output openclaw est réservé aux exécutions en arrière-plan de la plateforme. Il émet HEARTBEAT_OK sur les vérifications silencieuses, le texte HIT prêt pour l'utilisateur sur les alertes en temps réel, et le texte du digest lorsqu'un digest planifié est dû et que le canal de livraison principal est openclaw.

Gérer la planification

python3 scripts/signalradar.py schedule                        # Afficher le statut actuel
python3 scripts/signalradar.py schedule 10                     # Pilote automatique (crontab en premier)
python3 scripts/signalradar.py schedule 10 --driver openclaw   # Forcer le cron openclaw
python3 scripts/signalradar.py schedule disable                 # Désactiver la surveillance

Gérer la configuration

python3 scripts/signalradar.py config                           # Afficher toute la configuration
python3 scripts/signalradar.py config delivery webhook <url>    # Définir le webhook
python3 scripts/signalradar.py config threshold.abs_pp 5        # Seuil : changement absolu de 5 points de pourcentage
python3 scripts/signalradar.py config profile.language zh       # Notifications en chinois

Digest hebdomadaire

python3 scripts/signalradar.py digest

Diagnostic

python3 scripts/signalradar.py doctor --output json

Sections développeur

Variables d'environnement

VariableDescriptionValeur par défaut
SIGNALRADAR_DATA_DIRRépertoire de données pour les caches et la configuration~/.signalradar
SIGNALRADAR_LOG_LEVELNiveau de journalisationINFO

Structure du répertoire de données

~/.signalradar/
├── config/
│   └── watchlist.json          # Liste de surveillance + configuration
├── cache/
│   ├── baselines.json          # Dernières probabilités connues pour chaque marché
│   ├── event_cache.json        # Cache des métadonnées des événements
│   ├── app_config.json         # Préférences de l'utilisateur (langue des notifications, etc.)
│   ├── openclaw_reply_route.json  # (OpenClaw uniquement) Route de réponse capturée pour le push en arrière-plan
│   └── provider_cache.json     # Résultats de cache du fournisseur Polymarket
└── logs/
    └── signalradar.log         # Fichier journal

doctor : vérification de santé complète (JSON)

La commande doctor --output json vérifie la configuration, la connectivité, la liste de surveillance et l'état de la planification en une seule fois, et renvoie un rapport structuré :

{
  "watchlist": {
    "monitored_count": 8,
    "archived_count": 1
  },
  "connectivity": {
    "polymarket_graphql": true,
    "polymarket_archive": true
  },
  "config": {
    "threshold": {
      "abs_pp": 5
    },
    "delivery": {
      "primary": {
        "channel": "webhook"
      }
    },
    "profile": {
      "language": "en"
    }
  },
  "schedule": {
    "active": true,
    "interval_minutes": 10,
    "driver": "crontab",
    "delivery_status": "webhook_url_missing",
    "route_ready": false,
    "next_run_eta": "in ~7 minutes"
  },
  "webhook_url_configured": false,
  "suggestions": [
    "Configurer l'URL du webhook pour la livraison push : signalradar.py config delivery webhook <URL>"
  ]
}

Cette commande est le point d'entrée unique pour le diagnostic. Ne devinez pas l'état – exécutez doctor et utilisez les valeurs réelles.

Format de sortie --output openclaw (exécutions en arrière-plan)

Lorsque run est exécuté avec --output openclaw, la sortie change de comportement :

  • Aucun HIT → sortie silencieuse (code de sortie 0, pas de sortie standard). Utile comme battement de cœur.
  • HIT détecté → Texte du message formaté directement sur la sortie standard. --yes est implicite car il n'y a pas d'utilisateur interactif.
  • Digest dû → Texte du digest formaté sur la sortie standard, si le canal principal est openclaw.

Ce format est conçu pour la messagerie plateforme des bots et n'est pas destiné aux utilisateurs humains ou aux tuyaux automatisés.

Architecture & flux de travail

  [crontab] ──exécute──> signalradar.py run --yes --output json
                              │
                              ▼
                    Boucle des marchés surveillés
                              │
                              ├─ Aucun changement → sortie silencieuse (HEARTBEAT_OK)
                              │
                              └─ Changement > seuil → deliver_hit()
                                       │
                                       ├─ webhook → HTTP POST → Slack / Telegram / Discord
                                       ├─ file → ajouter au fichier .jsonl
                                       └─ openclaw → Message plateforme

Principes fondamentaux

  1. Zéro dépendance LLM — Une fois configurée, la surveillance s'exécute entièrement via crontab + scripts Python. Aucun appel API LLM n'est nécessaire pour les vérifications, réduisant les coûts d'exploitation à zéro.

  2. Zéro dépendance à une plateforme — Le chemin webhook + crontab fonctionne sur n'importe quel système *nix, n'importe quel fournisseur de cloud, n'importe quel environnement. Aucune plateforme d'agent spécifique requise pour le fonctionnement de base.

  3. Portabilité via la norme des fichiers — Toutes les données sont stockées dans ~/.signalradar/ en JSON simple. Aucune base de données, aucun service externe. Sauvegardez ce répertoire et vous pouvez migrer vers n'importe quelle machine.

  4. La CLI est la loi — Toute interaction passe par signalradar.py. Aucun contournement par édition manuelle de fichiers JSON (sauf toléré pour les utilisateurs humains). Cela garantit la cohérence de l'état et empêche la corruption de données.

Skills associés