Panniantong/Agent-Reach · 上手攻略

  • 仓库：Panniantong/Agent-Reach
  • 链接：https://github.com/Panniantong/Agent-Reach
  • 分类：agent / llm-infra
  • 作者：Jay
  • 更新：2026-07-11

它是什么

Agent Reach 是一个互联网能力集成层（capability layer），专为 AI 编程助手设计。它的核心功能是：让 AI Agent 能够读取 Twitter、Reddit、YouTube、B 站、小红书、GitHub、RSS 源等互联网平台的内容——无需你手动配置任何 API Key 或工具链。

你只需要把一句话发给 Agent，Agent 就会自动安装好所有上游工具（yt-dlp、gh CLI、mcporter、Exa 搜索等），并注册好 SKILL.md。之后 Agent 遇到"全网调研"、"搜推特"、"看视频"这类需求，会自动调用对应工具，整个过程对用户透明。

定位： 不是又一个爬虫工具，而是一个"选型 + 安装 + 体检 + 路由"的元工具层。每个平台的读取由 Agent 直接调用上游工具完成，没有额外的封装层。

解决什么问题

AI Agent 本身不具备互联网访问能力，这是最大的痛点：

  • 让 Agent 搜 Twitter → 要配置 Twitter API（付费）
  • 让 Agent 看 B 站视频总结 → yt-dlp 被 B 站封了，还要找替代
  • 让 Agent 搜 Reddit → 匿名接口已全面被封，只能走登录态
  • 让 Agent 读小红书 → 没有现成免费 CLI

每个平台都要单独踩坑、装工具、调配置。Agent Reach 把这件事变成一句话安装。

快速安装

前置条件

  • OpenClaw 用户需先确认 exec 权限已开启：
openclaw config set tools.profile "coding"
# 或在 ~/.openclaw/openclaw.json 中设置 "tools": { "profile": "coding" }
# 然后 openclaw gateway restart

其他平台（Claude Code、Cursor、Windsurf 等）不受此限制。

Agent 安装（推荐）

直接把下面这句话发给 Agent：

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

Agent 会自动完成： 1. 安装 agent-reach CLI（pipx 或 venv 方式） 2. 安装 Node.js、gh CLI、mcporter 等系统依赖 3. 配置 Exa 搜索引擎（MCP 接入，免费无需 Key） 4. 注册 SKILL.md 到 Agent 的 skills 目录 5. 体检：运行 agent-reach doctor 报告每个渠道状态

安全模式（不自动装系统包）

帮我安装 Agent Reach（安全模式）：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
安装时使用 --safe 参数

安全模式只列出需要什么，不实际安装，由你决定。

手动安装（不推荐）

# 方式一：pipx（推荐）
pipx install https://github.com/Panniantong/agent-reach/archive/main.zip
agent-reach install --env=auto

# 方式二：venv（macOS/Homebrew 或遇到 PEP 668 时）
python3 -m venv ~/.agent-reach-venv
source ~/.agent-reach-venv/bin/activate
pip install https://github.com/Panniantong/agent-reach/archive/main.zip
agent-reach install --env=auto

核心用法

基础命令

# 诊断所有渠道状态
agent-reach doctor

# 手动触发安装（由 Agent 调用，一般不需手动）
agent-reach install --env=auto

# 更新 Agent Reach
agent-reach update

安装后，Agent 可直接响应的请求（零配置渠道）

需求 背后调用的工具
"帮我看看这个链接" curl https://r.jina.ai/URL（Jina Reader）
"这个 GitHub 仓库是做什么的" gh repo view owner/repo
"这个 YouTube 视频讲了什么" yt-dlp --write-subs --skip-download <URL>
"B 站搜一下 AI 教程" bili search <关键词>
"全网搜一下 LLM 框架对比" Exa 语义搜索（via MCP）
"订阅这个 RSS" feedparser

需要额外配置的渠道

以下渠道需要用户提供额外凭据，安装后 Agent 会自动引导你：

渠道 配置方式
🐦 Twitter/X 登录 Cookie（OpenCLI 桌面版可复用浏览器登录态）
📕 小红书 OpenCLI（桌面）；xiaohongshu-mcp（服务器，需扫码）
📖 Reddit OpenCLI（桌面）；rdt-cli + Cookie
📘 Facebook OpenCLI（桌面，复用 Chrome 登录态）
📷 Instagram OpenCLI（桌面）
💼 LinkedIn linkedin-mcp 或 Jina Reader
📈 雪球 登录 Cookie
🎙️ 小宇宙播客 Groq 免费 Key（Whisper 转录）

配置方式：直接告诉 Agent「帮我配 Twitter」即可，Agent 会一步步引导你。

典型适用场景

1. AI 编程助手全网调研 Agent 写代码时需要调研竞品、查 Bug 解决方案、搜技术博客——可以直接发"帮我搜一下 Cursor 和 Copilot 的最新对比"。

2. 视频内容摘要 YouTube、B 站教程视频，直接让 Agent 提取字幕并总结。yt-dlp 提取字幕，Agent 总结，全程免费。

3. 社交媒体舆情监控 追踪某产品在小红书、Twitter、Reddit 上的口碑，生成报告。

4. 订阅源聚合 将多个 RSS 源聚合，让 Agent 每天总结新技术动态。

5. GitHub 仓库情报 快速了解一个陌生仓库的用途、最近提交、Issue 讨论，无需 clone。

坑与注意

  1. OpenClaw 必须开启 exec 权限：默认 messaging 工具配置下 Agent 无法执行命令，必须设置 tools.profile: "coding" 并重启 Gateway。

  2. B 站 yt-dlp 已失效：2026-06 实测 yt-dlp 被 B 站全面封禁（412），已切换到 bili-cli，无需登录即可搜索和读取视频详情。

  3. Reddit 无零配置路径：匿名接口已全面被封，必须走 OpenCLI 桌面版（浏览器登录态）或 rdt-cli + Cookie。

  4. Cookie 只存在本地：~/.agent-reach/config.yaml，文件权限 600，不上传不外传。

  5. 服务器部署需要代理：本地电脑不需要，但部署在服务器上需要代理（~$1/月）。

  6. 代理自行承担费用：Exa 搜索免费，但服务器代理费用需要自付。

  7. Windows Python 别名问题：如果 python3 --version 打开 Microsoft Store，需要改用 py -3 或实际安装目录的 python.exe。

与同类对比

方案 安装成本 维护成本 免费程度
Agent Reach 一句话安装 自动路由更新 核心工具全免费
手动配置各平台 高（每个平台单独踩坑） 高（平台 API 变了你得自己修） 各平台 API 差异大
BrowserBase / ScrapingBee 无 低 付费
直接调官方 API 中 高（版本管理） 多数付费

Agent Reach 的核心竞争力是替用户维护接入层的稳定性——平台换后端了，它会自动路由，用户无感。

一句话推荐结论

如果你的 AI 编程助手需要访问互联网内容（Twitter、B 站、小红书、YouTube、GitHub……），Agent Reach 是目前最低成本、最高稳定性的接入方案——一键安装，自动路由，永不操心平台封禁问题。