From 17624268a059ccfb23eba8a2ba50f9f92c8dc0ca Mon Sep 17 00:00:00 2001 From: Pnant <73925474+Panniantong@users.noreply.github.com> Date: Mon, 13 Apr 2026 17:45:43 +0800 Subject: [PATCH] docs: update Reddit auth requirement and fix architecture diagrams across all READMEs Reddit requires authentication since 2024 (all API requests return 403 without a valid session cookie). Updated all 4 language versions (zh, en, ja, ko) to reflect this: platform tables, tool choice tables, architecture diagrams, and FAQ sections. Also fixed Chinese README architecture diagram: reddit.py backend corrected from Exa to rdt-cli, wechat.py backend corrected from camoufox+miku to Exa. Fixed Japanese README reddit.py swap suggestions (removed outdated PRAW/Pushshift). Co-Authored-By: Claude Opus 4.6 (1M context) --- README.md | 10 +++++----- docs/README_en.md | 8 ++++---- docs/README_ja.md | 6 +++--- docs/README_ko.md | 8 ++++---- 4 files changed, 16 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index 2b82d83..efac08f 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** | 搜索 + 读帖子和评论（通过 rdt-cli） | — | 无需配置（pipx install rdt-cli） | +| 📖 **Reddit** | 搜索 + 读帖子和评论（通过 rdt-cli） | Cookie | 需要登录认证（`rdt login`），详见 [rdt-cli](https://github.com/public-clis/rdt-cli) | | 📕 **小红书** | — | 阅读、搜索、发帖、评论、点赞 | 告诉 Agent「帮我配小红书」 | | 🎵 **抖音** | — | 视频解析、无水印下载链接获取 | 告诉 Agent「帮我配抖音」 | | 💼 **LinkedIn** | Jina Reader 读公开页面 | Profile 详情、公司页面、职位搜索 | 告诉 Agent「帮我配 LinkedIn」 | @@ -173,11 +173,11 @@ channels/ ├── youtube.py → yt-dlp ← 可以换成 YouTube API、Whisper…… ├── github.py → gh CLI ← 可以换成 REST API、PyGithub…… ├── bilibili.py → yt-dlp ← 可以换成 bilibili-api…… -├── reddit.py → Exa ← 搜索+阅读，无需代理 +├── reddit.py → rdt-cli ← 搜索+阅读，需 Cookie 认证 ├── xiaohongshu.py → mcporter MCP ← 可以换成其他 XHS 工具…… ├── douyin.py → mcporter MCP ← 可以换成其他抖音工具…… ├── linkedin.py → linkedin-mcp ← 可以换成 LinkedIn API…… -├── wechat.py → camoufox+miku ← 搜索+阅读微信公众号文章 +├── wechat.py → Exa (+ Camoufox) ← 搜索+阅读微信公众号文章 ├── rss.py → feedparser ← 可以换成 atoma…… ├── exa_search.py → mcporter MCP ← 可以换成 Tavily、SerpAPI…… └── __init__.py → 渠道注册（doctor 检测用） @@ -191,7 +191,7 @@ channels/ |------|------|-----------| | 读网页 | [Jina Reader](https://github.com/jina-ai/reader) | 9.8K Star，免费，不需要 API Key | | 读推特 | [twitter-cli](https://github.com/public-clis/twitter-cli) | 2.1K Star，Cookie 登录，搜索/读推文/时间线/长文 | -| Reddit | [rdt-cli](https://github.com/public-clis/rdt-cli) | 304 Star，无需登录，搜索+全文+评论 | +| Reddit | [rdt-cli](https://github.com/public-clis/rdt-cli) | 304 Star，Cookie 认证，搜索+全文+评论 | | 视频字幕 + 搜索 | [yt-dlp](https://github.com/yt-dlp/yt-dlp) | 154K Star，YouTube + B站 + 1800 站通吃 | | B站增强 | [bili-cli](https://github.com/public-clis/bilibili-cli) | 590 Star，热门/排行/搜索/动态 | | 搜全网 | [Exa](https://exa.ai) via [mcporter](https://github.com/nicobailon/mcporter) | AI 语义搜索，MCP 接入免 Key | @@ -323,7 +323,7 @@ Agent Reach uses twitter-cli with cookie auth — zero API fees. Install with `p
Reddit 返回 403 怎么办？ -Agent Reach 使用 [rdt-cli](https://github.com/public-clis/rdt-cli) 访问 Reddit，无需登录、无需代理、无需 API Key。安装：`pipx install rdt-cli`。Agent 可以用 `rdt search "关键词"` 搜索、`rdt read POST_ID` 读帖子全文和评论。 +Agent Reach 使用 [rdt-cli](https://github.com/public-clis/rdt-cli) 访问 Reddit。Reddit 自 2024 年起要求认证，安装后需运行 `rdt login` 登录。安装：`pipx install rdt-cli`，然后 `rdt login`（自动从浏览器提取 Cookie）。之后 Agent 可以用 `rdt search "关键词"` 搜索、`rdt read POST_ID` 读帖子全文和评论。
diff --git a/docs/README_en.md b/docs/README_en.md index 6cab502..331d74f 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 [rdt-cli](https://github.com/public-clis/rdt-cli) (free, no proxy needed) | +| 📖 **Reddit** | Search · Read | Cookie | Requires auth since 2024 — `rdt login` after install ([rdt-cli](https://github.com/public-clis/rdt-cli)) | > **Setup levels:** Zero config = install and go · Auto-configured = handled during install · mcporter = needs MCP service · Cookie = export from browser · Proxy = $1/month @@ -205,7 +205,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 → rdt-cli ← search + read, no proxy needed +├── reddit.py → rdt-cli ← search + read, cookie auth required ├── 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… @@ -222,7 +222,7 @@ Each channel file only checks whether its upstream tool is installed and working |----------|------|-----| | Read web pages | [Jina Reader](https://github.com/jina-ai/reader) | 9.8K stars, free, no API key needed | | Read tweets | [twitter-cli](https://github.com/public-clis/twitter-cli) | 2.1K stars, cookie auth, search/read/timeline/articles | -| Reddit | [rdt-cli](https://github.com/public-clis/rdt-cli) | 304 stars, no login needed, search + full posts + comments | +| Reddit | [rdt-cli](https://github.com/public-clis/rdt-cli) | 304 stars, cookie auth, search + full posts + comments | | Video subtitles + search | [yt-dlp](https://github.com/yt-dlp/yt-dlp) | 154K stars, YouTube + Bilibili + 1800 sites | | Bilibili enhanced | [bili-cli](https://github.com/public-clis/bilibili-cli) | 590 stars, hot/rank/search/feed | | Search the web | [Exa](https://exa.ai) via [mcporter](https://github.com/nicobailon/mcporter) | AI semantic search, MCP integration, no API key | @@ -268,7 +268,7 @@ Agent Reach uses [twitter-cli](https://github.com/public-clis/twitter-cli) with
Reddit returns 403 from server / datacenter IP blocked? -Agent Reach uses [rdt-cli](https://github.com/public-clis/rdt-cli) for Reddit — no login, no proxy, no API key needed. Install with `pipx install rdt-cli`. Your agent can search with `rdt search "query"` and read full posts + comments with `rdt read POST_ID`. +Agent Reach uses [rdt-cli](https://github.com/public-clis/rdt-cli) for Reddit. Since 2024, Reddit requires authentication for all API requests. Install with `pipx install rdt-cli`, then run `rdt login` (auto-extracts cookies from your browser). Your agent can then search with `rdt search "query"` and read full posts + comments with `rdt read POST_ID`.
diff --git a/docs/README_ja.md b/docs/README_ja.md index 60119f9..b69600c 100644 --- a/docs/README_ja.md +++ b/docs/README_ja.md @@ -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** | 検索・閲覧 | 設定不要 | [rdt-cli](https://github.com/public-clis/rdt-cli)で検索+閲覧（無料、プロキシ不要） | +| 📖 **Reddit** | 検索・閲覧 | Cookie | 2024年以降認証が必要 — インストール後 `rdt login` を実行（[rdt-cli](https://github.com/public-clis/rdt-cli)） | > **セットアップレベル：** 設定不要 = インストールしてすぐ使える · 自動設定 = インストール時に処理 · mcporter = MCPサービスが必要 · Cookie = ブラウザからエクスポート · プロキシ = 月額$1 @@ -200,7 +200,7 @@ channels/ ├── youtube.py → yt-dlp ← YouTube API、Whisperなどに差し替え可能… ├── github.py → gh CLI ← REST API、PyGithubなどに差し替え可能… ├── bilibili.py → yt-dlp ← bilibili-apiなどに差し替え可能… -├── reddit.py → rdt-cli ← PRAW、Pushshiftなどに差し替え可能… +├── reddit.py → rdt-cli ← 検索+閲覧、Cookie認証が必要 ├── xiaohongshu.py → xhs-cli ← 他のXHSツールに差し替え可能… ├── douyin.py → mcporter MCP ← 他の抖音ツールに差し替え可能… ├── linkedin.py → linkedin-mcp ← LinkedIn APIに差し替え可能… @@ -261,7 +261,7 @@ Agent Reach は [twitter-cli](https://github.com/public-clis/twitter-cli) をCoo
サーバー/データセンターIPからRedditが403を返す？ -Agent Reach は [rdt-cli](https://github.com/public-clis/rdt-cli) でRedditにアクセスします — ログイン不要、プロキシ不要、APIキー不要。`pipx install rdt-cli` でインストール後、`rdt search "query"` で検索、`rdt read POST_ID` で投稿+コメントの閲覧ができます。 +Agent Reach は [rdt-cli](https://github.com/public-clis/rdt-cli) でRedditにアクセスします。2024年以降、RedditはすべてのAPIリクエストに認証を要求しています。`pipx install rdt-cli` でインストール後、`rdt login`（ブラウザからCookieを自動抽出）を実行してください。その後 `rdt search "query"` で検索、`rdt read POST_ID` で投稿+コメントの閲覧ができます。
diff --git a/docs/README_ko.md b/docs/README_ko.md index ce1ad47..21018f5 100644 --- a/docs/README_ko.md +++ b/docs/README_ko.md @@ -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** | 검색 · 읽기 | 없음 | [rdt-cli](https://github.com/public-clis/rdt-cli)를 통한 검색 및 읽기 (무료, 프록시 없음) | +| 📖 **Reddit** | 검색 · 읽기 | Cookie | 2024년부터 인증 필요 — 설치 후 `rdt login` 실행 ([rdt-cli](https://github.com/public-clis/rdt-cli)) | > **설정 단계:** 없음 = 설치 후 바로 사용 · 자동 = 설치 시 처리 · mcporter = MCP 서비스 필요 · Cookie = 브라우저에서 내보내기 · 프록시 = 월 $1 @@ -200,7 +200,7 @@ channels/ ├── youtube.py → yt-dlp ← YouTube API, Whisper로 교체... ├── github.py → gh CLI → REST API, PyGithub로 교체... ├── bilibili.py → yt-dlp → bilibili-api로 교체... -├── reddit.py → rdt-cli → 검색 + 읽기, 프록시 불필요 +├── reddit.py → rdt-cli → 검색 + 읽기, cookie 인증 필요 ├── xiaohongshu.py → mcporter MCP ← 다른 XHS 도구로 교체... ├── douyin.py → mcporter MCP ← 다른 Douyin 도구로 교체... ├── linkedin.py → linkedin-mcp ← LinkedIn API로 교체... @@ -217,7 +217,7 @@ 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, 로그인 불필요, 검색 + 전체 글 + 댓글 | +| 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, 인기/순위/검색/피드 | | 웹 검색 | [Exa](https://exa.ai) via [mcporter](https://github.com/nicobailon/mcporter) | AI 시맨틱 검색, MCP 통합, API key 불필요 | @@ -263,7 +263,7 @@ Agent Reach는 cookie 기반 인증을 사용하는 [twitter-cli](https://github
서버/데이터센터 IP에서 Reddit 403 반환 / 차단됨? -Agent Reach는 Reddit을 위해 [rdt-cli](https://github.com/public-clis/rdt-cli)를 사용합니다 — 로그인 불필요, 프록시 불필요, API key 불필요. `pipx install rdt-cli`로 설치하세요. 에이전트가 `rdt search "query"`로 검색하고 `rdt read POST_ID`로 전체 글 + 댓글을 읽을 수 있습니다. +Agent Reach는 Reddit을 위해 [rdt-cli](https://github.com/public-clis/rdt-cli)를 사용합니다. 2024년부터 Reddit은 모든 API 요청에 인증을 요구합니다. `pipx install rdt-cli`로 설치한 후 `rdt login`(브라우저에서 cookie 자동 추출)을 실행하세요. 이후 에이전트가 `rdt search "query"`로 검색하고 `rdt read POST_ID`로 전체 글 + 댓글을 읽을 수 있습니다.