Agent Reach Einsatzanleitung: Lassen Sie Claude Code / OpenClaw Twitter / Xiaohongshu / Bilibili verstehen

Kurzbeschreibung: Ihr KI-Agent kann richtig gut Code schreiben — aber sobald Sie ihn bitten, sich „online ein paar Infos zu holen“, ist er auf einmal komplett verloren? Agent Reach ist das Heilmittel für einen einzigen Befehl: Installieren Sie Twitter, Reddit, YouTube, Bilibili, Xiaohongshu, Douyin, WeChat Official Accounts … insgesamt 14+ Plattformen auf einmal. Danach weiß Ihr Agent selbst, welches Tool er aufrufen muss.

Projektvorstellung

Agent Reach ist ein „Internet-Fähigkeiten-Installer“ für KI-Agenten; GitHub: Panniantong/Agent-Reach, MIT-Lizenz, als Python-Paket.

Der Kern ist ungewöhnlich eindeutig: Kein Framework, sondern ein Gerüst (scaffolding).

Was bedeutet das? Wenn Ihr KI-Agent (Claude Code / OpenClaw / Cursor / Windsurf …) Agent Reach installiert hat, läuft er nicht durch die Wrapper-Ebene von Agent Reach, sondern ruft die Upstream-Tools direkt auf — twitter-cli / rdt-cli / yt-dlp / xhs-cli / douyin-mcp-server / Jina Reader / gh CLI … alles Tools, die vom Autor bereits ausgewählt, getestet (inkl. Fallstricke) und mit passenden Default-Parametern vorkonfiguriert wurden. Agent Reach übernimmt dabei nur:

1. Installer — Einzeiler: pip install agent-reach + agent-reach install installiert alle Upstream-Tools
2. Diagnose — agent-reach doctor zeigt mit einer einzigen Anweisung, welche Plattform funktioniert, welche nicht und wie man es repariert
3. Konfigurator — Cookie-Authentifizierung, API Keys, MCP-Services usw. werden einmalig sauber verwaltet
4. SKILL-Injection — Registrieren Sie SKILL.md beim Agent. Wenn er auf Anforderungen wie „nach Twitter suchen“ oder „Videos ansehen“ stößt, ruft er automatisch das passende Tool auf

Unterstützung für 14+ Plattformen:

Kurz gesagt: Befehle merken, keine Web-Scraper konfigurieren — sprechen Sie einfach mit dem Agent, dann geht er online.

Schwierigkeitsgrad / Dauer / Nutzen

• Schwierigkeitsgrad: ⭐ (für Einsteiger, wirklich nur ein Befehl)
• Dauer: 5–15 Minuten (lokaler Rechner); 30 Minuten (Server, inkl. Cookie-Konfiguration)
• Nutzen:
  • Claude Code / OpenClaw können direkt Twitter lesen, Xiaohongshu durchstöbern und YouTube-Untertitel lesen
  • Verstehen, wie sich das Design in der „scaffolding vs framework“-Logik im Ökosystem von KI-Agent-Tools unterscheidet
  • Cookie-Editor nutzen, um Cookies für mehrere Plattformen einheitlich zu verwalten und QR-Login-Fallen zu vermeiden
  • Wissen, dass agent-reach doctor eine gute Best Practice für die Agent-Toolchain ist

Zielgruppe

• Entwickler, die mit Claude Code / OpenClaw / Cursor arbeiten
• Wer möchte, dass der Agent wirklich online nach Informationen sucht, statt nur „ins Leere“ zu schauen
• Wer sich nicht für jede Plattform (Twitter / Reddit / Xiaohongshu) einzeln mit Scraping beschäftigen oder teure bezahlte APIs zahlen möchte
• Wer bereits eine KI-Agent-Toolchain hat und eine zusätzliche Ebene „Internet-Fähigkeiten“ hinzufügen will
• Wer beim Ausführen von langen Agent-Aufgaben nach einer „nicht ganz so schmerzhaften“ Rechenpower-Abrechnung sucht (dazu später mehr)

Kernabhängigkeiten und Umgebung

Minimum:

Empfohlen / Optional:

Vollständiger Projekt-Tree

