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: update all remaining files for v1.4.0 upstream migrations
Pnantdef2ce932ec8
diff --git a/README.md b/README.mdindex 0e273c21..3c6ad626 100644--- a/README.md+++ b/README.md@@ -73,7 +73,7 @@ AI Agent 已经能帮你写代码、改文档、管项目——但你让它去| 📦 **GitHub** | 读公开仓库 + 搜索 | 私有仓库、提 Issue/PR、Fork | 告诉 Agent「帮我登录 GitHub」 || 🐦 **Twitter/X** | 读单条推文 | 搜索推文、浏览时间线、发推 | 告诉 Agent「帮我配 Twitter」 || 📺 **B站** | 本地:字幕提取 + 搜索 | 服务器也能用 | 告诉 Agent「帮我配代理」 |-| 📖 **Reddit** | 搜索 + 读帖子和评论(通过 Exa) | — | 无需配置(自动通过 Exa) |+| 📖 **Reddit** | 搜索 + 读帖子和评论(通过 rdt-cli) | — | 无需配置(pipx install rdt-cli) || 📕 **小红书** | — | 阅读、搜索、发帖、评论、点赞 | 告诉 Agent「帮我配小红书」 || 🎵 **抖音** | — | 视频解析、无水印下载链接获取 | 告诉 Agent「帮我配抖音」 || 💼 **LinkedIn** | Jina Reader 读公开页面 | Profile 详情、公司页面、职位搜索 | 告诉 Agent「帮我配 LinkedIn」 |diff --git a/agent_reach/core.py b/agent_reach/core.pyindex fd8caae2..075d9de1 100644--- a/agent_reach/core.py+++ b/agent_reach/core.py@@ -3,7 +3,7 @@AgentReach — installer, doctor, and configuration tool.Agent Reach helps AI agents install and configure upstream platform tools-(bird CLI, yt-dlp, mcporter, gh CLI, etc.). After installation, agents+(twitter-cli, yt-dlp, mcporter, gh CLI, etc.). After installation, agentscall the upstream tools directly — no wrapper layer needed.Usage:diff --git a/agent_reach/guides/setup-reddit.md b/agent_reach/guides/setup-reddit.mdindex 022e5d5f..45e32a6e 100644--- a/agent_reach/guides/setup-reddit.md+++ b/agent_reach/guides/setup-reddit.md@@ -4,42 +4,51 @@Reddit 封锁了几乎所有非浏览器的直接访问(包括数据中心和 ISP 代理 IP),JSON API 返回 403。-Agent Reach 通过 **Exa** 实现 Reddit 的搜索和阅读功能:-- **搜索**:`web_search_exa` + `includeDomains: ["reddit.com"]`-- **阅读完整帖子+评论**:`crawling_exa` 读取 Reddit URL 的缓存内容+Agent Reach 通过 **rdt-cli** 实现 Reddit 的搜索和阅读功能:+- **搜索**:`rdt search "关键词"`+- **阅读完整帖子+评论**:`rdt read POST_ID`-免费,无需代理,无需 API Key。+免费,无需代理,无需 API Key,无需登录。## Agent 可自动完成的步骤-1. 检查 Exa 是否可用:+1. 检查 rdt-cli 是否可用:```bash-agent-reach doctor | grep -E "Reddit|Exa"+which rdt && echo "installed" || echo "not installed"```-2. 如果 Exa 未安装,自动安装:+2. 如果未安装,自动安装:```bash-npm install -g mcporter-mcporter config add exa https://mcp.exa.ai/mcp+pipx install rdt-cli```或一键安装:```bash-agent-reach install --env=auto+agent-reach install --env=auto --channels=reddit```## 使用示例搜索 Reddit 内容:```bash-mcporter call 'exa.web_search_exa(query: "python best practices", numResults: 5, includeDomains: ["reddit.com"])'+rdt search "python best practices" -n 5```阅读完整帖子和评论:```bash-mcporter call 'exa.crawling_exa(urls: ["https://www.reddit.com/r/python/comments/xxx/"], maxCharacters: 10000)'+rdt read POST_ID```## 需要用户手动做的步骤-无。Exa 通过 `agent-reach install --env=auto` 自动配置。+无。rdt-cli 通过 `agent-reach install --env=auto` 自动安装。++## Fallback:Exa 搜索++如果你已经配置了 Exa(通过 mcporter),也可以通过 Exa 搜索 Reddit 内容:++```bash+mcporter call 'exa.web_search_exa(query: "python best practices", numResults: 5, includeDomains: ["reddit.com"])'+```++rdt-cli 是当前推荐方案,无需额外配置即可使用。diff --git a/agent_reach/guides/setup-twitter.md b/agent_reach/guides/setup-twitter.mdindex 80237650..880656dd 100644--- a/agent_reach/guides/setup-twitter.md+++ b/agent_reach/guides/setup-twitter.md@@ -1,35 +1,34 @@-# Twitter 高级功能配置指南(bird CLI)+# Twitter 高级功能配置指南(twitter-cli)Twitter 基础阅读通过 Jina Reader 免费可用,无需配置。-高级功能需要 bird CLI(@steipete/bird):+高级功能需要 twitter-cli(@public-clis/twitter-cli):-- 搜索推文(`bird search`)-- 读取完整推文和对话链(`bird read`、`bird thread`)-- 用户时间线(`bird user-tweets`)+- 搜索推文(`twitter search`)+- 读取完整推文和对话链(`twitter tweet`、`twitter thread`)+- 用户时间线(`twitter timeline`)+- 长文阅读(`twitter article`)-bird 是免费开源工具(npm 包 @steipete/bird),但需要你的 Twitter 账号 cookie。+twitter-cli 是免费开源工具(pipx 安装),但需要你的 Twitter 账号 cookie。## 快速配置-1. 检查 bird 是否安装:+1. 检查 twitter-cli 是否安装:```bash-which bird && echo "installed" || echo "not installed"+which twitter && echo "installed" || echo "not installed"```-2. 安装 bird:+2. 安装 twitter-cli:```bash-npm install -g @steipete/bird+pipx install twitter-cli```-> 备选包:`npm install -g @connormartin/bird`-3. 测试是否配置好:```bash-AUTH_TOKEN="xxx" CT0="yyy" bird search "test" -n 1+twitter search "test" -n 1```## 获取 Cookie(Cookie-Editor 方式,推荐)@@ -49,7 +48,7 @@ agent-reach configure twitter-cookies "粘贴的 cookie JSON"如果你已经知道 `auth_token` 和 `ct0`:-1. 安装 bird(如果没装):`npm install -g @steipete/bird`+1. 安装 twitter-cli(如果没装):`pipx install twitter-cli`2. 设置环境变量:@@ -61,21 +60,25 @@ export CT0="你的ct0"3. 测试:```bash-bird search "test" -n 1+twitter search "test" -n 1```## 代理配置-> bird CLI 支持通过环境变量设置代理:+> twitter-cli 支持通过环境变量设置代理:```bashexport HTTP_PROXY="http://user:pass@host:port"export HTTPS_PROXY="http://user:pass@host:port"-bird search "test" -n 1+twitter search "test" -n 1```也可以使用全局代理工具:```bash-proxychains bird search "test" -n 1+proxychains twitter search "test" -n 1```++## Fallback:bird CLI++如果你已经安装了 [bird CLI](https://www.npmjs.com/package/@steipete/bird)(`npm install -g @steipete/bird`),它也能正常工作。Agent Reach 会自动检测并使用已安装的 bird。两者功能类似,twitter-cli 是当前推荐方案。diff --git a/agent_reach/guides/setup-xiaohongshu.md b/agent_reach/guides/setup-xiaohongshu.mdindex 2fe4ce75..18eb8f13 100644--- a/agent_reach/guides/setup-xiaohongshu.md+++ b/agent_reach/guides/setup-xiaohongshu.md@@ -1,51 +1,36 @@# 小红书配置指南## 功能说明-读取和搜索小红书笔记。通过 [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) 实现(⭐9K+,Go 语言,内置 Chrome 浏览器)。+读取和搜索小红书笔记。通过 [xhs-cli](https://github.com/jackwener/xiaohongshu-cli)(⭐1.5K,pipx 一行安装)实现。## 前置条件-- Docker(用来运行 xiaohongshu-mcp 服务)-- mcporter CLI(MCP 协议桥接工具)+- Python 3.10+(pipx 安装)+- 浏览器已登录 xiaohongshu.com(用于导出 Cookie)## Agent 可自动完成的步骤-### 1. 安装 mcporter+### 1. 安装 xhs-cli```bash-npm install -g mcporter+pipx install xiaohongshu-cli```-### 2. 启动 xiaohongshu-mcp 服务+### 2. 登录(从浏览器提取 Cookie)```bash-docker run -d \- --name xiaohongshu-mcp \- -p 18060:18060 \- xpzouying/xiaohongshu-mcp+xhs login```-> 如需代理(服务器部署推荐):-> ```bash-> docker run -d \-> --name xiaohongshu-mcp \-> -p 18060:18060 \-> -e XHS_PROXY=http://user:pass@ip:port \-> xpzouying/xiaohongshu-mcp-> ```--### 3. 注册到 mcporter-```bash-mcporter config add xiaohongshu http://localhost:18060/mcp-```+> 这会自动从浏览器提取 Cookie。如果自动提取失败,可以手动导入(见下方)。-### 4. 验证+### 3. 验证```bashagent-reach doctor```-应该看到小红书显示为 ✅ 或 ⚠️(MCP 已连接但未登录)。+应该看到小红书显示为 ✅。## 需要用户手动做的步骤-如果 doctor 显示"MCP 已连接但未登录",需要导入 cookies:+如果 `xhs login` 自动提取失败,需要手动导入 cookies:> **推荐方式:Cookie-Editor 浏览器导出(最可靠)**>@@ -54,43 +39,47 @@ agent-reach doctor> 3. 点击 Cookie-Editor 图标 → Export → Header String> 4. 把导出的字符串发给 Agent,运行:`agent-reach configure xhs-cookies "导出的cookie字符串"`>-> **注意**:`http://localhost:18060` 根路径可能返回 404,这是正常的——MCP 服务在 `/mcp` 路径。-> 不要依赖 QR 扫码登录,Docker 容器内的 QR 登录页面不一定可用,且 cookies 不会自动共享到 MCP 服务。+> **注意**:不要依赖 QR 扫码登录,Cookie-Editor 导出方式最简单可靠。-## 常见问题+## 使用示例-**Q: Docker 容器重启后 cookie 丢了?**-A: 挂载数据卷持久化:+搜索笔记:```bash-docker run -d \- --name xiaohongshu-mcp \- -p 18060:18060 \- -v xhs-data:/app/data \- xpzouying/xiaohongshu-mcp+xhs search "关键词"```-**Q: 服务器上小红书提示 IP 风险?**-A: 加代理参数 `-e XHS_PROXY=http://user:pass@ip:port`,推荐住宅代理。+阅读笔记详情:+```bash+xhs read NOTE_ID+```++查看评论:+```bash+xhs comments NOTE_ID+```++## 常见问题++**Q: Cookie 过期了?**+A: 重新运行 `xhs login` 或通过 Cookie-Editor 重新导出。-**Q: Docker 镜像不支持 ARM64 / Apple Silicon?**-A: 上游镜像暂无 ARM64 版本,两种解决办法:+**Q: 小红书提示 IP 风险?**+A: 推荐使用住宅代理:`export HTTP_PROXY="http://user:pass@ip:port"`。++**Q: xhs-cli 不支持我的系统?**+A: 确保 Python 3.10+ 和 pipx 已安装。运行 `pipx install xiaohongshu-cli` 即可。++## 备选方案:Docker MCP++如果你已经在使用 [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) Docker 方案,它也能正常工作:-方法一:使用 Rosetta 模拟运行(推荐,最简单)```bashdocker run -d \--name xiaohongshu-mcp \-p 18060:18060 \- --platform linux/amd64 \xpzouying/xiaohongshu-mcp-```-方法二:从源码编译原生 ARM64 版本-```bash-git clone https://github.com/xpzouying/xiaohongshu-mcp-cd xiaohongshu-mcp-docker build -t xiaohongshu-mcp .-docker run -d --name xiaohongshu-mcp -p 18060:18060 xiaohongshu-mcp+mcporter config add xiaohongshu http://localhost:18060/mcp```-**Q: 我不想用 Docker?**-A: 可以从源码编译:https://github.com/xpzouying/xiaohongshu-mcp+xhs-cli 是当前推荐方案,不需要 Docker,安装更简单。diff --git a/agent_reach/integrations/mcp_server.py b/agent_reach/integrations/mcp_server.pyindex 636e4ee5..bace664c 100644--- a/agent_reach/integrations/mcp_server.py+++ b/agent_reach/integrations/mcp_server.py@@ -5,7 +5,7 @@ Agent Reach MCP Server — expose doctor/status as MCP tool.Run: python -m agent_reach.integrations.mcp_serverAgent Reach is an installer + doctor tool. For actual reading/searching,-agents should call upstream tools directly (bird, yt-dlp, mcporter, etc.).+agents should call upstream tools directly (twitter-cli, yt-dlp, mcporter, etc.)."""import asynciodiff --git a/docs/README_en.md b/docs/README_en.mdindex 38f7017e..0fc5c9bc 100644--- a/docs/README_en.md+++ b/docs/README_en.md@@ -76,7 +76,7 @@ Update Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/ma| 📺 **YouTube** | Read · **Search** | Zero config | Subtitles + search across 1800+ video sites ([yt-dlp](https://github.com/yt-dlp/yt-dlp) ⭐148K) || 📺 **Bilibili** | Read · **Search** | Zero config / Proxy | Video info + subtitles + search. Local works directly, servers need a proxy ([yt-dlp](https://github.com/yt-dlp/yt-dlp)) || 📡 **RSS** | Read | Zero config | Any RSS/Atom feed ([feedparser](https://github.com/kurtmckee/feedparser) ⭐2.3K) |-| 📖 **Reddit** | Search · Read | Zero config | Search and read via Exa (free, no proxy needed) |+| 📖 **Reddit** | Search · Read | Zero config | Search and read via [rdt-cli](https://github.com/public-clis/rdt-cli) (free, no proxy needed) |> **Setup levels:** Zero config = install and go · Auto-configured = handled during install · mcporter = needs MCP service · Cookie = export from browser · Proxy = $1/month@@ -147,7 +147,7 @@ Tell your Agent "help me configure Twitter cookies" — it'll guide you throughBilibili blocks server IPs. Get a proxy ([Webshare](https://webshare.io) recommended, $1/month) and send the address to your Agent.-> Reddit now works free via Exa without any proxy. Local computers don't need a proxy for Bilibili either.+> Reddit now works free via rdt-cli without any proxy. Local computers don't need a proxy for Bilibili either.---@@ -171,7 +171,7 @@ $ agent-reach doctor⬜ Web semantic search — sign up at exa.ai for free key🔧 Configurable:- ✅ Reddit posts and comments — search and read via Exa (free, no proxy)+ ✅ Reddit posts and comments — search and read via rdt-cli (free, no proxy)⬜ XiaoHongShu notes — needs cookie. Export from browserStatus: 6/9 channels available@@ -200,7 +200,7 @@ channels/├── youtube.py → yt-dlp ← swap to YouTube API, Whisper…├── github.py → gh CLI ← swap to REST API, PyGithub…├── bilibili.py → yt-dlp ← swap to bilibili-api…-├── reddit.py → Exa ← search + read, no proxy needed+├── reddit.py → rdt-cli ← search + read, no proxy needed├── xiaohongshu.py → mcporter MCP ← swap to other XHS tools…├── douyin.py → mcporter MCP ← swap to other Douyin tools…├── linkedin.py → linkedin-mcp ← swap to LinkedIn API…diff --git a/docs/README_ja.md b/docs/README_ja.mdindex bed51597..d0658afa 100644--- a/docs/README_ja.md+++ b/docs/README_ja.md@@ -51,7 +51,7 @@ Update Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/ma|---|---|| 💰 **完全無料** | すべてのツールはオープンソース、すべてのAPIは無料。唯一のコストはサーバープロキシ(月額$1)の可能性のみ — ローカルPCでは不要 || 🔒 **プライバシー安全** | Cookieはローカルに保存。アップロードされることはありません。完全オープンソース — いつでも監査可能 |-| 🔄 **常に最新** | 上流ツール(yt-dlp、bird、Jina Reader等)を定期的に追跡・更新 |+| 🔄 **常に最新** | 上流ツール(yt-dlp、twitter-cli、rdt-cli、Jina Reader等)を定期的に追跡・更新 || 🤖 **あらゆるエージェントに対応** | Claude Code、OpenClaw、Cursor、Windsurf… コマンドを実行できるすべてのエージェント || 🩺 **組み込み診断** | `agent-reach doctor` — 1コマンドで何が動き、何が動かないか、どう修正するかを表示 |@@ -62,11 +62,11 @@ 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で検索、タイムライン、投稿が解放([bird](https://www.npmjs.com/package/@steipete/bird)) |-| 📕 **小紅書** | 閲覧・検索・**投稿・コメント・いいね** | mcporter | [xiaohongshu-mcp](https://github.com/user/xiaohongshu-mcp) 内部APIで、インストールしてすぐ使える |+| 🐦 **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)) || 🎵 **抖音** | 動画解析・ウォーターマークなしダウンロード | mcporter | [douyin-mcp-server](https://github.com/yzfly/douyin-mcp-server)、ログイン不要 || 💼 **LinkedIn** | Jina Reader(公開ページ) | プロフィール、企業、求人検索 | エージェントに「LinkedInの設定を手伝って」と伝えてください |-| 💬 **WeChat記事** | 検索 + 閲覧 | 設定不要 | WeChat公式アカウント記事の検索+閲覧(完全Markdown)([wechat-article-for-ai](https://github.com/Panniantong/wechat-article-for-ai) + [miku_ai](https://github.com/GobinFan/Miku_Spider)) |+| 💬 **WeChat記事** | 検索 + 閲覧 | 設定不要 | WeChat公式アカウント記事の検索+閲覧(完全Markdown)([Exa](https://exa.ai) + [Camoufox](https://github.com/daijro/camoufox)(オプション)) || 📰 **Weibo** | トレンド・検索・フィード・コメント | 設定不要 | ホット検索、コンテンツ/ユーザー/トピック検索、フィード、コメント([mcp-server-weibo](https://github.com/Panniantong/mcp-server-weibo)) || 💻 **V2EX** | 人気トピック・ノードトピック・トピック詳細+返信・ユーザープロフィール | 設定不要 | 公開JSON API、認証不要。技術コミュニティのコンテンツに最適 || 📈 **雪球(Xueqiu)** | 株価・検索・人気投稿・人気銘柄 | 設定不要 | 公開APIで自動セッションCookie、ログイン不要 |@@ -76,7 +76,7 @@ Update Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/ma| 📺 **YouTube** | 閲覧・**検索** | 設定不要 | 字幕 + 1800以上の動画サイトでの検索([yt-dlp](https://github.com/yt-dlp/yt-dlp) ⭐148K) || 📺 **Bilibili** | 閲覧・**検索** | 設定不要 / プロキシ | 動画情報 + 字幕 + 検索。ローカルはそのまま動作、サーバーはプロキシが必要([yt-dlp](https://github.com/yt-dlp/yt-dlp)) || 📡 **RSS** | 閲覧 | 設定不要 | 任意のRSS/Atomフィード([feedparser](https://github.com/kurtmckee/feedparser) ⭐2.3K) |-| 📖 **Reddit** | 検索・閲覧 | 無料 / プロキシ | 検索はExa(無料)経由。投稿の閲覧はサーバーでプロキシが必要 |+| 📖 **Reddit** | 検索・閲覧 | 設定不要 | [rdt-cli](https://github.com/public-clis/rdt-cli)で検索+閲覧(無料、プロキシ不要) |> **セットアップレベル:** 設定不要 = インストールしてすぐ使える · 自動設定 = インストール時に処理 · mcporter = MCPサービスが必要 · Cookie = ブラウザからエクスポート · プロキシ = 月額$1@@ -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` で字幕取得-- 「このツイートを読んで」→ `bird read URL`+- 「このツイートを読んで」→ `twitter tweet URL`- 「このRSSを購読して」→ `feedparser` でフィード解析- 「GitHubでLLMフレームワークを検索して」→ `gh search repos "LLM framework"`@@ -147,7 +147,7 @@ Skillインストール後、エージェントは`agent-reach` CLIが利用可RedditとBilibiliはサーバーIPをブロックします。プロキシを取得し([Webshare](https://webshare.io) 推奨、月額$1)、アドレスをエージェントに伝えてください。-> ローカルPCではプロキシは不要です。Reddit検索はプロキシなしでもExaで無料で動作します。+> ローカルPCではプロキシは不要です。Reddit検索はプロキシなしでもrdt-cliで無料で動作します。---@@ -171,7 +171,7 @@ $ agent-reach doctor⬜ Webセマンティック検索 — exa.aiで無料キーを取得🔧 設定可能:- ⬜ Reddit投稿とコメント — 検索はExa(無料)経由。閲覧にはプロキシが必要+ ✅ Reddit投稿とコメント — rdt-cliで検索+閲覧(無料、プロキシ不要)⬜ 小紅書ノート — Cookieが必要。ブラウザからエクスポートステータス: 9チャンネル中6チャンネルが利用可能@@ -187,7 +187,7 @@ $ agent-reach doctorAgent Reach はシンプルなことを1つだけ行います:**ツールの選定と設定の判断をあなたの代わりに行います。**-インストール後、エージェントは上流ツール(bird CLI、yt-dlp、mcporter、gh CLI等)を直接呼び出します — 間にラッパーレイヤーはありません。+インストール後、エージェントは上流ツール(twitter-cli、rdt-cli、xhs-cli、yt-dlp、mcporter、gh CLI等)を直接呼び出します — 間にラッパーレイヤーはありません。### 🔌 すべてのチャンネルはプラグ可能@@ -196,12 +196,12 @@ Agent Reach はシンプルなことを1つだけ行います:**ツールの```channels/├── web.py → Jina Reader ← Firecrawl、Crawl4AIなどに差し替え可能…-├── twitter.py → bird CLI ← Nitter、公式APIなどに差し替え可能…+├── 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 → JSON API + Exa ← PRAW、Pushshiftなどに差し替え可能…-├── xiaohongshu.py → mcporter MCP ← 他のXHSツールに差し替え可能…+├── reddit.py → rdt-cli ← PRAW、Pushshiftなどに差し替え可能…+├── xiaohongshu.py → xhs-cli ← 他のXHSツールに差し替え可能…├── douyin.py → mcporter MCP ← 他の抖音ツールに差し替え可能…├── linkedin.py → linkedin-mcp ← LinkedIn APIに差し替え可能…├── rss.py → feedparser ← atomaなどに差し替え可能…@@ -216,15 +216,15 @@ channels/| シナリオ | ツール | 理由 ||----------|--------|------|| Webページ閲覧 | [Jina Reader](https://github.com/jina-ai/reader) | ⭐9.8K、無料、APIキー不要 |-| ツイート閲覧 | [bird](https://www.npmjs.com/package/@steipete/bird) | Cookie認証、無料。公式APIは従量課金(投稿閲覧1件$0.005) |+| ツイート閲覧 | [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サイト || 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 |-| 小紅書 | [xiaohongshu-mcp](https://github.com/user/xiaohongshu-mcp) | 内部API、アンチボット回避 |+| 小紅書 | [xhs-cli](https://github.com/jackwener/xiaohongshu-cli) | 1.5K Star、pipxインストール、検索/閲覧/コメント/投稿 || 抖音 | [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記事 | [wechat-article-for-ai](https://github.com/Panniantong/wechat-article-for-ai) + [miku_ai](https://github.com/GobinFan/Miku_Spider) | ステルスブラウザで記事全文閲覧 + Sogou検索 |+| WeChat記事 | [Exa](https://exa.ai)(検索+閲覧)+ [Camoufox](https://github.com/daijro/camoufox)(オプション) | ゼロ設定で検索+全文閲覧、Camoufoxでオプション強化 || Weibo | `mcporter` | `mcporter call 'weibo.get_trendings(limit: 10)'` || 小宇宙Podcast | `transcribe.sh` | `bash ~/.agent-reach/tools/xiaoyuzhou/transcribe.sh <URL>` |@@ -249,7 +249,7 @@ channels/<details><summary><strong>Twitter/X APIに課金せずにAIエージェントで検索するには?</strong></summary>-Agent Reach は [bird CLI](https://www.npmjs.com/package/@steipete/bird) をCookie認証で使用します — 完全無料、Twitter APIのサブスクリプションは不要です。Agent Reach インストール後、Cookie-Editor Chrome拡張機能でTwitterのCookieをエクスポートし、`agent-reach configure twitter-cookies "your_cookies"` を実行すれば、`bird search "query" -n 10` でエージェントが検索できるようになります。+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` でエージェントが検索できるようになります。</details><details>@@ -261,7 +261,7 @@ Agent Reach は [bird CLI](https://www.npmjs.com/package/@steipete/bird) をCook<details><summary><strong>サーバー/データセンターIPからRedditが403を返す?</strong></summary>-Redditはデータセンター IPをブロックします。レジデンシャルプロキシを設定してください:`agent-reach configure proxy http://user:pass@ip:port`。推奨:Webshare(月額約$1)。ローカルマシンでは通常この問題は発生しません。+Agent Reach は [rdt-cli](https://github.com/public-clis/rdt-cli) でRedditにアクセスします — ログイン不要、プロキシ不要、APIキー不要。`pipx install rdt-cli` でインストール後、`rdt search "query"` で検索、`rdt read POST_ID` で投稿+コメントの閲覧ができます。</details><details>@@ -273,19 +273,19 @@ Redditはデータセンター IPをブロックします。レジデンシャ<details><summary><strong>Agent Reach は無料?APIのコストは?</strong></summary>-100%無料でオープンソース。すべてのバックエンド(bird CLI、yt-dlp、Jina Reader、Exa)は有料APIキーが不要な無料ツールです。唯一のオプションコストは、サーバーからReddit/Bilibiliにアクセスする場合のレジデンシャルプロキシ(月額約$1)です。+100%無料でオープンソース。すべてのバックエンド(twitter-cli、rdt-cli、xhs-cli、yt-dlp、Jina Reader、Exa)は有料APIキーが不要な無料ツールです。唯一のオプションコストは、サーバーからBilibiliにアクセスする場合のレジデンシャルプロキシ(月額約$1)です。</details><details><summary><strong>Twitter APIの無料代替 — Webスクレイピング用</strong></summary>-Agent Reach はbird CLIを使用し、Cookie認証でTwitterにアクセスします — ブラウザセッションと同じです。API料金なし、レート制限のティアなし、開発者アカウント不要。検索、ツイート閲覧、プロフィール閲覧、タイムラインに対応。+Agent Reach はtwitter-cliを使用し、Cookie認証でTwitterにアクセスします — ブラウザセッションと同じです。API料金なし、レート制限のティアなし、開発者アカウント不要。検索、ツイート閲覧、プロフィール閲覧、タイムラインに対応。</details><details><summary><strong>小紅書のコンテンツをプログラムで読むには?</strong></summary>-Agent Reach は xiaohongshu-mcp(Dockerで実行)と統合されています。セットアップ後、`mcporter call 'xiaohongshu.get_feed_detail(...)'` でノートを閲覧、`mcporter call 'xiaohongshu.search_feeds(keyword: "query")'` で検索できます。+`pipx install xiaohongshu-cli` でインストール後、`xhs login`(ブラウザからCookieを自動抽出)。エージェントは `xhs search "query"` でノートを検索、`xhs read NOTE_ID` で詳細を閲覧、`xhs comments NOTE_ID` でコメントを表示できます。Dockerは不要です。</details><details>@@ -298,7 +298,7 @@ douyin-mcp-serverをインストールすれば、`mcporter call 'douyin.parse_d## クレジット-[Jina Reader](https://github.com/jina-ai/reader) · [yt-dlp](https://github.com/yt-dlp/yt-dlp) · [bird](https://www.npmjs.com/package/@steipete/bird) · [Exa](https://exa.ai) · [feedparser](https://github.com/kurtmckee/feedparser) · [douyin-mcp-server](https://github.com/yzfly/douyin-mcp-server) · [linkedin-scraper-mcp](https://github.com/stickerdaniel/linkedin-mcp-server)+[twitter-cli](https://github.com/public-clis/twitter-cli) · [rdt-cli](https://github.com/public-clis/rdt-cli) · [xhs-cli](https://github.com/jackwener/xiaohongshu-cli) · [Jina Reader](https://github.com/jina-ai/reader) · [yt-dlp](https://github.com/yt-dlp/yt-dlp) · [Exa](https://exa.ai) · [feedparser](https://github.com/kurtmckee/feedparser) · [douyin-mcp-server](https://github.com/yzfly/douyin-mcp-server) · [linkedin-scraper-mcp](https://github.com/stickerdaniel/linkedin-mcp-server)## お問い合わせdiff --git a/docs/install.md b/docs/install.mdindex ced05fae..612cb89f 100644--- a/docs/install.md+++ b/docs/install.md@@ -156,18 +156,17 @@ agent-reach configure twitter-cookies "PASTED_STRING"agent-reach configure proxy http://user:pass@ip:port```-**XiaoHongShu / 小红书 (需要 Docker):**-> "小红书需要一个 MCP 服务。需要你的机器上有 Docker。安装好 Docker 后我来搞定剩下的。"+**XiaoHongShu / 小红书 (xhs-cli):**+> "小红书通过 xhs-cli 访问,pipx 一行安装,不需要 Docker。"```bash-docker run -d --name xiaohongshu-mcp -p 18060:18060 xpzouying/xiaohongshu-mcp-mcporter config add xiaohongshu http://localhost:18060/mcp+pipx install xiaohongshu-cli+xhs login```-> 如果在服务器上,建议加代理避免 IP 风控:-> `docker run -d --name xiaohongshu-mcp -p 18060:18060 -e XHS_PROXY=http://user:pass@ip:port xpzouying/xiaohongshu-mcp`+> `xhs login` 会自动从浏览器提取 Cookie。如果自动提取失败,可以手动导入:>-> **登录方式(优先用 Cookie-Editor,最简单):**+> **手动导入 Cookie(Cookie-Editor 方式):**> 1. 用户在自己的浏览器登录小红书 (xiaohongshu.com)> 2. 用 [Cookie-Editor](https://chromewebstore.google.com/detail/cookie-editor/hlkenndednhfkekhgcdicdfddnkalmdm) 插件导出 Cookie(JSON 或 Header String 格式均可)> 3. 把 Cookie 字符串发给 Agent@@ -181,7 +180,14 @@ mcporter config add xiaohongshu http://localhost:18060/mcp> agent-reach configure xhs-cookies "key1=val1; key2=val2; ..."> ```>-> **注意:** `http://localhost:18060` 根路径可能返回 404,MCP 服务在 `/mcp` 路径。推荐使用 Cookie-Editor 导出方式,不要依赖 Docker 容器内的 QR 扫码登录。+> **注意:** 推荐使用 Cookie-Editor 导出方式,不要依赖 QR 扫码登录。+>+> **备选方案:Docker MCP**+> 如果你已经在使用 [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) Docker 方案,它也能正常工作:+> ```bash+> docker run -d --name xiaohongshu-mcp -p 18060:18060 xpzouying/xiaohongshu-mcp+> mcporter config add xiaohongshu http://localhost:18060/mcp+> ```**微博 / Weibo (mcp-server-weibo):**> "微博已默认安装,装好即用。可搜索微博内容、查看热搜、获取用户动态和评论。"diff --git a/docs/troubleshooting.md b/docs/troubleshooting.mdindex 88c49459..eb70f50c 100644--- a/docs/troubleshooting.md+++ b/docs/troubleshooting.md@@ -16,11 +16,11 @@ agent-reach configure --from-browser chrome----## Twitter/X: bird CLI 连接失败+## Twitter/X: twitter-cli 连接失败-**症状:** `bird search` 或其他命令返回错误+**症状:** `twitter search` 或其他命令返回错误-**原因:** bird CLI 需要 AUTH_TOKEN 和 CT0 环境变量才能访问 Twitter API。如果你的网络环境需要代理才能访问 x.com,需要配置代理。+**原因:** twitter-cli 需要 AUTH_TOKEN 和 CT0 环境变量才能访问 Twitter API。如果你的网络环境需要代理才能访问 x.com,需要配置代理。**解决方案:**@@ -29,22 +29,22 @@ agent-reach configure --from-browser chrome```bashexport HTTP_PROXY="http://user:pass@host:port"export HTTPS_PROXY="http://user:pass@host:port"-bird search "test" -n 1+twitter search "test" -n 1```### 方案 2:使用全局代理工具-让代理工具接管所有网络流量,这样 bird 的请求也会走代理:+让代理工具接管所有网络流量,这样 twitter-cli 的请求也会走代理:```bash# macOS — ClashX / Surge 开启"增强模式"# Linux — proxychains 或 tun2socks-proxychains bird search "test" -n 1+proxychains twitter search "test" -n 1```-### 方案 3:不用 bird,用 Exa 搜索替代+### 方案 3:不用 twitter-cli,用 Exa 搜索替代-bird 不可用时,可以直接用 Exa 搜索 Twitter 内容:+twitter-cli 不可用时,可以直接用 Exa 搜索 Twitter 内容:```bashmcporter call 'exa.web_search_exa(query: "site:x.com 搜索词", numResults: 5)'@@ -53,7 +53,9 @@ mcporter call 'exa.web_search_exa(query: "site:x.com 搜索词", numResults: 5)'### 方案 4:检查认证```bash-bird check+twitter check```> 如果返回 "Missing credentials",需要设置 AUTH_TOKEN 和 CT0 环境变量。+>+> **Fallback:** 如果你已经安装了 bird CLI(`npm install -g @steipete/bird`),它也能正常工作。Agent Reach 会自动检测已安装的工具。