Agent Reach 解决的是一个很具体的痛点:AI 助手会上网查资料,但它够不到的网站其实很多。
一、问题是什么
现在的 CLI Agent(Claude Code、Codex、Hermes Agent、OpenClaw 这类)大多自带搜索和网页读取能力。但你真让它去查点东西,很快会撞上四堵墙。
第一堵:要登录才能用的功能。 在小红书搜笔记、在 X 查某个账号的动态、读招聘网站的职位详情——这些不登录根本进不去。
第二堵:视频里的内容。 B 站和 YouTube 的信息大半在字幕和音频里,普通网页抓取只能拿到标题和简介。小宇宙播客同理,内容全在音频里。
第三堵:中文平台覆盖差。 B 站、小红书、V2EX、雪球这些平台,通用搜索引擎的索引质量很差,AI 拿到的常常是过期或残缺的二手信息。
第四堵:拿到的不是结构化数据。 就算能抓到页面,也是混杂着导航栏、广告、推荐位的 HTML。想要雪球的行情、V2EX 的帖子和回复、GitHub 的 issue 和 PR,都得自己再解析一遍。
二、核心设计
Agent Reach 的思路是:把每个平台背后的工具替你装好、测好,然后给 Agent 一个统一入口。
具体有两个设计点值得说。
第一,每个平台 = 首选 + 备选的有序工具列表。 比如读 B 站视频,先用 bili-cli,失败了自动换 B 站公开接口;读网页先试 Jina Reader,不行再用 Exa。这个设计的意义在于容错:单个工具挂了不会导致整个能力失效,它会自动往下试。
第二,安装是「一句话」的。 你不用记一堆 pip 命令、brew 包名,只要把你的 Agent 指向一份 install.md,它自己读完、自己规划、自己装完。装的过程中它会跟你确认三件事:能不能执行命令、要不要装 uv、要不要加可选渠道。
第三,只读是硬约束。 官方明确写了:只搜索和读取,不发帖、不评论、不点赞、不私信。这不是谦虚,是安全边界——一旦允许写操作,AI 就可能在你不知情的情况下替你发言。
三、功能拆解
默认渠道(装好就能用):
- bilibili:搜索、视频信息、热门、字幕(字幕需要扫码登录)
- v2ex:热门、节点、帖子和回复、用户
- github:搜仓库、读仓库/README、读 issue 和 PR(含评论)
- youtube:视频信息、搜索、字幕、语音转文字(转文字需要 Groq 或 OpenAI Key)
- web:网页搜索、网页阅读(保底)
可选渠道(说一句「帮我加上 XX」就装):
- xiaohongshu:搜笔记、读正文、看评论(需要登录)
- xueqiu:实时行情、搜股票、热帖、热股(行情不用登录)
- boss:搜职位和 JD(需要登录)
- xiaoyuzhou:播客转文字(需要 Groq Key)
- linkedin:搜职位、读职位详情
- reddit:搜帖子、读正文、看评论、看版块(需要登录)
实验渠道(能用但反爬更严):twitter、facebook、instagram。
管理能力:
agent-reach channels查看有哪些渠道、各能做什么agent-reach read按链接自动选渠道- 说「小红书登录过期了」会打开登录窗口由你本人登录
- 说「卸载 Agent Reach」会先列出要删什么,你确认才动手
四、适合谁、不适合谁
适合:日常用 CLI Agent 做研究、需要读中文平台内容的人;要抓 B 站/YouTube 字幕、播客转文字的人;需要把社交平台内容变成结构化数据做分析的人;不想为每个平台单独折腾一套工具的人。
不适合:完全不用 CLI Agent 的人——它是给 Agent 用的工具,没有图形界面;想用它做自动发帖、批量私信这类操作的人——它明确只读,不提供写能力;对「让 AI 复用我的登录状态」不安心的人。
五、诚实提醒
用小号,别用主号。 官方自己也是这么建议的:它会复用你电脑上已有的登录状态(只复制这一个网站,原浏览器不变),复过来的通常是你的主账号,而平台可能限制自动访问的账号。想换小号跟 Agent 说一声就行。
实验级渠道随时可能失效。 X、Facebook、Instagram 被标成实验,因为平台反爬更严。今天能用不代表明天能用,重要工作别把这三家当稳定依赖。
Key 不要发在聊天里。 填 Groq Key 要用 agent-reach configure groq-key 在你自己终端里填,不要在对话里粘贴。
PyPI 上那个同名包不是此项目。 官方特别提醒了这一点:PyPI 上叫 agent-reach 的包不是它,只能按 install.md 里的地址装。这类「抢注同名包」是供应链攻击的常见手法,值得记住。
它不是万能搜索。 它解决的「够不到」问题,不是「搜得更准」问题。查询质量仍然取决于背后的工具和你问的方式。
登录窗口会弹出来。 需要重新登录时会开一个专用浏览器窗口由你本人操作——这是刻意的,它从不替你输密码。但这也意味着过程中会有需要你动手的时刻。
六、项目现状
用 Python 写,要求 3.10 以上,MIT 协议,star 数约 11 万,最新版本 v1.6.1。项目在 Trendshift 拿过当日第一,GitHub 全球排名约 118。
作者在 README 里说这是他每天自己在用的项目,所以会持续维护,有新需求会陆续加渠道。发布页提供 wheel、tar.gz 和一个 agent-reach.zip。
七、常见问题
问:要花钱吗?
答:工具本身免费(MIT)。默认渠道零 API 费用;YouTube 语音转文字和小宇宙播客转文字要 Groq 或 OpenAI Key,那部分按你自己账号计费。
问:会拿我的账号乱发东西吗?
答:官方写的是只读——只搜索和读取,不发帖、不评论、不点赞、不私信。
问:用主账号登录安全吗?
答:它会复用已登录状态,原浏览器不动。但官方建议用小号,因为平台可能限制自动访问的账号。
问:哪些平台要登录?
答:默认渠道基本不用(B 站字幕要扫码)。小红书、雪球热帖、BOSS、Reddit、LinkedIn 站内搜索要登录;X、Facebook、Instagram 是实验级。
问:怎么卸干净?
答:跟 Agent 说「卸载 Agent Reach」,它先列出要删什么,你确认才删,只删它自己装的东西。
下载地址
夸克网盘(永久有效,无提取码):https://pan.quark.cn/s/7acb579d02bb
本文由「宝藏星球屋」整理,更多软件、游戏、开源项目都在 https://cbge.top。






















暂无评论内容