Give your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Python agent-infrastructureai-agentai-searchautomationbilibiliclaude-codeclicursorfree-apillm-toolsmcppythonreddit-scrapertwitter-scraperweb-scraperxiaohongshuyoutube-transcript
docs(auth): enforce explicit cookie guidance
Pnant18cce856fb98
diff --git a/README.md b/README.mdindex 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.mdindex 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 String4. 运行配置命令:```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。## 手动设置 Cookiediff --git a/agent_reach/guides/setup-xiaohongshu.md b/agent_reach/guides/setup-xiaohongshu.mdindex 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 示例:+搜索笔记:```bashxhs 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.mdindex 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 10diff --git a/agent_reach/skill/SKILL_en.md b/agent_reach/skill/SKILL_en.mdindex 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 10diff --git a/agent_reach/skill/references/social.md b/agent_reach/skill/references/social.mdindex 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 yamlopencli 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 120000mcporter 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.mdindex 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 sessionStatus: 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.mdindex 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.mdindex 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.mdindex 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 firstThat's it! Your Agent will run:```bashagent-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.mdindex 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 ouagent-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——复用你浏览器里的登录态,平时刷过小红书就直接能用,零配置。"```bashagent-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.mdindex 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.mdindex 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_SOURCEwhich 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 theextension 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-backendplatform 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.pynew file mode 100644index 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)