Mode d’emploi
- Copiez la commande et examinez le paquet avant de l’installer dans votre environnement agent.
- Consultez le document original pour les outils, identifiants et environnements requis.
- Décrivez les entrées et le livrable souhaité ; comparez la sortie aux sources.
npx skills add https://github.com/smartworldarafath/rea_skill --skill agent-reachAvant de commencer
- L’installation n’inclut ni abonnement au modèle, ni quota API, ni accès aux fichiers.
- Étoiles et installations reflètent l’activité, pas un test indépendant de qualité ou de sécurité.
Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.
Agent Reach
Give your AI agent eyes to see the entire internet. Read & search Twitter/X, Reddit, YouTube, GitHub, LinkedIn, Bilibili, and login-walled web platforms with one CLI and zero API fees.
Overview
One command for every platform: agent-reach. Read-only; returns structured JSON output.
agent-reach channels # List available channels, actions, and parameters
agent-reach <channel> <action> [args] # e.g. agent-reach github search "vulnerability scanner"
agent-reach read <url> # Automatically select channel and read any URL🔌 Supported Channels
| Tier | Channel | Capabilities | Source / Upstream Tools |
|---|---|---|---|
| Default | web | General webpage reading, content extraction, search fallback | Jina Reader, Exa |
| Default | youtube | Video transcripts, subtitles, audio speech-to-text | yt-dlp, whisper |
| Default | github | Repositories, files, issues, commit logs, pull requests | GitHub public APIs |
| Default | bilibili | Video details, subtitles, Danmaku comments | bili-cli, public endpoints |
| Default | v2ex | Topic reading, community discussions | V2EX public feeds |
| Optional | reddit | Subreddit search, threads, comment trees | Reddit json/RSS |
| Optional | linkedin | Posts, company profiles, job postings | OpenCLI / CloakBrowser |
| Optional | twitter / x | Tweets, search, user profiles | OpenCLI / CloakBrowser |
| Optional | xiaohongshu | Note descriptions, tags, comments | CloakBrowser session |
| Optional | boss | Developer job listings, skill demands | boss-agent-cli |
| Optional | xueqiu | Stock quotes, financial sentiment | Xueqiu public endpoints |
| Optional | xiaoyuzhou | Podcast transcripts, summaries | Groq Whisper API |
⚡ Integration with REA (Reverse Engineer Anything)
When combined with the REA suite:
- Threat & Vulnerability Research: When auditing a website or binary with REA, use Agent Reach to instantly look up CVEs, GitHub discussions, and security advisories without leaving your terminal:
agent-reach github search "package-name vulnerability CVE"
agent-reach reddit search "framework-name security breach"- Deep Web Reading: When a website or API blocks standard curl/fetch with Cloudflare or bot protection, use:
agent-reach read https://target-app.com/docs- Tutorial & Exploit Video Transcripts: Extract technical explanations directly from YouTube or Bilibili video transcripts without watching the video:
agent-reach youtube read "https://www.youtube.com/watch?v=..."🚀 Setup & Installation
Install Agent Reach with uv (recommended):
uv tool install https://github.com/Panniantong/Agent-Reach/archive/refs/tags/v1.6.0.zip
agent-reach setupTo manage channels and dependencies:
agent-reach add <channel> # Install dependencies for an optional channel
agent-reach remove <channel> # Remove an unused channel
agent-reach doctor --text # Check system dependencies and browser status
agent-reach check <channel> # Verify connectivity for a specific channel
agent-reach update # Upgrade Agent Reach and installed channel tools📊 Result Structure & Error Handling
Outputs are standard JSON with { ok, channel, action, backend, items, meta, error }:
- `ok: true`: Results found in
items(title,url,author,published_at,text,raw). - `ok: false`: Examine
error.code:
| error.code | Meaning | Action to Take |
|---|---|---|
NEED_SETUP | Dependency missing | Run agent-reach add <channel>. If key is needed, user runs agent-reach configure <key> |
NEED_LOGIN | Site requires login | User runs agent-reach login <channel> in their own window. (Never log in for them) |
UPSTREAM_BROKEN | Platform changed layout | Inform user; run agent-reach update if agreed |
TIMEOUT | Request timed out | Run agent-reach doctor --text; do not retry in an aggressive loop |
RATE_LIMITED | Platform rate limit | Wait retry_after_seconds specified in meta |
PLATFORM_BLOCKED | Captcha / Cloudflare wall | User opens official page to solve captcha |
NOT_FOUND | Content nonexistent | Check target URL or keyword |
🛡️ Security & Red Lines
- Read-Only: Agent Reach never posts, comments, likes, or sends messages.
- Credential Safety: Never logs in for the user; never asks for, captures, or logs passwords.
- Dedicated Profile: Browser sessions run inside an isolated profile under
~/.agent-reach/browser/profileand shut down after 10 idle minutes.