# Agent-Reach changelog

> Give your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.

- Vendor: Panniantong
- Category: AI
- Platforms: Android
- Official site: https://github.com/Panniantong/Agent-Reach
- Tracked by: What's New (https://whatsnew.fyi/product/agent-reach)
- Harvested from: GitHub (Panniantong/Agent-Reach)
- Entries below: 7 (newest first)

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

## Releases

### v1.5.0 — v1.5.0 — 能力层:多后端路由 + 真体检 + OpenCLI

- Date: 2026-06-11
- Version: v1.5.0
- Original notes: https://github.com/Panniantong/Agent-Reach/releases/tag/v1.5.0
- Permalink: https://whatsnew.fyi/product/agent-reach/releases/v1.5.0
- Labels: Platforms: Android

- **changed** — Restructured platform routing to use ordered fallback backends with primary and secondary options, enabling seamless switching between access methods without user intervention
- **changed** — Xiaohongshu now routes through OpenCLI (desktop, zero-config browser login reuse) as primary, followed by xiaohongshu-mcp (server, QR code), with xhs-cli as legacy fallback
- **changed** — Reddit routing now uses OpenCLI as primary with rdt-cli as secondary, with explicit documentation that no zero-config path exists due to API authentication requirements
- **changed** — Bilibili now routes through bili-cli (search/trending/details without login) as primary, OpenCLI (subtitles) as secondary, with search API as fallback
- **removed** — Removed yt-dlp support for Bilibili due to comprehensive 412 rate limiting blocks; yt-dlp continues to support YouTube
- **changed** — Twitter routing prioritizes twitter-cli with OpenCLI as secondary option with detection and retry logic
- **changed** — Enhanced doctor command to perform actual command execution testing instead of just checking file existence, identifying broken installations and providing direct copy-paste remediation steps
- **added** — Doctor command now reports which backend is currently active for each multi-backend platform via active_backend in --json output
- **changed** — Improved doctor reliability so that failure in one channel no longer impacts the entire health check
- **added** — Added OpenCLI desktop backend support with automatic npm installation and Chrome extension installation, reusing existing browser login state
- **changed** — Skill system rewritten to reliably trigger research features and provide non-intrusive version update notifications after task completion
- **fixed** — Fixed check-update command to not suggest updating when local version is ahead of latest release, preventing unintended downgrades
- **added** — Increased test coverage from 107 to 162 tests including contract tests, disconnection scenarios, and backend priority matrix validation
- **fixed** — Fixed Twitter routing blocking, watch downgrade prompts, and dead proxy switches through three rounds of adversarial review
- **added** — Verified 13 channels with 32 end-to-end real device tests all passing, based on June 2026 hardware testing
- **added** — Integrated upstream projects OpenCLI and xiaohongshu-mcp as new backend options

##### 这一版是什么

