Donner à un agent des yeux sur tout internet
Agent Reach branche ton agent sur une quinzaine de plateformes, dont celles qui demandent une connexion. Avec ce que ça implique vraiment.
Un agent qui ne voit qu'une page web à la fois passe à côté de l'essentiel : les discussions, les vidéos, les fils de commentaires, tout ce qui vit derrière un mur de connexion ou une API payante. Agent Reach comble ce trou. C'est un outil libre, sous licence MIT, qui installe et pilote une collection d'outils en ligne de commande pour lire une quinzaine de plateformes depuis ton agent.
Le point important, et il est écrit dans sa propre documentation : Agent Reach
n'est pas un enrobage magique. C'est un sélecteur, un installateur, un
vérificateur d'état et un routeur. Derrière, ce sont des outils existants qui
travaillent : yt-dlp pour YouTube, gh pour GitHub, OpenCLI pour la
navigation, et d'autres selon la plateforme. Comprendre ça change la façon de
déboguer quand quelque chose ne marche pas.
Ce qu'il couvre vraiment
| Sans configuration | Après une mise en place |
|---|---|
| YouTube, GitHub, RSS et quelques autres | Twitter/X, Reddit, LinkedIn, Instagram, Facebook |
| Lecture immédiate après installation | Réutilisation d'une session de navigateur déjà connectée |
Une quinzaine de plateformes au total, dont plusieurs sources chinoises (Bilibili, XiaoHongShu, Xueqiu) qui sont rarement accessibles ailleurs.
Où en est le projet
68 349 étoiles sur GitHub, 5 741 forks, licence MIT, dernier envoi de code la
veille de la rédaction de ce guide. Les chiffres bougent : gh api repos/Panniantong/Agent-Reach te donne l'état du jour.
Avant de commencer
- Claude Code installé et fonctionnel
- Python 3 avec `pipx`, ou de quoi créer un environnement virtuel
- Un navigateur Chrome, pour les plateformes qui demandent une connexion
1Installer, sans donner les clés de la maison
La méthode annoncée un peu partout consiste à coller une URL dans l'agent et à le laisser faire. Ça marche, mais tu peux aussi installer toi-même et savoir exactement ce qui se passe :
pipx install https://github.com/Panniantong/agent-reach/archive/main.zip
agent-reach install --env=auto
Par défaut, install ne modifie rien : il inspecte la machine et liste les
dépendances manquantes. C'est le drapeau --system qui autorise les
installations et les écritures de configuration au niveau système.
Le drapeau qui mérite ton attention
Ne passe --system qu'après avoir lu ce que la commande précédente a listé.
C'est la documentation officielle elle-même qui pose cette limite : lecture
seule par défaut, changements système uniquement sur accord explicite. Un
agent à qui tu dis « installe et débloque tout » franchira cette limite sans
te demander.
Si ton Python vient de Homebrew et que tu tombes sur une erreur
externally-managed-environment, passe par un environnement virtuel dédié
plutôt que de forcer l'installation globale.
Tout ce qu'Agent Reach installe vit dans ~/.agent-reach/. Rien n'est écrit
dans ton projet, ce qui évite de polluer un dépôt avec des dépôts clonés.
2Vérifier ce qui est prêt
Avant de formuler une demande, regarde ce qui répond réellement :
agent-reach doctor --json
Tu obtiens, plateforme par plateforme, le service qui la sert et son état. C'est la commande à relancer chaque fois qu'une recherche échoue : le plus souvent, le problème n'est pas ta demande mais un outil en amont qui n'est pas installé ou une session expirée.
3Premier essai sur une plateforme ouverte
YouTube fonctionne sans configuration. C'est le bon test :
Avec Agent Reach, trouve les cinq videos YouTube les plus vues sur [TON SUJET]
et resume ce qui revient dans chacune. Donne l'URL et la date de chaque video.
Demander les URL et les dates n'est pas cosmétique : ça te permet de vérifier que le résultat vient bien d'une recherche et non d'une reconstitution de mémoire. Si l'agent te sort cinq vidéos sans lien, la recherche n'a pas eu lieu.
4Les plateformes fermées, et ce que ça implique
LinkedIn, Instagram, X et Reddit demandent une connexion. Le mécanisme habituel consiste à réutiliser la session de ton navigateur, déjà authentifiée.
Aide-moi a configurer LinkedIn dans Agent Reach, etape par etape.
Avant de le faire, deux choses valent d'être posées clairement.
C'est ton compte qui prend le risque. Réutiliser ta session revient à agir sous ton identité. Une cadence de requêtes anormale peut déclencher une limitation ou une suspension, et c'est ton compte, pas celui d'un service tiers, qui en fait les frais.
Les conditions d'utilisation ne disparaissent pas. LinkedIn, Instagram et X interdisent la collecte automatisée dans leurs conditions. Le fait qu'un outil rende la chose techniquement facile ne la rend pas contractuellement permise.
Des profils, ce sont des données personnelles
Collecter des profils pour prospecter fait de toi un responsable de traitement : base légale, information des personnes, durée de conservation, droit d'opposition. Le fichier de leads constitué en trois prompts est soumis aux mêmes règles qu'un fichier constitué à la main. Notre guide sur le RGPD détaille ce qu'il faut mettre en place ; ceci n'est pas un avis juridique.
Rien de tout ça n'interdit l'outil. Une veille sur ton propre secteur, la lecture de discussions publiques, l'analyse de contenus que tu as le droit de consulter : ce sont des usages ordinaires. C'est l'extraction massive de profils qui demande de savoir où tu mets les pieds.
5Garder le contexte au sec
Une recherche large ramène beaucoup de texte. Le réflexe qui vaut ici vaut partout ailleurs : demande une synthèse, pas la matière brute.
Avec Agent Reach, trouve les discussions Reddit les plus actives sur [SUJET]
ces 30 derniers jours. Rends-moi un tableau : titre, lien, nombre de
commentaires, et l'argument principal en une phrase. Pas le fil complet.
Sur un volume important, délègue la collecte à un sous-agent et ne fais remonter que le tableau. Tu paies alors la synthèse, pas les milliers de commentaires lus pour l'établir.
Quand ça ne marche pas
| Symptôme | Première chose à regarder |
|---|---|
| Une plateforme ne répond plus | agent-reach doctor --json : session expirée ou outil en amont cassé |
| L'installation échoue sur Python | Erreur externally-managed-environment, passe par un environnement virtuel |
| Résultats sans lien ni date | La recherche n'a pas eu lieu, l'agent a répondu de mémoire. Redemande en exigeant les URL |
| Le compte est limité | Cadence trop élevée. Espace les requêtes, ne relance pas en boucle |
Quelques prompts pour aller plus loin
| Objectif | Prompt à adapter |
|---|---|
| Veille sectorielle | Avec Agent Reach, trouve ce qui s'est dit sur [SUJET] ces 7 derniers jours sur Reddit et X. Un tableau : source, lien, date, idee principale. |
| Analyse de contenu | Avec Agent Reach, analyse les 10 dernieres videos de [CHAINE YOUTUBE] et identifie les formats et sujets qui reviennent. |
| Étude de la concurrence | Avec Agent Reach, releve les publications publiques de [ENTREPRISE] du dernier trimestre et resume les themes, sans copier les textes. |
| Vérifier une affirmation | Avec Agent Reach, cherche des sources primaires sur [AFFIRMATION]. Si tu n'en trouves pas, dis-le au lieu de conclure. |
| Diagnostiquer | Lance agent-reach doctor --json et explique-moi, plateforme par plateforme, ce qui est pret et ce qui manque. |
Tu as d’autres ressources comme ça ?
Ce que tu viens de lire est entièrement gratuit. Une nouvelle ressource part chaque semaine dans la newsletter : guides, modèles à copier et liens triés, sans compte à créer.
Me contacter
Une question, un projet, une envie de collaborer ? Écris-moi.
Cette page est en accès libre, n’hésite pas à la partager.