Agent Reach 部署指南: 让 Claude Code / OpenClaw 读懂推特/小红书/B站

一句话简介: 你的 AI Agent 写代码很溜, 但让它"上网搜点东西"就抓瞎? Agent Reach 是一行命令的解药 — 把推特、Reddit、YouTube、B 站、小红书、抖音、微信公众号… 14+ 个平台一次性装好, Agent 自己知道调哪个工具。

项目简介

Agent Reach 是一个 给 AI Agent 用的"互联网能力安装器", GitHub: Panniantong/Agent-Reach, MIT 协议, Python 包。

它的核心定位很独特: 不是框架, 是脚手架 (scaffolding)。

什么意思? 你的 AI Agent (Claude Code / OpenClaw / Cursor / Windsurf...) 装上 Agent Reach 之后, 不会经过 Agent Reach 的包装层, 而是直接调用上游工具 — twitter-cli / rdt-cli / yt-dlp / xhs-cli / douyin-mcp-server / Jina Reader / gh CLI 这些已经被项目作者挑好、踩过坑、配好默认参数的工具。Agent Reach 只负责:

1. 安装器 — 一行 pip install agent-reach + agent-reach install 把这些上游工具全装好
2. 诊断器 — agent-reach doctor 一条命令告诉你哪个平台能用、哪个不能用、怎么修
3. 配置器 — Cookie 认证、API Key、MCP 服务等一次性管理好
4. SKILL 注入 — 给 Agent 注册 SKILL.md, 让它遇到"搜推特"、"看视频"这种需求时自动调对应工具

支持 14+ 平台渠道:

一句话: 不用记命令, 不用配爬虫, 跟 Agent 说话它就能上网。

难度 / 时长 / 收获

• 难度: ⭐ (入门, 真就一行命令)
• 时长: 5–15 分钟 (本地电脑); 30 分钟 (服务器, 含 Cookie 配)
• 收获:
  • 让 Claude Code / OpenClaw 直接读推特、刷小红书、读 YouTube 字幕
  • 理解 AI Agent 工具生态里 "scaffolding vs framework" 的设计差异
  • 学会用 Cookie-Editor 统一管理多平台 Cookie, 避免 QR 登录坑
  • 知道 agent-reach doctor 是 Agent 工具链的好实践

目标读者画像

• 用 Claude Code / OpenClaw / Cursor 干活的开发者
• 想让 Agent 真的能上网查资料, 而不是干瞪眼
• 不想为推特 / Reddit / 小红书每个平台单独折腾爬虫或付费 API
• 已经有 AI Agent 工具链, 想加一层"互联网能力"的玩家
• 跟 Agent 跑长任务时, 想找点不那么肉疼的算力接法的玩家 (后面会聊到)

核心依赖与环境

最低配置:

推荐 / 可选:

完整项目结构树

Agent-Reach/
├── pyproject.toml                # Python 包定义
├── agent_reach/
│   ├── __init__.py               # 版本号
│   ├── cli.py                    # CLI 入口 (argparse)
│   ├── core.py                   # 核心 read/search 路由
│   ├── config.py                 # YAML 配置管理
│   ├── doctor.py                 # 诊断引擎
│   ├── cookie_extract.py         # Cookie 提取工具
│   ├── channels/                 # 每个平台一个文件
│   │   ├── base.py               # BaseChannel 抽象类
│   │   ├── web.py                # Jina Reader
│   │   ├── twitter.py            # twitter-cli
│   │   ├── youtube.py            # yt-dlp
│   │   ├── github.py             # gh CLI
│   │   ├── bilibili.py           # yt-dlp + bili-cli
│   │   ├── reddit.py             # rdt-cli
│   │   ├── xiaohongshu.py        # xhs-cli
│   │   ├── douyin.py             # douyin-mcp-server
│   │   ├── linkedin.py           # linkedin-mcp
│   │   ├── wechat.py             # Exa + Camoufox
│   │   ├── rss.py                # feedparser
│   │   ├── exa_search.py         # Exa via mcporter
│   │   ├── weibo.py
│   │   ├── v2ex.py
│   │   ├── xueqiu.py
│   │   └── xiaoyuzhou.py
│   ├── integrations/
│   │   └── mcp_server.py         # MCP server 接入
│   ├── skill/                    # 给 Agent 用的 SKILL.md
│   ├── guides/                   # 使用文档 (中/英/日/韩)
│   ├── scripts/                  # 安装脚本
│   └── utils/
├── config/
│   └── mcporter.json             # MCP 工具配置
├── tests/                        # pytest 测试
└── docs/                         # README 多语言版本

