Agent Reach 是一个能力层（Capability Layer），它为 AI Agent 提供了一键式的互联网访问能力。安装后，Agent 就能阅读网页、搜索全网、提取 YouTube 字幕、查看 GitHub 仓库、刷小红书和 Twitter——全部免费，无需配置复杂API。

1. 系统要求与准备

1.1 软件前提

  • AI 编程助手：您需要安装并配置好以下任一 AI 编程助手：
    • Claude Code（推荐）
    • OpenClaw
    • Cursor
    • Windsurf
    • 任何能运行命令行的 Agent
  • Python：版本 3.8 或更高（用于安装 agent-reach 工具）。
  • （可选）Node.js：部分后端工具需要。
  • （可选）Git：用于 gh CLI 操作。

1.2 网络与权限

  • 网络：需要互联网连接以安装工具和访问平台。
  • 权限：本地电脑无需额外配置。如果部署在服务器上，可能需要一个便宜的代理（约 $1/月）用于某些平台。

2. 安装步骤（一句话安装）

2.1 核心安装命令

在您支持的 AI 编程助手的对话中，直接发送以下一句话。Agent 会自动完成所有安装和配置：

1
帮我安装 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

就这一句话。 Agent 会：

  1. 克隆本仓库并安装 agent-reach CLI 工具。
  2. 检查系统环境（Node.js、gh CLI 等）并给出安装建议。
  3. 默认仅激活 6 个零配置渠道（网页、YouTube、B站搜索、GitHub公开仓库、RSS、全网搜索）。
  4. 询问您是否需要配置需要登录态的平台（小红书、Twitter、Reddit、Facebook、Instagram）。

2.2 安全检查安装

如果您希望先预览安装过程而不做任何修改，可以使用：

1
帮我安全检查并安装 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

默认情况下，agent-reach install 命令不会自动修改系统。只有您明确允许后（例如在后续命令中传入 --system），它才会安装外部依赖和写入配置。

2.3 更新已安装版本

已经安装过？更新也只是一句话：

1
帮我更新 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md

3. 支持的平台与使用方式

安装完成后，您可以直接用自然语言让 Agent 执行任务。Agent Reach 的 SKILL.md 会指导 Agent 调用正确的底层工具。

3.1 零配置（装好即用）

以下平台无需任何配置，安装后即可使用：

平台/功能 使用示例（告诉 Agent） 底层工具
任意网页 “帮我看看这个链接：https://…” Jina Reader
YouTube 视频 “总结这个视频：https://youtu.be/...” yt-dlp (提取字幕)
B站 “B站搜一下 AI 绘画教程” / “这个B站视频讲了什么” bili-cli
GitHub 公开仓库 “这个仓库是做什么的？https://github.com/...” gh CLI
RSS 订阅 “订阅这个 RSS 源，有更新告诉我” feedparser
全网搜索 “搜索一下最新的 LLM 开源模型” Exa (通过 mcporter，免费)

3.2 需简单配置后解锁

对于需要登录态的平台，告诉 Agent “帮我配 XXX” （如“帮我配 Twitter”），它会一步步引导您完成配置。建议使用专用小号以降低封号风险。

平台 使用示例 配置方式
Twitter/X “搜一下推特上大家怎么评价 GPT-5” 通过 Cookie-Editor 导出 Cookie 并配置
小红书 “小红书上这个产品口碑怎么样” OpenCLI (使用您已有的 Chrome 会话) 或 Cookie-Editor 导出
Reddit “去 Reddit 上看看有没有人遇到这个 bug” OpenCLI (使用桌面浏览器登录态) 或 rdt-cli + Cookie
Facebook “在 Facebook 上搜索这个群组” OpenCLI (复用 Chrome 登录态)
Instagram “看看这个 Instagram 博主的最新帖子” OpenCLI (复用 Chrome 登录态)
LinkedIn “查一下这个人的 LinkedIn 资料” mcp-server-linkedin 或 Jina Reader (读公开页面)

4. 常用命令与诊断

安装后，您或您的 Agent 可以使用以下命令：

  • agent-reach doctor：核心诊断命令。检查每个平台渠道的状态，告诉您哪个通、哪个不通、当前走的是哪条路由（首选/备选）、如何修复。这是排查问题的第一站。
  • agent-reach install --dry-run：预览安装操作，不做任何修改。
  • agent-reach uninstall：卸载 Agent Reach（会询问确认，可保留配置）。

5. 设计理念与安全性

5.1 “首选 + 备选”路由机制

每个平台都有有序的后端列表。例如，B站的接入路径现在是 bili-cli ▸ OpenCLI ▸ 搜索 API，而 yt-dlp 在 2026年6月被B站风控封死后已从B站路由中退役。agent-reach doctor 会告知您当前实际使用的后端。

5.2 安全设计

  • 凭据本地存储：Cookie 和 Token 仅保存在您本机的 ~/.agent-reach/config.yaml 中，文件权限为 600（仅所有者可读写），不会上传。
  • 默认不修改系统：安装命令默认是只读的，只有显式传递 --system 参数才会安装外部依赖和写入配置。
  • 开源透明：代码完全开源，所有依赖工具也是开源项目，您随时可以审查。

强烈建议使用专用小号配置需要 Cookie 的平台（Twitter、小红书、Reddit等）。平台可能检测到非浏览器环境的 API 调用行为，有封禁主账号的风险。

6. 常见问题排查

问题 可能原因 解决方案
Agent 无法执行 agent-reach install 命令 Agent 的 shell 执行权限未开启（OpenClaw 常见） 对于 OpenClaw，需设置 tools.profile "coding" 并重启 Gateway。其他 Agent 通常无此限制。
agent-reach doctor 显示某个渠道“不可用” 该平台的后端工具未安装、Cookie 未配置或已失效 按照 doctor 给出的修复建议操作，通常是安装缺失依赖或重新配置 Cookie。
Twitter/小红书等平台无法搜索或读取 Cookie 未配置、已过期或被平台封禁 1. 运行 agent-reach doctor 检查状态。 2. 重新执行“帮我配 XXX”流程，更新 Cookie。 3. 确保使用的是专用小号。
B站视频字幕或详情获取失败 B站反爬策略更新 Agent Reach 会持续维护和更新B站路由。运行 agent-reach update 更新工具，然后重试。
安装后部分功能仍然无法使用 底层依赖工具未安装（如 ffmpeg） agent-reach doctor 会列出所有缺失的系统依赖。按提示安装即可。

7. 总结

Agent Reach 将繁杂的互联网接入配置简化成“一句话安装”。

核心使用路径：

  1. 一句话安装：在您的 AI 编程助手中发送安装指令。
  2. 立即使用：立即使用零配置渠道（网页、YouTube、B站、GitHub、RSS、全网搜索）。
  3. 按需解锁：对于需要登录的平台，告诉 Agent“帮我配 XXX”，它引导您完成配置。
  4. 诊断维护：遇到问题时，运行 agent-reach doctor 查看状态和修复建议。

它不是一个需要部署的服务，而是您的AI Agent的知识库和工具箱。安装它，相当于给您的 Agent 配齐了浏览器、搜索引擎和社交平台阅读器，让 Agent 能真正“看到”整个互联网。

项目地址：https://github.com/Panniantong/agent-reach