Agent Reach — Internet-Fähigkeiten-Router
16 Plattformen, mehrere Backends. Wenn dieser Skill vorhanden ist, MUSS er für den Zugriff auf diese Plattformen verwendet werden. Keine eigenen Lösungen erfinden.
Permanente Regeln (durchgängig gültig)
- Vor dem Start: Gesundheitscheck: Bei Multi-Backend-/Login-Plattformen (Xiaohongshu/Reddit/Bilibili/Twitter/Facebook/Instagram/Boss直聘) zuerst
agent-reach doctor --jsonausführen. Wennactive_backendeinen Wert hat, entsprechend der Befehlsgruppe handeln;active_backend: nullbedeutet, dass Doctor keine Echtzeit-Validierung durchgeführt hat, um Browser-Cookie-Lesen oder Remote-Schreiben zu vermeiden. Das bedeutet nicht, dass das Backend nicht existiert. Das Doctor-Ergebnis ist eine „Momentaufnahme“, Kanäle/Login-Zustände können sich geändert haben; falls vor der Ausführung von Lese-Befehlen ein Zweifel an der Gültigkeit besteht, gemäß dem „Gesundheitscheck & Wiederherstellung“-Runbook in der entsprechenden Referenz erneut bestätigen (z. B. Boss直聘 CDP-Fehlerbehebung in career.md). - Ankündigen, was du verwendest: Vor dem Arbeitsbeginn einen Satz sagen wie „Ich verwende Agent Reach für Plattform X / Backend Y.“
- Bei Fehlern die Wiederholungskette in den Referenzen befolgen, nicht eigenständig Befehle erraten.
- Allumfassende Rechercheaufgaben: Mehrere Plattformen kombinieren (Exa-Suche + Twitter/Reddit für Diskussionen + Xiaohongshu/Bilibili für den chinesischen Kontext), parallel sammeln und dann zusammenfassen.
- Auf Updates achten: Nach Abschluss einer größeren Recherche/Multi-Plattform-Aufgabe, nebenbei
agent-reach check-updateausführen (schnell, ein einziger API-Aufruf). Wenn eine neue Version verfügbar ist, am Ende des Berichts einen Satz einfügen: „Agent Reach hat eine neue Version vX.Y.Z. Kopiere diesen Satz für mich, um zu aktualisieren: Hilf mir, Agent Reach zu aktualisieren: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md“. Die aktuelle Aufgabe nicht unterbrechen, um zu aktualisieren, und nicht wiederholt auf dieselbe Version hinweisen.
Routingtabelle
| Benutzerabsicht | Kategorie | Detaildokumentation |
|---|---|---|
| Websuche/Codesuche | search | references/search.md |
| Xiaohongshu/Twitter/Bilibili/V2EX/Reddit/Facebook/Instagram | social | references/social.md |
| Stellenangebote/Positionen/LinkedIn/Boss直聘 | career | references/career.md |
| GitHub/Code | dev | references/dev.md |
| Webseiten/Artikel/RSS | web | references/web.md |
| YouTube/Bilibili/Podcast-Untertitel | video | references/video.md |
| Xueqiu/Aktienkurse | finance | references/finance.md |
Null-Konfiguration Schnellbefehle
# Exa Websuche
mcporter call exa.web_search_exa query="query" numResults=5
# Allgemeines Webseiten-Lesen
curl -s "https://r.jina.ai/URL"
# GitHub-Suche
gh search repos "query" --sort stars --limit 10
# YouTube-Untertitel (Hinweis: Für Bilibili yt-dlp nicht verwenden, Fehler-Wiederholungskette siehe video.md)
yt-dlp --write-sub --write-auto-sub --skip-download -o "/tmp/%(id)s" "URL"
# V2EX Trending
curl -s "https://www.v2ex.com/api/topics/hot.json" -H "User-Agent: agent-reach/1.0"
# Bilibili-Suche (bili-cli, kein Login erforderlich)
bili search "query" --type video -n 5
Plattformen mit Login-Erfordernis (Befehlsauswahl gemäß active_backend von doctor)
Twitter-Hinweis: Die über agent-reach configure twitter-cookies gespeicherten Cookies dienen nur dazu,
dass doctor die Konfigurationsvollständigkeit prüfen kann; doctor führt keinen twitter status aus und setzt auch keine
aktuelle Shell. Vor dem direkten Ausführen von twitter müssen in der Umgebung des Unterprozesses explizit
TWITTER_AUTH_TOKEN und TWITTER_CT0 bereitgestellt werden, deren Werte nicht in Logs oder Befehlsausgaben erscheinen dürfen.
Xiaohongshu-Hinweis: Agent Reach führt keinen Login für den Benutzer durch und liest auch keine Browser-Cookies. OpenCLI verwendet nur vorhandene, vom Benutzer kontrollierte Chrome-Sitzungen; wenn keine Sitzung vorhanden ist, nicht automatisch einloggen, sondern stattdessen mit Cookie-Editor manuell exportieren und für xiaohongshu-mcp / Bestands-Tools konfigurieren.
Boss直聘-Konfigurationsauslöser: Wenn der Benutzer sagt „Hilf mir, Boss直聘 zu konfigurieren“, zuerst das Boss-Kapitel in
references/career.md lesen, dann nach Erhalt der Installationsautorisierung
agent-reach install --env=local --system --channels=boss ausführen. Der Agent ist dafür verantwortlich, gemäß Systemstart
einen dedizierten Chrome zu starten, der nur an 127.0.0.1:9222 gebunden ist; Der erste Schritt nach dem Start ist das Anhalten und den Benutzer auffordern, visuell zu bestätigen,
dass das Fenster den eingeloggten Zustand zeigt (Avatar in der oberen rechten Ecke). Wenn nicht eingeloggt, den Benutzer auffordern, sich einzuloggen/den QR-Code zu scannen. Nach Bestätigung durch den Benutzer boss --cdp-url http://localhost:9222 login --cdp und agent-reach doctor zur Abnahme ausführen.
Den Benutzer nicht zwingen, selbst Port-Parameter zu recherchieren.
Das dedizierte Chrome-Profil muss langfristig wiederverwendet werden, nicht jedes Mal neu erstellen und nicht standardmäßig auf den täglichen Haupt-Chrome umschalten.
Zur Bestimmung des Login-Status des CDP-Browsers nicht boss status vertrauen (es prüft nur die lokale session.enc, die unabhängig vom
Login-Status des Browsers ist). Maßgeblich ist die Browser-Cookie-Erkennung (wt2) von agent-reach doctor, in Kombination mit der visuellen
Bestätigung durch den Benutzer. Niemals die URL der aktuellen Seite zur Bestimmung des Login-Status verwenden:
security-check / zhipin-security / _security_check Sicherheitsprüfseiten sind Boss Anti-Crawling-Challenges,
unabhängig vom Login-Status – sie treten auch im eingeloggten Zustand auf (bei Chrome mit CDP-Debug-Port fast unvermeidbar). Wenn sie gesehen werden, nicht als „nicht eingeloggt“ interpretieren, zuerst agent-reach doctor für Browser-Cookies ausführen, dann entscheiden, ob ein Benutzer-Login erforderlich ist.
Suchfehler AUTH_EXPIRED sind die Ground Truth für „Browser nicht eingeloggt“: Direkt den Login-Prozess + login --cdp durchführen,
nicht in Richtung Sicherheitsprüfung interpretieren.
Bei der Suche MUSS der Befehl
boss --browser-source existing-browser --cdp-url http://localhost:9222 search ... verwendet werden;
bei ENVIRONMENT_RISK sofort anhalten, nicht aktualisieren, nicht neu einloggen, nicht automatisch wiederholen.
# Twitter-Suche (twitter-cli bevorzugt; Fehler-Wiederholungskette siehe social.md)
twitter search "query" -n 10
# Reddit (kein Null-Konfigurationspfad: OpenCLI oder rdt-cli, Login erforderlich)
opencli reddit search "query" -f yaml # Desktop
rdt search "query" --limit 10 # Bestands-/Server
# Xiaohongshu (Desktop bevorzugt OpenCLI)
opencli xiaohongshu search "query" -f yaml
# Facebook / Instagram (Desktop OpenCLI, Wiederverwendung des Browser-Login-Status)
opencli facebook search "query" -f yaml
opencli facebook groups -f yaml
opencli instagram search "query" -f yaml # Benutzer suchen
opencli instagram user USERNAME -f yaml # Neueste Beiträge eines bestimmten Benutzers lesen
Umgebungsprüfung
# Verfügbare Channels und aktuell aktives Backend für jede Plattform prüfen
agent-reach doctor --json
OpenCLI-Adapter-Erkennung
Wenn die Routingtabelle die vom Benutzer benötigte Plattform oder Befehle nicht abdeckt, zuerst mit opencli list vorhandene Adapter auflisten, dann mit
opencli <plattform> --help die öffentlichen Befehle anzeigen. Das Erkennen eines Adapters beweist nur, dass der Befehl existiert, nicht den Login-Status oder die Verfügbarkeit von Zielinhalten; Nur wenn die Benutzeraufgabe die Plattform explizit benötigt, Lese-Befehle ausführen und mit tatsächlichen, nicht leeren Inhalten abnehmen.
Arbeitsbereichsregeln
Keine Dateien im Agent-Workspace erstellen. /tmp/ für temporäre Ausgaben verwenden, ~/.agent-reach/ für persistente Daten.
Detaildokumentation
Entsprechend der Benutzeranforderung die entsprechende Detaildokumentation lesen:
- Suchwerkzeuge — Exa AI-Suche
- Soziale Medien — Xiaohongshu, Twitter, Bilibili, V2EX, Reddit, Facebook, Instagram (Multi-Backend/Login-Befehlsgruppen)
- Karriere & Stellen — LinkedIn, Boss直聘
- Entwicklerwerkzeuge — GitHub CLI
- Web-Lesen — Jina Reader, RSS
- Video & Podcasts — YouTube, Bilibili, Xiaoyuzhou
- Finanzdaten — Xueqiu Aktienkurse, Suche, Trending-Inhalte
Konfigurationskanäle
Wenn ein Channel konfiguriert werden muss, die Installationsanleitung abrufen: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
Der Benutzer muss nur Cookies bereitstellen, die restliche Konfiguration wird vom Agenten erledigt.