Agent Reach
为命令行 AI 助手配置并诊断多平台互联网访问。
- Star 数
- ★ 109k
- 最近更新
- 1 天前
- License
- MIT
- 主语言
- Python
- FA 评分
- 62/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Claude Code
- 费用
- 免费，无需付费服务
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 使用 Claude Code 的开发者想快速阅读 GitHub 公开仓库、搜索仓库内容，并在登录后处理私有仓库、Issue、PR 或 Fork。
- 不适合
- 需要完全离线、不依赖外部平台登录态的团队
- 不愿使用小号或承担账号封禁风险的用户
- 只想调用统一阅读 API、不想自己装上游工具的开发者
- 源码审查
- 62/100 · 存在缺口
这个 Agent 能做什么，适合哪些场景？
Agent Reach 是一个 Python 3.10+ 的命令行能力层，用于为可执行 shell 命令的 AI 助手安装、配置和诊断互联网访问工具。它不封装各平台的数据读取，而是通过 channels 中的有序后端选择可用路径，并让 Agent 直接调用上游命令或服务。README 列出的渠道包括网页、YouTube、RSS、GitHub、X、Reddit、B 站、小红书、Facebook、Instagram、LinkedIn、V2EX、雪球和全网语义搜索。安装流程可配置 Exa MCP、注册 SKILL.md，并以 agent-reach doctor 检测各渠道当前可用的后端与修复建议。它适合希望把多种公开网页、视频字幕、代码仓库和部分需登录社交平台接入同一命令行 Agent 环境的用户。
执行 agent-reach install 时，项目会安装 agent-reach CLI，并检测或安装 Node.js、gh CLI 和 mcporter；README 还说明它会通过 mcporter 接入无需 API Key 的 Exa MCP，并为 Agent 的 skills 目录注册 SKILL.md。channels/web.py 使用 Jina Reader 读取网页，youtube.py 使用 yt-dlp 提取字幕，rss.py 使用 feedparser 解析 RSS/Atom，github.py 使用 gh CLI 读取和搜索 GitHub。doctor 会按候选顺序真实探测渠道后端，例如 twitter-cli、OpenCLI、rdt-cli、bili-cli、xiaohongshu-mcp 和 linkedin-scraper-mcp，并报告当前选中的后端或修复处方。实际搜索、阅读和数据提取由 Agent 直接运行这些上游工具完成，而不是通过 Agent Reach 的统一数据 API 返回。
- 使用 Claude Code 的开发者想快速阅读 GitHub 公开仓库、搜索仓库内容，并在登录后处理私有仓库、Issue、PR 或 Fork。
- 研究人员需要提取 YouTube 视频字幕、搜索视频，或用 Jina Reader 将普通网页转换为可读内容。
- 运营人员需要在已配置登录态的桌面环境中搜索或阅读 X、Reddit、Facebook、Instagram 或小红书内容。
- 需要订阅 RSS/Atom 信息源的用户，可让 Agent 使用 feedparser 读取源内容。
- 在本地开发机或服务器上部署命令行 Agent 的团队，需要通过 agent-reach doctor 检查每个互联网渠道的可用性和后端选择。
如何安装或部署这个 Agent？
运行环境为 Python 3.10+，并且你的 Agent 必须具备执行 shell 命令的权限。可执行：agent-reach install --env=auto。安全模式使用：agent-reach install --env=auto --safe；预览操作使用：agent-reach install --env=auto --dry-run。README 也提供了把“帮我安装 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md”交给 Claude Code、OpenClaw、Cursor 等 Agent 的安装方式。OpenClaw 用户需先启用 exec 权限，例如执行 openclaw config set tools.profile "coding"，重启 Gateway 后开启新对话。
如何使用这个 Agent？
安装后先运行 agent-reach doctor，查看各渠道的可用状态、当前后端和修复建议。无需额外配置即可使用 Jina Reader 读网页、yt-dlp 提取 YouTube 字幕、bili search 搜索 B 站、gh repo view owner/repo 查看公开 GitHub 仓库，以及 feedparser 读取 RSS。需要登录的平台可直接要求 Agent“帮我配 Twitter”“帮我配 Reddit”或“帮我配小红书”。X 的 Cookie 需要用户通过 Cookie-Editor 手工导出；直接调用上游 twitter 命令时，还必须在当前进程显式设置 TWITTER_AUTH_TOKEN 和 TWITTER_CT0。
这个 Agent 有哪些优点和局限？
- 将渠道的首选与备选后端组织为有序路由，并通过 agent-reach doctor 实际探测候选后端，而非仅检查命令是否存在。
- 把网页阅读、YouTube 字幕、RSS、GitHub 与 Exa 语义搜索纳入同一套命令行 Agent 安装与诊断流程。
- 对多个需要登录态的平台明确区分桌面 Chrome 会话、Cookie-Editor 导出 Cookie 和服务器场景的后端路径。
- 它是能力层而非统一读取 API；Agent 仍需直接调用 Jina Reader、gh、yt-dlp、OpenCLI 等上游工具。
- X、Reddit、小红书、Facebook 和 Instagram 等能力依赖用户登录态或 Cookie，且 README 提醒脚本/API 调用存在账号受限或封禁风险。
- 安装可能涉及 Python、Node.js、gh CLI、mcporter 和各渠道上游工具；服务器环境还可能需要代理。
- 部分渠道没有零配置路径，例如 README 明确说明 Reddit 的匿名接口已被封，必须使用登录态路线。
这个 Agent 与同类方案有什么区别？
与直接分别安装 Jina Reader、yt-dlp、gh CLI、feedparser、twitter-cli 或 OpenCLI 相比，Agent Reach 的定位是管理这些上游工具的选型、安装、健康检查和渠道后端切换；它不替代这些工具执行底层读取。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Agent Reach 当前 | 62 · 存在缺口 | 命令行工具免费 | ★ 109k | 1 天前 | Python | Claude Code |
| CompozyOS | 52 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 2.8k | 1 天前 | Go | ChatGPT · Codex · Claude Code |
| AI 原生搜索中枢 | 24 · 缺口较多 | 命令行工具免费 | ★ 1.3k | 6 个月前 | Python | Codex · Claude Code |
| OWL 多智能体自动化 | 39 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 20k | 4 天前 | Python | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示默认安装不修改系统，需显式--system；Cookie本地存储且权限600；有dry-run和uninstall。但依赖安全仅声明开源，未提供依赖审计或锁定版本；外部效果有封号风险提示但未提供缓解措施。
文档与测试一致，渠道注册有契约测试；但依赖可用性依赖外部工具（如yt-dlp、bili-cli），未提供版本锁定或镜像；失败消息有doctor诊断，但未提供具体错误处理示例。
面向多种Agent和平台，场景明确；能力边界清晰（零配置vs需配置）；触发词明确（安装/更新/配置）；环境适配有本地/服务器区分，但未提供Windows/macOS详细说明。
信息架构清晰，有README、docs、guides；安装说明详细；命名稳定（agent-reach）；有示例和FAQ；已知限制有说明；MIT许可证；版本号存在但无changelog；维护责任有声明但未提供贡献指南。
输出可用性高，提供结构化结果；边际价值高，解决Agent访问互联网痛点；成本效益好，免费开源，但依赖外部服务可能产生费用。
声明有测试支撑，但未提供测试结果；跨源验证不足，仅依赖单一仓库；事实与推断分离，文档区分了当前选型和设计理念。
- 依赖外部工具（yt-dlp、bili-cli等）可能失效，需定期更新；
- Cookie使用存在封号风险，建议使用小号；
- 未提供依赖版本锁定，供应链安全需关注。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
中文： - 全网搜索、Reddit、小红书、B站在 1.6.0 里会出现的几种"明明能查却报错"或"显示成功但内容是空的"，这版都修好了。 - 电脑上别的软件占用了浏览器端口时，可以换一个端口，不用关掉那个软件。 - 复制登录失败时会如实告诉你，不再假装成功。 - Windows 上小红书带特殊符号的链接能正常打开了。 English: - Several 1.6.0 cases where web search, Reddit, Xiaohongshu or Bilibili failed although the content was reachable, or reported success with empty content, are fixed. - When another program on your computer uses the browser port, Agent Reach can use a different one; you don't have to close that program. - A login copy that fails now says so instead of reporting success. …在 GitHub 查看 ↗ -
发布说明摘录
中文： - 从旧版升级：把"帮我更新 Agent Reach"那句话发给你的 AI 就行。你的密钥和设置都保留，旧版程序会自动删掉。 - 加一个平台只要说一句，需要的软件都会自动装好，不需要管理员密码；你只需要登录或者填一个 Key。 - 小红书、推特这类要登录的平台，改用 Agent Reach 自己的专用浏览器，不弹窗、不占用你的浏览器；多个 AI 可以同时查。 - RSS 订阅和 Exa 全网搜索合并进了"网页"。以后有新版本，AI 会用大白话告诉你改了什么，你同意了才更新。 English: - Upgrading from an older version: just send your AI the "update Agent Reach" sentence. Your keys and settings are kept, and the old program is removed for you. - Adding a platform takes one sentence. Everything it needs is installed for you, with no admin password; you only log in or enter a key. …在 GitHub 查看 ↗ -
v1.5.0 v1.5.0 — 能力层:多后端路由 + 真体检 + OpenCLI
发布说明摘录
这一版是什么 Agent Reach 从「工具集合」升级为「能力层」:每个平台 = 首选 + 备选的有序后端列表,当下最稳的接入方式替你实测选好、装好、体检好——接入方式换代,你无感。本版全部选型基于 2026-06 真机实测(32 项端到端测试)。 平台路由变化 | 平台 | 现在的路 | |------|---------| | 小红书 | OpenCLI(桌面,复用浏览器登录态零配置)▸ xiaohongshu-mcp(服务器,扫码)▸ xhs-cli(存量备选,上游已停更) | | Reddit | OpenCLI ▸ rdt-cli。诚实口径:Reddit 没有零配置路径(匿名接口已被全面封锁、官方 API 审批制),必须登录态 | | B站 | bili-cli(搜索/热门/详情,无需登录)▸ OpenCLI(字幕)▸ 搜索 API 兜底。yt-dlp 退出 B站(被 412 风控全面拦截,实测最新版+代理+Cookie 均无效);yt-dlp 继续服务 YouTube | | Twitter | twitter-cli 守门(实测稳定)▸ OpenCLI 备选,探测加重试 | doctor 成了真体检 …在 GitHub 查看 ↗