CLI Agent-Reach 让AI智能体读遍登录墙后的互联网

CLI 智能体火了之后，一个尴尬的差距摆在眼前：模型会推理，但很多互联网内容它根本够不着。小红书笔记要登录、X 的动态要登录、B 站内容在视频里、雪球行情有反爬、V2EX 和 GitHub 的 issue 散落在非结构化页面里。你让 AI「看看最近大家对某个库的讨论」，它只能对着搜索引擎摘要抓瞎。Agent-Reach 就是补这个缺口的：一个给 AI 智能体装「互联网之眼」的工具集，把各平台背后的抓取、字幕、转写能力封装成统一命令，智能体一条命令就能读小红书、B 站、YouTube、GitHub、V2EX、雪球、LinkedIn、Reddit 等平台的内容。项目作者是中文开发者，README 直接写着「让 AI Agent 够得着它自己上不去的互联网」，对中文语料和中文平台的支持是同类工具里最全的。

项目采用 MIT 协议，Python 编写（3.10 以上），当前版本 v1.6.0，最近更新 2026 年 10 月 25 日，GitHub 星数已超过 10.1 万，上线后拿下过 Trendshift 日榜第一。它的安装方式也很「智能体友好」：把一句安装指令发给你的 AI，剩下的它自己完成。

项目基本信息

一、项目介绍

Agent-Reach 的世界观是「渠道」（channels）。每个平台是一个渠道，渠道下挂若干动作：B 站可以搜视频、看视频信息、刷热门、拿字幕；GitHub 可以搜仓库、读 README、读 issue 和 PR 含评论；雪球能拿实时行情；LinkedIn 能搜职位。渠道分三档：默认渠道装好即用（B 站、V2EX、GitHub、YouTube、网页），可选渠道说一句「帮我加上」就装（小红书、雪球、BOSS、小宇宙等），实验渠道能用但反爬严可能失效（X、Facebook、Instagram）。

底层设计是「首选加备选的有序工具列表」：每个平台的每个动作都按顺序尝试多个上游工具，失败了自动降级——读 B 站先用 bili-cli，失败换公开接口；读网页先用 Jina Reader，再用 Exa。平台改版、工具失效是常态，但换工具只改这个列表，智能体的用法不变。安装的一切都收敛在 ~/.agent-reach/ 目录，升级、卸载一句话搞定。

二、核心优势

第一，中文平台覆盖是独一档。小红书、B 站、V2EX、雪球、小宇宙播客、BOSS 直聘，这些通用搜索质量很差或够不着的平台，它都做了原生支持，对中文开发者和做国内市场的团队价值巨大。

第二，只读设计，安全边界清晰。只搜索和读取，不发帖、不评论、不点赞；从不替用户登录、不要密码；登录态复用只复制单个网站的快照，原浏览器不动，官方建议用小号。

第三，装好即用的零摩擦。一条指令发给自己的智能体，uv、依赖、渠道工具全自动装好；日常管理全用大白话——「看看状态」「加上小红书」「升级」，智能体转成命令执行。

第四，故障降级自动化。平台反爬变化时自动切备选工具，智能体无感；作者自己每天在用，渠道失效响应快。

第五，安装收敛。所有东西在一个目录，不散落系统各处，卸载列清单确认后只删自己的东西。

三、适用场景

市场与竞品调研：让智能体读小红书笔记、B 站评论、X 讨论，汇总真实用户反馈。技术选型调研：直接读 GitHub issue 和 PR 评论、V2EX 讨论帖，比二手技术文靠谱。内容监控：跟踪特定 UP 主、账号、股票的更新。招聘与商务：搜职位 JD、查公司公开信息。知识库建设：把分散在中文平台的优质讨论批量结构化。研究与学习：视频字幕、播客转文字，长内容快速消化。

四、安装教程

最简方式：把下面这句话发给你的智能体（Claude Code、Codex、OpenClaw 等都行），它自动完成全部安装：

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

过程中可能需要你在客户端设置里打开「允许执行命令」；电脑没有 uv 的话智能体会先装它（无需管理员密码）；可选渠道装完后按提示勾选。验证安装：

agent-reach channels

查看所有渠道及状态。搜 B 站内容：

agent-reach bilibili search "大模型"

按链接自动识别渠道并读取：

agent-reach read https://www.v2ex.com/t/123

常见报错：其一，PyPI 上有个同名包不是本项目——官方明确警告只从 install.md 的 GitHub 地址安装。其二，提示词说智能体不能执行命令——去客户端设置开启命令执行权限。其三，某平台突然读不了——大概率是该渠道上游工具被反爬，先 agent-reach 状态命令看哪个渠道坏了，或告诉智能体「小红书登录过期了」重新走登录窗口。其四，YouTube 转文字失败——该功能需要 Groq 或 OpenAI Key，在终端运行 agent-reach configure groq-key 填写，不要把 key 发在聊天里。

五、使用示例

调研场景：让智能体「看看小红书和 B 站上大家对某款降噪耳机的真实评价，按优缺点分类总结」。智能体依次调用小红书渠道搜笔记、读正文和评论，B 站渠道搜评测视频、拉字幕，交叉验证后输出结构化结论——价格敏感点、佩戴舒适度吐槽、续航口碑各占多少，附原始链接。全程只读，不点赞不评论。

技术选型场景：「读一下 GitHub 上这个仓库最近半年的 issue，看看大家抱怨最多的问题」。智能体用 GitHub 渠道列出 issue、按 reactions 排序、读高热度 issue 的完整评论串，汇总出「文档缺失」「Windows 兼容」「内存占用」三大抱怨点，每条附 issue 编号——比搜索引擎的聚合文章直接一个量级。

日常管理对话：「看看 Agent Reach 状态」——它报告每个渠道能否用、哪些上次还好现在坏了；「加上雪球」——自动装好所需工具；「小红书登录过期了」——打开专用窗口由你本人扫码，它不碰你的密码。

六、常见问题

问：会用我的主账号登录吗？答：需要登录的平台用专用浏览器，首次会从你 Chrome 复制该网站的登录态（只此一个网站、原浏览器不变），复制的通常是主账号——官方建议在登录窗口换成小号，防平台限制自动访问。

问：数据隐私怎么样？答：所有工具和登录态都在本机 ~/.agent-reach/，专用浏览器只对这台机器开放；项目本身只读，不发布任何内容。

问：平台改版失效了怎么办？答：每个渠道有多工具降级，单个工具失效通常无感；整渠道失效时告诉智能体，它会指出是哪个平台、什么原因，等上游更新或换备选。

问：为什么推荐用 Agent 安装而不是手动？答：安装涉及 uv、多渠道工具、登录配置，交给智能体一句话完成；后续升级、管理同样用自然语言，项目就是按「智能体即运维」设计的。

七、总结

Agent-Reach 精准命中了一个真实缺口：智能体「够不着」的互联网内容——登录墙后、视频里、中文平台里。渠道化设计加多工具降级让它在平台反爬的游击战里保持可用，只读边界和小号建议体现了对账号安全的清醒，而「把安装指令发给 AI」的交互几乎消灭了上手成本。对要做国内平台调研、内容监控、中文语料处理的团队和个人，它是目前最顺手的解决方案。需要注意实验渠道的稳定性预期，以及任何登录态复用都遵循官方的小号建议。