1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | Agent-Reach |
| 作者/维护者 | Panniantong（个人开发者，社区已有 36 位贡献者参与） |
| 来源链接 | https://github.com/Panniantong/Agent-Reach |
| 许可证 | MIT（GitHub API 确认） |
| GitHub Stars | 71,328（GitHub API） |
| Forks | 6,048（GitHub API） |
| 最新版本 | v1.5.0（GitHub Releases，主干代码持续更新，最近一次提交为近日） |
| 安装方式 | pipx / venv 安装 CLI，或直接把安装说明文档地址交给 Agent 自动安装 |
2. 功能介绍与亮点
Agent-Reach 让 Agent 具备“上网读信息”能力：覆盖 Twitter/X、Reddit、YouTube、GitHub、B 站、小红书、LinkedIn 等 15 个平台的搜索与内容读取，默认零 API 费用。
- 多后端自动路由：官方 API、专用 CLI、Cookie 直连、Jina Reader 兜底等取数方式，由
agent-reach doctor实时探测并自动切换。 - 零配置起步：6 个渠道开箱即用，仅登录态平台需用户自行提供 token/cookie。
- 权限边界清晰：不使用 sudo、不越权改系统文件、不写入 Agent 工作区，配置与凭据只落在独立目录。
- 提供中/英/日/韩四语文档，并有自动更新提醒机制。
3. 适用场景
固定分类：集成与工作流自动化
适合需要 Agent 主动“上网调研”的场景：查某话题在小红书/推特的口碑、搜 Reddit 上是否有人遇到过同样的报错、提取 YouTube/B 站视频字幕、检索 LinkedIn 职位、跨平台汇总资料做竞品分析。核心受益人群是希望 Agent 能自主上网查资料、又不想逐平台踩坑装工具的用户。
4. 跨 Agent 兼容性
- Claude Code：原生支持，官方文档列为可安装 Skill 的目标平台之一。
- OpenClaw：支持，但需先把工具权限档位切到
coding（开启exec）才能正常安装使用。 - Codex：文档未点名提及，仅笼统声明支持任何能执行命令的 Agent，未验证。
- Hermes Agent：文档未点名提及，未验证。
5. 推荐理由
Reddit 服务器 IP 常被 403、小红书需登录态、B 站拦截海外 IP、Twitter API 按量收费——多数 Agent“能联网”却读不动这些高信息密度平台。Agent-Reach 把各平台接入门槛一次性打包解决，一条指令即可自助安装与维护。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9 | 71,328 Stars、6,048 Forks；issue 区有 36 位贡献者与大量具体技术讨论，已被多个第三方 Skill 目录收录 |
| 可用性 | 9 | 一条指令即可自助安装；6 个渠道零配置；文档含中英日韩多语言与安装边界说明；近期持续有提交，维护活跃；核心功能无付费依赖 |
| 安全性 | 7 | 见下方安全检查清单 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令与权限范围 | 会执行本地安装脚本与多个第三方 CLI（yt-dlp、gh、bili-cli 等），但文档明确写出权限边界（不 sudo、不越权改系统文件、不写入 Agent 工作区），范围可审计 |
| ② 是否联网外发数据 | 会向对应平台（Twitter、Reddit 等）发起读取请求，目标平台在文档中逐一列出，透明 |
| ③ 凭据存储方式 | 登录态 Cookie/Token 仅存本机 ~/.agent-reach/config.yaml，文件权限设为仅所有者可读写，不上传不外传；文档同时提醒凭据等同完整登录权限，建议使用小号以控制泄露影响面 |
| ④ 可疑指令/注入迹象 | 抓取到的 README、SKILL.md、安装脚本内容中未发现诱导执行额外操作或隐蔽外发的指令 |
| ⑤ 作者/组织信誉 | 个人开发者，未发现刷星或话术操纵迹象；仓库另有声明澄清“未发行任何代币/加密货币项目”，防止他人假冒该项目行骗，属主动维护信誉的正面信号 |
| ⑥ License | MIT，仓库内 LICENSE 文件明确 |
| ⑦ 最近维护时间 | 近日仍有提交，活跃维护中 |
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与 Agent-Reach 的差异 |
|---|---|---|
| web-access（eze-is） | 通过 CDP 协议直连用户本机浏览器，复用浏览器已登录状态做通用网页操作与抓取 | 覆盖面更通用（任意网页+浏览器交互），但依赖接管用户真实浏览器会话，权限面更大；Agent-Reach 走的是各平台官方/半官方 CLI 与专用取数通道，权限颗粒度更细，且天然支持 15 个具名平台的零配置直取 |
| firecrawl-cli | 网页抓取与结构化转换 CLI，偏向“把任意网页转成干净文本/Markdown” | 更聚焦网页正文提取本身，不针对社交媒体、视频字幕、职位等平台做专门适配；Agent-Reach 更贴近“多平台调研”场景，对小红书、B 站、Reddit 等平台有专门优化 |
| browser-use | 通用浏览器自动化框架，驱动真实浏览器完成网页交互任务 | 更适合需要点击、填表等复杂交互的自动化任务，配置与资源消耗更高；Agent-Reach 更轻量，优先走 API/CLI 通道，仅在必要时才涉及浏览器层 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价，但已被多个第三方 Agent Skill 目录收录展示。
9. 其他补充
社区已有 36 位贡献者参与代码提交，issue 区可见持续的功能建议与缺陷报告，迭代节奏较快。
10. 安装使用方式
- 推荐方式：把仓库
docs/install.md的安装说明地址交给 Agent，由其自动完成安装、依赖检查与配置。 - 手动方式：
pipx install仓库源码包，再执行agent-reach install --env=auto做只读环境检查，确认后加--system实际安装。 - 需要 Python 3.10+，安装后无需重启 Agent，SKILL.md 会引导其在“查资料/访问指定平台链接”场景自动调用。
- 访问登录态平台（Twitter、LinkedIn 等）前，需用户自行提供对应账号的 Cookie/Token。
11. 注意事项
- 部分平台（Reddit、B 站等）存在服务器 IP 被限访问的情况，该 skill 通过多后端路由缓解，但不保证所有网络环境都能取到数据。
- 登录态凭据一旦配置即等同账号完整登录权限，官方文档建议使用小号降低泄露影响。
- OpenClaw 默认权限档位下会因缺少命令执行权限而安装失败，需先切到
coding档位。 - Codex、Hermes Agent 兼容情况官方文档未明确说明，使用前建议自行验证。