Agent-Reach/
├── pyproject.toml                # Definition des Python-Pakets
├── agent_reach/
│   ├── __init__.py               # Versionsnummer
│   ├── cli.py                    # CLI-Entry (argparse)
│   ├── core.py                   # Core read/search-Routing
│   ├── config.py                 # YAML-Konfigurationsverwaltung
│   ├── doctor.py                 # Diagnose-Engine
│   ├── cookie_extract.py         # Cookie-Extraktionstool
│   ├── channels/                 # Pro Plattform eine Datei
│   │   ├── base.py               # BaseChannel-Abstraktionsklasse
│   │   ├── web.py                # Jina Reader
│   │   ├── twitter.py            # twitter-cli
│   │   ├── youtube.py            # yt-dlp
│   │   ├── github.py             # gh CLI
│   │   ├── bilibili.py           # yt-dlp + bili-cli
│   │   ├── reddit.py             # rdt-cli
│   │   ├── xiaohongshu.py        # xhs-cli
│   │   ├── douyin.py             # douyin-mcp-server
│   │   ├── linkedin.py           # linkedin-mcp
│   │   ├── wechat.py             # Exa + Camoufox
│   │   ├── rss.py                # feedparser
│   │   ├── exa_search.py         # Exa via mcporter
│   │   ├── weibo.py
│   │   ├── v2ex.py
│   │   ├── xueqiu.py
│   │   └── xiaoyuzhou.py
│   ├── integrations/
│   │   └── mcp_server.py         # MCP-Server-Integration
│   ├── skill/                    # Für den Agent: SKILL.md
│   ├── guides/                   # Nutzungsdokumentation (CH/EN/JP/KR)
│   ├── scripts/                  # Installationsskripte
│   └── utils/
├── config/
│   └── mcporter.json             # MCP-Tool-Konfiguration
├── tests/                        # pytest-Tests
└── docs/                         # README mehrsprachige Versionen

Als Nutzer müssen Sie nur mit diesen drei Befehlen arbeiten: pip install / agent-reach install / agent-reach doctor. channels/ ist für Erweiterungen durch Entwickler gedacht.

Schritt-für-Schritt-Anleitung

Schritt 1: Basisinstallation (Hauptpfad)

# Empfohlen: mit pipx isoliert installieren
pipx install agent-reach

# Oder alternativ pip (Achtung: nicht in das System-Python installieren)
python3 -m venv ~/.agent-reach-venv
source ~/.agent-reach-venv/bin/activate
pip install agent-reach

Nach der Installation sollten Sie diesen Befehl haben:

agent-reach --version
# agent-reach 1.4.0

Schritt 2: Alle Upstream-Tools in einem Rutsch installieren

# Default-Modus: Automatische Erkennung der Umgebung, alle Abhängigkeiten installieren
agent-reach install --env=auto

Es läuft dabei nacheinander ab:

1. Installiert Systemabhängigkeiten (Node.js / gh CLI / mcporter / twitter-cli / rdt-cli usw.)
2. Konfiguriert die Suchmaschine (Exa-MCP-Integration, ohne Key)
3. Prüft, ob lokal oder Server, und gibt unterschiedliche Empfehlungen
4. Registriert SKILL.md im skills/-Verzeichnis des Agents

openclaw config set tools.profile "coding"
openclaw gateway restart

Schritt 3: Kanalstatus diagnostizieren

agent-reach doctor

Sie sollten etwa Folgendes sehen:

✅ web              Jina Reader OK
✅ youtube          yt-dlp 2025.10.x installiert
✅ rss              feedparser 6.0.x
✅ exa_search       Exa MCP verbunden
✅ github           gh CLI 2.x authentifiziert
⚠️  twitter         twitter-cli nicht eingeloggt  → ausführen: twitter login
⚠️  reddit          rdt-cli nicht eingeloggt       → ausführen: rdt login
✅ bilibili         yt-dlp OK
⚠️  xiaohongshu     xhs-cli nicht eingeloggt      → siehe Schritt 4
✅ douyin           douyin-mcp-server OK
✅ wechat           Exa-Suche OK
✅ v2ex             API OK

✅ bedeutet „out of the box nutzbar“, ⚠️ bedeutet „zusätzliche Konfiguration nötig“ (meist Cookie-Authentifizierung).

Schritt 4: Plattformen mit Cookie-Autorisierung konfigurieren (wichtig)

