Agent Reach : donner internet à un agent IA, en open source

Agent Reach est un outil open source en Python qui permet à un agent IA de lire et de chercher sur le web : pages, YouTube, Reddit, Twitter/X, GitHub, Bilibili, flux RSS. Il ne lit pas lui-même : il choisit les outils qui s’en chargent, les installe et vérifie qu’ils fonctionnent. Tu donnes à ton agent le lien du guide d’installation, et il s’occupe du reste.

En bref

Web, YouTube (sous-titres), RSS, GitHub public : utilisables sans configuration
Twitter/X, Reddit, Facebook, Instagram : il faut connecter un compte
agent-reach doctor teste vraiment chaque outil et indique comment réparer
Licence MIT, outils et API gratuits selon le README
Installation en lecture seule par défaut, modifications du système sur accord

Ce que fait Agent Reach pour un agent IA

Un agent IA est un assistant appuyé sur un modèle de langage et capable de lancer des commandes sur ton ordinateur. Il écrit du code sans difficulté, mais dès que tu lui demandes de lire le web, les obstacles s’accumulent. Le README les énumère : sous-titres YouTube introuvables, API Twitter payante, Reddit qui répond par une erreur 403 depuis une adresse de serveur, Xiaohongshu qui exige une connexion, Bilibili qui bloque les outils de téléchargement génériques.

Agent Reach, publié par Panniantong sous licence MIT, répond à ce problème en choisissant à ta place les outils adaptés à chaque plateforme. Selon le README, tous les outils sont open source et toutes les API utilisées sont gratuites. Le seul coût possible est un proxy de serveur, environ 1 dollar par mois, inutile sur un ordinateur personnel.

Comment fonctionne Agent Reach

Le projet se décrit comme une couche de capacités : il s’occupe de la sélection, de l’installation, du contrôle et de l’aiguillage des outils, pas de la lecture elle-même. Celle-ci reste confiée à l’agent, qui appelle directement les outils d’origine, sans couche d’emballage entre les deux. L’agent apprend quelle commande lancer en lisant un fichier SKILL.md que l’installation range dans son dossier de compétences.

Chaque plateforme dispose d’une liste ordonnée d’outils : un premier choix, puis des solutions de repli. Pour Twitter, l’ordre est twitter-cli, puis OpenCLI, puis bird. Pour Bilibili, c’est bili-cli, puis OpenCLI, puis une API de recherche. Si un outil cesse de marcher, le projet change l’ordre de la liste au lieu de réécrire du code, et tu n’as rien à faire. Le README cite un cas de juin 2026 : yt-dlp s’est fait bloquer par Bilibili et a été remplacé par bili-cli.

Les sites que ton agent peut lire

Une partie des plateformes fonctionne dès l’installation, sans compte ni clé :

D’autres demandent une connexion. Twitter/X permet de lire un tweet isolé tout de suite, mais la recherche et la lecture de la timeline passent par des cookies. Reddit n’a aucune voie sans configuration : l’interface anonyme est bloquée et l’API officielle passe par une validation. Facebook, Instagram et Xiaohongshu reposent sur OpenCLI, qui réutilise la session de ton navigateur Chrome. LinkedIn est lisible en partie via Jina Reader, le reste demande un serveur MCP dédié.

Pages web, lues avec Jina Reader pour éviter la soupe de balises HTML
YouTube : extraction des sous-titres et recherche de vidéos avec yt-dlp
RSS et Atom, lus avec feedparser
GitHub : dépôts publics et recherche, avec l’outil officiel gh
Recherche web par sens avec Exa, branchée automatiquement par MCP, sans clé
Bilibili (recherche et détail des vidéos, sans connexion) et V2EX

curl https://r.jina.ai/URL
gh repo view owner/repo

Installer Agent Reach

La méthode prévue est de copier une phrase dans ton agent (Claude Code, Cursor, OpenClaw ou un autre). Le README la donne en chinois, avec le lien vers le guide d’installation : l’agent lit le guide et exécute les étapes.

Pour installer à la main, il faut Python 3.10 ou plus. Le projet recommande pipx, ou un environnement virtuel si ton Python signale externally-managed-environment. Attention : le paquet du même nom sur PyPI n’est pas ce projet. La commande agent-reach install se contente de vérifier ta machine. Les installations système n’ont lieu qu’avec --system, après ton accord, et --dry-run montre ce qui serait fait.

帮我安装 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
pipx install https://github.com/Panniantong/agent-reach/archive/main.zip
agent-reach install --env=auto
agent-reach install --env=auto --dry-run
agent-reach install --env=auto --system

Vérifier ses outils avec agent-reach doctor

