Agent-Reach 是一支開源 CLI,把 Twitter、Reddit、YouTube、GitHub、Bilibili、小紅書等十多個平台的免費爬取與閱讀工具整合成統一介面。AI agent 不必付 API 費、不必各別處理登入,就能讀取與搜尋這些平台的內容。相容 Claude Code、OpenClaw、Cursor、Windsurf。本手冊涵蓋一鍵安裝、支援平台、Cookie 設定與實戰範例。
AI agent 的天生限制是讀不到網路:登入牆、付費 API、各平台不同的反爬機制,讓它無法自行瀏覽 Twitter 串、看 YouTube 字幕或讀小紅書貼文。Agent-Reach 解決的就是這件事——它把各平台社群維護的免費爬取與閱讀工具(如 twitter-cli、yt-dlp、Jina Reader)整合成一支統一 CLI,讓 agent 用同一套指令讀遍十多個平台,且零 API 費。
支援平台涵蓋 Twitter/X、Reddit、YouTube、GitHub、Bilibili、小紅書、微信、微博、V2EX、雪球、LinkedIn、TikTok 與 RSS。底層不是自建爬蟲,而是包裝既有開源工具:網頁用 Jina Reader(免金鑰)、影片字幕用 yt-dlp(154K stars)、搜尋用 Exa via mcporter、GitHub 用官方 gh CLI。Agent-Reach 負責統一介面與通道管理,實際抓取交給這些上游工具。
架構上採可插拔通道(channel)設計,每個平台獨立在 channels/PLATFORM.py,部分平台透過 MCP(Model Context Protocol)接入。設定存在本機 ~/.agent-reach/config.yaml(600 權限、僅本地)。授權 MIT,最新版 v1.4.0(2026 年 3 月)。
Agent-Reach 的安裝方式很特別:你不自己跑指令,而是把官方 install 文件網址貼給支援的 agent(Claude Code、Cursor 等),由 agent 讀文件、依環境完成安裝。直接在對話框貼:
安裝完成後,先跑診斷指令確認各通道狀態(哪些平台已就緒、哪些還需登入):
docs/update.md 網址貼給 agent(「幫我更新 Agent Reach:…」)。要移除用 agent-reach uninstall;加 --dry-run 只預覽、加 --keep-config 保留登入憑證。設定統一存在 ~/.agent-reach/(YAML、600 權限、僅本地)。
每個平台是一條獨立通道,背後對應一個成熟的開源工具。以下列出主要通道與其底層工具;標註 cookie 的平台需先登入匯出 Cookie,標註 MCP 的透過 Model Context Protocol 接入。
rdt login 完成 Cookie 登入。xhs login,底層 xhs-cli(約 1.5K stars)。
免登入的通道裝完即用;Cookie 通道需先在瀏覽器登入再匯出 Cookie;MCP 通道透過 mcporter 接入。用 agent-reach doctor 可隨時確認狀態。
| 類型 | 平台 | 底層工具 |
|---|---|---|
| 免登入 | Web / YouTube / Bilibili / RSS | Jina Reader · yt-dlp · feedparser |
| Cookie 登入 | Twitter / Reddit / 小紅書 | twitter-cli · rdt-cli · xhs-cli |
| MCP 接入 | Search / TikTok / LinkedIn | Exa · douyin-mcp · linkedin-mcp |
| 官方工具 | GitHub | gh CLI |
以下要點整理自 Agent-Reach 官方 README 與文件。核心是讓需要登入的通道先過 Cookie 這關,並善用 doctor 排查;細節以 GitHub repo 最新文件為準。
安裝後第一件事是 agent-reach doctor。它會逐通道回報狀態,告訴你哪些平台已可用、哪些還缺登入或工具,比逐一試錯快。
Web(Jina Reader)、YouTube/Bilibili(yt-dlp)、RSS(feedparser)都免登入,裝完即用。先用這些跑通流程,再回頭處理需要 Cookie 的平台。
來源 · 官方 README · 工具表Twitter、Reddit、小紅書需登入。官方建議用 Chrome 的 Cookie-Editor 外掛在登入後匯出 Cookie,再依文件填入,比手動抓 header 可靠。
來源 · 官方 README · Cookie 設定Reddit 用 rdt login、小紅書用 xhs login 完成各自的登入流程。這些是底層工具自帶的指令,跟著文件跑一次即可。
從海外伺服器存取 Bilibili 可能受地區限制,官方提到可選用約每月 1 美元的代理。非必要平台可先略過,需要時再加。
來源 · 官方 README · 設定要讓 agent 主動找資料,用內建的 Exa 語意搜尋(透過 mcporter)。免費額度免金鑰,先用免費層驗證需求,再決定是否升級。
來源 · 官方 README · Search以下示意一段對話:你要 agent 整理某條 X 串文的重點,並補一支相關 YouTube 影片的字幕摘要。裝好 Agent-Reach、Twitter Cookie 已就緒後,agent 直接呼叫對應通道取得內容。指令與輸出為示意,實際結果依平台內容而定。
關鍵在 agent 能跨平台自行取材:它依任務挑通道(Twitter 用 twitter-cli、YouTube 用 yt-dlp),取得原始內容後直接比對。你不必先手動複製貼上,也不必為每個平台買 API。
對研究、輿情、競品追蹤等需要大量讀取的工作,這把「人去各平台抓資料」收斂成「對 agent 下一句話」。底層仍是成熟的開源工具,Agent-Reach 只是讓 agent 用得順、用得統一。
~/.agent-reach/(600 權限),仍要避免外洩或 commit 進版控,並定期更新。
doctor 定位。
通道跑通之後,下一步是把讀網能力接進你的 agent 工作流。以下方向皆基於 Agent-Reach 既有能力。
1. 把 Agent-Reach 寫進 agent 的工具清單。在 Claude Code、Cursor、Windsurf 的設定或 CLAUDE.md 註明:需要讀網時優先用 Agent-Reach 的對應通道,讓 agent 自動選對工具。
2. 組合多通道做研究。一個任務串接搜尋(Exa)、社群(Twitter/Reddit)、影片(yt-dlp)與網頁(Jina),讓 agent 一次跨來源彙整,而非單點查詢。
3. 用 RSS 做持續追蹤。把要長期盯的部落格、新聞做成 RSS 通道,搭配排程讓 agent 定期讀取與摘要,形成輕量輿情/競品監控。
4. 擴充新通道。架構採可插拔 channel(channels/PLATFORM.py)。要支援新平台,可依現有通道結構新增,或接入對應的 MCP server。
5. 跨 agent 共用。同一套安裝可服務多個相容 agent(Claude Code、OpenClaw、Cursor、Windsurf),切換工具時讀網能力不必重設。
① GitHub repo——安裝文件、通道清單與 release notes 的原始來源。
② docs/install.md——貼給 agent 的一鍵安裝文件。
③ agent-reach doctor——隨時檢查各通道狀態的第一手診斷。