Installer Agent Reach · Donner des yeux à Claude · Guide complet

👁️ Ce que tu reçois : l'installation d'Agent Reach pas à pas, la commande doctor qui te dit canal par canal ce qui marche, les 5 canaux à activer en premier (zéro compte, zéro cookie), et l'audit du code que j'ai fait avant de te l'envoyer.

Agent Reach installe et surveille les outils qui permettent à Claude d'aller lire Internet : transcriptions YouTube, posts X, threads Reddit, dépôts GitHub, flux RSS, recherche web. Il ne lit rien lui-même : il choisit les bons outils, les installe, et te dit lesquels marchent. Ensuite Claude les appelle directement.

🔗 Dépôt officiel : github.com/Panniantong/agent-reach

⚠️ Ce que ça fait vraiment (lis ça avant d'installer)

J'ai fait lire le code avant de te l'envoyer. Trois choses que le README ne met pas en avant.

• 15 plateformes annoncées, mais 5 sont chinoises (Xiaohongshu, Bilibili, V2EX, Xueqiu, Xiaoyuzhou). Si tu es en France, tu en utiliseras une dizaine au maximum.
• La « recherche Instagram » cherche des comptes, pas des posts. Il n'y a aucun moyen de chercher des reels par mot-clé. Tu peux lire les posts d'un compte que tu nommes, c'est tout.
• Instagram, Facebook et Reddit ont besoin de ton Chrome ouvert et connecté. Ça tourne sur ta machine uniquement, jamais sur un serveur, et jamais pendant que ton ordi est éteint.

Ce qui marche vraiment bien, en revanche : YouTube, la recherche web, les flux RSS et GitHub. Zéro compte, zéro cookie, zéro risque.

🧱 Prérequis

• Python 3.10+
• pipx · pipx.pypa.io
• Node.js (pour la recherche web via mcporter)
• gh CLI (pour GitHub) · cli.github.com
• Un agent capable de lancer des commandes : Claude Code, Cursor, Windsurf…

⚡ Étape 1 · Installer

La méthode paresseuse (celle que je recommande)

Colle exactement ça à Claude Code :

Installe Agent Reach en suivant ce guide : https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

Il lit la doc, vérifie ta machine, et te dit ce qui manque. Le guide est écrit pour être exécuté par un agent, pas lu par un humain.

La méthode manuelle

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

🛡️ Par défaut, il ne touche à rien. agent-reach install se contente de vérifier ta machine et de lister ce qui manque. Pour qu'il installe vraiment les dépendances, il faut le lui autoriser explicitement avec --system. Bon réflexe : faire le tour en lecture seule d'abord.

agent-reach install --env=auto --dry-run    # voir ce qu'il ferait
agent-reach install --env=auto --system     # l'autoriser à installer

🩺 Étape 2 · Le doctor

La commande la plus utile du lot. Elle te dit, canal par canal, ce qui marche et par quel outil ça passe :

agent-reach doctor
agent-reach doctor --json    # version structurée, pour ton agent

💡 Quand un canal tombe en panne (une plateforme change son API, un outil arrête d'être maintenu), le doctor te le dit et te donne la commande pour réparer. C'est ce qui fait la différence avec « j'ai installé un truc il y a trois mois et je sais plus s'il marche ».

🎯 Les 5 canaux à activer en premier

✅ Ces cinq-là marchent sans compte, sans cookie et sans risque. Commence par eux, tu couvres 90 % de l'usage réel.

1. YouTube · la transcription complète d'une vidéo

Le meilleur du lot. Tu lui donnes une vidéo d'une heure, il te sort le texte entier.

yt-dlp --write-sub --write-auto-sub --skip-download -o "/tmp/%(id)s" "URL_YOUTUBE"
cat /tmp/*.vtt

Si la vidéo n'a aucun sous-titre, il télécharge l'audio et le transcrit (clé Groq gratuite) :

agent-reach transcribe "URL_YOUTUBE"

2. Recherche web (Exa)

Recherche sémantique, pas par mots-clés. Aucune clé à créer.

mcporter call exa.web_search_exa query="ta recherche" numResults=5

3. Lire n'importe quelle page

Renvoie la page en markdown propre, sans les balises HTML.

curl -s "https://r.jina.ai/https://exemple.com/article"

4. GitHub

gh search repos "ta recherche" --sort stars --limit 10
gh repo view owner/repo

5. Flux RSS

python3 -c "
import feedparser
for e in feedparser.parse('URL_DU_FLUX').entries[:5]:
    print(f'{e.title} · {e.link}')
"

🔐 Les canaux qui demandent un login

🚨 Utilise un compte secondaire. Le projet le dit lui-même dans son README. Passer par un script pour lire X ou Instagram peut être détecté par la plateforme et faire limiter ou bannir le compte. Si ton compte principal est ton outil de travail, ne le mets pas là-dedans.

X / Twitter

L'authentification se fait avec deux cookies que tu exportes toi-même depuis ton navigateur avec l'extension Cookie-Editor, puis :

agent-reach configure twitter-cookies
export TWITTER_AUTH_TOKEN="..."
export TWITTER_CT0="..."

Les commandes stables :

twitter user-posts @uncompte -n 20    # les posts d'un compte
twitter tweet URL                     # un post et ses réponses
twitter feed -n 20                    # ton fil

⚠️ twitter search par mot-clé est marqué comme instable par le projet lui-même : X change son API régulièrement et la commande peut renvoyer une erreur. Suivre une liste de comptes fonctionne, chercher par thème non.

Instagram et Reddit

Ces deux-là passent par OpenCLI, une extension qui réutilise ta session Chrome déjà connectée.

opencli instagram user UNCOMPTE --limit 12 -f yaml   # les 12 derniers posts
opencli instagram profile UNCOMPTE -f yaml
opencli reddit search "ta recherche" -f yaml
opencli reddit subreddit LocalLLaMA -f yaml

🖥️ Il faut que Chrome soit ouvert, avec l'extension OpenCLI installée et la session connectée au site. Rien de tout ça ne tourne sans ton ordinateur allumé. Espace les requêtes : en enchaînant trop vite, tu récoltes un 429 ou une demande de reconnexion.

🚫 Ce que je n'installe pas

🧯 Dépannage rapide

🔄 Mettre à jour et désinstaller

La mise à jour se fait comme l'install, en collant un lien à ton agent :

Mets à jour Agent Reach en suivant ce guide : https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md

Pour tout enlever (config, tokens, cookies, fichiers skill) :

agent-reach uninstall --dry-run     # voir ce qui serait supprimé
agent-reach uninstall
pip uninstall agent-reach

🔒 Tes cookies et tokens restent dans ~/.agent-reach/config.yaml sur ta machine, en permissions 600. Rien n'est envoyé ailleurs, et le code est ouvert si tu veux vérifier.

Récap

Ressources

• 📦 Dépôt GitHub : github.com/Panniantong/agent-reach
• 🐍 Installeur Python isolé : pipx.pypa.io
• 🐙 GitHub CLI : cli.github.com