La commande agent-reach doctor donne l’état de chaque plateforme, indique quelle voie est utilisée et propose un remède quand quelque chose ne va pas. Depuis la version 1.5.0, elle exécute réellement les commandes au lieu de vérifier qu’un fichier existe. Elle repère donc un outil installé mais cassé, par exemple un environnement virtuel dont le lien se rompt après une mise à jour de Python, et fournit une commande de réinstallation à copier.

Le rapport nomme, pour chaque plateforme à plusieurs outils, celui qui est actif. agent-reach doctor --json en donne une version lisible par une machine, avec le champ active_backend. Un canal en panne ne bloque plus le diagnostic des autres.

Où en est le projet

Au 6 octobre 2026, le dépôt GitHub compte 92 405 étoiles, 8 105 copies (forks), 36 contributeurs et 213 tickets et demandes de fusion ouverts. Il a été créé le 24 février 2026, son code a été modifié pour la dernière fois le 15 septembre 2026 et la dernière version publiée est la v1.5.0, du 11 juin 2026.

Les notes de version récentes donnent le rythme des changements :

v1.5.0 (11 juin 2026) : passage au routage par liste d’outils, doctor qui teste vraiment, ajout d’OpenCLI pour les ordinateurs de bureau
v1.4.2 (10 juin 2026) : retrait de Douyin, Weibo et des comptes WeChat, jugés inutilisables, et ajout de agent-reach transcribe, qui transcrit l’audio avec Whisper pour les vidéos sans sous-titres
v1.4.2 : sortie JSON pour doctor et correction de caractères illisibles sous Windows
v1.4.1 (10 juin 2026) : correction d’un échec d’installation depuis les sources, dû à un fichier empaqueté en double

Avant de se lancer : comptes, cookies et limites

Les cookies et jetons restent sur ta machine, dans le dossier ~/.agent-reach/, et ne sont pas envoyés ailleurs, selon le README. Il recommande pourtant d’utiliser un compte secondaire pour Twitter, Xiaohongshu, Reddit, Facebook ou Instagram : les plateformes peuvent détecter des appels automatisés et restreindre le compte, et un cookie donne un accès complet s’il fuit. Pour Twitter, les cookies enregistrés ne servent qu’au diagnostic de doctor : avant de lancer la commande twitter, il faut définir les variables d’environnement dans le processus.

Quelques limites sont précisées. OpenCLI demande un ordinateur de bureau avec Chrome et est ignoré sur un serveur. La recherche Instagram porte sur les utilisateurs, pas sur les publications. Reddit demande un proxy depuis la Chine continentale. Sous OpenClaw, l’agent doit avoir le droit d’exécuter des commandes, ce que règle tools.profile. Le README est surtout rédigé en chinois, avec des versions en anglais, japonais et coréen. Le projet ne donne pas de configuration matérielle minimale.

export TWITTER_AUTH_TOKEN="..."
export TWITTER_CT0="..."
twitter search "query" -n 10

Quelques repères

Ligne de commande : Manière de piloter un logiciel en tapant des instructions écrites dans un terminal, plutôt qu’en cliquant dans une fenêtre.
Cookie : Petit fichier que le navigateur conserve après une connexion à un site. Qui le détient peut se faire passer pour la personne connectée, d’où l’intérêt de le protéger.
MCP : Protocole ouvert qui permet à un agent IA de se brancher à des outils et à des services externes de façon standardisée.

Questions fréquentes

Agent Reach est-il gratuit ?

Oui. Selon le README, tous les outils sont open source, les API utilisées sont gratuites et le projet est sous licence MIT. Le seul coût possible est un proxy de serveur, environ 1 dollar par mois, inutile sur un ordinateur personnel.

Agent Reach permet-il de lire Reddit sans compte ?

Non. Le projet indique que Reddit n’a pas de voie sans configuration : l’interface anonyme est bloquée et l’API officielle passe par une validation. Il faut une session de navigateur via OpenCLI sur un ordinateur de bureau, ou rdt-cli avec un cookie.

Comment extraire les sous-titres YouTube avec Agent Reach ?

Sans aucune configuration, l’agent utilise yt-dlp pour extraire les sous-titres et chercher des vidéos. Pour une vidéo sans sous-titres, agent-reach transcribe transcrit l’audio avec Whisper, avec une clé Groq gratuite.

Agent Reach fonctionne-t-il avec Claude Code ou Cursor ?

Oui. Le README cite Claude Code, OpenClaw, Cursor et Windsurf, et indique que tout agent capable de lancer des commandes peut l’utiliser.

À retenir

Agent Reach ne lit pas le web lui-même : il choisit, installe et contrôle les outils que ton agent IA appelle pour lire Twitter, Reddit, YouTube, GitHub ou des flux RSS. Certaines plateformes marchent dès l’installation, d’autres demandent une connexion, et le README conseille un compte secondaire dans ce cas.