Agent Reach 实战指南给 AI Agent 接上全网访问的“能力层”——渠道注册、后端排序回退与 doctor 体检机制解析【免费下载链接】Agent-ReachGive your AI agent eyes to see the entire internet. Read search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.项目地址: https://gitcode.com/GitHub_Trending/ag/Agent-ReachAgent Reach 是 Panniantong 开源的 Python CLI 工具定位为 AI Agent 的“全网访问能力层”它不直接替你读平台内容而是负责为 Twitter/X、Reddit、YouTube、GitHub、Bilibili、XiaoHongShu 等每个平台选择、安装并健康检查最可靠的访问路径。读完本文你将理解它的渠道注册Channel Registry与“主后端 回退列表”路由机制、agent-reach install / doctor / configure的完整用法并能从 渠道基类、探测模块 的源码层面弄清“后端断链时为什么你不需要改一行代码”。一、要解决的问题最值钱的信息都在高门槛平台Agent Reach 要解决的核心矛盾是AI Agent 早已“能上网”但信息密度最高的平台恰好壁垒最高。官方英文 READMEdocs/README_en.md给出的痛点表如下痛点现实情况Twitter API按量付费中等用量约 $215/月Reddit服务器 IP 直接 403XiaoHongShu必须登录才能浏览Bilibili屏蔽海外/服务器 IP如果把这些平台一一接上你需要逐个找工具、装依赖、调配置。Agent Reach 把这件事压缩成一条命令交给 Agent 执行安装完成后 Agent 可以直接读推文、搜 Reddit、看 B站。项目免费、开源MITCookies 只保存在本地不上传唯一的可选开销是受限网络下的 $1/月 代理本地电脑通常不需要。二、安装与快速开始推荐方式让 Agent 替你装把下面这句话复制给你的 AI AgentClaude Code、OpenClaw、Cursor 等即可Install Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.mdAgent 会读取 安装指南、安装 Python 包、检查环境并报告“哪些渠道已就绪”。已安装过的用户可以用同样的一行更新指令触发 更新流程。注意OpenClaw 用户需先开启exec权限否则 Agent 无法执行pip install、mcporter等 shell 命令openclaw config set tools.profile coding或在~/.openclaw/openclaw.json中设置tools: { profile: coding }改完重启 Gatewayopenclaw gateway restart并开新会话。Claude Code、Cursor、Windsurf 等平台不受影响。安全默认install 默认只读检查从源码看agent-reach install默认运行在safe只读模式——只检查机器、列出缺失依赖不安装系统包、不写配置见 CLI 入口 中_cmd_install的safe_mode逻辑safe_mode args.safe or not args.system。只有显式加--system才会真正执行系统级变更agent-reach install --envauto # 只读检查默认安全 agent-reach install --envauto --system # 明确批准后安装/配置核心外部工具 agent-reach install --envauto --safe # 与默认行为等价的兼容别名 agent-reach install --envauto --dry-run # 预览 --system 将做什么--env支持local/server/auto自动探测--channels用于挑选可选渠道逗号分隔twitter, xiaoyuzhou, xueqiu, xiaohongshu, reddit, facebook, instagram, bilibili, linkedin, all。手动安装# 从主分支源码包安装完整命令见 docs/install.md然后 agent-reach install --envautodocs/install.md 还覆盖了pipx、Homebrew/PEP 668 虚拟环境、Windows Storepython3别名改用py -3等边界情况的处理。以 Skill 形式安装支持 Skills 的 AgentClaude Code / OpenClaw 等可以直接npx skills add Panniantong/Agent-Reachagent-reachSkill 安装后Agent 会自动检测agent-reachCLI 是否可用缺了就装。从 _install_skill 实现看SKILL.md 会被写入已存在的 Agent skill 目录~/.claude/skills、~/.openclaw/skills、~/.config/opencode/skills、~/.agents/skills等。默认中文技能文件为 SKILL.md设置英文 locale 或导出AGENT_REACH_LANGen后安装则写入 SKILL_en.md 的内容文件名始终为SKILL.md。三、支持的平台与 Setup 等级官方平台矩阵继承自 docs/README_en.md平台能力Setup说明Web读取零配置任意 URL → 干净 MarkdownJina ReaderTwitter/X读取 · 搜索CookieCookie 解锁搜索、时间线、推文、文章twitter-cliXiaoHongShu读取 · 搜索 · 评论OpenCLI / MCPOpenCLI 只复用用户已有且明确控制的 Chrome 会话MCP/存量工具用手工 Cookie-Editor 导出Facebook搜索 · 主页 · Feed · 群组列表OpenCLI仅桌面复用已登录的 Chrome 会话Instagram用户搜索 · 主页 · 最近帖子 · ExploreOpenCLI仅桌面LinkedInJina Reader公开页Profile/公司/职位搜索告诉 Agent “help me set up LinkedIn”V2EX热帖 · 节点帖 · 详情回复 · 用户主页零配置公开 JSON API无需鉴权Xueqiu雪球行情 · 搜索 · 热帖 · 热股浏览器 Cookie告诉 Agent “help me set up Xueqiu”Xiaoyuzhou Podcast转录免费 API Key播客音频 → Groq Whisper 免费转文字Web Search搜索安装时自动配置免费、无 API KeyExa via mcporterGitHub读取 · 搜索零配置gh CLI 驱动公开仓库立即可用gh auth login解锁 Fork/Issue/PRYouTube读取 · 搜索零配置字幕 跨 1800 视频站点搜索yt-dlpBilibili读取 · 搜索零配置bili-cli 搜索详情免登录字幕走 OpenCLI。yt-dlp 已被 B站 412 封锁不再用于此RSS读取零配置任意 RSS/Atom 源feedparserReddit搜索 · 读取OpenCLI / Cookie无零配置路径匿名接口被封桌面走 OpenCLI或 rdt-cli cookieSetup 等级含义Zero config 装完即用Auto-configured 安装时自动处理Cookie 从浏览器导出Proxy $1/月。四、装完即用Agent 直接调用上游工具核心理念是“没有 wrapper 层”Agent 读 SKILL.md 后直接调用上游 CLI无需记忆命令。开箱即用的典型用法“读这个链接” →curl -s https://r.jina.ai/URL读任意网页“这个 GitHub 仓库讲什么” →gh repo view owner/repo“这个视频讲了什么” →yt-dlp --dump-json URL取字幕“读这条推文” → 设置TWITTER_AUTH_TOKEN/TWITTER_CT0后运行twitter tweet URL“搜 GitHub 上的 LLM 框架” →gh search repos LLM framework“订阅这个 RSS” → feedparser 解析从源码结构看这条链路确实没有被 Agent Reach 包装例如 WebChannel 的read()只是拼出https://r.jina.ai/{url}的请求并做反爬页识别而can_handle()恒返回 True作为“任何 URL 都能兜底”的最后一条渠道。五、设计哲学每个平台 一份有序后端列表官方表述是“Agent Reach is a capability layer, not yet another tool.” 它比具体实现高一层负责选择、安装、健康检查、路由真正的读取由 Agent 直接调上游工具完成。访问路径会生灭2026 年 3 月一批单平台 CLI 停更项目重新路由6 月 B站 412 封锁 yt-dlp切换到 bili-cli而你只需重排列表不改代码。5.1 渠道基类backends 就是路由表agent_reach/channels/base.py 中的Channel抽象类定义了路由语义见 L29-L59backends: List[str]有序候选列表backends[0]是首选后端其余为回退“切换后端” 重排这个列表tier: int0 零配置1 需要免费 Key2 需要较复杂 Setupactive_backendcheck()必须设置为当前真正在服务的后端找不到可用后端则为 Noneordered_backends(config)支持用户覆盖——配置键channel_backend或环境变量CHANNEL_BACKEND会把指定后端提到列表最前未知值直接忽略防止一个过期的 override 把可用的后端全部藏住。所有渠道在 agent_reach/channels/__init__.py 的ALL_CHANNELS注册表中集中登记GitHub、Twitter、YouTube、Reddit、Facebook、Instagram、Bilibili、XiaoHongShu、LinkedIn、Xiaoyuzhou、V2EX、Xueqiu、RSS、Exa Search、Webdoctor的体检就是遍历这个注册表。README 中给出的目录映射与之一致channels/ ├── web.py → Jina Reader ├── twitter.py → twitter-cli ▸ OpenCLI ▸ bird ├── youtube.py → yt-dlp ├── github.py → gh CLI ├── bilibili.py → bili-cli ▸ OpenCLI ▸ search API (yt-dlp retired, 412-blocked) ├── reddit.py → OpenCLI ▸ rdt-cli (no zero-config path, login required) ├── facebook.py → OpenCLI (desktop browser session) ├── instagram.py → OpenCLI (desktop browser session) ├── xiaohongshu.py → OpenCLI ▸ xiaohongshu-mcp ▸ xhs-cli ├── linkedin.py → linkedin-mcp ▸ Jina Reader ├── rss.py → feedparser ├── exa_search.py → Exa via mcporter └── __init__.py → Channel registry (for doctor checks)5.2 真实探测which()不算健康shutil.which()只能证明“命令在 PATH 上”不能证明它能跑——最常见的坑是系统 Python 升级后 pipx/uv 留下的 stale venv shimwhich 能找到执行即 FileNotFoundError。agent_reach/probe.py 的probe_command()真正执行cmd --version这类无副作用命令并把结果分类为missing / broken / timeout / error / okbroken还会附带重装处方uv tool install --force pkg或pipx reinstall pkg。各渠道的check()都遵循两段式先收集全部候选的状态第一个ok获胜没有ok才轮到第一个warn——避免“装了但未登录”的弱候选把后面完整可用的回退后端挡在门外。5.3 案例Bilibili 的 412 事件如何被“重排列表”消化BilibiliChannel 的模块 docstringL1-L10记录了真实切换过程2026-06 实测 B站风控对 yt-dlp 的所有请求配置最新版、直连、代理、预热 Cookie一律 412 封锁而 bili-cli 保持可用、OpenCLI 覆盖字幕于是backends [bili-cli, OpenCLI, B站搜索 API]yt-dlp 从该渠道彻底退役它仍是 YouTube 后端。check()中还保留了一个细节即使某个候选断链、其他候选兜底成功doctor 报告也会把[备选后端异常]的处方一并带出来。零依赖的最后一道兜底是直连 B站搜索 API仅搜索能力。5.4 案例Twitter 的凭据边界TwitterChannel 的check()只检查显式凭据是否存在绝不执行上游twitter status——因为上游在凭据缺失或无效时会自动回退读取浏览器 Cookie执行它就违反了“Cookie-Editor 手工导出”策略见 L83-L109 注释。twitter_cli_child_env()则把保存在配置中的twitter_auth_token/twitter_ct0以“子进程环境变量”的形式注入单次调用绝不改动os.environ。这与 doctor 输出 中的措辞一致“doctor checks only that explicit credentials exist; direct CLI still needs its environment variables”。六、agent-reach doctor一次命令看全所有渠道README 中的官方示例输出英文界面$ agent-reach doctor ️ Agent Reach Status ✅ Ready to use: ✅ GitHub repos and code — public repos readable and searchable ✅ YouTube video subtitles — yt-dlp ✅ Bilibili search video detail — bili-cli (subtitles via OpenCLI) ✅ RSS/Atom feeds — feedparser ✅ Web pages (any URL) — Jina Reader API Search (free Exa key to unlock): ⬜ Web semantic search — sign up at exa.ai for free key Configurable: ⚠️ Twitter/X — doctor checks only that explicit credentials exist; direct CLI still needs its environment variables ⬜ Reddit posts and comments — needs login: rdt-cli after rdt login, or OpenCLI browser session ⬜ XiaoHongShu notes — OpenCLI needs an existing user-controlled session; otherwise use Cookie-Editor with MCP/legacy tools ⬜ Facebook / Instagram — desktop: OpenCLI browser session Status: 6/9 channels available实现层面agent_reach/doctor.pycheck_all(config)遍历ALL_CHANNELS逐个调用ch.check(config)单个渠道抛异常只降级为该渠道statuserror绝不拖垮整份报告L23-L32 有明确注释渠道是注册表单例出错时还要清掉上一轮残留的active_backend所有消息包括上游探测回显的 URL在渲染前统一经过scrub_url_credentials()脱敏防止配置里的代理口令泄漏进报告format_report()按 tier 分组tier 0 归入“装好即用”tier 1/2 归入“可选渠道”并对每个多后端渠道标注当前后端xxx附--json输出机器可读结果配合active_backend字段即可程序化确认“某平台当前真正走的是哪个后端”非 Windows 下还会顺带检查~/.agent-reach/config.yaml的权限位Cookie 文件的私有性。除 doctor 外CLI 还提供agent-reach watch健康检查 更新检查适合放进定时任务与agent-reach check-update检查新版本完整子命令表install/configure/uninstall/skill/format/transcribe 等可直接运行agent-reach --help或在 cli.py 中查看。七、当前工具选型Primary / Fallback 对照表以下为官方维护的当前选型定期在真机上复验路径失效时切换到下一位agent-reach doctor会告诉你当前生效的是哪一个场景PrimaryFallback理由读网页Jina Reader—免费、免 API Key读推文twitter-cliOpenCLI实测搜索可靠OpenCLI 靠浏览器会话兜底RedditOpenCLI桌面rdt-cli匿名接口被封、官方 API 受限——登录态是最后的路FacebookOpenCLI桌面—Graph/Groups API 限制极严浏览器会话是务实路线InstagramOpenCLI桌面官方 Graph APIBusiness/Creator 审核Instaloader 类路径不稳定OpenCLI 复用真实浏览器会话YouTube 字幕 搜索yt-dlp—仍是 YouTube 最佳方案不再用于 B站Bilibilibili-cliOpenCLI ▸ 搜索 APIyt-dlp 被 B站 412 封锁2026-06 实测bili-cli 免登录可搜索/读取Web 搜索Exa via mcporter—AI 语义搜索MCP 集成免 API KeyGitHubgh CLI—官方工具登录后全 API读 RSSfeedparser—Python 生态标准XiaoHongShuOpenCLI桌面xiaohongshu-mcp服务器▸ xhs-cliOpenCLI 只用已有会话其他后端用手工 Cookie-Editor 导出LinkedInmcp-server-linkedinJina ReaderMCP server 浏览器自动化Xiaoyuzhou Podcasttranscribe.sh—bash ~/.agent-reach/tools/xiaoyuzhou/transcribe.sh URLmcporter 的接入配置模板随仓库提供于 config/mcporter.json。八、按需解锁Cookie 与代理都是可选项“不用就不配”每一步都是可选的。Cookies——免费约 2 分钟告诉 Agent “help me configure Twitter cookies”它会引导你走 Cookie-Editor 手工导出浏览器登录 → 装 Cookie-Editor 扩展 → Export → Header String → 发给 Agentagent-reach configure twitter-cookies # 隐藏输入保存凭据供 doctor 检查 agent-reach configure xhs-cookies # 仅保存 xiaohongshu.com 同域 Cookie非该域一律忽略边界很明确与源码一致Agent Reach从不替你登录、从不读取浏览器 Cookieconfigure xhs-cookies不会把 Cookie 注入 OpenCLI 或 Chrome。雪球、Bilibili 支持按平台显式导入例如agent-reach configure --from-browser chrome --platform xueqiu命令不会扫描或保存其他平台。代理——$1/月仅限受限网络多数用户不需要代理。如果网络封锁 Reddit/Twitter如中国大陆配一个住宅代理$1/月档并把地址交给 Agent 保存它调用这些工具时会自动导出HTTP(S)_PROXYagent-reach configure proxy # 隐藏输入保存Reddit 无论如何都需要登录态OpenCLI 复用浏览器会话或rdt login后的 rdt-clirdt-cli 需安装 cli.py 中_RDT_GIT_SOURCE钉定的 git 版本因为 PyPI 包落后Bilibili 走 bili-cli 则不需要代理。各平台解锁速查# Twitter凭据保存后直接调用仍需显式环境变量 export TWITTER_AUTH_TOKEN... export TWITTER_CT0... twitter search query -n 10 # Facebook / Instagram桌面 OpenCLI装完扩展并在 Chrome 登录后 opencli facebook search query -f yaml opencli facebook profile zuck -f yaml opencli instagram user nasa -f yaml # 小宇宙播客只需一个免费 Groq Key agent-reach configure groq-key bash ~/.agent-reach/tools/xiaoyuzhou/transcribe.sh https://www.xiaoyuzhoufm.com/episode/xxxxx # Web 搜索安装时自动配置的 Exa mcporter call exa.web_search_exa query... numResults5 # LinkedInmcp-server-linkedinstdio 方式 mcporter config add linkedin --command uvx --arg mcp-server-linkedinlatest --env UV_HTTP_TIMEOUT300 --scope homeFacebook Groups 当前只承诺“登录后可见的群组列表/最近动态”Instagram 的 search 是用户搜索而非全站关键词搜索——出现 429/登录错误时先重新登录 Chrome 并降频。九、安全边界与使用注意默认安全agent-reach install默认只读检查系统级安装/配置写入必须显式--system批准。docs/install.md 还为 Agent 划定了边界不用 sudo、不碰~/.agent-reach/之外的系统文件、不在工作区落盘配置与 token 全部位于~/.agent-reach/上游工具位于~/.agent-reach/tools/。凭据本地化Cookie 只存在本地配置文件中doctor 报告输出前会做 URL 凭据脱敏见 doctor.py 的scrub_url_credentials调用链。无代币/加密资产关联官方明确声明 Agent Reach 没有任何官方代币、币、投资产品、钱包连接或 Pump.fun/Solana 项目任何借用该项目名、GitHub 地址或作者身份声称收益的加密项目均与仓库无关切勿连接钱包或领取“费用”。建议为需要 Cookie 的平台使用小号/专用账号平台可能因非浏览器调用风控封号Cookie 泄露时小号也能限制影响面。十、延伸阅读想继续深入当前仓库建议按这个顺序看安装指南含 Windows/PEP 668/PEP 环境细节与 Agent 行为边界→ 排障手册 → 技能文件Agent 实际调用的完整命令参考另含 career/dev/finance/search/social/video/web 六类场景参考→ 路由与体检核心实现base.py、probe.py、doctor.py→ 行为验证tests/test_channel_contracts.py、tests/test_doctor.py、tests/test_opencli_backend.py 等测试可确认各渠道探测与回退约定。适用前提与限制功能行为以当前仓库代码为准Python 3.10OpenCLI 类后端仅限桌面环境服务器环境安装时会自动跳过 Facebook/Instagram/opencli 渠道Reddit 无零配置路径doctor不做实时平台命令验证因此 OpenCLI 桥接“已连接但未实测”时只给 warn 而不标 ok——以agent-reach doctor --json中的active_backend为当前生效后端的最终依据。【免费下载链接】Agent-ReachGive your AI agent eyes to see the entire internet. Read search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.项目地址: https://gitcode.com/GitHub_Trending/ag/Agent-Reach创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考