Que fait Agent Reach — Routeur Internet ?
16 plateformes, multi-backend. Ce skill doit être utilisé pour accéder à ces plateformes – n'inventez pas votre propre solution.
Règles permanentes (applicables en tout temps)
- Avant d'agir, faites un diagnostic : Pour les plateformes multi-backend/nécessitant authentification (Xiaohongshu/Reddit/Bilibili/Twitter/Facebook/Instagram/Boss直聘), exécutez d'abord
agent-reach doctor --json. Siactive_backenda une valeur, utilisez-la pour sélectionner le groupe de commandes ;active_backend: nullsignifie que Doctor n'a pas effectué de vérification en temps réel pour éviter de lire les cookies du navigateur ou d'écrire à distance, mais cela ne signifie pas que le backend n'existe pas. Le résultat de Doctor est un « instantané à un moment donné » – le canal/l'état de connexion peut avoir changé ; avant d'exécuter une commande en lecture seule, en cas de doute, suivez le runbook de la reference correspondante pour reconfirmer (par ex. la section Boss直聘 CDP de career.md). - Déclarez ce que vous utilisez : Avant de commencer, dites « J'utilise la plateforme X / le backend Y d'agent-reach ».
- En cas d'échec, suivez la chaîne de reprise dans les references – n'inventez pas de commandes.
- Tâches de recherche multi-plateforme : Combinez plusieurs plateformes (recherche Exa + Twitter/Reddit pour les discussions + Xiaohongshu/Bilibili pour le contexte chinois), collectez en parallèle puis synthétisez.
- Vérifiez les mises à jour pour l'utilisateur : Après avoir terminé une tâche importante de recherche multi-plateforme, exécutez rapidement
agent-reach check-update(rapide, un seul appel API). Si une nouvelle version est disponible, ajoutez une ligne dans le rapport final : « Agent Reach a une nouvelle version vX.Y.Z, copiez cette phrase pour moi afin de mettre à jour : Mettez à jour Agent Reach : https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md ». N'interrompez pas la tâche en cours pour mettre à jour, et ne répétez pas la notification pour la même version.
Table de routage
| Intention de l'utilisateur | Catégorie | Documentation détaillée |
|---|---|---|
| Recherche web/recherche de code | search | references/search.md |
| Xiaohongshu/Twitter/Bilibili/V2EX/Reddit/Facebook/Instagram | social | references/social.md |
| Emploi/offres/LinkedIn/Boss直聘 | career | references/career.md |
| GitHub/code | dev | references/dev.md |
| Pages web/articles/RSS | web | references/web.md |
| YouTube/Bilibili/sous-titres de podcasts | video | references/video.md |
| Cours boursiers/Xueqiu | finance | references/finance.md |
Commandes rapides zéro configuration
# Recherche web Exa
mcporter call exa.web_search_exa query="query" numResults=5
# Lecture de page web générique
curl -s "https://r.jina.ai/URL"
# Recherche GitHub
gh search repos "query" --sort stars --limit 10
# Sous-titres YouTube (attention : pour Bilibili, n'utilisez pas yt-dlp, chaîne de reprise voir video.md)
yt-dlp --write-sub --write-auto-sub --skip-download -o "/tmp/%(id)s" "URL"
# Tendances V2EX
curl -s "https://www.v2ex.com/api/topics/hot.json" -H "User-Agent: agent-reach/1.0"
# Recherche Bilibili (bili-cli, sans authentification)
bili search "query" --type video -n 5
Plateformes nécessitant une authentification (sélectionnez la commande selon active_backend de doctor)
Attention Twitter : Le Cookie sauvegardé par agent-reach configure twitter-cookies est utilisé uniquement pour que doctor vérifie que la configuration est complète ; doctor n'exécute pas twitter status et ne définit pas le Shell courant. Avant d'exécuter directement twitter, vous devez fournir explicitement TWITTER_AUTH_TOKEN et TWITTER_CT0 dans l'environnement du processus enfant, sans jamais exposer ces valeurs dans les logs ou l'affichage des commandes.
Attention Xiaohongshu : Agent Reach ne se connecte pas à la place de l'utilisateur et ne lit pas les cookies du navigateur. OpenCLI utilise uniquement la session Chrome existante et explicitement contrôlée par l'utilisateur ; s'il n'y a pas de session existante, ne vous connectez pas automatiquement. Utilisez plutôt Cookie-Editor pour exporter manuellement, puis configurez xiaohongshu-mcp / les outils existants.
Déclenchement de la configuration de Boss直聘 : Lorsque l'utilisateur dit « Aide-moi à configurer Boss直聘 », lisez d'abord la section Boss de references/career.md, puis, après avoir obtenu l'autorisation d'installation, exécutez
agent-reach install --env=local --system --channels=boss. L'agent doit lancer un Chrome dédié lié uniquement à 127.0.0.1:9222 ; la première étape après le démarrage est de faire une pause et de demander à l'utilisateur de vérifier visuellement que la fenêtre affiche un état connecté (avatar dans le coin supérieur droit). Si ce n'est pas le cas, demandez à l'utilisateur de se connecter/scanner le code QR. Une fois confirmé, exécutez
boss --cdp-url http://localhost:9222 login --cdp et agent-reach doctor pour valider.
Ne laissez pas l'utilisateur chercher les paramètres de port.
Le profil Chrome dédié doit être réutilisé à long terme – ne le recréez pas à chaque fois et n'utilisez pas par défaut le navigateur principal de l'utilisateur.
Pour juger de l'état de connexion du navigateur CDP, ne faites pas confiance à boss status (il ne vérifie que le fichier local session.enc, qui n'est pas corrélé à l'état de connexion du navigateur). Fiez-vous à la détection de cookie du navigateur par agent-reach doctor (wt2) et à la confirmation visuelle de l'utilisateur. N'utilisez jamais l'URL de la page courante pour juger de l'état de connexion :
Les pages security-check / zhipin-security / _security_check sont des défis anti-scraping de Boss sans rapport avec la connexion – elles peuvent apparaître même si vous êtes connecté (presque inévitable avec un navigateur Chrome doté d'un port de débogage CDP). Ne les interprétez pas comme « non connecté ». Exécutez d'abord agent-reach doctor pour vérifier les cookies du navigateur, puis décidez si l'utilisateur doit se connecter.
L'erreur de recherche AUTH_EXPIRED est la vérité terrain d'une session navigateur non connectée : suivez directement le processus de connexion + login --cdp, sans interpréter dans le sens d'un défi de sécurité.
Lors de l'exécution d'une recherche, utilisez impérativement
boss --browser-source existing-browser --cdp-url http://localhost:9222 search ... ;
en cas d'erreur ENVIRONMENT_RISK, arrêtez immédiatement – ne rafraîchissez pas, ne vous reconnectez pas, ne réessayez pas automatiquement.
# Recherche Twitter (twitter-cli en priorité ; chaîne de reprise voir social.md)
twitter search "query" -n 10
# Reddit (pas de chemin zéro configuration : OpenCLI ou rdt-cli, nécessite authentification)
opencli reddit search "query" -f yaml # bureau
rdt search "query" --limit 10 # existant/serveur
# Xiaohongshu (OpenCLI en priorité pour le bureau)
opencli xiaohongshu search "query" -f yaml
# Facebook / Instagram (OpenCLI pour le bureau, réutilise l'état de connexion du navigateur)
opencli facebook search "query" -f yaml
opencli facebook groups -f yaml
opencli instagram search "query" -f yaml # rechercher utilisateur
opencli instagram user USERNAME -f yaml # lire les publications récentes d'un utilisateur spécifique
Vérification d'environnement
# Vérifier les canaux disponibles et le backend actuellement actif pour chaque plateforme
agent-reach doctor --json
Découverte d'adaptateurs OpenCLI
Si la table de routage ne couvre pas la plateforme ou la commande souhaitée par l'utilisateur, utilisez d'abord opencli list pour lister les adaptateurs existants, puis opencli <plateforme> --help pour afficher les commandes publiques. La découverte d'un adaptateur prouve seulement que la commande existe, pas que l'état de connexion ou le contenu cible est disponible ; exécutez des commandes en lecture seule uniquement lorsque la tâche de l'utilisateur mentionne explicitement cette plateforme, et validez avec un contenu non vide réel.
Règles de l'espace de travail
Ne créez pas de fichiers dans l'espace de travail de l'agent. Utilisez /tmp/ pour les sorties temporaires et ~/.agent-reach/ pour les données persistantes.
Documentation détaillée
En fonction des besoins de l'utilisateur, lisez la documentation correspondante :
- Outils de recherche — Recherche Exa AI
- Réseaux sociaux — Xiaohongshu, Twitter, Bilibili, V2EX, Reddit, Facebook, Instagram (groupes de commandes multi-backend/authentification)
- Emploi et recrutement — LinkedIn, Boss直聘
- Outils de développement — GitHub CLI
- Lecture web — Jina Reader, RSS
- Vidéos et podcasts — YouTube, Bilibili, Xiaoyuzhou
- Marchés financiers — Cours boursiers Xueqiu, recherche, contenu tendances
Canaux de configuration
Si un canal a besoin d'être configuré, obtenez le guide d'installation : https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
L'utilisateur n'a qu'à fournir les cookies, le reste de la configuration est effectué par l'agent.