Agent Reach 使用指南：让 AI 搜索和读取多平台资料

这就是我们每天遇到的情况——

「我无法直接访问该链接的具体内容，请你把文章正文粘贴给我。」

把一篇文章链接丢给 AI，想让它总结一下重点，结果跑了一会儿，它回了上面这句话。直接整无语了。本来想让 AI 帮我省点事，结果它反手把活派了回来。

问题是，我连具体链接都不想找。我真正想要的是：只给 AI 一个关键词，它就能自己去网上搜索，把各个平台上相关的内容捞回来，再进行整理。

这事应该不止我一个人烦。于是我打开了神奇网站 GitHub，逛了一圈，还真翻到一个宝贝：Agent Reach。

GitHub 地址：https://github.com/Panniantong/Agent-Reach

它到底是干什么的？

现在的 AI 不是不会搜，而是很多平台搜得到、读不到。B站、小红书、X、YouTube、GitHub 各有门槛，登录、权限、接口、风控，卡住一处，AI 就只能停在外面。

Agent Reach 把这些读取工具选好、装好、检查好，再告诉 AI 遇到什么内容该走哪条路。

配好以后，你可以直接说“搜一下小红书上大家怎么评价”，AI 会按情况去找工具，把相关材料读出来，再整理给你。

它真正好用的地方

第一，不把能力绑死在一条路上

像 B站这类平台，读取方式很容易受风控影响，今天能用，过段时间可能就不稳定了。Agent Reach 不会把 AI 固定在某一个接入工具上：一条路不好走，就换另一条，不用把整套配置推倒重来。

第二，配好以后还能做体检

agent-reach doctor 会检查各个平台当前是否可用、正在用哪种读取方式、还缺什么配置。对普通用户来说，这比看到一长串报错后自己上网找答案省事得多。

第三，你不需要记住每个平台的命令

配好以后，直接用自然语言说需求，Agent 会自己判断该怎么处理。

第四，不绑定某一个 Agent 平台

Claude Code、Codex、WorkBuddy 等 Agent 都可以使用。它提供的是一套可复用的互联网能力，而不是某个聊天产品里的专属插件。

安全性怎么样？

Cookie 和 Token 保存在本机配置文件里，并限制为当前用户读写。也就是说，这些登录信息不会直接暴露到网上；安装前也可以先预览操作，确认没问题再继续。

但只要用到 Cookie 或浏览器登录态，就要把它当成账号权限来看。X、小红书、Reddit 这类平台还是有风控风险的，所以更稳的做法是用专门的小号测试，别直接拿主账号上。

它的边界也要说清楚

它不是万能读取器

平台规则和网页结构一直在变，今天能读到的内容，之后也可能失效。Agent Reach 能帮你少折腾，但不能保证每个链接、每条视频、每个帖子都读成功。

它主要解决“找资料、读内容、做整理”

如果你要让 AI 在网页里反复筛选、翻页、点详情，或者批量抓取结构化数据，还是要用浏览器自动化或专门的数据工具。

开源免费也不代表全程零成本

本地使用通常不需要代理，但账号登录、视频转录、服务器环境、地区网络和平台限制，都可能带来额外配置或费用。

它适合哪些人？

1. 经常需要查资料、看项目、读网页、整理视频或做内容调研的人。
2. 内容创作者、开发者、产品经理、研究人员。
3. 想把 AI 当成资料整理助手，而不是只让它坐在对话框里等投喂的人。

怎么装？

安装

第一次使用，直接把这句话发给你的 AI Agent：

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

Agent 会根据安装文档检查环境、安装依赖、激活默认的零配置渠道，并询问你是否要继续配置需要登录态的平台。

更新

如果你已经装过 Agent Reach，后面可以把这句话发给 AI Agent：

更新 Agent Reach：
https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md

它会先检查当前版本，再更新 Agent Reach 和已经装过的相关工具，最后跑一遍检查，看看各个平台还能不能正常读取。

安全模式

如果你担心它自动改环境，可以用安全模式。它不会自动安装系统包，只会告诉你需要补什么：

安装 Agent Reach（安全模式）：
https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
安装时使用 --safe 参数

如果只是想先看看它准备做什么，也可以让它预览一遍：

安装 Agent Reach：
https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
先使用 --dry-run 预览，不要实际安装

第一次调研，把“读到了什么”也写进交付要求

先选一个公开网页或 GitHub 项目跑通读取，再扩大到需要登录的平台。可以把下面的任务交给 Agent：

围绕我给出的主题整理 3 条可访问的资料。
每条保留标题、原链接、可见的发布日期、与问题有关的原文依据和你的总结。
发布日期看不到就写未知；区分完整正文、搜索摘要和视频字幕。
打不开的链接单独列出失败原因，不用其他页面替它补正文。
最后列出互相矛盾的结论，等待我选择需要进一步核对的材料。

“能打开页面”和“拿到完整正文”是两件事。只有摘要时，不应把结果写成阅读全文后的判断；视频只有字幕时，也不能声称检查过画面。遇到登录或平台限制，先缩小到可访问的来源，并保留失败记录。

如果任务需要逐页点击、分页取数和字段表格，可对照 BrowserAct 的网页采集流程；已经有可调用接口时，先按 public-apis 接口筛选方法 判断能否直接取数。

渠道与配置方式参考 Agent Reach 官方仓库。

写在最后

AI 现在已经很会写、很会总结、很会改稿，但它拿不到材料的时候，还是只能等你一点点投喂。

Agent Reach 把原本零散、容易失效的接入方式整理成了一层可以维护、诊断和替换的能力。你给 AI 一个明确的问题，它会自己去搜索材料、整理结果；你只负责判断这些内容是不是够用。