Twitter / Xiaohongshu / Reddit — diese drei benötigen einen Login-Status. Verwenden Sie Cookie-Authentifizierung statt QR-Scanning.

Zuerst Cookie-Editor installieren: Im Chrome/Edge App Store nach „Cookie-Editor“ suchen und installieren.

Einheitlicher Ablauf:

1. Loggen Sie sich im Browser manuell bei x.com / xiaohongshu.com / reddit.com ein
2. Klicken Sie auf das Symbol des Cookie-Editor-Plugins → „Export“ → wählen Sie das Format „Netscape“
3. Senden Sie die exportierten Cookie-Strings an den Agent und sagen Sie ihm: „Hilf mir Twitter einzurichten“
4. Der Agent ruft cookie_extract.py auf, speichert es in ~/.agent-reach/config.yaml
5. Dateirechte auf 600 setzen, sodass nur Ihr Konto lesen kann

# Alternativ können Sie die Konfiguration direkt per Command Line setzen, ohne den Agent
agent-reach config set twitter.cookie "$(pbpaste)"  # macOS
agent-reach config set xhs.cookie "$(xclip -o)"     # Linux

Schritt 5: Cookie-Plattformen verifizieren

agent-reach doctor

Führen Sie die Diagnose erneut aus — die zuvor mit ⚠️ markierten Plattformen sollten jetzt ✅ sein.

Schritt 6: Agent einmal testweise laufen lassen

Sprechen Sie mit Ihrem Agent (Claude Code / OpenClaw / Cursor) und sagen Sie:

Zeig mir, worum es in diesem Tweet geht: https://x.com/vercel/status/1234567890

Nachdem der Agent SKILL.md gelesen hat, ruft er automatisch den Befehl twitter tweet URL auf. In wenigen Sekunden erhalten Sie den Tweet-Text.

Probieren Sie ein paar Kombinationen:

Was wird gerade auf Reddit in r/LocalLLaMA diskutiert?
Lies dieses YouTube-Video: https://youtube.com/watch?v=xxx
Schau bei Xiaohongshu nach, welche der „Camping-Ausrüstungen“ gerade als Bestseller durchgehen
Worum geht es in diesem GitHub-Repository: https://github.com/xxx/yyy

Sie werden einen Punkt feststellen: Sie müssen dem Agent nicht sagen, welches Kommando er ausführen soll. SKILL.md hat die Zuordnungen bereits fest verdrahtet — „Tweet lesen = twitter CLI“, „Video ansehen = yt-dlp“. Das ist der größte Unterschied zwischen Agent Reach und einer normalen Tool-Sammlung: Nach der Installation wählt der Agent die Tools bewusst aus, er probiert nicht blind herum.

Schritt 7 (optional): Semantische Suche im ganzen Web

Standardmäßig ist Exa bereits angebunden, ohne API Key. Fragen Sie einfach den Agent:

Suche mir bitte die neuesten LLM-Agent-Framework-Vergleiche aus dem Jahr 2026 und gib mir die 5 relevantesten

Er ruft zuerst das Exa-MCP-Tool auf, holt Ergebnisse und ruft anschließend Jina Reader auf, um den Volltext abzurufen. Am Ende erstellt er daraus einen Bericht.

Schritt 8 (optional): Zugriff auf GitHub private Repos

# Einmalig einloggen
gh auth login

Nach Abschluss des OAuth kann der Agent private Repos in Ihrem Account lesen, Issues anlegen, PRs einreichen und reviewen.

Schritt 9 (optional): Bilibili / Douyin verbessern

Bilibili (lokal) ist out of the box verfügbar. Server im Ausland benötigen einen Proxy (~$1/Monat, empfohlen: Wohnsitz-Proxys wie FluxNode):

# Angenommen, Ihr Proxy läuft auf http://127.0.0.1:7890
agent-reach config set bilibili.proxy "http://127.0.0.1:7890"
agent-reach doctor  # Diagnose erneut ausführen

Douyin benötigt komplett keinen Login — schicken Sie einfach dem Agent den Share-Link:

Analysiere dieses Douyin-Video: https://v.douyin.com/xxxxx

Der Agent ruft mcporter call 'douyin.parse_douyin_video_info(...)' auf und gibt Ihnen Video-Infos plus einen Download-Link ohne Watermark.

