Agent-Reach

这一版是什么

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

渠道调整

移除抖音、微博、微信公众号三个渠道。 原因很直接——它们已经名不副实：

• 抖音：上游 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

修复

修复了源码安装失败的问题。 近期从 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

核心变更：6 大上游迁移

本版本对多个渠道的上游工具进行了大规模迁移，解决了已弃用工具、不稳定方案和部署门槛高的问题。

上游迁移

渠道	旧方案	新方案	效果
Twitter/X	bird CLI（repo 已 404）	twitter-cli (2,137 ⭐)	修复完全不可用的渠道
Reddit	Exa crawling（经常超时）	rdt-cli (304 ⭐)	搜索+全文+评论全通，无需登录
小红书	Docker MCP（部署门槛高）	xhs-cli (1,477 ⭐)	pipx install 一行搞定，tier 2→1
微信公众号	miku_ai（停更 20 个月）	Exa 搜索+阅读	零配置，tier 2→0
雪球 Cookie	browser_cookie3（停更 15 月）	rookiepy (Rust 内核)	更稳定，保留 fallback
B站	纯 yt-dlp	yt-dlp + bili-cli (590 ⭐)	增加热门/排行/搜索

渠道调整

• ➕ B站增加 bili-cli 增强后端
• ➖ 移除 Discord（仅元数据，不够实用）
• ➖ 移除头条（HTML 解析脆弱）

社区 PR 合并

• #225 fix(youtube): 跨平台 yt-dlp 配置路径 (@biyusku)
• #200 docs: 日文 README (@eltociear)
• #211 docs: 抖音/小红书可选 MCP 文档 (@JNHFlow21)

端到端验证

所有 16 个渠道经过真实网络测试：

• ✅ Reddit: rdt search 返回真实帖子+全部评论
• ✅ Twitter: twitter search 返回真实推文+互动数据
• ✅ B站: bili hot 返回热门视频+播放量
• ✅ 微信: Exa 搜索返回公众号文章+全文阅读
• ✅ 小红书: xhs CLI 安装正常，登录后可用
• ✅ 77 tests passing

升级方式

pip install --upgrade agent-reach
agent-reach doctor

注意：Twitter 用户需要重新安装工具：

pipx install twitter-cli
# bird CLI 已弃用，可卸载：npm uninstall -g @steipete/bird

🆕 新功能

• 微信公众号渠道 — Agent Reach 第 13 个渠道
  • 搜索：miku_ai（搜狗微信搜索）按关键词搜公众号文章
  • 阅读：wechat-article-for-ai（Camoufox 隐身浏览器）读取全文 Markdown
  • 安装：pip install miku_ai camoufox[geoip] markdownify beautifulsoup4 httpx

🐛 修复

• Windows 中文系统 doctor 崩溃 (#64) — text=True 在 GBK 系统解码 UTF-8 报错
• Windows .cmd 文件找不到 (#64) — npm 全局安装的工具用 shutil.which() 解析完整路径

📝 文档

• 澄清 agent-reach 没有 read/search 命令 (#58, #59)
• 修复小红书 SKILL.md 函数名 (#65)
• 新增 CONTRIBUTING.md (#62)
• README 中英文更新

更新命令

pip install --upgrade https://github.com/Panniantong/agent-reach/archive/main.zip

🎉 v1.2.0

✨ 新增

• 抖音（Douyin）渠道 — 基于 douyin-mcp-server，通过 mcporter 调用
  • 支持视频解析（分享链接 → 视频信息 + 下载URL）
  • 无需认证，安装即用
  • 与小红书 MCP 同架构，部署方式一致

🗑️ 移除

• Instagram — 上游工具不成熟，暂时移除

📝 文档改进

• Cookie-Editor 统一为所有 cookie 平台的首选登录方式（#27）
• 更新 install.md / SKILL.md / README 文档

📊 渠道状态

渠道	工具	状态
Twitter/X	bird CLI	✅
Reddit	curl + OAuth	✅
YouTube	yt-dlp	✅
GitHub	gh CLI	✅
Bilibili	curl	✅
小红书	xiaohongshu-mcp	✅
抖音	douyin-mcp-server	✅ 新增
LinkedIn	linkedin-scraper-mcp	✅
Boss直聘	mcp-bosszp	⚠️ 上游待修复
Web	Jina Reader	✅
Exa	Exa MCP	✅
RSS	feedparser	✅

安装/升级

pip install --upgrade https://github.com/Panniantong/agent-reach/archive/main.zip

🆕 New Channels / 新增渠道

📷 Instagram

• Read public posts and profiles via instaloader (⭐9.8K)
• Search via Exa (free, no API key)
• Optional cookie login for private content

💼 LinkedIn

• Read person profiles, company pages, and job details via linkedin-scraper-mcp
• Search people and jobs via MCP, with Exa fallback
• Fallback to Jina Reader when MCP is not configured

🏢 Boss直聘 (BOSS Zhipin)

• QR code login via mcp-bosszp
• Job search and recruiter greeting via MCP
• Fallback to Jina Reader for reading job pages

📈 Improvements / 改进

• Channel count: 9 → 12 (12/12 passing agent-reach doctor)
• CLI: added search-instagram, search-linkedin, search-bosszhipin subcommands
• Updated install guide with setup instructions for new channels
• Added CHANGELOG.md

📦 Upgrade / 升级

pip install --upgrade https://github.com/Panniantong/agent-reach/archive/main.zip

---

Full Changelog: https://github.com/Panniantong/Agent-Reach/compare/v1.0.0...v1.1.0