Agent Reach(github.com/Panniantong/agent-reach)是一个给 AI Agent 一键装好"联网能力"的开源脚手架,完全免费、无需任何 API Key,兼容 Claude Code / Cursor / OpenClaw。
| 渠道 | 状态 | 说明 |
|---|---|---|
| 任意网页 | ✅ | Jina Reader,给 URL 就读(偶发不稳) |
| V2EX | ✅ | 公开 API,稳定 |
| RSS/Atom | ✅ | 任意订阅源 |
| B站 | ✅ | 视频/字幕/搜索 |
| YouTube | ✅ | 字幕提取+搜索 |
| GitHub | ✅ | 仓库/代码/搜索 |
| 全网搜索 | ✅ | Exa 语义搜索,已配好 |
突破国内 3 重卡点——Chrome 装扩展要 Google 账号(被风控禁用)、document.cookie 读不到 HttpOnly、脸书会话凭证藏得深。
解法:用 browser_cookie3 从本机 Chrome 直接解密导出完整 Cookie(含 HttpOnly),零扩展、零 Google 账号、全自动。实测:
sb / xs / c_user / datr / fr 等 8 个 Cookieis_checkpointed=false,登录有效pip install agent-reach
→ ERROR: Could not find a version that satisfies the requirement agent-reach
卡点 1:Python 版本门槛。 PyPI 版要求 Python ≥ 3.11,本机 3.9.6 直接装不上。
仓库要求 Py3.10+,Homebrew 有 3.12,用官方推荐的虚拟环境装:
/opt/homebrew/bin/python3.12 -m venv ~/.agent-reach-venv
~/.agent-reach-venv/bin/pip install https://github.com/Panniantong/agent-reach/archive/main.zip
✅ 成功,命令集齐全:setup / install / configure / doctor / uninstall / skill / format / transcribe。
| 工具 | 用途 | 方式 | 坑 |
|---|---|---|---|
| yt-dlp | YouTube/B站字幕 | pip install yt-dlp[default] | PEP 668 拦 → 改装 venv |
| gh CLI | GitHub | brew install gh | 要 gh auth login |
| mcporter | MCP 客户端 | npm install -g mcporter | 慢 |
| Exa | 全网搜索 | mcporter config add exa ... | 单独配一次 |
最大坑:PEP 668——brew 的 Python 不能直接 pip 装,必须虚拟环境,README 已给方案。
agent-reach doctor(亮点功能)一条命令看全渠道状态,可视化 + 带修复指引,是同类工具少见的好设计:
图例:✅ 可用 [!] 已装需配 [X] 未安装
✅ V2EX | ✅ RSS | ✅ 任意网页(Jina) | ✅ B站
[!] GitHub(gh 未登录)
[X] 全网搜索(Exa 未配)
…Twitter/Reddit/小红书/LinkedIn 等可选
Q:Agent Reach 要付费吗?要 API Key 吗?
A:完全免费、无需任何 API Key。底层全是开源免费工具。
Q:装好就能打开推特/脸书/小红书吗?
A:不能秒开。推特要导 Cookie、小红书要 Docker、脸书官方还没实现渠道。只有网页/V2EX/RSS/B站/YouTube/GitHub/全网搜索 7 项装好即用。
Q:装不上报"no matching distribution"怎么办?
A:PyPI 版要 Python 3.11+。用 Python 3.10+ 建虚拟环境,从 GitHub 仓库 zip 安装即可。
Q:读不了"需要登录"的网页怎么办?
A:用 browser_cookie3 从本机 Chrome 解密导出完整 Cookie(含 HttpOnly),绕开扩展和 Google 账号,喂给 Agent 即可。
Q:兼容哪些 Agent?
A:Claude Code、Cursor、OpenClaw、Windsurf 等任何能跑命令行的 Agent。
Agent Reach 是一个"给 Agent 免费配齐上网工具"的优质脚手架,完成度超出"vibe coding"预期,但它不是"打开即刷社交站"的神器。
*本报告为 kaiyuanzhan.com 实战踩坑全记录,所有结论来自 2026-08-18 真实测试,未作美化。*