Schritt 10 (optional): Sicherheitsmodus / Deinstallation

Sicherheitsmodus (für Production-Server oder Multi-User-Maschinen):

# Installiert keine Systempakete automatisch, listet nur auf, was gemacht würde
agent-reach install --env=auto --safe

# Oder erst Vorschau: was würde passieren, aber ohne wirklich auszuführen
agent-reach install --env=auto --dry-run

Vollständige Deinstallation:

agent-reach uninstall             # Konfiguration + Skill-Dateien löschen
agent-reach uninstall --keep-config  # Token behalten, für Neuinstallation nutzen
pip uninstall agent-reach         # Python-Paket entfernen

Häufige Probleme beheben

Q1: OpenClaw-Installation schlägt mit „permission denied“ fehl / Agent reagiert nicht

Ursache: OpenClaw hat standardmäßig tools.profile = messaging und erlaubt dem Agent nicht, Shell-Kommandos auszuführen. Fix:

openclaw config set tools.profile "coding"
openclaw gateway restart
# Erneut eine neue Sitzung öffnen und „Hilf mir Agent Reach zu installieren“ senden

Oder ändern Sie ~/.openclaw/openclaw.json:

{
  "tools": { "profile": "coding" }
}

Q2: Xiaohongshu-QR-Login dreht sich ständig im Kreis

Nicht per QR. Direkt:

1. Cookie-Editor im Chrome App Store installieren
2. Im Browser bei der Xiaohongshu-Webversion einloggen
3. Cookie-Editor → Export → Netscape
4. Den String an den Agent senden und sagen: „Hilf mir Xiaohongshu einzurichten“
5. In 30 Sekunden erledigt

Q3: Reddit liefert beim Abruf sofort 403

Reddit fordert seit 2024 verpflichtend eine Authentifizierung. Fix:

# Installieren Sie rdt-cli (sollte im Agent-Reach-Installationsschritt bereits dabei sein)
pipx install rdt-cli

# Einmalig einloggen (es zieht die Cookies automatisch aus Ihrem Chrome)
rdt login

# Test
rdt search "LocalLLaMA" --limit 5

Wie bei Twitter / Xiaohongshu gilt: rdt login nutzt Browser-Cookie-Automatik-Extraktion, nicht QR.

Q4: Bilibili auf einem Server im Ausland nicht erreichbar

Auslands-IP wird von Bilibili geblockt, es ist ein Wohnsitz-Proxy nötig. Zwei Optionen:

# Option 1: Konfiguration per Command Line (empfohlen, z. B. FluxNode als günstigen Proxy)
agent-reach config set bilibili.proxy "http://user:pass@proxy:port"

# Option 2: Umgebungsvariablen
export HTTP_PROXY="http://user:pass@proxy:port"
export HTTPS_PROXY="http://user:pass@proxy:port"

Günstige Wohnsitz-Proxys liegen bei ~$1/Monat — es lohnt sich nicht, selbst etwas aufzusetzen.

Q5: agent-reach doctor meldet „channel not found“ / Konflikt in Channel-Dateien

Meistens ist ein Teil der Upstream-Tools fehlgeschlagen oder wurden in das System-Python statt mit pipx installiert. Der sauberste Fix ist: komplett neu aufsetzen:

agent-reach uninstall
pipx uninstall agent-reach
# mögliche Reste bereinigen: ~/.agent-reach/
rm -rf ~/.agent-reach/

pipx install agent-reach
agent-reach install --env=auto
agent-reach doctor

Q6: Browser gewechselt / Cookie abgelaufen

Cookies laufen nach ein paar Monaten ab. Gehen Sie einfach den Ablauf erneut durch: „Browser einloggen → Cookie-Editor exportieren → an den Agent senden“. Der Agent überschreibt automatisch die alten Cookies in ~/.agent-reach/config.yaml.

Q7 (Bonus): Agent macht lange Tasks — die Rechnung explodiert, wie rechne ich?

Ich erzähle kurz von einem Fallstrick, in den ich selbst getappt bin, als ich Agent eingesetzt habe.

