Skip to content

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

docs(auth): enforce explicit cookie guidance

Pnant18cce856fb98
diff --git a/README.md b/README.md
index 38a40115..53055f70 100644
--- a/README.md
+++ b/README.md
@@ -84,7 +84,7 @@ AI Agent 已经能帮你写代码、改文档、管项目——但你让它去
| 📖 **Reddit** | —(没有零配置路径:匿名接口已被封) | 搜索 + 读帖子和评论 | 桌面装 OpenCLI 用浏览器登录态;或 rdt-cli + Cookie |
| 📘 **Facebook** | — | 搜索、主页、Feed、群组列表 | 桌面装 OpenCLI(复用 Chrome 登录态) |
| 📷 **Instagram** | — | 用户搜索、Profile、用户最近帖子、Explore | 桌面装 OpenCLI(复用 Chrome 登录态) |
-| 📕 **小红书** | — | 搜索、阅读、评论 | 桌面装 OpenCLI(刷过小红书即可用);服务器用 xiaohongshu-mcp 扫码 |
+| 📕 **小红书** | — | 搜索、阅读、评论 | OpenCLI 只用用户已有 Chrome 会话;MCP/存量工具用 Cookie-Editor |
| 💼 **LinkedIn** | Jina Reader 读公开页面 | Profile 详情、公司页面、职位搜索 | 告诉 Agent「帮我配 LinkedIn」 |
| 💻 **V2EX** | 热门帖子、节点帖子、帖子详情+回复、用户信息 | — | 无需配置 |
| 📈 **雪球** | 股票行情、搜索股票、热门帖子、热门股票排行 | — | 告诉 Agent「帮我配雪球」 |
@@ -92,7 +92,9 @@ AI Agent 已经能帮你写代码、改文档、管项目——但你让它去
> **不知道怎么配?不用查文档。** 直接告诉 Agent「帮我配 XXX」,它知道需要什么、会一步一步引导你。
>
-> 🍪 需要 Cookie/登录态的平台(Twitter、小红书、Reddit、Facebook、Instagram 等),优先让用户在自己的浏览器里登录。OpenCLI 复用 Chrome 登录态;传统 CLI 才需要 Cookie-Editor 导出 Cookie。
+> 🍪 Twitter 只接受用户通过 Cookie-Editor 手工导出的内容。Agent Reach 不替用户执行小红书登录,也不读取小红书浏览器 Cookie;OpenCLI 只使用用户已经存在且明确控制的 Chrome 会话。`agent-reach configure xhs-cookies` 不会把 Cookie 注入 OpenCLI / Chrome;没有现成会话时,改用 Cookie-Editor 导出后配置 xiaohongshu-mcp / 存量工具。
+>
+> Twitter Cookie 保存后仅供 `agent-reach doctor` 检查配置是否齐全;直接运行上游 `twitter` 命令前,仍需在当前进程环境中显式设置 `TWITTER_AUTH_TOKEN` 和 `TWITTER_CT0`。
>
> 🔒 Cookie 只存在你本地,不上传不外传。代码完全开源,随时可审查。
> 💻 本地电脑不需要代理。代理只有部署在服务器上才需要(~$1/月)。
@@ -211,7 +213,7 @@ channels/
| 搜全网 | [Exa](https://exa.ai) via [mcporter](https://github.com/nicobailon/mcporter) | — | AI 语义搜索,MCP 接入免 Key |
| GitHub | [gh CLI](https://cli.github.com) | — | 官方工具,认证后完整 API 能力 |
| 读 RSS | [feedparser](https://github.com/kurtmckee/feedparser) | — | Python 生态标准选择 |
-| 小红书 | [OpenCLI](https://github.com/jackwener/opencli)(桌面) | [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp)(服务器)▸ xhs-cli | xhs-cli 作者已转投 OpenCLI(24K Star);浏览器登录态零摩擦 |
+| 小红书 | [OpenCLI](https://github.com/jackwener/opencli)(桌面) | [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp)(服务器)▸ xhs-cli | OpenCLI 只用用户已有会话;其余后端用 Cookie-Editor 手工导出 |
| LinkedIn | [linkedin-scraper-mcp](https://github.com/stickerdaniel/linkedin-mcp-server) | Jina Reader | MCP 服务,浏览器自动化 |
> 📌 这些都是「当前选型」,基于真机实测定期复核。某条路失效了我们换下一条——`agent-reach doctor` 永远告诉你现在走的是哪条。
diff --git a/agent_reach/guides/setup-twitter.md b/agent_reach/guides/setup-twitter.md
index 1cccdfba..61eb9d4c 100644
--- a/agent_reach/guides/setup-twitter.md
+++ b/agent_reach/guides/setup-twitter.md
@@ -25,31 +25,43 @@ which twitter && echo "installed" || echo "not installed"
pipx install twitter-cli
```
-3. 测试是否配置好:
+3. 确认命令已安装(此时不做认证请求):
```bash
-twitter search "test" -n 1
+twitter --help
```
## 获取 Cookie(Cookie-Editor 方式,推荐)
1. 安装 [Cookie-Editor](https://cookie-editor.com/) 浏览器扩展
2. 登录 x.com
-3. 点击 Cookie-Editor 图标 → Export → 复制全部
+3. 点击 Cookie-Editor 图标 → Export → Header String
4. 运行配置命令:
```bash
-agent-reach configure twitter-cookies "粘贴的 cookie JSON"
+agent-reach configure twitter-cookies "粘贴的 Header String"
```
这会提取 `auth_token` 和 `ct0`,安全保存到
-`~/.agent-reach/config.yaml`。之后 `agent-reach doctor` 会只把凭据注入
-自己的 `twitter status` 子进程,不会修改当前 Shell 的环境变量。
+`~/.agent-reach/config.yaml`,供 `agent-reach doctor` 检查显式凭据是否齐全。
+`doctor` 不会执行 `twitter status`,不会实时验证账号是否可用,也不会修改当前 Shell。
+
+默认只写 `~/.agent-reach/config.yaml`。只有用户明确同意复制凭据并显式增加
+`--sync-legacy-twitter` 时,才会额外写入:
+
+- `~/.config/xfetch/session.json`
+- `~/.config/bird/credentials.env`
+
+```bash
+agent-reach configure twitter-cookies "粘贴的 Header String" --sync-legacy-twitter
+```
+
+`agent-reach uninstall` 只会提醒这些 legacy 副本,不会自动删除。需要清理时,
+先让用户确认,再手工删除上述两个文件。
`twitter` 是独立的上游命令,不会读取 Agent Reach 的配置文件。直接运行
-`twitter search/read/...` 时,需要让 twitter-cli 从浏览器登录态提取,
-或按下节在当前 Shell 设置环境变量;已经存在的环境变量优先于 Agent Reach
-保存的值。
+`twitter status/search/read/...` 时,必须按下节在当前 Shell 或子进程环境中
+显式设置 `TWITTER_AUTH_TOKEN` 和 `TWITTER_CT0`。不要依赖自动读取浏览器 Cookie。
## 手动设置 Cookie
diff --git a/agent_reach/guides/setup-xiaohongshu.md b/agent_reach/guides/setup-xiaohongshu.md
index f855da7f..f952acd4 100644
--- a/agent_reach/guides/setup-xiaohongshu.md
+++ b/agent_reach/guides/setup-xiaohongshu.md
@@ -1,48 +1,43 @@
# 小红书配置指南
## 功能说明
-读取和搜索小红书笔记。通过 [xhs-cli](https://github.com/jackwener/xiaohongshu-cli)(⭐1.5K,pipx 一行安装)实现。
+读取和搜索小红书笔记。桌面优先使用 OpenCLI,服务器使用
+[xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp);
+xhs-cli 仅作为已安装用户的存量备选。
## 前置条件
-- Python 3.10+(pipx 安装)
-- 浏览器已登录 xiaohongshu.com(用于导出 Cookie)
+- OpenCLI:用户已经存在且明确控制的 Chrome 小红书会话
+- xiaohongshu-mcp / 存量工具:Cookie-Editor 浏览器扩展
-## Agent 可自动完成的步骤
+## 认证边界
-### 1. 安装 xhs-cli
-```bash
-pipx install xiaohongshu-cli
-```
+Agent Reach 不替用户执行小红书登录,也不读取浏览器 Cookie。
-### 2. 登录(从浏览器提取 Cookie)
-```bash
-xhs login
-```
+OpenCLI 只使用用户已经存在且明确控制的 Chrome 会话。
+`agent-reach configure xhs-cookies` 不会把 Cookie 注入 OpenCLI 或 Chrome。
+如果没有现成会话,不要自动登录;改用 Cookie-Editor 手工导出后配置
+xiaohongshu-mcp 或存量工具:
-> 这会自动从浏览器提取 Cookie。如果自动提取失败,可以手动导入(见下方)。
+1. 在 Chrome 中安装 [Cookie-Editor](https://chromewebstore.google.com/detail/cookie-editor/hlkenndednhfkekhgcdicdfddnkalmdm) 扩展
+2. 用户自行在 xiaohongshu.com 准备要导出的会话
+3. 点击 Cookie-Editor 图标 → Export → Header String
+4. 把导出的字符串发给 Agent,运行:
-### 3. 验证
```bash
+agent-reach configure xhs-cookies "导出的 Cookie Header String"
agent-reach doctor
```
-应该看到小红书显示为 ✅。
+该显式命令会保存/导入用户提供的 xiaohongshu.com 同域 Cookie 集;执行前请
+确认 Cookie 名称和范围。非 xiaohongshu.com 域 Cookie 会被忽略。
-## 需要用户手动做的步骤
-
-如果 `xhs login` 自动提取失败,需要手动导入 cookies:
-
-> **推荐方式:Cookie-Editor 浏览器导出(最可靠)**
->
-> 1. 在 Chrome 中安装 [Cookie-Editor](https://chromewebstore.google.com/detail/cookie-editor/hlkenndednhfkekhgcdicdfddnkalmdm) 扩展
-> 2. 浏览器登录 xiaohongshu.com
-> 3. 点击 Cookie-Editor 图标 → Export → Header String
-> 4. 把导出的字符串发给 Agent,运行:`agent-reach configure xhs-cookies "导出的cookie字符串"`
->
-> **注意**:不要依赖 QR 扫码登录,Cookie-Editor 导出方式最简单可靠。
+如果 xiaohongshu-mcp 容器正在运行,配置命令会把 Cookie 导入容器;否则会写入
+owner-only 的本地文件,并打印后续手工导入路径。
## 使用示例
+先按 `agent-reach doctor --json` 的 `active_backend` 选择命令。存量 xhs-cli 示例:
+
搜索笔记:
```bash
xhs search "关键词"
@@ -61,7 +56,8 @@ xhs comments NOTE_ID
## 常见问题
**Q: Cookie 过期了?**
-A: 重新运行 `xhs login` 或通过 Cookie-Editor 重新导出。
+A: 重新通过 Cookie-Editor 手工导出,再运行
+`agent-reach configure xhs-cookies "新的 Cookie Header String"`。
**Q: 小红书提示 IP 风险?**
A: 推荐使用住宅代理:`export HTTP_PROXY="http://user:pass@ip:port"`。
@@ -69,7 +65,7 @@ A: 推荐使用住宅代理:`export HTTP_PROXY="http://user:pass@ip:port"`。
**Q: xhs-cli 不支持我的系统?**
A: 确保 Python 3.10+ 和 pipx 已安装。运行 `pipx install xiaohongshu-cli` 即可。
-## 备选方案:Docker MCP
+## 服务器方案:Docker MCP
如果你已经在使用 [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) Docker 方案,它也能正常工作:
@@ -82,4 +78,4 @@ docker run -d \
mcporter config add xiaohongshu http://localhost:18060/mcp --scope home
```
-xhs-cli 是当前推荐方案,不需要 Docker,安装更简单。
+该服务器后端使用上面的 Cookie-Editor 手工导出流程。
diff --git a/agent_reach/skill/SKILL.md b/agent_reach/skill/SKILL.md
index 918ba2dc..e65d4601 100644
--- a/agent_reach/skill/SKILL.md
+++ b/agent_reach/skill/SKILL.md
@@ -92,6 +92,15 @@ bili search "query" --type video -n 5
## 需登录态的平台(按 doctor 的 active_backend 选命令)
+Twitter 注意:`agent-reach configure twitter-cookies` 保存的 Cookie 只供
+`doctor` 检查配置是否齐全;`doctor` 不执行 `twitter status`,也不会设置当前
+Shell。直接运行 `twitter` 前,必须在子进程环境中显式提供
+`TWITTER_AUTH_TOKEN` 和 `TWITTER_CT0`,不得在日志或命令回显中暴露值。
+
+小红书注意:Agent Reach 不替用户登录,也不读取浏览器 Cookie。OpenCLI 只用
+用户已有且明确控制的 Chrome 会话;没有现成会话时不要自动登录,改用
+Cookie-Editor 手工导出后配置 xiaohongshu-mcp / 存量工具。
+
```bash
# Twitter 搜索(twitter-cli 首选;失败重试链见 social.md)
twitter search "query" -n 10
diff --git a/agent_reach/skill/SKILL_en.md b/agent_reach/skill/SKILL_en.md
index c30ed744..e102df1c 100644
--- a/agent_reach/skill/SKILL_en.md
+++ b/agent_reach/skill/SKILL_en.md
@@ -80,6 +80,17 @@ bili search "query" --type video -n 5
## Login-backed platforms (pick by doctor's active_backend)
+Twitter boundary: cookies saved by `agent-reach configure twitter-cookies`
+are used only by `doctor` to check whether explicit credentials are present.
+`doctor` does not run `twitter status` or configure the current shell. Before
+calling `twitter` directly, explicitly provide `TWITTER_AUTH_TOKEN` and
+`TWITTER_CT0` in the child-process environment without logging their values.
+
+XiaoHongShu boundary: Agent Reach must not log the user in or read browser
+cookies. OpenCLI may use only an existing Chrome session explicitly controlled
+by the user. If none exists, do not automate login; use a manual Cookie-Editor
+export with xiaohongshu-mcp or a legacy tool instead.
+
```bash
# Twitter search (twitter-cli preferred; retry chain in social.md)
twitter search "query" -n 10
diff --git a/agent_reach/skill/references/social.md b/agent_reach/skill/references/social.md
index 1bd5303c..fabfcfcb 100644
--- a/agent_reach/skill/references/social.md
+++ b/agent_reach/skill/references/social.md
@@ -6,7 +6,7 @@
小红书有三个后端,**先跑 `agent-reach doctor --json` 看 xiaohongshu 的 `active_backend` 是哪个**,再用对应命令组。
-### 后端 A:OpenCLI(桌面首选,复用浏览器登录态)
+### 后端 A:OpenCLI(桌面首选)
```bash
# 搜索笔记
@@ -25,14 +25,20 @@ opencli xiaohongshu feed -f yaml
opencli xiaohongshu user USER_ID -f yaml
```
-> 要求 Chrome 打开且装了 OpenCLI 扩展。报 AUTH_REQUIRED 说明浏览器里没登录小红书,让用户在 Chrome 里登录一次即可。
+> 要求 Chrome 打开且装了 OpenCLI 扩展。OpenCLI 只使用用户已经存在且明确控制
+> 的 Chrome 会话;Agent Reach 不替用户登录,也不读取浏览器 Cookie。
+> `agent-reach configure xhs-cookies` 不会把 Cookie 注入 OpenCLI。
+> 如果没有现成会话,不要自动登录;改走后端 B/C,并按对应的
+> Cookie-Editor 手工导出流程配置。
### 后端 B:xiaohongshu-mcp(服务器场景)
```bash
-# 未登录时:先查状态,再取二维码给用户扫
+# 认证前先让用户用 Cookie-Editor 手工导出,再显式导入
+agent-reach configure xhs-cookies "导出的 Cookie Header String"
+
+# 只读检查当前状态
mcporter call 'xiaohongshu.check_login_status()' --timeout 120000
-mcporter call 'xiaohongshu.get_login_qrcode()' --timeout 120000
# 搜索
mcporter call 'xiaohongshu.search_feeds(keyword: "query")' --timeout 120000
@@ -41,7 +47,10 @@ mcporter call 'xiaohongshu.search_feeds(keyword: "query")' --timeout 120000
mcporter call 'xiaohongshu.get_feed_detail(feed_id: "...", xsec_token: "...")' --timeout 120000
```
-> 首次调用会自动下载约 150MB 无头浏览器,务必带 `--timeout 120000`。未登录时 search 会挂死,先 check_login_status。
+> 首次调用会自动下载约 150MB 无头浏览器,务必带 `--timeout 120000`。
+> 认证只走 Cookie-Editor 手工导出;导入后先运行 `check_login_status`。
+> 该显式命令会保存/导入用户提供的 xiaohongshu.com 同域 Cookie 集,用户应
+> 确认范围;非 xiaohongshu.com 域 Cookie 会被忽略。
### 后端 C:xhs-cli(存量备选,上游 2026-03 起停更)
@@ -57,6 +66,10 @@ xhs feed # 推荐
### 通用注意事项
+> **认证边界**: Agent Reach 不得替用户执行小红书登录,也不得读取浏览器
+> Cookie。OpenCLI 只能使用用户已有且明确控制的 Chrome 会话;
+> xiaohongshu-mcp / 存量工具使用 Cookie-Editor 手工导出。
+>
> **xsec_token 限制**: 小红书强制 xsec_token 机制,**不能直接用裸 note_id 去读**。正确流程:先搜索/feed 拿结果,再用结果中的完整 URL/ID 去读。三个后端都一样。
>
> **频率控制**: 高频请求(批量搜索、深翻评论)会触发验证码,平台限制无法绕过。每次操作间隔 2-3 秒。
@@ -65,6 +78,18 @@ xhs feed # 推荐
## Twitter/X (twitter-cli)
+### 认证前置条件
+
+`agent-reach configure twitter-cookies "..."` 保存的 Cookie 只供
+`agent-reach doctor` 检查显式凭据是否齐全。`doctor` 不执行上游
+`twitter status`,也不会设置当前 Shell。运行下面任何 `twitter` 命令前,
+必须在同一个 Shell 或子进程环境中显式提供:
+
+```bash
+export TWITTER_AUTH_TOKEN="..."
+export TWITTER_CT0="..."
+```
+
### 稳定命令
```bash
@@ -105,7 +130,8 @@ twitter likes
> **安装**: `pipx install twitter-cli`(确保 v0.8.5+)
>
-> **认证**: 推荐用 Cookie-Editor 导出后设置环境变量 `TWITTER_AUTH_TOKEN` + `TWITTER_CT0`。自动提取在 SSH/Docker/无头环境不可用。
+> **认证**: 只用 Cookie-Editor 手工导出,再显式设置环境变量
+> `TWITTER_AUTH_TOKEN` + `TWITTER_CT0`;不要依赖自动浏览器读取。
>
> **IP 风控**: 不要在 VPS/数据中心 IP 上频繁调用,尤其是 followers/following,有封号风险。使用住宅代理或本地环境。
>
diff --git a/docs/README_en.md b/docs/README_en.md
index b6246c0f..e059bd3d 100644
--- a/docs/README_en.md
+++ b/docs/README_en.md
@@ -73,7 +73,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 · 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 |
+| 📕 **XiaoHongShu** | Read · Search · Comments | OpenCLI / MCP | OpenCLI uses only an existing user-controlled Chrome session; MCP/legacy tools use a manual Cookie-Editor export |
| 📘 **Facebook** | Search · Profiles · Feed · Groups list | OpenCLI | Desktop only: [OpenCLI](https://github.com/jackwener/opencli) reuses your logged-in Chrome session |
| 📷 **Instagram** | User search · Profiles · Recent posts · Explore | OpenCLI | Desktop only: [OpenCLI](https://github.com/jackwener/opencli) reuses your logged-in Chrome session |
| 💼 **LinkedIn** | Jina Reader (public pages) | Full profiles, companies, job search | Tell your Agent "help me set up LinkedIn" |
@@ -156,7 +156,7 @@ No configuration needed — just tell your Agent:
- "Read this link" → `curl https://r.jina.ai/URL` for any web page
- "What's this GitHub repo about?" → `gh repo view owner/repo`
- "What does this video cover?" → `yt-dlp --dump-json URL` for subtitles
-- "Read this tweet" → `twitter tweet URL`
+- "Read this tweet" → set `TWITTER_AUTH_TOKEN` / `TWITTER_CT0`, then run `twitter tweet URL`
- "Subscribe to this RSS" → `feedparser` to parse feeds
- "Search GitHub for LLM frameworks" → `gh search repos "LLM framework"`
@@ -176,7 +176,17 @@ Don't use it? Don't configure it. Every step is optional.
### 🍪 Cookies — Free, 2 minutes
-Tell your Agent "help me configure Twitter cookies" — it'll guide you through exporting from your browser. Local computers can auto-import.
+Tell your Agent "help me configure Twitter cookies" — it'll guide you through a
+manual Cookie-Editor export. Agent Reach saves the values for `doctor` to check
+whether credentials are present; `doctor` does not run `twitter status`.
+Direct `twitter` commands still require `TWITTER_AUTH_TOKEN` and `TWITTER_CT0`
+in their process environment.
+
+For XiaoHongShu, Agent Reach never logs the user in or reads browser cookies.
+OpenCLI may use only an existing Chrome session explicitly controlled by the
+user. If none exists, do not automate login; use a manual Cookie-Editor export
+with xiaohongshu-mcp or a legacy tool. `agent-reach configure xhs-cookies`
+does not inject cookies into OpenCLI or Chrome.
### 🌐 Proxy — $1/month, restricted networks only
@@ -196,7 +206,6 @@ $ agent-reach doctor
✅ Ready to use:
✅ GitHub repos and code — public repos readable and searchable
- ✅ Twitter/X tweets — readable. Cookie unlocks search and posting
✅ YouTube video subtitles — yt-dlp
✅ Bilibili search & video detail — bili-cli (subtitles via OpenCLI)
✅ RSS/Atom feeds — feedparser
@@ -206,8 +215,9 @@ $ agent-reach doctor
⬜ Web semantic search — sign up at exa.ai for free key
🔧 Configurable:
+ ⚠️ Twitter/X — doctor checks only that explicit credentials exist; direct CLI still needs its environment variables
⬜ Reddit posts and comments — needs login: rdt-cli after `rdt login`, or OpenCLI browser session
- ⬜ XiaoHongShu notes — desktop: OpenCLI (browser session); server: xiaohongshu-mcp (QR)
+ ⬜ XiaoHongShu notes — OpenCLI needs an existing user-controlled session; otherwise use Cookie-Editor with MCP/legacy tools
⬜ Facebook / Instagram — desktop: OpenCLI browser session
Status: 6/9 channels available
@@ -260,7 +270,7 @@ Each channel file **actually probes** its candidate backends in order (not just
| Search the web | [Exa](https://exa.ai) via [mcporter](https://github.com/nicobailon/mcporter) | — | AI semantic search, MCP integration, no API key |
| GitHub | [gh CLI](https://cli.github.com) | — | Official tool, full API after auth |
| Read RSS | [feedparser](https://github.com/kurtmckee/feedparser) | — | Python ecosystem standard |
-| XiaoHongShu | [OpenCLI](https://github.com/jackwener/opencli) (desktop) | [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) (server) ▸ xhs-cli | The xhs-cli author moved to OpenCLI (24K stars); browser sessions mean zero friction |
+| XiaoHongShu | [OpenCLI](https://github.com/jackwener/opencli) (desktop) | [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) (server) ▸ xhs-cli | OpenCLI uses only an existing user-controlled session; other backends use a manual Cookie-Editor export |
| LinkedIn | [linkedin-scraper-mcp](https://github.com/stickerdaniel/linkedin-mcp-server) | Jina Reader | MCP server, browser automation |
| Xiaoyuzhou Podcast | `transcribe.sh` | — | `bash ~/.agent-reach/tools/xiaoyuzhou/transcribe.sh <URL>` |
diff --git a/docs/README_ja.md b/docs/README_ja.md
index b69600cb..88c15f54 100644
--- a/docs/README_ja.md
+++ b/docs/README_ja.md
@@ -63,7 +63,7 @@ Update Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/ma
|-----------------|------|:----------:|------|
| 🌐 **Web** | 閲覧 | 設定不要 | 任意のURL → クリーンなMarkdown([Jina Reader](https://github.com/jina-ai/reader) ⭐9.8K) |
| 🐦 **Twitter/X** | 閲覧・検索 | 設定不要 / Cookie | 単一ツイートはすぐに閲覧可能。Cookieで検索、タイムライン、投稿が解放([twitter-cli](https://github.com/public-clis/twitter-cli)) |
-| 📕 **小紅書** | 閲覧・検索・**投稿・コメント・いいね** | Cookie | `pipx install xiaohongshu-cli` + `xhs login`([xhs-cli](https://github.com/jackwener/xiaohongshu-cli)) |
+| 📕 **小紅書** | 閲覧・検索・コメント | OpenCLI / Cookie | OpenCLI はユーザー管理の既存 Chrome セッションだけを使用。MCP/旧ツールは Cookie-Editor を使用 |
| 🎵 **抖音** | 動画解析・ウォーターマークなしダウンロード | mcporter | [douyin-mcp-server](https://github.com/yzfly/douyin-mcp-server)、ログイン不要 |
| 💼 **LinkedIn** | Jina Reader(公開ページ) | プロフィール、企業、求人検索 | エージェントに「LinkedInの設定を手伝って」と伝えてください |
| 💬 **WeChat記事** | 検索 + 閲覧 | 設定不要 | WeChat公式アカウント記事の検索+閲覧(完全Markdown)([Exa](https://exa.ai) + [Camoufox](https://github.com/daijro/camoufox)(オプション)) |
@@ -74,7 +74,7 @@ Update Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/ma
| 🔍 **Web検索** | 検索 | 自動設定 | インストール時に自動設定、無料、APIキー不要([Exa](https://exa.ai)、[mcporter](https://github.com/nicepkg/mcporter)経由) |
| 📦 **GitHub** | 閲覧・検索 | 設定不要 | [gh CLI](https://cli.github.com) 搭載。公開リポジトリはすぐ使える。`gh auth login`でFork、Issue、PRが解放 |
| 📺 **YouTube** | 閲覧・**検索** | 設定不要 | 字幕 + 1800以上の動画サイトでの検索([yt-dlp](https://github.com/yt-dlp/yt-dlp) ⭐148K) |
-| 📺 **Bilibili** | 閲覧・**検索** | 設定不要 / プロキシ | 動画情報 + 字幕 + 検索。ローカルはそのまま動作、サーバーはプロキシが必要([yt-dlp](https://github.com/yt-dlp/yt-dlp)) |
+| 📺 **Bilibili** | 閲覧・**検索** | 設定不要 | [bili-cli](https://github.com/public-clis/bilibili-cli) で検索・動画情報(ログイン不要)、字幕は OpenCLI。yt-dlp は Bilibili の 412 制限により使用しません |
| 📡 **RSS** | 閲覧 | 設定不要 | 任意のRSS/Atomフィード([feedparser](https://github.com/kurtmckee/feedparser) ⭐2.3K) |
| 📖 **Reddit** | 検索・閲覧 | Cookie | 2024年以降認証が必要 — インストール後 `rdt login` を実行([rdt-cli](https://github.com/public-clis/rdt-cli)) |
@@ -127,7 +127,7 @@ Skillインストール後、エージェントは`agent-reach` CLIが利用可
- 「このリンクを読んで」→ `curl https://r.jina.ai/URL` で任意のWebページ
- 「このGitHubリポジトリは何?」→ `gh repo view owner/repo`
- 「この動画の内容は?」→ `yt-dlp --dump-json URL` で字幕取得
-- 「このツイートを読んで」→ `twitter tweet URL`
+- 「このツイートを読んで」→ `TWITTER_AUTH_TOKEN` / `TWITTER_CT0` を設定してから `twitter tweet URL`
- 「このRSSを購読して」→ `feedparser` でフィード解析
- 「GitHubでLLMフレームワークを検索して」→ `gh search repos "LLM framework"`
@@ -141,11 +141,15 @@ Skillインストール後、エージェントは`agent-reach` CLIが利用可
### 🍪 Cookie — 無料、2分
-エージェントに「Twitterのクッキーの設定を手伝って」と伝えてください — ブラウザからのエクスポート手順を案内してくれます。ローカルPCなら自動インポートも可能です。
+エージェントに「Twitterのクッキーの設定を手伝って」と伝えてください —
+Cookie-Editor による手動エクスポートを案内します。保存した値は
+`agent-reach doctor` が設定の有無を確認するためだけに使われ、doctor は
+`twitter status` を実行しません。上流の `twitter` コマンドには
+`TWITTER_AUTH_TOKEN` と `TWITTER_CT0` を明示的に設定してください。
### 🌐 プロキシ — 月額$1、サーバーのみ
-RedditとBilibiliはサーバーIPをブロックします。プロキシを取得し([Webshare](https://webshare.io) 推奨、月額$1)、アドレスをエージェントに伝えてください。
+通常はプロキシ不要です。ネットワーク上で Reddit/Twitter が遮断されている場合のみ、プロキシを設定してください。Bilibili は bili-cli を使用します。
> ローカルPCではプロキシは不要です。Reddit検索はプロキシなしでもrdt-cliで無料で動作します。
@@ -161,9 +165,8 @@ $ agent-reach doctor
✅ 利用可能:
✅ GitHubリポジトリとコード — 公開リポジトリの閲覧・検索可能
- ✅ Twitter/Xツイート — 閲覧可能。Cookieで検索・投稿が解放
✅ YouTube動画字幕 — yt-dlp
- ⚠️ Bilibili動画情報 — サーバーIPがブロックされる可能性あり、プロキシを設定してください
+ ✅ Bilibili検索・動画情報 — bili-cli(字幕は OpenCLI)
✅ RSS/Atomフィード — feedparser
✅ Webページ(任意のURL) — Jina Reader API
@@ -171,8 +174,9 @@ $ agent-reach doctor
⬜ Webセマンティック検索 — exa.aiで無料キーを取得
🔧 設定可能:
+ ⚠️ Twitter/X — doctor は明示的な認証情報の有無だけを確認。上流CLIには環境変数が必要
✅ Reddit投稿とコメント — rdt-cliで検索+閲覧(無料、プロキシ不要)
- ⬜ 小紅書ノート — Cookieが必要。ブラウザからエクスポート
+ ⬜ 小紅書ノート — OpenCLI は既存セッションのみ。それ以外は Cookie-Editor で MCP/旧ツールを設定
ステータス: 9チャンネル中6チャンネルが利用可能
```
@@ -199,9 +203,9 @@ channels/
├── twitter.py → twitter-cli ← 公式APIなどに差し替え可能…
├── youtube.py → yt-dlp ← YouTube API、Whisperなどに差し替え可能…
├── github.py → gh CLI ← REST API、PyGithubなどに差し替え可能…
-├── bilibili.py → yt-dlp ← bilibili-apiなどに差し替え可能…
-├── reddit.py → rdt-cli ← 検索+閲覧、Cookie認証が必要
-├── xiaohongshu.py → xhs-cli ← 他のXHSツールに差し替え可能…
+├── bilibili.py → bili-cli ▸ OpenCLI ▸ 検索 API(yt-dlp は 412 制限により退役)
+├── reddit.py → OpenCLI ▸ rdt-cli(ログイン状態が必要)
+├── xiaohongshu.py → OpenCLI ▸ xiaohongshu-mcp ▸ xhs-cli
├── douyin.py → mcporter MCP ← 他の抖音ツールに差し替え可能…
├── linkedin.py → linkedin-mcp ← LinkedIn APIに差し替え可能…
├── rss.py → feedparser ← atomaなどに差し替え可能…
@@ -217,11 +221,12 @@ channels/
|----------|--------|------|
| Webページ閲覧 | [Jina Reader](https://github.com/jina-ai/reader) | ⭐9.8K、無料、APIキー不要 |
| ツイート閲覧 | [twitter-cli](https://github.com/public-clis/twitter-cli) | 2.1K Star、Cookie認証、検索/閲覧/タイムライン/長文 |
-| 動画字幕 + 検索 | [yt-dlp](https://github.com/yt-dlp/yt-dlp) | ⭐148K、YouTube + Bilibili + 1800サイト |
+| YouTube 字幕 + 検索 | [yt-dlp](https://github.com/yt-dlp/yt-dlp) | YouTube と対応動画サイト向け(Bilibili には使用しません) |
+| Bilibili | [bili-cli](https://github.com/public-clis/bilibili-cli) ▸ OpenCLI ▸ 検索 API | yt-dlp は 412 制限で退役。bili-cli はログイン不要で検索・閲覧可能 |
| Web検索 | [Exa](https://exa.ai)([mcporter](https://github.com/nicepkg/mcporter)経由) | AIセマンティック検索、MCP統合、APIキー不要 |
| GitHub | [gh CLI](https://cli.github.com) | 公式ツール、認証後フルAPI |
| RSS閲覧 | [feedparser](https://github.com/kurtmckee/feedparser) | Pythonエコシステムの標準、⭐2.3K |
-| 小紅書 | [xhs-cli](https://github.com/jackwener/xiaohongshu-cli) | 1.5K Star、pipxインストール、検索/閲覧/コメント/投稿 |
+| 小紅書 | [OpenCLI](https://github.com/jackwener/opencli)(デスクトップ)▸ [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp)(サーバー)▸ xhs-cli | OpenCLI は既存のユーザー管理セッションのみ使用。その他は Cookie-Editor で手動設定 |
| 抖音 | [douyin-mcp-server](https://github.com/yzfly/douyin-mcp-server) | MCPサーバー、ログイン不要、動画解析 + ウォーターマークなしダウンロード |
| LinkedIn | [linkedin-scraper-mcp](https://github.com/stickerdaniel/linkedin-mcp-server) | ⭐900+、MCPサーバー、ブラウザ自動化 |
| WeChat記事 | [Exa](https://exa.ai)(検索+閲覧)+ [Camoufox](https://github.com/daijro/camoufox)(オプション) | ゼロ設定で検索+全文閲覧、Camoufoxでオプション強化 |
@@ -249,7 +254,7 @@ channels/
<details>
<summary><strong>Twitter/X APIに課金せずにAIエージェントで検索するには?</strong></summary>
-Agent Reach は [twitter-cli](https://github.com/public-clis/twitter-cli) をCookie認証で使用します — 完全無料、Twitter APIのサブスクリプションは不要です。`pipx install twitter-cli` でインストール後、Cookie-Editor Chrome拡張機能でTwitterのCookieをエクスポートし、`agent-reach configure twitter-cookies "your_cookies"` を実行すれば、`twitter search "query" -n 10` でエージェントが検索できるようになります。
+Agent Reach は [twitter-cli](https://github.com/public-clis/twitter-cli) をCookie認証で使用します。Cookie-Editor で手動エクスポートし、`agent-reach configure twitter-cookies "your_cookies"` で Agent Reach に保存します。これは doctor の設定確認用であり、doctor は上流の認証をリアルタイム検証しません。`twitter search "query" -n 10` を直接実行するプロセスには `TWITTER_AUTH_TOKEN` と `TWITTER_CT0` を明示的に渡してください。
</details>
<details>
@@ -273,7 +278,7 @@ Agent Reach は [rdt-cli](https://github.com/public-clis/rdt-cli) でRedditに
<details>
<summary><strong>Agent Reach は無料?APIのコストは?</strong></summary>
-100%無料でオープンソース。すべてのバックエンド(twitter-cli、rdt-cli、xhs-cli、yt-dlp、Jina Reader、Exa)は有料APIキーが不要な無料ツールです。唯一のオプションコストは、サーバーからBilibiliにアクセスする場合のレジデンシャルプロキシ(月額約$1)です。
+100%無料でオープンソース。すべてのバックエンド(twitter-cli、rdt-cli、OpenCLI、bili-cli、yt-dlp、Jina Reader、Exa)は有料APIキーが不要な無料ツールです。ネットワーク上で特定サイトが遮断されている場合のみ、プロキシ費用が発生することがあります。
</details>
<details>
@@ -285,7 +290,7 @@ Agent Reach はtwitter-cliを使用し、Cookie認証でTwitterにアクセス
<details>
<summary><strong>小紅書のコンテンツをプログラムで読むには?</strong></summary>
-`pipx install xiaohongshu-cli` でインストール後、`xhs login`(ブラウザからCookieを自動抽出)。エージェントは `xhs search "query"` でノートを検索、`xhs read NOTE_ID` で詳細を閲覧、`xhs comments NOTE_ID` でコメントを表示できます。Dockerは不要です。
+Agent Reach は小紅書へのログインを代行せず、ブラウザ Cookie も読み取りません。OpenCLI はユーザーが既に所有・管理している Chrome セッションだけを使用します。既存セッションがない場合は自動ログインせず、Cookie-Editor で手動エクスポートして xiaohongshu-mcp または旧ツールを設定してください。`agent-reach configure xhs-cookies` は OpenCLI / Chrome に Cookie を注入しません。
</details>
<details>
diff --git a/docs/README_ko.md b/docs/README_ko.md
index b587a97a..da035a6b 100644
--- a/docs/README_ko.md
+++ b/docs/README_ko.md
@@ -63,7 +63,7 @@ Update Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/ma
|----------|-------------|:-----:|-------|
| 🌐 **Web** | 읽기 | 없음 | 모든 URL → 깨끗한 Markdown ([Jina Reader](https://github.com/jina-ai/reader) ⭐9.8K) |
| 🐦 **Twitter/X** | 읽기 · 검색 | Cookie | Cookie로 검색, 타임라인, 트윗 읽기, 아티클 읽기 가능 ([twitter-cli](https://github.com/public-clis/twitter-cli)) |
-| 📕 **XiaoHongShu** | 읽기 · 검색 · **게시글 작성 · 댓글 · 좋아요** | Cookie | `pipx install xiaohongshu-cli` + `xhs login` ([xhs-cli](https://github.com/jackwener/xiaohongshu-cli)) |
+| 📕 **XiaoHongShu** | 읽기 · 검색 · 댓글 | OpenCLI / Cookie | OpenCLI는 사용자가 관리하는 기존 Chrome 세션만 사용하며, MCP/기존 도구는 Cookie-Editor 사용 |
| 🎵 **Douyin** | 비디오 파싱 · 워터마크 없는 다운로드 | mcporter | [douyin-mcp-server](https://github.com/yzfly/douyin-mcp-server) 통해, 로그인 불필요 |
| 💼 **LinkedIn** | Jina Reader (공개 페이지) | Cookie | 전체 프로필, 회사, 채용 공고 검색 가능. 에이전트에 "LinkedIn 설정 도와줘"라고 말하세요 |
| 💬 **WeChat Articles** | 검색 + 읽기 | 없음 | Exa를 통한 WeChat 공식 계정 게시글 검색 + 읽기 (설정 없음) + 선택적 [Camoufox](https://github.com/daijro/camoufox) |
@@ -74,7 +74,7 @@ Update Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/ma
| 🔍 **Web Search** | 검색 | 자동 설정 | 설치 시 자동 설정, 무료, API key 불필요 ([Exa](https://exa.ai) via [mcporter](https://github.com/nicepkg/mcporter)) |
| 📦 **GitHub** | 읽기 · 검색 | 없음 | [gh CLI](https://cli.github.com) 기반. 공개 저장소는 즉시 사용 가능. `gh auth login`으로 Fork, Issue, PR 기능 활성화 |
| 📺 **YouTube** | 읽기 · **검색** | 없음 | 자막 + 1800+ 비디오 사이트 검색 ([yt-dlp](https://github.com/yt-dlp/yt-dlp) ⭐148K) |
-| 📺 **Bilibili** | 읽기 · **검색** | 없음 / 프록시 | 비디오 정보 + 자막 + 검색. 로컬은 바로 작동, 서버는 프록시 필요 ([yt-dlp](https://github.com/yt-dlp/yt-dlp)) |
+| 📺 **Bilibili** | 읽기 · **검색** | 설정 없음 | [bili-cli](https://github.com/public-clis/bilibili-cli)로 검색·비디오 정보(로그인 불필요), 자막은 OpenCLI. yt-dlp는 Bilibili의 412 차단으로 사용하지 않음 |
| 📡 **RSS** | 읽기 | 없음 | 모든 RSS/Atom 피드 ([feedparser](https://github.com/kurtmckee/feedparser) ⭐2.3K) |
| 📖 **Reddit** | 검색 · 읽기 | Cookie | 2024년부터 인증 필요 — 설치 후 `rdt login` 실행 ([rdt-cli](https://github.com/public-clis/rdt-cli)) |
@@ -127,7 +127,7 @@ Skill이 설치된 후, 에이전트는 `agent-reach` CLI 사용 가능 여부
- "이 링크 읽어줘" → 모든 웹 페이지에 대해 `curl https://r.jina.ai/URL`
- "이 GitHub 저장소는 무엇인가요?" → `gh repo view owner/repo`
- "이 비디오는 무엇을 다루나요?" → 자막을 위해 `yt-dlp --dump-json URL`
-- "이 트윗 읽어줘" → `twitter tweet URL`
+- "이 트윗 읽어줘" → `TWITTER_AUTH_TOKEN` / `TWITTER_CT0` 설정 후 `twitter tweet URL`
- "이 RSS 구독해줘" → 피드 파싱을 위해 `feedparser`
- "GitHub에서 LLM 프레임워크 검색" → `gh search repos "LLM framework"`
@@ -141,11 +141,15 @@ Skill이 설치된 후, 에이전트는 `agent-reach` CLI 사용 가능 여부
### 🍪 Cookies — 무료, 2분
-에이전트에 "Twitter 쿠키 설정 도와줘"라고 말하세요 — 브라우저에서 내보내는 과정을 안내해 줍니다. 로컬 컴퓨터는 자동으로 가져올 수 있습니다.
+에이전트에 "Twitter 쿠키 설정 도와줘"라고 말하세요. Cookie-Editor 수동
+내보내기 절차를 안내합니다. 저장한 값은 `agent-reach doctor`가 명시적
+자격 증명의 존재 여부를 확인할 때만 사용하며, doctor는 `twitter status`를
+실행하지 않습니다. 직접 실행하는 `twitter` 프로세스에는
+`TWITTER_AUTH_TOKEN`과 `TWITTER_CT0`를 명시적으로 전달해야 합니다.
### 🌐 Proxy — 월 $1, 서버 전용
-Bilibili은 서버 IP를 차단합니다. 프록시를 가져오세요([Webshare](https://webshare.io) 추천, 월 $1)하고 주소를 에이전트에 보내세요.
+대부분의 사용자는 프록시가 필요 없습니다. 네트워크에서 Reddit/Twitter가 차단된 경우에만 프록시를 설정하세요. Bilibili는 bili-cli를 사용합니다.
> Reddit은 이제 프록시 없이 rdt-cli를 통해 무료로 작동합니다. 로컬 컴퓨터는 Bilibili에도 프록시가 필요 없습니다.
@@ -161,9 +165,8 @@ $ agent-reach doctor
✅ 사용 가능:
✅ GitHub 저장소 및 코드 — 공개 저장소 읽기 및 검색 가능
- ✅ Twitter/X 트윗 — 읽기 가능. Cookie로 검색 및 게시 가능
✅ YouTube 비디오 자막 — yt-dlp
- ⚠️ Bilibili 비디오 정보 — 서버 IP가 차단될 수 있음, 프록시 설정
+ ✅ Bilibili 검색 및 비디오 정보 — bili-cli (자막은 OpenCLI)
✅ RSS/Atom 피드 — feedparser
✅ 웹 페이지 (모든 URL) — Jina Reader API
@@ -171,8 +174,9 @@ $ agent-reach doctor
⬜ 웹 시맨틱 검색 — exa.ai에서 무료 key 발급
🔧 설정 가능:
+ ⚠️ Twitter/X — doctor는 명시적 자격 증명의 존재만 확인하며, 업스트림 CLI에는 환경 변수가 필요
✅ Reddit 글 및 댓글 — rdt-cli를 통한 검색 및 읽기 (무료, 프록시 없음)
- ⬜ XiaoHongShu 노트 — 쿠키 필요. 브라우저에서 내보내기
+ ⬜ XiaoHongShu 노트 — OpenCLI는 기존 세션만 사용하며, 그 외에는 Cookie-Editor로 MCP/기존 도구 설정
상태: 6/9 채널 사용 가능
```
@@ -199,9 +203,9 @@ channels/
├── twitter.py → twitter-cli ← 공식 API로 교체...
├── youtube.py → yt-dlp ← YouTube API, Whisper로 교체...
├── github.py → gh CLI → REST API, PyGithub로 교체...
-├── bilibili.py → yt-dlp → bilibili-api로 교체...
-├── reddit.py → rdt-cli → 검색 + 읽기, cookie 인증 필요
-├── xiaohongshu.py → mcporter MCP ← 다른 XHS 도구로 교체...
+├── bilibili.py → bili-cli ▸ OpenCLI ▸ 검색 API (yt-dlp는 412 차단으로 폐기)
+├── reddit.py → OpenCLI ▸ rdt-cli (로그인 상태 필요)
+├── xiaohongshu.py → OpenCLI ▸ xiaohongshu-mcp ▸ xhs-cli
├── douyin.py → mcporter MCP ← 다른 Douyin 도구로 교체...
├── linkedin.py → linkedin-mcp ← LinkedIn API로 교체...
├── rss.py → feedparser ← atoma로 교체...
@@ -218,12 +222,12 @@ channels/
| 웹 페이지 읽기 | [Jina Reader](https://github.com/jina-ai/reader) | 9.8K stars, 무료, API key 불필요 |
| 트윗 읽기 | [twitter-cli](https://github.com/public-clis/twitter-cli) | 2.1K stars, cookie 인증, 검색/읽기/타임라인/글 |
| Reddit | [rdt-cli](https://github.com/public-clis/rdt-cli) | 304 stars, cookie 인증, 검색 + 전체 글 + 댓글 |
-| 비디오 자막 + 검색 | [yt-dlp](https://github.com/yt-dlp/yt-dlp) | 154K stars, YouTube + Bilibili + 1800 사이트 |
-| Bilibili 향상 | [bili-cli](https://github.com/public-clis/bilibili-cli) | 590 stars, 인기/순위/검색/피드 |
+| YouTube 자막 + 검색 | [yt-dlp](https://github.com/yt-dlp/yt-dlp) | YouTube 및 지원 비디오 사이트용(Bilibili에는 사용하지 않음) |
+| Bilibili | [bili-cli](https://github.com/public-clis/bilibili-cli) ▸ OpenCLI ▸ 검색 API | yt-dlp는 412 차단으로 폐기. bili-cli는 로그인 없이 검색·읽기 가능 |
| 웹 검색 | [Exa](https://exa.ai) via [mcporter](https://github.com/nicobailon/mcporter) | AI 시맨틱 검색, MCP 통합, API key 불필요 |
| GitHub | [gh CLI](https://cli.github.com) | 공식 도구, 인증 후 전체 API |
| RSS 읽기 | [feedparser](https://github.com/kurtmckee/feedparser) | Python 생태계 표준, 2.3K stars |
-| XiaoHongShu | [xhs-cli](https://github.com/jackwener/xiaohongshu-cli) | 1.5K stars, pipx 설치, 검색/읽기/댓글/게시 |
+| XiaoHongShu | [OpenCLI](https://github.com/jackwener/opencli) (데스크톱) ▸ [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) (서버) ▸ xhs-cli | OpenCLI는 사용자가 관리하는 기존 세션만 사용하며, 그 외에는 Cookie-Editor로 수동 설정 |
| Douyin | [douyin-mcp-server](https://github.com/yzfly/douyin-mcp-server) | MCP 서버, 로그인 불필요, 비디오 파싱 + 워터마크 없는 다운로드 |
| LinkedIn | [linkedin-scraper-mcp](https://github.com/stickerdaniel/linkedin-mcp-server) | 1.2K stars, MCP 서버, 브라우저 자동화 |
| WeChat Articles | [Exa](https://exa.ai) (검색 + 읽기) + [Camoufox](https://github.com/daijro/camoufox) (선택) | 설정 없이 검색 + 전체 글 읽기 |
@@ -251,7 +255,7 @@ channels/
<details>
<summary><strong>AI 에이전트로 Twitter/X를 API 비용 없이 검색하는 방법?</strong></summary>
-Agent Reach는 cookie 기반 인증을 사용하는 [twitter-cli](https://github.com/public-clis/twitter-cli)를 사용합니다 — 완전 무료, Twitter API 구독 불필요. `pipx install twitter-cli`로 설치하고, 브라우저에서 x.com에 로그인되어 있는지 확인하세요. 에이전트가 `twitter search "query" -n 10`으로 검색할 수 있습니다.
+Agent Reach는 cookie 기반 인증을 사용하는 [twitter-cli](https://github.com/public-clis/twitter-cli)를 사용합니다. Cookie-Editor로 수동 내보낸 뒤 `agent-reach configure twitter-cookies "..."`로 저장합니다. 이 값은 doctor의 설정 확인용이며 실시간 인증 성공을 뜻하지 않습니다. `twitter search "query" -n 10`을 직접 실행하는 프로세스에는 `TWITTER_AUTH_TOKEN`과 `TWITTER_CT0`를 명시적으로 전달해야 합니다.
</details>
<details>
@@ -275,7 +279,7 @@ Agent Reach는 Reddit을 위해 [rdt-cli](https://github.com/public-clis/rdt-cli
<details>
<summary><strong>Agent Reach는 무료인가요? API 비용이 있나요?</strong></summary>
-100% 무료 오픈 소스입니다. 모든 백엔드(twitter-cli, rdt-cli, xhs-cli, yt-dlp, Jina Reader, Exa)는 유료 API key가 필요 없는 무료 도구입니다. 유일한 선택적 비용은 서버에서 Bilibili 접근이 필요한 경우 주거용 프록시(월 ~$1)입니다. Reddit은 프록시 없이 rdt-cli를 통해 무료로 작동합니다.
+100% 무료 오픈 소스입니다. 모든 백엔드(twitter-cli, rdt-cli, OpenCLI, bili-cli, yt-dlp, Jina Reader, Exa)는 유료 API key가 필요 없는 무료 도구입니다. 네트워크에서 특정 사이트가 차단된 경우에만 선택적으로 프록시 비용이 발생할 수 있습니다.
</details>
<details>
@@ -287,7 +291,7 @@ Agent Reach는 cookie 인증을 통해 Twitter에 접근하는 twitter-cli를
<details>
<summary><strong>XiaoHongShu / 小红书 콘텐츠를 프로그래밍 방식으로 읽는 방법?</strong></summary>
-`pipx install xiaohongshu-cli`를 설치한 다음 `xhs login`(브라우저에서 cookie 자동 추출)을 실행하세요. 에이전트가 `xhs search "query"`로 노트를 검색하고, `xhs read NOTE_ID`로 상세 정보를 읽고, `xhs comments NOTE_ID`로 댓글을 볼 수 있습니다. Docker 불필요.
+Agent Reach는 XiaoHongShu 로그인을 대신 수행하거나 브라우저 cookie를 읽지 않습니다. OpenCLI는 사용자가 이미 보유하고 명시적으로 관리하는 Chrome 세션만 사용합니다. 기존 세션이 없다면 자동 로그인하지 말고 Cookie-Editor로 수동 내보내 xiaohongshu-mcp 또는 기존 도구를 설정하세요. `agent-reach configure xhs-cookies`는 OpenCLI/Chrome에 cookie를 주입하지 않습니다.
</details>
<details>
diff --git a/docs/cookie-export.md b/docs/cookie-export.md
index 02e052c2..c384aa8c 100644
--- a/docs/cookie-export.md
+++ b/docs/cookie-export.md
@@ -19,8 +19,20 @@ Here's how to export cookies from your local computer — **fastest method first
That's it! Your Agent will run:
```bash
agent-reach configure twitter-cookies <your_pasted_string>
+agent-reach configure xhs-cookies <your_pasted_string>
```
+Twitter values saved by Agent Reach are used by `agent-reach doctor` only to
+check whether explicit credentials are present. Doctor does not run
+`twitter status`. Direct `twitter` commands still require
+`TWITTER_AUTH_TOKEN` and `TWITTER_CT0` in their process environment.
+
+This XiaoHongShu export is for xiaohongshu-mcp or a legacy tool.
+`agent-reach configure xhs-cookies` does not inject cookies into OpenCLI or
+Chrome. OpenCLI may use only an existing Chrome session explicitly controlled
+by the user. Agent Reach never logs the user in or reads XiaoHongShu browser
+cookies.
+
### Sites to export:
| Site | URL to visit | What to tell Agent |
diff --git a/docs/install.md b/docs/install.md
index 7c57e82a..67de80c0 100644
--- a/docs/install.md
+++ b/docs/install.md
@@ -96,11 +96,11 @@ After installing the basics, **ask the user** which additional channels they nee
>
> 还有这些可选渠道,你需要哪些?
>
-> - 🌟 **OpenCLI**(桌面推荐)— 一次安装,小红书/Reddit/Facebook/Instagram/B站字幕/Twitter 备选全解锁(复用浏览器登录态,零配置;只需在 Chrome 商店点一次"添加扩展")
+> - 🌟 **OpenCLI**(桌面推荐)— 一次安装即可提供 Reddit/Facebook/Instagram/B站字幕/Twitter 备选,并作为小红书桌面后端;小红书只使用用户已有且明确控制的 Chrome 会话
> - 🐦 **Twitter/X** — 搜推文、看时间线(需要登录 Cookie)
> - 📈 **雪球** — 股票行情、热门帖子(需要登录 Cookie)
> - 🎙️ **小宇宙播客** — 音频转文字(需要免费 Groq Key)
-> - 📕 **小红书** — 搜索、阅读、评论(桌面走 OpenCLI;服务器用 xiaohongshu-mcp 扫码)
+> - 📕 **小红书** — 搜索、阅读、评论(OpenCLI 用已有会话;MCP/存量工具用 Cookie-Editor)
> - 📖 **Reddit** — 搜索和阅读帖子(必须登录态:桌面 OpenCLI 或 rdt-cli + Cookie)
> - 📘 **Facebook** — 搜索、主页、Feed、群组列表(桌面走 OpenCLI,复用 Chrome 登录态)
> - 📷 **Instagram** — 用户搜索、Profile、用户最近帖子、Explore(桌面走 OpenCLI,复用 Chrome 登录态)
@@ -143,7 +143,7 @@ Some channels need credentials only the user can provide. Based on the doctor ou
> 3. 点击插件 → Export → Header String
> 4. 把导出的字符串发给 Agent
>
-> Twitter 与小红书只接受用户通过 Cookie-Editor 明确导出的内容,不会自动读取浏览器 Cookie。雪球、Bilibili 可按平台显式导入,例如 `agent-reach configure --from-browser chrome --platform xueqiu`;命令不会扫描或保存其他平台。OpenCLI 平台(Reddit、小红书桌面后端、Facebook、Instagram)优先复用 Chrome 登录态,不需要把 Cookie 发给 Agent。
+> Twitter 只接受用户通过 Cookie-Editor 明确导出的内容。Agent Reach 不替用户执行小红书登录,也不读取小红书浏览器 Cookie;小红书 OpenCLI 只使用用户已有且明确控制的 Chrome 会话。没有现成会话时,改用 Cookie-Editor 导出后配置 xiaohongshu-mcp / 存量工具。雪球、Bilibili 可按平台显式导入,例如 `agent-reach configure --from-browser chrome --platform xueqiu`;命令不会扫描或保存其他平台。
**Twitter search & posting:**
> "To unlock Twitter search, I need your Twitter cookies. Install the Cookie-Editor Chrome extension, go to x.com/twitter.com, click the extension → Export → Header String, and paste it to me."
@@ -152,6 +152,16 @@ Some channels need credentials only the user can provide. Based on the doctor ou
agent-reach configure twitter-cookies "PASTED_STRING"
```
+这会把 `twitter_auth_token` 和 `twitter_ct0` 保存给 Agent Reach 自己的
+`doctor` 配置检查。`doctor` 不会实时执行上游 `twitter status`,也不会修改
+当前 Shell。直接运行 `twitter search/read/...` 前,必须在该进程环境中显式设置:
+
+```bash
+export TWITTER_AUTH_TOKEN="..."
+export TWITTER_CT0="..."
+twitter search "query" -n 10
+```
+
> **代理说明(中国大陆等需要翻墙的网络环境):**
>
> twitter-cli 和 rdt-cli 使用 Python,在需要代理的网络环境下可通过环境变量配置代理。
@@ -179,8 +189,20 @@ rdt login # 自动提取浏览器 Cookie;服务器无浏览器时按 doctor
**XiaoHongShu / 小红书(多后端,按环境选):**
+> **认证边界:** Agent Reach 不替用户执行小红书登录,也不读取浏览器
+> Cookie。OpenCLI 只使用用户已经存在且明确控制的 Chrome 会话;
+> `agent-reach configure xhs-cookies` 不会把 Cookie 注入 OpenCLI 或 Chrome。
+> 如果没有现成会话,不要自动登录;改用 Cookie-Editor 手工导出后配置
+> xiaohongshu-mcp 或存量工具:
+>
+> ```bash
+> agent-reach configure xhs-cookies "key1=val1; key2=val2; ..."
+> ```
+>
+> 该显式命令会保存/导入用户提供的 xiaohongshu.com 同域 Cookie 集;请先确认
+> Cookie 名称和范围。非 xiaohongshu.com 域 Cookie 会被忽略。
+>
> **桌面电脑(推荐 OpenCLI):**
-> "小红书走 OpenCLI——复用你浏览器里的登录态,平时刷过小红书就直接能用,零配置。"
```bash
agent-reach install --channels opencli
@@ -191,17 +213,19 @@ agent-reach install --channels opencli
> 2. 点「添加至 Chrome」
> 3. 运行 `opencli doctor` 验证(显示 Extension: connected 即成功)
>
+> AUTH_REQUIRED 且用户没有现成会话时,不要替用户自动登录;改走下面的
+> xiaohongshu-mcp / 存量工具 Cookie-Editor 路线。
+>
> **服务器 / 无桌面环境(xiaohongshu-mcp):**
> 1. 从 https://github.com/xpzouying/xiaohongshu-mcp/releases 下载对应平台 binary 到 `~/.agent-reach/tools/`
> 2. 启动服务(首次运行会自动下载约 150MB 无头浏览器,耐心等完成)
-> 3. 让用户扫码登录(agent 调 `get_login_qrcode` 工具取二维码)
+> 3. 按上面的 Cookie-Editor 流程手工导入 Cookie
> 4. 接入:`mcporter config add xiaohongshu http://localhost:18060/mcp --scope home`
> 5. 调用时务必带 `--timeout 120000`
>
-> **存量用户(xhs-cli):** 已装好的 xhs-cli 继续作为备选后端工作(上游 2026-03 起停更,不推荐新装)。`xhs login` 自动提取浏览器 Cookie;失败时用 Cookie-Editor 导出后:
-> ```bash
-> agent-reach configure xhs-cookies "key1=val1; key2=val2; ..."
-> ```
+> **存量用户(xhs-cli):** 已装好的 xhs-cli 继续作为备选后端工作
+> (上游 2026-03 起停更,不推荐新装);认证仍使用上面的 Cookie-Editor
+> 手工导出流程。
**Facebook / Instagram(桌面 OpenCLI):**
> 这两个平台走 OpenCLI:复用用户自己的 Chrome 登录态,不保存账号密码,不走 Meta Graph API 审批流。服务器/无桌面环境不推荐支持。
@@ -337,7 +361,7 @@ If the user wants a different agent to handle it, let them choose.
| `agent-reach doctor` | Show channel status |
| `agent-reach watch` | Quick health + update check (for scheduled tasks) |
| `agent-reach check-update` | Check for new versions |
-| `agent-reach configure twitter-cookies "..."` | Unlock Twitter search + posting |
+| `agent-reach configure twitter-cookies "..."` | 保存 Twitter Cookie 供 doctor 检查;直接调用仍需显式环境变量 |
| `agent-reach configure proxy URL` | 保存代理地址(Agent 访问 Reddit/Twitter 等受限网络时读取它设置 HTTP_PROXY/HTTPS_PROXY,不是自动解锁开关) |
| `agent-reach configure groq-key gsk_xxx` | Unlock Xiaoyuzhou podcast transcription |
@@ -345,7 +369,7 @@ After installation, use upstream tools directly. See SKILL.md for the full comma
| Platform | Upstream Tool | Example |
|----------|--------------|---------|
-| Twitter/X | `twitter`(备选 `opencli`) | `twitter search "query" -n 10` |
+| Twitter/X | `twitter`(备选 `opencli`) | 设置 `TWITTER_AUTH_TOKEN` / `TWITTER_CT0` 后运行 `twitter search "query" -n 10` |
| YouTube | `yt-dlp` | `yt-dlp --dump-json URL` |
| Bilibili | `bili`(字幕走 `opencli`) | `bili search "query" --type video` / `opencli bilibili subtitle BVxxx` |
| Reddit | `opencli`(备选 `rdt`) | `opencli reddit search "query" -f yaml` / `rdt read POST_ID` |
diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
index 0d9817ff..fea4c4c3 100644
--- a/docs/troubleshooting.md
+++ b/docs/troubleshooting.md
@@ -20,13 +20,18 @@ agent-reach configure --from-browser chrome --platform xueqiu
**症状:** `twitter search` 或其他命令返回错误
-**原因:** twitter-cli 需要 AUTH_TOKEN 和 CT0 环境变量才能访问 Twitter API。如果你的网络环境需要代理才能访问 x.com,需要配置代理。
+**原因:** twitter-cli 需要 `TWITTER_AUTH_TOKEN` 和 `TWITTER_CT0`
+环境变量才能访问 Twitter API。`agent-reach configure twitter-cookies`
+保存的值只供 doctor 检查配置是否齐全;doctor 不执行上游认证,也不会设置当前
+Shell。如果你的网络环境需要代理才能访问 x.com,还需要配置代理。
**解决方案:**
### 方案 1:设置环境变量代理
```bash
+export TWITTER_AUTH_TOKEN="..."
+export TWITTER_CT0="..."
export HTTP_PROXY="http://user:pass@host:port"
export HTTPS_PROXY="http://user:pass@host:port"
twitter search "test" -n 1
@@ -56,6 +61,7 @@ mcporter call 'exa.web_search_exa(query: "site:x.com 搜索词", numResults: 5)'
twitter check
```
-> 如果返回 "Missing credentials",需要设置 AUTH_TOKEN 和 CT0 环境变量。
+> 如果返回 "Missing credentials",需要在运行该命令的进程环境中设置
+> `TWITTER_AUTH_TOKEN` 和 `TWITTER_CT0`。
>
> **Fallback:** 如果你已经安装了 bird CLI(`npm install -g @steipete/bird`),它也能正常工作。Agent Reach 会自动检测已安装的工具。
diff --git a/docs/update.md b/docs/update.md
index 546a7388..17836a6f 100644
--- a/docs/update.md
+++ b/docs/update.md
@@ -56,7 +56,7 @@ exception: OpenCLI on desktop, see below).
which twitter >/dev/null 2>&1 && { pipx upgrade twitter-cli 2>/dev/null || uv tool upgrade twitter-cli 2>/dev/null; }
which bili >/dev/null 2>&1 && { pipx upgrade bilibili-cli 2>/dev/null || uv tool upgrade bilibili-cli 2>/dev/null; }
which xhs >/dev/null 2>&1 && { pipx upgrade xiaohongshu-cli 2>/dev/null || uv tool upgrade xiaohongshu-cli 2>/dev/null; }
-which yt-dlp >/dev/null 2>&1 && { pipx upgrade yt-dlp 2>/dev/null || uv tool upgrade yt-dlp 2>/dev/null || pip install -U yt-dlp 2>/dev/null; }
+which yt-dlp >/dev/null 2>&1 && { pipx install --force 'yt-dlp[default]' 2>/dev/null || uv tool install --force 'yt-dlp[default]' 2>/dev/null || python -m pip install -U 'yt-dlp[default]' 2>/dev/null; }
# rdt-cli is pinned to a git source (PyPI lags upstream) — same pin as the code's _RDT_GIT_SOURCE
which rdt >/dev/null 2>&1 && pipx install --force 'git+https://github.com/public-clis/rdt-cli.git@5e4fb3720d5c174e976cd425ccc3b879d52cac66' 2>/dev/null
@@ -67,10 +67,13 @@ which opencli >/dev/null 2>&1 && npm update -g @jackwener/opencli 2>/dev/null
```
**Desktop users without OpenCLI**: since v1.5.0 OpenCLI is the preferred
-backend for 小红书/Reddit (and adds B站 subtitles) by riding the user's
-browser session. Offer it once:
+backend for 小红书/Reddit (and adds B站 subtitles). Offer it once. For
+小红书, OpenCLI may use only an existing Chrome session explicitly controlled
+by the user. The update must never log the user in or read browser cookies:
-> "这次更新引入了 OpenCLI 后端(复用你的浏览器登录态,小红书/Reddit 零配置)。要装吗?装完只需你在 Chrome 商店点一次『添加扩展』。"
+> "这次更新引入了 OpenCLI 后端。要装吗?装完只需你在 Chrome 商店点一次
+> 『添加扩展』。小红书 OpenCLI 只使用你已有的 Chrome 会话;如果没有现成
+> 会话,我不会自动登录,会改用 Cookie-Editor 配置 MCP / 存量工具。"
If yes: `agent-reach install --channels opencli` and guide them through the
extension click. If no, everything keeps working on existing backends.
@@ -110,8 +113,8 @@ Tell the user:
1. What version they're on now (`agent-reach version`)
2. How many channels are available, and which backend each multi-backend
platform is using (from doctor)
-3. Anything that needs their action (e.g. Chrome extension click, `xhs login`,
- QR scan for xiaohongshu-mcp on servers)
+3. Anything that needs their action (e.g. a Chrome extension click, or a
+ manual Cookie-Editor export when XiaoHongShu uses MCP / a legacy tool)
4. What changed in this update (release notes shown by `check-update`)
Done.
diff --git a/tests/test_auth_guidance_policy.py b/tests/test_auth_guidance_policy.py
new file mode 100644
index 00000000..f67bb54e
--- /dev/null
+++ b/tests/test_auth_guidance_policy.py
@@ -0,0 +1,141 @@
+"""Documentation must preserve the project's explicit auth boundaries."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parents[1]
+
+
+def _policy_documents() -> list[Path]:
+ documents = list(ROOT.glob("README*.md"))
+ for directory in (
+ ROOT / "docs",
+ ROOT / "agent_reach" / "guides",
+ ROOT / "agent_reach" / "skill",
+ ):
+ documents.extend(directory.rglob("*.md"))
+ return sorted(set(documents))
+
+
+def test_xiaohongshu_guidance_never_starts_implicit_login():
+ """Do not reintroduce QR or automatic browser-cookie login guidance."""
+ xhs_markers = ("xiaohongshu", "小红书", "小紅書", "xhs")
+ legacy_auth_markers = (
+ "扫码",
+ "二维码",
+ "qr login",
+ "qr scan",
+ "qrcode",
+ "ブラウザからcookieを自動抽出",
+ "브라우저에서 cookie 자동 추출",
+ )
+ forbidden_commands = (
+ "xhs " + "login",
+ "get_login_" + "qrcode",
+ )
+
+ violations = []
+ for path in _policy_documents():
+ text = path.read_text(encoding="utf-8")
+ lowered = text.lower()
+ for command in forbidden_commands:
+ if command in lowered:
+ violations.append(f"{path.relative_to(ROOT)}: {command}")
+ for line_number, line in enumerate(lowered.splitlines(), 1):
+ if not any(marker in line for marker in xhs_markers):
+ continue
+ if any(marker in line for marker in legacy_auth_markers):
+ violations.append(
+ f"{path.relative_to(ROOT)}:{line_number}: {line.strip()}"
+ )
+
+ assert not violations, "\n".join(violations)
+
+
+def test_xiaohongshu_opencli_and_export_boundaries_are_truthful():
+ """Cookie import is for MCP/legacy tools, never OpenCLI or Chrome."""
+ boundary_docs = (
+ ROOT / "docs" / "install.md",
+ ROOT / "agent_reach" / "guides" / "setup-xiaohongshu.md",
+ ROOT / "agent_reach" / "skill" / "references" / "social.md",
+ )
+ for path in boundary_docs:
+ text = path.read_text(encoding="utf-8")
+ assert "已经存在且明确控制" in text, path.relative_to(ROOT)
+ assert "不会把 Cookie 注入 OpenCLI" in text, path.relative_to(ROOT)
+
+ xhs_guide = boundary_docs[1].read_text(encoding="utf-8")
+ assert "xiaohongshu.com 同域 Cookie 集" in xhs_guide
+ assert "非 xiaohongshu.com 域 Cookie" in xhs_guide
+
+
+def test_twitter_operational_docs_explain_the_environment_boundary():
+ """Saved cookies help doctor only; direct twitter commands need env vars."""
+ operational_docs = (
+ ROOT / "README.md",
+ ROOT / "docs" / "README_en.md",
+ ROOT / "docs" / "README_ja.md",
+ ROOT / "docs" / "README_ko.md",
+ ROOT / "docs" / "cookie-export.md",
+ ROOT / "docs" / "install.md",
+ ROOT / "docs" / "troubleshooting.md",
+ ROOT / "agent_reach" / "guides" / "setup-twitter.md",
+ ROOT / "agent_reach" / "skill" / "SKILL.md",
+ ROOT / "agent_reach" / "skill" / "SKILL_en.md",
+ ROOT / "agent_reach" / "skill" / "references" / "social.md",
+ )
+
+ for path in operational_docs:
+ text = path.read_text(encoding="utf-8")
+ assert "TWITTER_AUTH_TOKEN" in text, path.relative_to(ROOT)
+ assert "TWITTER_CT0" in text, path.relative_to(ROOT)
+
+ twitter_guide = (
+ ROOT / "agent_reach" / "guides" / "setup-twitter.md"
+ ).read_text(encoding="utf-8")
+ assert "不会执行 `twitter status`" in twitter_guide
+ assert "不会修改当前 Shell" in twitter_guide
+ assert "Export → Header String" in twitter_guide
+ assert "cookie JSON" not in twitter_guide
+ assert "复制全部" not in twitter_guide
+
+ for expected in (
+ "--sync-legacy-twitter",
+ "~/.agent-reach/config.yaml",
+ "~/.config/xfetch/session.json",
+ "~/.config/bird/credentials.env",
+ ):
+ assert expected in twitter_guide
+ assert "默认只写" in twitter_guide
+ assert "不会自动删除" in twitter_guide
+
+ rendered_as_verified = (
+ "✅ Twitter/X tweets",
+ "✅ Twitter/Xツイート",
+ "✅ Twitter/X 트윗",
+ )
+ all_text = "\n".join(
+ path.read_text(encoding="utf-8") for path in _policy_documents()
+ )
+ assert not any(claim in all_text for claim in rendered_as_verified)
+
+
+def test_localized_readmes_keep_current_bilibili_and_xhs_routes():
+ """Translations must not revive retired yt-dlp/Bilibili or XHS defaults."""
+ readmes = (
+ ROOT / "README.md",
+ ROOT / "docs" / "README_en.md",
+ ROOT / "docs" / "README_ja.md",
+ ROOT / "docs" / "README_ko.md",
+ )
+
+ for path in readmes:
+ text = path.read_text(encoding="utf-8")
+ assert "bilibili.py → yt-dlp" not in text, path.relative_to(ROOT)
+ assert "YouTube + Bilibili" not in text, path.relative_to(ROOT)
+ assert "bili-cli" in text, path.relative_to(ROOT)
+ assert (
+ "xiaohongshu.py → OpenCLI ▸ xiaohongshu-mcp ▸ xhs-cli"
+ in text
+ ), path.relative_to(ROOT)