PyPI 上叫 agent-reach 的包不是本项目,只能按 install.md 的 GitHub 地址安装;YouTube 语音转文字和小宇宙播客转文字需要 Groq 或 OpenAI Key;小红书、X、Reddit 等可选渠道需要登录,建议用小号
Agent-Reach
PanniantongMIT活跃维护一条命令行就能让 AI 智能体读取和搜索 Twitter、Reddit、YouTube、GitHub、B站、小红书等平台内容,不用付任何 API 费用。
Give your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
帮我安装 Agent Reach:https://raw.githubusercontent.com/Panniantong/Agent-Reach/main/docs/install.mdREADME 未说明硬件要求,未提及显存、GPU 或 CPU 限制
给 CLI Agent 补上搜索和读取 X、Reddit、B站、小红书等平台的互联网能力
一条命令行就能让 AI 智能体读取和搜索 Twitter、Reddit、YouTube、GitHub、B站、小红书等平台内容,不用付任何 API 费用。
核心能力
- 每个平台动作按首选加备选工具列表依次尝试
- 一条命令按渠道和动作调用,如 agent-reach bilibili search
- 按链接自动选择渠道读取网页或帖子
- 复用本机 Chrome 登录,用专用后台浏览器免弹窗
- 只读操作,不发帖不评论不点赞不私信
容易踩的坑
- v1.6.1最新正式版2026-11-01 · 2026-11-01 07:24 UTC
中文:
- 全网搜索、Reddit、小红书、B站在 1.6.0 里会出现的几种"明明能查却报错"或"显示成功但内容是空的",这版都修好了。
- 电脑上别的软件占用了浏览器端口时,可以换一个端口,不用关掉那个软件。
- 复制登录失败时会如实告诉你,不再假装成功。
- Windows 上小红书带特殊符号的链接能正常打开了。
English:
- Several 1.6.0 cases where web search, Reddit, Xiaohongshu or Bilibili failed although the content was reachable, or reported success with empty content, are fixed.
- When another program on your computer uses the browser port, Agent Reach can use a different one; you don't have to close that program.
- A login copy that fails now says so instead of reporting success.
- On Windows, Xiaohongshu links with special characters open correctly.
中文(技术细节):
- 全网搜索:请求统一带上
agent-reach/<版本号>标识,避免被 Exa 的防护拦截(#877)。 - Reddit:站内工具临时失败(比如返回网页而不是数据)时,自动改用公开网页搜索和阅读(#880)。
- 小红书:适配 OpenCLI 2.0 的返回格式,阅读不再"成功但内容全空";搜索和评论没有结果时也不再返回一条空数据(#861、#895)。
- B站:扫码后如果没存下有效登录,不再显示登录成功;提示改为运行
agent-reach login bilibili(#866、#883)。 - 专用浏览器端口可以改:
agent-reach configure browser-port <端口>,9222 被别的软件占用时用(#848)。 - 复制登录:浏览器后台程序没开时不再记一次"复制了 0 条";手动
login <渠道> --import-existing一条都没复制到时会明确报错(#879)。 - Windows:链接里带
&的小红书笔记能正常阅读和查看评论(#860)。
English (technical):
- Web search: every request identifies itself as
agent-reach/<version>, so Exa's Cloudflare front no longer blocks it (#877). - Reddit: when the site tool fails transiently (for example it returns HTML instead of data), search and read fall back to the public web (#880).
- Xiaohongshu: OpenCLI 2.0 results are mapped, so read no longer succeeds with empty fields; search and comments no longer return one empty row when there are no results (#861, #895).
- Bilibili: a QR login that saved no usable credential is no longer reported as success, and the hint now says
agent-reach login bilibili(#866, #883). - The dedicated browser's port is configurable with
agent-reach configure browser-port <port>, for when another tool holds 9222 (#848). - Login reuse: no "copied 0 cookies" record when the browser bridge is down; an explicit
login <channel> --import-existingthat copies nothing now fails clearly (#879). - Windows: Xiaohongshu note links containing
&can be read and their comments loaded (#860).
- v1.6.02026-10-23 · 2026-10-23 06:45 UTC
查看更新说明
中文:
- 从旧版升级:把"帮我更新 Agent Reach"那句话发给你的 AI 就行。你的密钥和设置都保留,旧版程序会自动删掉。
- 加一个平台只要说一句,需要的软件都会自动装好,不需要管理员密码;你只需要登录或者填一个 Key。
- 小红书、推特这类要登录的平台,改用 Agent Reach 自己的专用浏览器,不弹窗、不占用你的浏览器;多个 AI 可以同时查。
- RSS 订阅和 Exa 全网搜索合并进了"网页"。以后有新版本,AI 会用大白话告诉你改了什么,你同意了才更新。
English:
- Upgrading from an older version: just send your AI the "update Agent Reach" sentence. Your keys and settings are kept, and the old program is removed for you.
- Adding a platform takes one sentence. Everything it needs is installed for you, with no admin password; you only log in or enter a key.
- Platforms that need a login, such as Xiaohongshu and X, now use Agent Reach's own browser in the background, never yours, and several AIs can search at once.
- RSS and Exa search are now part of "web". When a new version is out, your AI tells you in plain words what changed and updates only if you say yes.
1.6 is a rebuild. Agents call one command,
agent-reach; everything Agent Reach installs or stores lives under~/.agent-reach/. 1.6 是重构版本:Agent 只调一个命令agent-reach,Agent Reach 装的、存的东西全部在~/.agent-reach/下。中文(技术细节):
- 本版发布前已真实测通 28/40 个动作;以下未在发布机上测通,经维护者批准随本版发布:Reddit(测试网络被拦)、Instagram(限流)、B站字幕、LinkedIn、雪球热帖热股(未登录)、小宇宙(未配 Key)。
- 修复未登录 gh 阻断公开 API、公开行情触发浏览器、错误认证提示和未登记缓存清理;临时音频/字幕保存在 Reach 内。BOSS 站内搜索优先官方 OpenCLI,JD 上游适配故障单列;PR 与发版均检查真实验收和待验状态。
- CLI 对已声明的公开搜索/阅读先复用网页工具,成功后不准备浏览器;结果标注来源和内容范围,站内路径明确要求认证时才提示登录。可指定后端保留原有站内能力。
- 浏览器渠道共用一份登录,闲置十分钟自动关闭,下次使用自动打开。
- 添加渠道自动准备工具;删除时只清理该网站的登录。默认平台也能去掉,去掉后更新不会再加回来。
- 更新时,有已测版本的工具保持在已测版本,其他工具用兼容范围内的最新版。
- 公开内容继续先读,不强制登录;安装后用简短表格说明能查什么。
- 保留小宇宙转录;去掉额外模型配置和重复的网站抓取实现。
- Bridge 随专用浏览器管理;按真实页面操作计时、定期保存登录。清理失败保留渠道,卸载只删台账文件。发布前必须有渠道真实验收。
- 查询默认无头,优先只读复用本机已有的站点登录;显窗登录与无头查询共用配置。B站字幕、雪球社区自动同步登录,BOSS JD 使用上游浏览器接口。缺失接口和限流不再误报为需要重登。
- 专用浏览器按扩展保存在它自己配置里的编号识别,不会再把用户日常的 Chrome 认成专用浏览器;登录窗口开着时查询不再把它收掉。
- 浏览器渠道可以并行查询:同一平台最多 2 条、合计 4 条同时跑,多出来的排队而不是立刻报"正忙";登录窗口、退出登录等操作等正在跑的查询结束再做。
- 没登录时报"需要登录"而不是"上游工具坏了":雪球社区(错误码 400016)、B站字幕(没有 B站登录)、LinkedIn(专用浏览器里没有 LinkedIn 登录)。
- 从 1.5 升级更顺:安装和更新合成一份 install.md,先看版本再分流(旧版指向的 update.md 转到它);
agent-reach update遇到 pip/pipx 装的旧版会自己换成 uv 安装;setup删掉旧版 Agent Reach 程序(只删它自己,不动其他工具),安装汇报说明保留了什么、变了什么、以前用过哪些渠道可以加回来。安装地址改为始终指向最新正式版。 - 平台出错时,报错原话和自带的处理建议原样交给 AI,由 AI 用平台名告诉用户哪个平台暂时有问题;不再用 Reach 自己编的建议覆盖("要登录"仍给 Reach 自己专用浏览器的登录步骤)。
English (technical):
- 28 of 40 actions passed real acceptance before release; these shipped untested with maintainer approval: Reddit (test network blocked), Instagram (rate limited), Bilibili subtitles, LinkedIn, Xueqiu hot posts/stocks (no login), Xiaoyuzhou (no key).
- Browser channels share one profile, close after ten idle minutes and reopen on demand.
- Adding a channel prepares its tools; removal clears only that site's login. Default platforms can be removed and updates won't add them back.
- Updating keeps tools that have a tested version at that version; other tools get the newest version inside their supported range.
- Public content remains public-first, with a compact capability receipt.
- Keep Xiaoyuzhou transcription; remove the extra planner and duplicate site extraction.
- Reuse existing local site sessions read-only; queries default to headless, with a visible window for human login.
- The dedicated browser is identified by the id its extension saves inside its own profile, so the user's own Chrome is never mistaken for it; a query no longer closes an open login window.
- Browser channels run queries in parallel: up to 2 per platform and 4 in total, with the rest queued instead of failing BUSY at once; login windows, logout and browser setup wait for running queries.
- Report NEED_LOGIN instead of UPSTREAM_BROKEN when not logged in: Xueqiu community (error 400016), Bilibili subtitles (no Bilibili login), LinkedIn (no LinkedIn login in the dedicated browser).
- Smoother upgrade from 1.5: install and update share one guide, install.md, which checks the version first (update.md, where 1.5 sends users, points to it);
agent-reach updatemoves a pip/pipx install to uv by itself; `
- v1.5.0v1.5.0 — 能力层:多后端路由 + 真体检 + OpenCLI2026-06-11 · 2026-06-11 12:29 UTC
查看更新说明
这一版是什么
Agent Reach 从「工具集合」升级为「能力层」:每个平台 = 首选 + 备选的有序后端列表,当下最稳的接入方式替你实测选好、装好、体检好——接入方式换代,你无感。本版全部选型基于 2026-06 真机实测(32 项端到端测试)。
平台路由变化
平台 现在的路 小红书 OpenCLI(桌面,复用浏览器登录态零配置)▸ xiaohongshu-mcp(服务器,扫码)▸ xhs-cli(存量备选,上游已停更) Reddit OpenCLI ▸ rdt-cli。诚实口径:Reddit 没有零配置路径(匿名接口已被全面封锁、官方 API 审批制),必须登录态 B站 bili-cli(搜索/热门/详情,无需登录)▸ OpenCLI(字幕)▸ 搜索 API 兜底。yt-dlp 退出 B站(被 412 风控全面拦截,实测最新版+代理+Cookie 均无效);yt-dlp 继续服务 YouTube Twitter twitter-cli 守门(实测稳定)▸ OpenCLI 备选,探测加重试 doctor 成了真体检
- 真跑命令探测,而不是只看文件存在——能识别「装了但坏了」(典型:系统 Python 升级后 venv 断链),并给出可直接复制的重装处方
- 报告每个多后端平台当前在用哪条路(
doctor --json的active_backend) - 一个渠道崩了不再拖垮整个体检
收纳 OpenCLI(桌面后端)
agent-reach install --channels opencli:npm 自动装,Chrome 扩展商店点一次(Chrome 安全模型,无法代点)。复用你浏览器的登录态——刷过小红书、登过 Reddit 就直接能用。需要桌面 + Chrome,服务器自动跳过。安装与更新体验
- 安装一句话:
帮我安装 Agent Reach:https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md - 更新一句话:
帮我更新 Agent Reach:https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md(本体+上游工具+skill 一次跟上) - skill 重写:「全网调研」「帮我调研」可靠触发;agent 干完大活会顺手查版本,有新版在收尾时提示一句(不打断、不重复唠叨)
check-update修复:本地版本领先于最新 release 时不再误提示"更新"(避免降级)
质量
- 测试 107 → 162(契约/断链场景/后端优先级矩阵/版本比较全覆盖)
- 经三轮对抗性 review(12 项发现全部修复):修掉了 Twitter 路由屏蔽、watch 降级提示、死代理开关等会真实伤到用户的问题
- 13 渠道 32 项真机端到端实测全通过
致谢
新收纳的上游:OpenCLI(@jackwener)、xiaohongshu-mcp(@xpzouying)。
🤖 Generated with Claude Code
- v1.4.2v1.4.2 — 诚实瘦身:移除失修渠道,新增转写与 doctor --json2026-06-10 · 2026-06-10 08:02 UTC
查看更新说明
渠道调整
移除抖音、微博、微信公众号三个渠道。 原因很直接——它们已经名不副实:
- 抖音:上游 douyin-mcp-server 已停止维护(archived),且需要手动起本地服务的 4 步配置,几乎没人能配通
- 微博:依赖一个久未维护的个人 fork,实际已不可用
- 微信公众号:全文阅读被反爬拦截越来越严重(#339),却还在宣传"零配置可用"
与其展示坏掉的承诺,不如诚实下架。等有可靠的上游方案时它们会回来(v1.4.0 移除 Discord/头条是同样的逻辑)。现在的口径:13 个平台,6 个真零配置。
新功能
agent-reach transcribe <链接或文件>— Whisper 音频转写直接进 CLI(Groq 免费 key 即可,失败自动降级 OpenAI),无字幕视频的兜底方案(#277)agent-reach doctor --json— 机器可读的健康检查输出;文本版加了图例,看得懂 ✅/[!]/[X] 是什么意思了(#348)- Skill 自动触发优化 — 重写了 SKILL 描述(平台中英文别名 + 动作触发词),Agent 现在能更可靠地自动用上 Agent Reach(#324,感谢 @alfred1994)
修复
- Reddit 安装命令修复 — doctor 之前教你装 PyPI 上不存在的 rdt-cli 0.4.2;现在从 GitHub 源安装(钉死 0.4.2 commit),文档同步更新(#326,感谢 @Bortlesboat,关闭 #294)
- 小宇宙转写质量 — Whisper prompt 要求输出中文标点(修复了被 bash 吞掉的引号),429 重试也带 prompt;新增可选
--polish用免费 Llama 3.3 70B 润色分段(#291,感谢 @hymansun) - Windows 中文乱码 — 子进程和 MCP server 强制 UTF-8 环境,weibo 时代引入、对 mcporter 类渠道通用(#345,感谢 @chidaobuchidao)
- 清理无人消费的 uv.lock
升级方式
把这句话发给你的 Agent:
帮我更新 Agent Reach:https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md - v1.4.1v1.4.1 — 修复源码安装失败(wheel 重复打包)2026-06-10 · 2026-06-10 03:47 UTC
查看更新说明
修复
修复了源码安装失败的问题。 近期从 GitHub 安装(
pip install .../archive/main.zip、pipx、uvx)会因 wheel 重复打包直接构建失败:ValueError: A second file is being added to the wheel archive at the same path: `agent_reach/guides/setup-exa.md`原因是
pyproject.toml中packages = ["agent_reach"]已经包含了guides/、skill/、scripts/,而force-include又把它们打包了一遍——新版 hatchling 对此直接报错。现已删除冗余的 force-include 块(#329)。已验证:wheel 构建干净(无重复条目)、SKILL.md / guides / scripts 全部正常随包分发、85 个测试全绿。
- 关闭:#308 #315 #328 #332 #334
- 感谢 @nyxst4ck(#329)与 @1131096740(#319)提交修复 🙏
CI 加固
新增 wheel-build 门禁(#340):每次提交都会真实构建 wheel、校验无重复条目、确认数据文件在包内,并在干净 venv 中冒烟安装。此前 CI 只跑 editable 安装(
pip install -e .),永远测不到打包问题——这类 bug 从此结构性地无法再发布出去。升级方式
把这句话发给你的 Agent:
帮我更新 Agent Reach:https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md或手动:
pip install --upgrade https://github.com/Panniantong/agent-reach/archive/main.zip
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
❤️赞助商
为什么需要 Agent Reach?
Agent Reach 让你的 Agent 真正连上互联网,用上它自己够不着的平台和能力。
Claude Code、Codex、Hermes Agent、OpenClaw 这类 CLI Agent 自带搜索和网页读取,但下面这些它们基本够不着:
- 要登录才能用的功能:在小红书搜笔记、在 X 查账号动态、读职位详情等。
- 视频里的内容:B站和 YouTube 的字幕,以及 YouTube 视频、小宇宙播客的语音转文字。
- 中文平台:B站、小红书、V2EX、雪球,通用搜索覆盖很差。
- 干净的结构化数据:雪球行情、V2EX 帖子和回复、GitHub 仓库和 issue,拿到的是整理好的内容。
Agent Reach 把这些平台背后的工具替你装好、测好,Agent 一条命令就能用:
agent-reach channels # 有哪些渠道、每个渠道能做什么
agent-reach bilibili search "大模型" # agent-reach <渠道> <动作> [参数]
agent-reach read https://www.v2ex.com/t/123 # 按链接自动选渠道
✅ 在你用之前,你可能想知道
- 适用于哪些 Agent? 一切 Agent 都能用。
- 会碰我的浏览器和账号吗? 要登录的平台用 Agent Reach 自己的专用浏览器,在后台运行、不弹窗。第一次用某个网站时,会把你 Chrome 里这个网站的登录复制一份过去,原浏览器不变,不读密码库。复制过来的通常是主账号,建议换成小号,做法见下面的"安全性"。详见会话配置。
支持的平台
下表是当前版本的情况。
| 渠道 | 等级 | 能做什么 | 需要什么 |
|---|---|---|---|
| bilibili | 默认 | 搜索、视频信息、热门、字幕 | 无;字幕需要登录(扫码) |
| v2ex | 默认 | 热门、节点、帖子和回复、用户 | 无 |
| github | 默认 | 搜仓库、读仓库/README、读 issue 和 PR(含评论) | 无 |
| youtube | 默认 | 视频信息、搜索、字幕、语音转文字 | 无;转文字需要 Groq 或 OpenAI Key |
| web | 默认 | 网页搜索、网页阅读(保底) | 无 |
| xiaohongshu | 可选 | 搜笔记、读正文、看评论 | 登录 |
| xueqiu | 可选 | 实时行情、搜股票、热帖、热股 | 行情不用登录;热帖、热股要登录 |
| boss | 可选 | 搜职位和 JD | 登录 |
| xiaoyuzhou | 可选 | 播客转文字 | Groq Key |
| 可选 | 搜职位、读职位详情 | 公开职位不用登录;站内搜索要登录 | |
| 可选 | 搜帖子、读正文、看评论、看版块 | 登录 | |
| 实验 | 搜推文、用户资料、用户推文、读推文串 | 登录 | |
| 实验 | 搜索、主页资料 | 登录 | |
| 实验 | 搜用户、主页资料、用户帖子 | 登录 |
- 默认:装好就能用;不想要也可以去掉,以后更新不会再加回来。
- 可选:说一句"帮我加上 XX"就开启,需要的软件会自动装好。
- 实验:能用,但平台反爬更严,可能随时失效。
快速上手
把这句话发给你的 Agent:
帮我安装 Agent Reach:https://raw.githubusercontent.com/Panniantong/Agent-Reach/main/docs/install.md
无论是安装还是升级,都只需要这一条命令就行了。
剩下的 Agent 自己做完。过程中你可能会被问到:
- 允许它执行命令:如果 Agent 说自己不能运行命令,去它的设置里打开"允许执行命令"。
- 装 uv:uv 是一个安装命令行程序的小工具,不需要管理员密码。电脑上没有的话 Agent 会先装它,会跟你说一声。
- 要不要加可选渠道:装完后 Agent 会告诉你哪些已经能用(B站、V2EX、GitHub、YouTube、网页),以及还能加哪些。你选了再加,也可以以后随时说"帮我加上小红书",一条命令就装好。
关于登录:部分平台会直接复用你电脑上已有的登录。想换成某个特定账号(比如小号),跟 Agent 说一声就行。Agent 从不替你登录,也不会要你的密码。
⚠️ PyPI 上叫
agent-reach的包不是本项目,请勿从 PyPI 安装,只用 install.md 里的 GitHub 地址。
装好之后怎么管
Agent Reach 装的所有东西(各渠道的工具、登录、设置)都放在你电脑上同一个文件夹里(~/.agent-reach/),不散落到别处。所以升级、管理、删除都很省事,一句话就行。
直接用大白话跟 Agent 说:
| 你说 | 它会做什么 |
|---|---|
| "看看 Agent Reach 状态" | 告诉你每个渠道现在能不能用,哪些是上次还好、现在坏了 |
| "加上小红书" / "去掉小红书" | 开启并装好它需要的一切 / 关掉它,清掉它的登录和专用工具 |
| "小红书登录过期了" / "换个账号" / "退出登录" | 打开登录窗口,由你本人登录 / 清掉这个网站的登录 |
| "升级 Agent Reach" | 一次更新程序和各渠道的工具,并告诉你还需要做什么 |
| "卸载 Agent Reach" | 先列出要删的东西,你确认后再删 |
| "让另一个 AI 也能用" | 给那个 AI 也放一份使用说明 |
出了问题,Agent 会告诉你是哪个平台、什么原因、下一步怎么做。常见问题见 troubleshooting.md。
设计理念
🔌 每个平台 = 首选 + 备选的有序工具列表
每个平台的每个动作都有一个按顺序尝试的工具列表。比如读 B站视频先用 bili-cli,失败了自动换 B站公开接口;读网页先用 Jina Reader,再用 Exa。
flowchart LR
A[Agent] -->|agent-reach 渠道 动作| B[Agent Reach]
B --> C{按顺序尝试}
C -->|首选| D[上游工具 1]
C -->|失败时备选| E[上游工具 2]
D --> F[结果]
E --> F
F --> A
平台改版、工具失效是常态。换工具只是调整这个列表,Agent 的用法不变。
安全性
- 只读:只搜索和读取,不发帖、不评论、不点赞、不私信。
- 从不替你登录,也不要你的密码。 部分平台会复用你电脑上已有的登录(只复制这一个网站,原浏览器不变);确实需要重新登录时才打开专用窗口,由你本人完成。
- 专用浏览器只对你这台电脑开放,别的电脑连不上它。
- 建议用小号登录。 复用过来的通常是主账号,而平台可能限制自动访问的账号。想换成小号,跟 Agent 说一声就行。
- Key 不要发在聊天里:在你自己的终端里运行
agent-reach configure groq-key填写。
🗑️ 卸载
跟 Agent 说"卸载 Agent Reach"。它会先列出要删的东西,你确认后再删。只删 Agent Reach 自己装的东西,你的其他文件和浏览器都不动。最后它会告诉你怎么删掉程序本身。
⭐ 为什么值得 Star
这个项目我自己每天在用,所以我会一直维护它。
- 有新需求或者大家提了想要的渠道,我会陆续加上
- 每个渠道我会尽量保证能用、好用、免费
- 平台改了反爬或者 API 变了,我会想办法解决
Star 一下,下次需要的时候能找到。⭐
致谢
OpenCLI · bili-cli · boss-agent-cli · yt-dlp · Jina Reader · Exa
联系
- 📧 Email: [email protected]
业务合作 / 交流群
有相关合作,或者想加交流群,加我微信,或直接加入 Discord 社区:
Bug 反馈和功能请求请用 GitHub Issues,更容易跟踪。
防骗提醒
Agent Reach 没有官方代币、币、投资产品、领取手续费活动、钱包连接,也没有 Solana/Pump.fun 项目。任何借用 Agent Reach 名字、GitHub 地址或作者身份的加密项目都与本仓库无关,请勿据此连接钱包或领取任何费用。
License
友情链接
Agent Skills Hub — 找 Claude 技能和 MCP 服务器,不用猜哪个安全:133,000+ 个条目全部安全分级、质量评分,每 8 小时刷新。
AtomGit 镜像 — Agent Reach 的 AtomGit 同步镜像,便于国内访问与克隆。