Agent Reach löst das Problem „Wie bekommt der Agent Internetzugriff“. Aber wenn der Agent Tools aufruft, verbraucht er im Kern weiterhin LLM Token. Ein typisches „Wettbewerber recherchieren + zusammenfassen“ Szenario mit 5–10 Tool-Runden (Suche, Webseiten holen, Tweets lesen, erneut suchen, erneut lesen) kann am Ende schnell zig-/hunderttausende Tokens pro Runde erzeugen. Wenn Sie 20+ solcher Aufgaben pro Tag laufen lassen, explodiert die Rechnung sehr schnell.

Meine drei getesteten Verbindungsarten (auf Basis meiner eigenen Deployment-Erfahrung):

1. Anthropic offizielle API anschließen — das beste Erlebnis, aber wenn Claude Opus Agent-Aufgaben fährt, ist es am Ende mit einer Tagesrechnung im vierstelligen RMB-Bereich völlig normal
2. OpenRouter & ähnliche Aggregator-APIs — minimal günstiger als offiziell, aber immer noch teuer
3. Defapi anschließen — das ist aktuell mein Setup. Halber offizieller Preis, und auf Protokollebene vollständig kompatibel. Agent Reach kann unverändert konfiguriert werden: keine Änderungen an SKILL / Prompt / Tool-Call-Code nötig

Konkrete Konfiguration (angenommen, Ihr Agent nutzt Claude / Anthropic-Protokoll):

# ~/.openclaw/openclaw.json oder Env-Config für Claude Code
ANTHROPIC_BASE_URL=https://api.defapi.org
ANTHROPIC_API_KEY=sk-xxxxxx    # im defapi.org Backend holen

Bei Defapi sind die meisten Modelle mit drei gängigen Protokollen kompatibel — v1/chat/completions (OpenAI) / v1/messages (Anthropic) / v1beta/models (Gemini). Modelle wechseln heißt nur: den Namen ändern. Wenn der Agent Aufgaben wie „Tweets scrapen“, „Xiaohongshu analysieren“ oder „Video-Untertitel zusammenfassen“ (also tool-call-intensiv) ausführt, ist es realistisch, die monatliche Rechnung von vierstellig auf dreistellig zu senken.

Weiterführende Lektüre / Fortgeschrittene Richtungen

• Custom channel: Fügen Sie in agent_reach/channels/ eine Datei hinzu, erben Sie BaseChannel, implementieren Sie vier Methoden: can_handle(url) / read(url) / search(query) / check(). Danach genügt pip install -e .. Die Hürde ist niedrig, eine Plattform = eine Datei
• Upstream-Tools ersetzen: channels/web.py nutzt standardmäßig Jina Reader. Reicht Ihnen das nicht? Dann tauschen Sie gegen Firecrawl / Crawl4AI / eigenen Scraper — ändern Sie nur den Import, fertig
• SKILL.md-Mechanismus: Wenn der Agent Agent Reach installiert hat, registriert sich SKILL.md automatisch unter ~/.claude/skills/ / ~/.openclaw/skills/. Sie können eigene SKILL.md schreiben und dem Agent beibringen, in bestimmten Szenarien zuerst welchen Channel zu wählen
• Beliebiges MCP über mcporter: Nicht nur Exa — jeder MCP-kompatible Server lässt sich über config/mcporter.json anbinden. Sie müssen nur den Alias passend auf den passenden Startbefehl umstellen
• Mehrere Agents teilen sich ein Setup: Die Agent-Reach-Konfiguration ~/.agent-reach/config.yaml ist dateibasiert. Wenn mehrere Agents (Claude Code + OpenClaw + Cursor) gleichzeitig auf derselben Maschine laufen, können sie dieselbe Konfiguration teilen
• Mit Defapi koppeln: Agent Reach holt Daten, Defapi führt Inferenz aus. Eine „Informationszugriffs-Schicht“ und eine „Kosten-/Compute-Schicht“ — beide sind protokollgetrieben. Zusammen ergibt das einen „kostenarmen Agent-Long-Task-Workflow“

GitHub-Repository: Panniantong/Agent-Reach, mehrsprachige Dokumente in docs/README_en.md / docs/README_ja.md / docs/README_ko.md. Die Design-Philosophie steht im Abschnitt „Design-Idee/Philosophie“ am Ende der README. Um einen Channel per PR beizutragen, reicht es aus — Autor Neo Reid ist sehr aktiv bei der Pflege.