21k Star 的开源神器，让 AI 终端能搜 B站、小红书、GitHub、Twitter——但安装过程比想象中曲折得多
起因
我的 Claude Code 一直有个尴尬的限制：它只能读我给它的链接，或者用内置的 WebSearch 搜一些英文内容。遇到要搜 B站、小红书、GitHub 代码这些东西，只能我自己打开浏览器搜完把结果贴给它。
直到看到一个视频介绍 Agent-Reach——一个 GitHub 上 21000+ Star 的开源项目，号称能让 AI Agent "一键获得全网感知能力"，支持 17 个平台，全部零 API 费用。
"一行命令安装。"视频里这么说。
我信了。
第一天：发现 npm 上的假货
npm install -g agent-reach
装了。跑了。agent-reach: command not found。
查了一下，npm 上这个 agent-reach 是个叫 OpenClaw 的 Nostr 网络插件，只有 0.3.3 版本，跟视频里那个完全是两回事。
教训一：npm 包名不代表就是你要的东西。 真正的 Agent-Reach 是 Python 包，只在 GitHub 上发布。
npm uninstall -g agent-reach # 删掉假的
第二天：hosts 文件里藏着一堵墙
真正的安装命令是这样的：
pipx install https://github.com/Panniantong/agent-reach/archive/main.zip
但 GitHub 连不上。
curl: (7) Failed to connect to raw.githubusercontent.com port 443
查 DNS，nslookup raw.githubusercontent.com 返回 185.199.111.133，但 curl 却解析到 127.0.0.1。
问题出在 C:\Windows\System32\drivers\etc\hosts——里面整整 27 行 GitHub 域名全被指向了 127.0.0.1：
127.0.0.1 github.com
127.0.0.1 api.github.com
127.0.0.1 raw.githubusercontent.com
...（共 27 行）
这是某个"GitHub 加速器"留下的。加速器原理是在本地跑一个代理，把 hosts 指向 127.0.0.1 让请求走代理——但代理程序没在运行，hosts 条目就成了死墙。
解法：临时注释掉 hosts 里的 GitHub 行，装完再恢复。
# 备份原文件
cp /c/Windows/System32/drivers/etc/hosts /tmp/hosts-backup
# 注释所有 GitHub 行
sed -i 's/^127\.0\.0\.1.*github/#&/' /tmp/hosts-modified
# 管理员权限覆盖（Windows 需要提权）
powershell -Command "Start-Process -FilePath 'cmd' \
-ArgumentList '/c copy /y 修改版路径 C:\Windows\System32\drivers\etc\hosts' \
-Verb RunAs -Wait"
# 刷新 DNS 缓存
powershell -Command "Clear-DnsClientCache"
第三天：npm 和 pip 都拉不下来
hosts 解封后，pipx install 跑起来了。但安装 OpenCLI（Chrome 扩展的 CLI 端）时又卡了：
npm install -g @jackwener/opencli # 超时
GitHub 虽然通了，npm 默认走的还是官方源。换国内镜像：
npm install -g @jackwener/opencli --registry=https://registry.npmmirror.com
pip 也有类似问题：
pip install https://github.com/.../main.zip # 部分依赖拉不下来
解法：从 GitHub 下载 zip → 本地解压 → pip install 本地路径，依赖从 PyPI 缓存走。
第四天：Chrome 应用商店被墙
Agent-Reach 最核心的组件是 OpenCLI——它通过一个 Chrome 扩展读取浏览器登录态，让 AI 能复用你在小红书、Twitter 等平台的登录状态。不需要 Cookie，不需要 API Key。
但 OpenCLI 扩展要从 Chrome Web Store 安装。
Chrome Web Store 在中国打不开。
绕路方案：
扩展不在 Chrome 商店装了，直接从 GitHub Releases 下载 zip
↓
chrome://extensions → 开发者模式 → 加载未打包的扩展程序
↓
选择解压后的文件夹
↓
opencli doctor → Extension: connected ✅
扩展的 zip 包在 OpenCLI 的 GitHub Releases 里：
https://github.com/jackwener/OpenCLI/releases/download/v1.8.4/opencli-extension-v1.0.20.zip
第五天：小红书扫码登录启动了 150MB 的下载
Agent-Reach 为小红书提供了两个后端：OpenCLI（桌面推荐）和 xiaohongshu-mcp（服务器/无桌面）。
试了一下 xiaohongshu-mcp 的登录工具，它二话不说开始下载 Chromium 浏览器：
Download: chromium-browser-snapshots/Win_x64/1321438/chrome-win.zip
Progress: 09%
150MB，就为了扫个二维码。
立刻停掉。走 OpenCLI 路线——Chrome 扩展已经装好了，在 Chrome 里正常登录 xiaohongshu.com 就行，零配置。
教训二：官方推荐的方案不一定最适合你的环境。桌面用户一律走 OpenCLI，别碰 xiaohongshu-mcp。
最终成果
$ agent-reach doctor
✅ GitHub 仓库和代码
✅ YouTube 视频和字幕
✅ 任意网页 (Jina Reader)
✅ 全网语义搜索 (Exa)
✅ RSS/Atom 订阅源
✅ B站视频、字幕和搜索 (bili-cli)
✅ Twitter/X 推文 (OpenCLI)
✅ Reddit 帖子和评论 (OpenCLI)
✅ Facebook 帖子、主页和群组 (OpenCLI)
✅ Instagram 用户、主页和帖子 (OpenCLI)
✅ 小红书笔记 (OpenCLI)
状态：11/15 个渠道可用
技术架构总结
Agent-Reach (Python v1.5.0)
│
├── 核心层 (~/.agent-reach-venv/)
│ ├── agent-reach CLI # 安装器 + 健康检查
│ ├── yt-dlp # YouTube
│ ├── feedparser # RSS
│ └── bili-cli # B站
│
├── MCP 路由层
│ ├── mcporter (npm) # MCP 配置管理
│ └── Exa MCP # 语义搜索引擎
│
├── 浏览器桥接层
│ ├── OpenCLI CLI (npm) # 命令行 → 浏览器通信
│ └── OpenCLI 扩展 (Chrome) # 浏览器端，复用登录态
│
└── 技能层
└── ~/.claude/skills/agent-reach/ # Claude Code 自动加载
踩坑清单
| 坑 | 现象 | 解法 |
|---|---|---|
| npm 假包 | 装了一个不相关的 OpenClaw 插件 | 真正的 Agent-Reach 是 Python 包 |
| hosts 屏蔽 GitHub | curl GitHub 返回连接拒绝 | 临时注释 hosts，装完恢复 |
| pipx PATH 不生效 | pipx: command not found |
新 shell 需要重载 PATH |
| npm 官方源慢 | install 超时 | --registry=https://registry.npmmirror.com |
| Chrome 应用商店被墙 | 装不了 OpenCLI 扩展 | 从 GitHub Releases 下载 zip，手动加载 |
| xiaohongshu-mcp 下载 Chromium | 150MB 下载就为扫个码 | 桌面用户直接用 OpenCLI，不需要 mcp |
| pipx 安装超时 | 2 分钟超时 | 改走 venv + pip 本地安装 |
| GitHub Releases 重定向 | 下载链接跳转到被屏蔽的域名 | 确认 GitHub 主域名解封后再下载 |
写在最后
Agent-Reach 确实是个好工具，但它的安装过程对国内用户来说是一座障碍赛。最根本的问题是 GitHub 访问不稳定——这不是工具的问题，但导致了一系列连锁反应。
如果你也在国内安装，记住这三个关键点：
- 先把 GitHub 弄通——无论是 hosts、代理还是镜像
- npm 和 pip 都配好国内镜像
- 桌面用户全部走 OpenCLI，别碰那些需要下载无头浏览器的方案
折腾了五天才装好，但结果是值得的。现在我的 AI 终端能搜 B站、看小红书、查 GitHub——以前这些事需要我自己打开浏览器做，现在一句话就行。