From f65526cbaaad3879473acc1ba6dbefd195caf2be Mon Sep 17 00:00:00 2001 From: Pnant <73925474+Panniantong@users.noreply.github.com> Date: Thu, 11 Jun 2026 20:23:00 +0800 Subject: [PATCH] =?UTF-8?q?docs(readme):=20full-pass=20audit=20=E2=80=94?= =?UTF-8?q?=20purge=20pre-v1.5=20worldview=20from=20both=20READMEs?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Two factual errors and a batch of stale-world copy found by auditing the full README against v1.5.0 reality: - "what install does" claimed twitter-cli/rdt-cli are installed by default — they never are (opt-in via --channels); now describes the real flow incl. the channel menu step - zero-config examples listed "read a tweet" — Twitter is tier 1, not zero-config; list now shows truly free channels (incl. bili search) - FAQ rewrites: xiaohongshu (OpenCLI-first, mcp for servers, xhs-cli as legacy fallback), Reddit (login mandatory, OpenCLI first, pinned rdt source), free-cost answer (tool list updated, proxy rescoped to restricted networks) - platform table stops advertising write ops (发推/Post·Comment·Like) — aligned with the skill's fetch-only boundary - bilibili pain-point line updated to the 412 reality - credits gain OpenCLI and xiaohongshu-mcp - README_en: same FAQ/table/doctor-sample fixes Co-Authored-By: Claude Fable 5 --- README.md | 29 +++++++++++++++-------------- docs/README_en.md | 6 +++--- 2 files changed, 18 insertions(+), 17 deletions(-) diff --git a/README.md b/README.md index e5d7204..bad92ad 100644 --- a/README.md +++ b/README.md @@ -28,7 +28,7 @@ AI Agent 已经能帮你写代码、改文档、管项目——但你让它去 - 🐦 "帮我搜一下推特上大家怎么评价这个产品" → **搜不了**，Twitter API 要付费 - 📖 "去 Reddit 上看看有没有人遇到过同样的 bug" → **403 被封**，服务器 IP 被拒 - 📕 "帮我看看小红书上这个品的口碑" → **打不开**，必须登录才能看 -- 📺 "B站上有个技术视频，帮我总结一下" → **连不上**，海外/服务器 IP 被屏蔽 +- 📺 "B站上有个技术视频，帮我总结一下" → **拿不到**，通用下载工具被 B站风控全面拦截 - 🔍 "帮我在网上搜一下最新的 LLM 框架对比" → **没有好用的搜索**，要么付费要么质量差 - 🌐 "帮我看看这个网页写了啥" → **抓回来一堆 HTML 标签**，根本没法读 - 📦 "这个 GitHub 仓库是干嘛的？Issue 里说了什么？" → 能用，但认证配置很麻烦 @@ -75,7 +75,7 @@ AI Agent 已经能帮你写代码、改文档、管项目——但你让它去 | 📡 **RSS** | 阅读任意 RSS/Atom 源 | — | 无需配置 | | 🔍 **全网搜索** | — | 全网语义搜索 | 自动配置（MCP 接入，免费无需 Key） | | 📦 **GitHub** | 读公开仓库 + 搜索 | 私有仓库、提 Issue/PR、Fork | 告诉 Agent「帮我登录 GitHub」 | -| 🐦 **Twitter/X** | 读单条推文 | 搜索推文、浏览时间线、发推 | 告诉 Agent「帮我配 Twitter」 | +| 🐦 **Twitter/X** | 读单条推文 | 搜索推文、浏览时间线、读长文 | 告诉 Agent「帮我配 Twitter」 | | 📺 **B站** | 搜索 + 视频详情（bili-cli，无需登录） | 字幕（OpenCLI） | 告诉 Agent「帮我配 B站」 | | 📖 **Reddit** | —（没有零配置路径：匿名接口已被封） | 搜索 + 读帖子和评论 | 桌面装 OpenCLI 用浏览器登录态；或 rdt-cli + Cookie | | 📕 **小红书** | — | 搜索、阅读、评论 | 桌面装 OpenCLI（刷过小红书即可用）；服务器用 xiaohongshu-mcp 扫码 | @@ -127,13 +127,14 @@ AI Agent 已经能帮你写代码、改文档、管项目——但你让它去
它会做什么？（点击展开） -1. **安装 CLI 工具** — `pip install` 装好 `agent-reach` 命令行 -2. **安装系统依赖** — 自动检测并安装 Node.js、gh CLI、mcporter、twitter-cli、rdt-cli 等 +1. **安装 CLI 工具** — `pip install` 装好 `agent-reach` 命令行（自带 yt-dlp、feedparser） +2. **安装系统基建** — 自动检测并安装 Node.js、gh CLI、mcporter 3. **配置搜索引擎** — 通过 MCP 接入 Exa（免费，无需 API Key） 4. **检测环境** — 判断是本地电脑还是服务器，给出对应的配置建议 -5. **注册 SKILL.md** — 在 Agent 的 skills 目录安装使用指南，以后 Agent 遇到"搜推特"、"看视频"这类需求，会自动知道该调哪个上游工具 +5. **注册 SKILL.md** — 在 Agent 的 skills 目录安装使用指南，以后 Agent 遇到"全网调研"、"搜推特"、"看视频"这类需求，会自动知道该调哪个上游工具 +6. **问你要不要更多** — 默认只激活 6 个零配置渠道；小红书、Twitter、Reddit 这些需要登录的，Agent 会列菜单问你要哪些，点名才装 -安装完之后，`agent-reach doctor` 一条命令告诉你每个渠道的状态。 +安装完之后，`agent-reach doctor` 一条命令告诉你每个渠道的状态、当前走哪条路。
--- @@ -144,12 +145,12 @@ AI Agent 已经能帮你写代码、改文档、管项目——但你让它去 - "帮我看看这个链接" → `curl https://r.jina.ai/URL` 读任意网页 - "这个 GitHub 仓库是做什么的" → `gh repo view owner/repo` -- "这个视频讲了什么" → `yt-dlp --dump-json URL` 提取字幕 -- "帮我看看这条推文" → `twitter tweet URL` +- "这个 YouTube 视频讲了什么" → `yt-dlp` 提取字幕 +- "B站搜一下 AI 教程" → `bili search`（无需登录） +- "全网搜一下 LLM 框架对比" → Exa 语义搜索 - "订阅这个 RSS" → `feedparser` 解析 -- "搜一下 GitHub 上有什么 LLM 框架" → `gh search repos "LLM framework"` -**不需要记命令。** Agent 读了 SKILL.md 之后自己知道该调什么。 +**不需要记命令。** Agent 读了 SKILL.md 之后自己知道该调什么。需要登录的平台（小红书、Twitter、Reddit），告诉 Agent「帮我配 XXX」即可解锁。 --- @@ -292,7 +293,7 @@ Agent Reach uses twitter-cli with cookie auth — zero API fees. Install with `p
Reddit 返回 403 怎么办？ -Agent Reach 使用 [rdt-cli](https://github.com/public-clis/rdt-cli) 访问 Reddit。Reddit 自 2024 年起要求认证，安装后需运行 `rdt login` 登录。安装：`pipx install 'git+https://github.com/public-clis/rdt-cli.git'`（PyPI 版本暂时落后，从 GitHub 装），然后 `rdt login`（自动从浏览器提取 Cookie）。之后 Agent 可以用 `rdt search "关键词"` 搜索、`rdt read POST_ID` 读帖子全文和评论。 +Reddit 所有访问都需要登录态（匿名接口已被全面封锁，官方 API 需人工审批）。桌面首选 **OpenCLI**：浏览器里登录过 reddit.com 即可直接 `opencli reddit search "关键词"`。备选 [rdt-cli](https://github.com/public-clis/rdt-cli)：`pipx install 'git+https://github.com/public-clis/rdt-cli.git@5e4fb3720d5c174e976cd425ccc3b879d52cac66'`（与代码同一钉定版本，PyPI 落后），然后 `rdt login`。中国大陆网络访问 Reddit 需要代理。
@@ -304,7 +305,7 @@ Agent Reach 使用 [rdt-cli](https://github.com/public-clis/rdt-cli) 访问 Redd
怎么让 AI Agent 读小红书？ -安装 `pipx install xiaohongshu-cli`，然后 `xhs login`（自动从浏览器提取 Cookie）。之后 Agent 就能用 `xhs search "关键词"` 搜索笔记、`xhs read NOTE_ID` 阅读详情、`xhs comments NOTE_ID` 查看评论了。不需要 Docker。 +桌面电脑首选 **OpenCLI**（`agent-reach install --channels opencli`）——它复用你浏览器里的登录态，平时刷过小红书就直接能用，零配置；装完在 Chrome 商店点一次「添加扩展」即可。之后 Agent 用 `opencli xiaohongshu search "关键词"` 搜索、`opencli xiaohongshu note URL` 读笔记。服务器上用 [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp)（自带无头浏览器，扫码登录）。已装过 xhs-cli 的老用户不受影响，它仍是备选后端（上游 2026-03 起停更，不推荐新装）。
@@ -318,14 +319,14 @@ Yes! Agent Reach is an installer + configuration tool — any AI coding agent th
Is this free? Any API costs? -100% free. All backends are open-source tools (twitter-cli, rdt-cli, xhs-cli, yt-dlp, Jina Reader, Exa, etc.) that don't require paid API keys. The only optional cost is a residential proxy (~$1/month) if you need Bilibili access from an overseas server. +100% free. All backends are open-source tools (OpenCLI, twitter-cli, bili-cli, rdt-cli, yt-dlp, Jina Reader, Exa, xiaohongshu-mcp, etc.) that don't require paid API keys. The only optional cost is a residential proxy (~$1/month) if your network blocks Reddit/Twitter (e.g. mainland China).
--- ## 致谢 -[twitter-cli](https://github.com/public-clis/twitter-cli) · [rdt-cli](https://github.com/public-clis/rdt-cli) · [xhs-cli](https://github.com/jackwener/xiaohongshu-cli) · [bili-cli](https://github.com/public-clis/bilibili-cli) · [yt-dlp](https://github.com/yt-dlp/yt-dlp) · [Jina Reader](https://github.com/jina-ai/reader) · [Exa](https://exa.ai) · [mcporter](https://github.com/nicobailon/mcporter) · [feedparser](https://github.com/kurtmckee/feedparser) · [linkedin-scraper-mcp](https://github.com/stickerdaniel/linkedin-mcp-server) +[OpenCLI](https://github.com/jackwener/opencli) · [twitter-cli](https://github.com/public-clis/twitter-cli) · [rdt-cli](https://github.com/public-clis/rdt-cli) · [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) · [xhs-cli](https://github.com/jackwener/xiaohongshu-cli) · [bili-cli](https://github.com/public-clis/bilibili-cli) · [yt-dlp](https://github.com/yt-dlp/yt-dlp) · [Jina Reader](https://github.com/jina-ai/reader) · [Exa](https://exa.ai) · [mcporter](https://github.com/nicobailon/mcporter) · [feedparser](https://github.com/kurtmckee/feedparser) · [linkedin-scraper-mcp](https://github.com/stickerdaniel/linkedin-mcp-server) ## 联系 diff --git a/docs/README_en.md b/docs/README_en.md index 7c7eb88..742edd7 100644 --- a/docs/README_en.md +++ b/docs/README_en.md @@ -67,7 +67,7 @@ Update Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/ma |----------|-------------|:-----:|-------| | 🌐 **Web** | Read | Zero config | Any URL → clean Markdown ([Jina Reader](https://github.com/jina-ai/reader) ⭐9.8K) | | 🐦 **Twitter/X** | Read · Search | Cookie | Cookie unlocks search, timeline, tweet reading, articles ([twitter-cli](https://github.com/public-clis/twitter-cli)) | -| 📕 **XiaoHongShu** | Read · Search · **Post · Comment · Like** | OpenCLI / MCP | Desktop: [OpenCLI](https://github.com/jackwener/opencli) (reuses browser session); Server: [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) (QR login); legacy xhs-cli still works | +| 📕 **XiaoHongShu** | Read · Search · Comments | OpenCLI / MCP | Desktop: [OpenCLI](https://github.com/jackwener/opencli) (reuses browser session); Server: [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) (QR login); legacy xhs-cli still works | | 💼 **LinkedIn** | Jina Reader (public pages) | Full profiles, companies, job search | Tell your Agent "help me set up LinkedIn" | | 💻 **V2EX** | Hot topics · Node topics · Topic detail + replies · User profile | Zero config | Public JSON API, no auth required. Great for tech community content | | 📈 **Xueqiu (雪球)** | Stock quotes · Search · Hot posts · Hot stocks | Browser cookie | Tell your Agent "help me set up Xueqiu" | @@ -193,7 +193,7 @@ $ agent-reach doctor 🔧 Configurable: ⬜ Reddit posts and comments — needs login: rdt-cli after `rdt login`, or OpenCLI browser session - ⬜ XiaoHongShu notes — needs cookie. Export from browser + ⬜ XiaoHongShu notes — desktop: OpenCLI (browser session); server: xiaohongshu-mcp (QR) Status: 6/9 channels available ``` @@ -302,7 +302,7 @@ Agent Reach uses twitter-cli which accesses Twitter via cookie auth — same as
How to read XiaoHongShu / 小红书 content programmatically? -Install `pipx install xiaohongshu-cli`, then `xhs login` (auto-extracts cookies from browser). Your agent can then use `xhs search "query"` to search notes, `xhs read NOTE_ID` to read details, `xhs comments NOTE_ID` to view comments. No Docker needed. +On desktop, prefer **OpenCLI** (`agent-reach install --channels opencli`) — it reuses your browser's logged-in session, so if you've browsed XiaoHongShu you're set; one Chrome Web Store click installs the extension. Then `opencli xiaohongshu search "query"` / `opencli xiaohongshu note URL`. On servers use [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) (bundled headless browser, QR login). Existing xhs-cli installs keep working as a fallback backend (upstream unmaintained since 2026-03, not recommended for new setups).
---