作为用户, 你只需要碰 pip install / agent-reach install / agent-reach doctor 三个命令。channels/ 是开发者扩展用的。

手把手步骤

步骤 1: 基础安装 (主路径)

# 推荐用 pipx 隔离安装
pipx install agent-reach

# 或者 pip (注意不要装到系统 Python)
python3 -m venv ~/.agent-reach-venv
source ~/.agent-reach-venv/bin/activate
pip install agent-reach

装完之后应该有这个命令:

agent-reach --version
# agent-reach 1.4.0

步骤 2: 一键安装所有上游工具

# 默认模式: 自动检测环境, 装所有依赖
agent-reach install --env=auto

它会依次:

1. 安装系统依赖 (Node.js / gh CLI / mcporter / twitter-cli / rdt-cli 等)
2. 配置搜索引擎 (MCP 接入 Exa, 免 Key)
3. 判断是本机还是服务器, 给出不同建议
4. 在 Agent 的 skills/ 目录注册 SKILL.md

openclaw config set tools.profile "coding"
openclaw gateway restart

步骤 3: 诊断渠道状态

agent-reach doctor

你应该看到类似:

✅ web              Jina Reader OK
✅ youtube          yt-dlp 2025.10.x installed
✅ rss              feedparser 6.0.x
✅ exa_search       Exa MCP connected
✅ github           gh CLI 2.x authenticated
⚠️  twitter         twitter-cli not logged in  → run: twitter login
⚠️  reddit          rdt-cli not logged in       → run: rdt login
✅ bilibili         yt-dlp OK
⚠️  xiaohongshu     xhs-cli not logged in      → see step 4
✅ douyin           douyin-mcp-server OK
✅ wechat           Exa search OK
✅ v2ex             API OK

✅ 表示开箱即用, ⚠️ 表示需要额外配 (通常是 Cookie 认证)。

步骤 4: 给需要 Cookie 的平台配认证 (重点)

Twitter / 小红书 / Reddit 这三类需要登录态, 走 Cookie 认证而不是 QR 扫码。

先装 Cookie-Editor: Chrome / Edge 应用商店搜 "Cookie-Editor", 装好。

统一流程:

1. 浏览器里手动登录 x.com / xiaohongshu.com / reddit.com
2. 点 Cookie-Editor 插件图标 → "Export" → 选 "Netscape" 格式
3. 把导出的 Cookie 字符串发给 Agent, 跟它说: "帮我配 Twitter"
4. Agent 调 cookie_extract.py 把它存到 ~/.agent-reach/config.yaml
5. 文件权限 600, 仅你的账号可读

# 你也可以直接命令行配, 不通过 Agent
agent-reach config set twitter.cookie "$(pbpaste)"  # macOS
agent-reach config set xhs.cookie "$(xclip -o)"     # Linux

步骤 5: 验证 Cookie 平台

agent-reach doctor

重新跑诊断, 之前 ⚠️ 的平台应该都变 ✅ 了。

步骤 6: 让 Agent 试一次

跟你的 Agent (Claude Code / OpenClaw / Cursor) 说:

帮我看看这条推特说了啥: https://x.com/vercel/status/1234567890

Agent 读 SKILL.md 之后会自动调 twitter tweet URL 命令, 几秒钟返回推文内容。

试几个组合:

搜一下 Reddit 上 r/LocalLLaMA 最近在讨论什么
读一下这个 YouTube 视频: https://youtube.com/watch?v=xxx
看看小红书上 "露营装备" 有什么爆款笔记
这个 GitHub 仓库是干啥的: https://github.com/xxx/yyy

你会发现一个细节: 你不需要告诉 Agent 调什么命令。SKILL.md 已经把"读推特 = twitter CLI"、"看视频 = yt-dlp"这些映射写好了。这是 Agent Reach 跟普通工具集最大的差异 — 装好后 Agent 是有意识地选择工具, 不是瞎试。

步骤 7 (可选): 全网语义搜索

默认已经接了 Exa, 不需要 API Key。直接问 Agent:

搜一下 2026 年最新的 LLM Agent 框架对比, 给我 5 篇最相关的

它会调 Exa MCP 工具, 拿到结果后再调 Jina Reader 抓全文, 整理成报告。

步骤 8 (可选): GitHub 私有仓库访问

# 一次性登录
gh auth login

完成 OAuth 后, Agent 就能读你账号下的私有仓库、提 Issue、PR、review。

步骤 9 (可选): B 站 / 抖音增强

B 站本机开箱即用, 海外服务器需要代理 (~$1/月, 推荐 FluxNode 之类住宅代理):

# 假设你的代理是 http://127.0.0.1:7890
agent-reach config set bilibili.proxy "http://127.0.0.1:7890"
agent-reach doctor  # 重新跑诊断

抖音完全无需登录, 把分享链接发给 Agent:

解析这个抖音视频: https://v.douyin.com/xxxxx

Agent 调 mcporter call 'douyin.parse_douyin_video_info(...)', 给你视频信息 + 无水印下载链接。

步骤 10 (可选): 安全模式 / 卸载

安全模式 (生产服务器或多用户机器用):

# 不会自动装系统包, 只列出来让你看
agent-reach install --env=auto --safe

# 或者先预览会做什么, 不实际执行
agent-reach install --env=auto --dry-run

完全卸载:

agent-reach uninstall             # 删配置 + skill 文件
agent-reach uninstall --keep-config  # 保留 token, 重装时用
pip uninstall agent-reach         # 卸 Python 包

常见问题排查

Q1: OpenClaw 用户安装时报 "permission denied" / Agent 不动

根因: OpenClaw 默认 tools.profile = messaging, 不允许 Agent 执行 shell 命令。修复:

openclaw config set tools.profile "coding"
openclaw gateway restart
# 重新开一个新会话, 再发 "帮我安装 Agent Reach"

或者改 ~/.openclaw/openclaw.json:

{
  "tools": { "profile": "coding" }
}

Q2: 小红书 QR 登录一直转圈

别用 QR。直接:

1. Chrome 应用商店装 Cookie-Editor
2. 浏览器登录小红书网页版
3. Cookie-Editor → Export → Netscape
4. 把字符串发给 Agent, 说"帮我配小红书"
5. 30 秒搞定

Q3: Reddit 一调就 403

Reddit 自 2024 年起强制要认证。修复:

# 安装 rdt-cli (Agent Reach install 阶段应该已经装了)
pipx install rdt-cli

# 一次性登录 (它会从你 Chrome 里自动抓 Cookie)
rdt login

# 验证
rdt search "LocalLLaMA" --limit 5

跟 Twitter / 小红书一样, rdt login 走的是浏览器 Cookie 自动提取, 不是 QR。

Q4: B 站海外服务器连不上

海外 IP 被 B 站屏蔽, 需要住宅代理。两种方案:

# 方案 1: 命令行配 (推荐 FluxNode 之类便宜代理)
agent-reach config set bilibili.proxy "http://user:pass@proxy:port"

# 方案 2: 环境变量
export HTTP_PROXY="http://user:pass@proxy:port"
export HTTPS_PROXY="http://user:pass@proxy:port"

便宜的住宅代理 ~$1/月, 没必要自己搭。

Q5: agent-reach doctor 报 "channel not found" / 渠道文件冲突

