Guide de Configuration — Agent-Reach

Guide de Configuration — Agent-Reach

Donne à ton agent IA un accès en lecture à tout internet : Twitter, Reddit, YouTube, GitHub, et plus. GitHub : https://github.com/Panniantong/Agent-Reach

---

Prérequis

• Python ≥ 3.9
• pipx installé (pip install pipx)
• Un agent IA compatible (Claude Code, Cursor, Windsurf, Codex, etc.)

---

1. Installation

Méthode recommandée (pipx) :

pipx install https://github.com/Panniantong/agent-reach/archive/main.zip

Alternative (venv, si erreur PEP 668 / Homebrew) :

python3 -m venv ~/.agent-reach-venv
source ~/.agent-reach-venv/bin/activate
pip install https://github.com/Panniantong/agent-reach/archive/main.zip

---

2. Installation automatique des dépendances

agent-reach install --env=auto

Cette commande installe automatiquement :

• Node.js + mcporter + xreach CLI (pour Twitter/X)
• gh CLI (pour GitHub)
• yt-dlp (pour YouTube)
• feedparser (pour RSS)
• Configure l'accès à Exa pour la recherche web

Mode sans modifications système :

agent-reach install --env=auto --safe

---

3. Vérifier l'état des canaux

agent-reach doctor

Résultat attendu (exemple) :

✅ Twitter/X    — cookie OK
✅ YouTube      — yt-dlp OK
✅ GitHub       — gh CLI OK
✅ Reddit       — rdt-cli OK
✅ RSS/Web      — feedparser + Jina OK
⚠️  XiaoHongShu — cookie manquant
⬜ Exa Search   — clé API non configurée

---

4. Configuration des canaux

Twitter/X

pipx install twitter-cli
# S'assurer d'être connecté à x.com dans le navigateur
# Le cookie est extrait automatiquement

Reddit

pipx install rdt-cli
rdt login   # extrait le cookie depuis le navigateur

Recherche web (Exa)

# Créer un compte gratuit sur https://exa.ai (1000 req/mois offerts)
# Puis configurer la clé :
agent-reach configure

Variables d'environnement (optionnel)

Créer un fichier .env :

EXA_API_KEY=exa-votre-clé        # Recherche web sémantique
GITHUB_TOKEN=ghp_votre-token     # Rate limit plus élevé
REDDIT_PROXY=http://user:pass@ip:port  # Proxy Reddit si blocage
GROQ_API_KEY=votre-clé-groq      # Transcription audio/vidéo

---

5. Intégration avec ton agent IA

Pour Claude Code / Cursor / Windsurf :

npx skills add https://github.com/panniantong/agent-reach --skill agent-reach

L'agent détecte automatiquement les outils disponibles et sait quand les utiliser.

Usage direct depuis l'agent :

twitter search "intelligence artificielle"
twitter tweet https://x.com/user/status/123456

rdt search "LLM agents"
rdt read POST_ID

gh search repos "copilotkit" --sort=stars
yt-dlp --write-auto-sub --skip-download URL_YOUTUBE

---

6. Surveillance et mises à jour

agent-reach watch           # Santé + check de mise à jour
agent-reach check-update    # Vérifier si nouvelle version disponible

# Mettre à jour :
pip install --upgrade https://github.com/Panniantong/agent-reach/archive/main.zip

---

Canaux disponibles (v1.3.0)

Canal	Statut	Prérequis
Twitter/X	✅ Gratuit	Cookie navigateur
Reddit	✅ Gratuit	rdt login
YouTube subtitles	✅ Gratuit	yt-dlp
GitHub	✅ Gratuit	gh CLI (token optionnel)
RSS/Atom	✅ Gratuit	Aucun
Web (Jina)	✅ Gratuit	Aucun
Web Search (Exa)	🔑 Clé gratuite	Compte exa.ai
XiaoHongShu	🍪 Cookie	Export depuis navigateur
Bilibili	⚠️ Proxy	IP bloquée en dehors de CN

---

Ressources

• Docs : https://github.com/Panniantong/Agent-Reach/blob/main/docs/README_en.md
• Issues : https://github.com/Panniantong/Agent-Reach/issues