**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](https://github.com/jackwener/opencli)(@jackwener)、[xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp)(@xpzouying)。

🤖 Generated with [Claude Code](https://claude.com/claude-code)

### v1.4.2 — v1.4.2 — 诚实瘦身：移除失修渠道，新增转写与 doctor --json

- Date: 2026-06-10
- Version: v1.4.2
- Original notes: https://github.com/Panniantong/Agent-Reach/releases/tag/v1.4.2
- Permalink: https://whatsnew.fyi/product/agent-reach/releases/v1.4.2
- Labels: Platforms: Android

- **removed** — Remove Douyin, Weibo, and WeChat Official Account channels due to upstream maintenance issues and unreliability
- **added** — Add `agent-reach transcribe <link or file>` command for Whisper audio transcription via CLI with Groq free key and automatic OpenAI fallback
- **added** — Add `agent-reach doctor --json` flag for machine-readable health check output with added legend for status indicators
- **changed** — Rewrite Skill descriptions with platform aliases and action trigger words to improve Agent auto-invocation reliability
- **fixed** — Fix Reddit installation command to install rdt-cli 0.4.2 from GitHub source instead of non-existent PyPI package
- **fixed** — Fix Xiaoyuzhouh transcription quality by correcting Whisper prompt to require Chinese punctuation and including prompt in 429 retries
- **added** — Add optional `--polish` flag for transcription output polishing using free Llama 3.3 70B
- **fixed** — Fix Windows Chinese character encoding issues by enforcing UTF-8 environment for subprocesses and MCP servers

##### 渠道调整

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

- **抖音**：上游 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.1 — v1.4.1 — 修复源码安装失败(wheel 重复打包)

- Date: 2026-06-10
- Version: v1.4.1
- Original notes: https://github.com/Panniantong/Agent-Reach/releases/tag/v1.4.1
- Permalink: https://whatsnew.fyi/product/agent-reach/releases/v1.4.1
- Labels: Platforms: Android

- **fixed** — Fixed wheel packaging failure when installing from source due to duplicate file entries in archive, caused by overlapping package configuration in pyproject.toml
- **added** — Added wheel-build gate to CI pipeline that verifies wheel builds without duplicate entries, confirms data files are included in package, and performs smoke installation in clean virtual environment

##### 修复

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

或手动:

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

### v1.4.0 — v1.4.0 — 上游大迁移：更稳定、更简单、更可靠

- Date: 2026-03-31
- Version: v1.4.0
- Original notes: https://github.com/Panniantong/Agent-Reach/releases/tag/v1.4.0
- Permalink: https://whatsnew.fyi/product/agent-reach/releases/v1.4.0
- Labels: Platforms: Android

- **changed** — Migrate Twitter/X upstream from bird CLI to twitter-cli for stable functionality
- **changed** — Migrate Reddit upstream from Exa crawling to rdt-cli with search, full text, and comments support
- **changed** — Migrate Xiaohongshu upstream from Docker MCP to xhs-cli with simplified installation via pipx
- **changed** — Migrate WeChat official accounts upstream from miku_ai to Exa search with zero configuration
- **changed** — Migrate Xueqiu Cookie upstream from browser_cookie3 to rookiepy for improved stability
- **changed** — Enhance Bilibili upstream to use yt-dlp with bili-cli for trending, rankings, and search capabilities
- **added** — Add bili-cli enhanced backend support for Bilibili channel
- **removed** — Remove Discord channel due to limited metadata usefulness
- **removed** — Remove Toutiao channel due to fragile HTML parsing
- **fixed** — Fix cross-platform yt-dlp configuration path for YouTube

##### 核心变更：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

###### 升级方式

```bash
pip install --upgrade agent-reach
agent-reach doctor
```

**注意**：Twitter 用户需要重新安装工具：
```bash
pipx install twitter-cli
#### bird CLI 已弃用，可卸载：npm uninstall -g @steipete/bird
```

### v1.3.0 — v1.3.0 — WeChat 公众号 + Windows 修复

- Date: 2026-03-04
- Version: v1.3.0
- Original notes: https://github.com/Panniantong/Agent-Reach/releases/tag/v1.3.0
- Permalink: https://whatsnew.fyi/product/agent-reach/releases/v1.3.0
- Labels: Platforms: Android

- **added** — WeChat official account channel as the 13th supported channel
- **fixed** — Doctor command crashing on Windows Chinese systems due to UTF-8 decoding error with GBK encoding
- **fixed** — npm globally installed tools not found on Windows by using shutil.which() to resolve full paths

##### 🆕 新功能

- **微信公众号渠道** — 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 中英文更新

##### 更新命令

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

### v1.2.0 — v1.2.0 — 新增抖音，移除 Instagram

- Date: 2026-02-26
- Version: v1.2.0
- Original notes: https://github.com/Panniantong/Agent-Reach/releases/tag/v1.2.0
- Permalink: https://whatsnew.fyi/product/agent-reach/releases/v1.2.0
- Labels: Platforms: Android

- **added** — Add Douyin channel support based on douyin-mcp-server with video parsing from share links to video information and download URLs, requiring no authentication
- **removed** — Remove Instagram channel due to upstream tool immaturity
- **changed** — Establish Cookie-Editor as the preferred login method for all cookie-based platforms

##### 🎉 v1.2.0

###### ✨ 新增
- **抖音（Douyin）渠道** — 基于 [douyin-mcp-server](https://github.com/yzfly/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 | ✅ |

###### 安装/升级
```bash
pip install --upgrade https://github.com/Panniantong/agent-reach/archive/main.zip
```

### v1.1.0 — v1.1.0 — Instagram, LinkedIn & Boss直聘

- Date: 2026-02-25
- Version: v1.1.0
- Original notes: https://github.com/Panniantong/Agent-Reach/releases/tag/v1.1.0
- Permalink: https://whatsnew.fyi/product/agent-reach/releases/v1.1.0
- Labels: Platforms: Android

- **added** — Instagram channel with ability to read public posts and profiles via instaloader and search via Exa
- **added** — Instagram optional cookie login for private content access
- **added** — LinkedIn channel with ability to read person profiles, company pages, and job details via linkedin-scraper-mcp
- **added** — LinkedIn search for people and jobs via MCP with Exa fallback
- **added** — Boss Zhipin channel with QR code login via mcp-bosszp
- **added** — Boss Zhipin job search and recruiter greeting via MCP with Jina Reader fallback
- **added** — CLI subcommands search-instagram, search-linkedin, and search-bosszhipin
- **added** — CHANGELOG.md file
- **changed** — Channel count increased from 9 to 12
- **changed** — LinkedIn fallback to Jina Reader when MCP is not configured
- **changed** — Boss Zhipin fallback to Jina Reader for reading job pages
- **changed** — Updated install guide with setup instructions for new channels

##### 🆕 New Channels / 新增渠道

###### 📷 Instagram
- Read public posts and profiles via [instaloader](https://github.com/instaloader/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](https://github.com/stickerdaniel/linkedin-mcp-server)
- 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](https://github.com/mucsbr/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 / 升级
```bash
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