通常是因为部分上游工具装失败, 或者装到了系统 Python 而不是 pipx。最干净的修复是彻底重来:

agent-reach uninstall
pipx uninstall agent-reach
# 清理可能残留的 ~/.agent-reach/
rm -rf ~/.agent-reach/

pipx install agent-reach
agent-reach install --env=auto
agent-reach doctor

Q6: 浏览器换了 / Cookie 过期了

Cookie 几个月后会过期, 重新走一遍"浏览器登录 → Cookie-Editor 导出 → 发给 Agent"的流程就行。Agent 会自动覆盖 ~/.agent-reach/config.yaml 里的旧 Cookie。

Q7 (Bonus): Agent 跑长任务时账单爆炸, 怎么算账?

讲个我自己接 Agent 干活时踩过的坑。

Agent Reach 解决的是 "Agent 怎么联网" 的问题, 但 Agent 跑工具调用本质上还是消耗 LLM token。一个典型的 "研究竞品 + 总结" 任务, 涉及 5-10 轮工具调用 (搜索、抓网页、读推特、再搜索、再读), 一轮下来几十万 token, 一天跑 20 几次任务, 账单很快爆炸。

实测三种接法 (我自己的部署经验):

1. 接 Anthropic 官方 API — 体验最完整, 但 Claude Opus 跑 Agent 任务, 一天下来账单四位数人民币很正常
2. 接 OpenRouter 等聚合 API — 价格略低于官方, 但还是贵
3. 接 Defapi — 我现在的方案。官方价格的半价, 而且协议层完全兼容, Agent Reach 这边配置照旧, 不用改任何 SKILL / prompt / 工具调用代码

具体配置 (假设你 Agent 用的是 Claude / Anthropic 协议):

# ~/.openclaw/openclaw.json 或 Claude Code 的 env 配置
ANTHROPIC_BASE_URL=https://api.defapi.org
ANTHROPIC_API_KEY=sk-xxxxxx    # 在 defapi.org 后台拿

Defapi 的所有模型基本都兼容三套主流协议 — v1/chat/completions (OpenAI) / v1/messages (Anthropic) / v1beta/models (Gemini) — 切换模型改个名字就行。Agent 跑推特抓取、小红书分析、视频字幕总结这种"工具调用密集型"任务, 每月账单从四位数降到三位数是实打实的。

扩展阅读 / 进阶方向

• 自定义 channel: 在 agent_reach/channels/ 加一个文件, 继承 BaseChannel, 实现 can_handle(url) / read(url) / search(query) / check() 四个方法, 重新 pip install -e . 即可。门槛很低, 一个平台一个文件
• 替换上游工具: channels/web.py 默认用 Jina Reader, 觉得不够用? 换成 Firecrawl / Crawl4AI / 自建爬虫都行, 改个 import 就完事
• SKILL.md 机制: Agent 装上 Agent Reach 后, SKILL.md 自动注册到 ~/.claude/skills/ / ~/.openclaw/skills/。你可以自己写 SKILL.md, 教 Agent 在特定场景优先调哪个 channel
• mcporter 任意 MCP: 不光是 Exa, 任何 MCP 兼容的服务器都能通过 config/mcporter.json 接进来。改 alias 对应的启动命令就行
• 多 Agent 共享: Agent Reach 的配置 ~/.agent-reach/config.yaml 是文件级的, 多 Agent (Claude Code + OpenClaw + Cursor) 同时跑同一台机器可以共享同一份配置
• 跟 Defapi 联动: Agent Reach 拿数据, Defapi 跑推理, 一个"信息获取层"一个"算力成本层", 两者都是协议驱动, 组合起来就是"低成本的 Agent 长任务工作流"

GitHub 仓库: Panniantong/Agent-Reach, 多语言文档在 docs/README_en.md / docs/README_ja.md / docs/README_ko.md, 设计理念在 README 末尾的 "设计理念" 段。想贡献 channel 提 PR 即可, 作者 Neo Reid 维护很活跃。