使用手冊

第 01 期 · 開源工具 / AI Agent

給 AI Agent 一雙讀遍全網的眼睛。

Agent-Reach 是開源 CLI,把 Twitter、Reddit、YouTube、GitHub、Bilibili、小紅書等平台的免費爬取與閱讀工具整合成統一介面,讓 AI agent 零 API 費讀取與搜尋全網。本手冊涵蓋一鍵安裝、支援平台、Cookie 設定與實戰範例。

Agent-Reach 是一支開源 CLI,把 Twitter、Reddit、YouTube、GitHub、Bilibili、小紅書等十多個平台的免費爬取與閱讀工具整合成統一介面。AI agent 不必付 API 費、不必各別處理登入,就能讀取與搜尋這些平台的內容。相容 Claude Code、OpenClaw、Cursor、Windsurf。本手冊涵蓋一鍵安裝、支援平台、Cookie 設定與實戰範例。

panniantong/agent-reach
星標
—
分支
—
授權
—
資料截至
—
閱讀時間
7 分
更新日期
開啟原始報告
GitHub Stars
23.1k
支援平台
13+
API 費用
$0
開源授權
MIT
本頁章節

01這到底是什麼

把全網讀取, 收成一支 CLI。

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 月)。

  1. 安裝

  2. 登入 Cookie

  3. doctor 檢查

  4. agent 呼叫通道

  5. 取得內容

02一鍵安裝

把網址丟給 agent, 讓它自己裝。

Agent-Reach 的安裝方式很特別:你不自己跑指令,而是把官方 install 文件網址貼給支援的 agent(Claude Code、Cursor 等),由 agent 讀文件、依環境完成安裝。直接在對話框貼:

bash
# 貼這段給 agent,它會讀文件並完成安裝
幫我安裝 Agent Reach:
https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

安裝完成後,先跑診斷指令確認各通道狀態(哪些平台已就緒、哪些還需登入):

bash
# 檢查所有通道狀態
agent-reach doctor

# 安裝/修復通道(預覽用 --safe 或 --dry-run)
agent-reach install --env=auto
agent-reach install --env=auto --dry-run

03支援平台與通道

一套指令, 讀遍十多個平台。

每個平台是一條獨立通道,背後對應一個成熟的開源工具。以下列出主要通道與其底層工具;標註 cookie 的平台需先登入匯出 Cookie,標註 MCP 的透過 Model Context Protocol 接入。

免登入 · 01

Web

網頁 Jina Reader

任意網址轉乾淨可讀文字,免 API 金鑰。agent 讀一般網頁與文章的預設通道。

cookie · 02

Twitter / X

推文 twitter-cli

讀取與搜尋推文、串文。Cookie 登入,底層 twitter-cli(約 2.1K stars)。

cookie · 03

Reddit

討論 rdt-cli

讀子版與討論串。需先 rdt login 完成 Cookie 登入。

免登入 · 04

YouTube / Bilibili

影片字幕 yt-dlp

抽取影片字幕與資訊。底層 yt-dlp(約 154K stars),把長影片轉成可讀文字。

MCP · 05

Search

語意搜尋 Exa

透過 mcporter 接 Exa 做 AI 語意搜尋,免費額度免金鑰。給 agent 主動找資料的能力。

官方工具 · 06

GitHub

程式碼 gh CLI

讀 repo、issue、PR 與程式碼。底層為 GitHub 官方 gh CLI。

cookie · 07

小紅書 XiaoHongShu

圖文 xhs-cli

讀小紅書貼文。需 xhs login,底層 xhs-cli(約 1.5K stars)。

MCP · 08

TikTok / LinkedIn

社群 MCP server

TikTok 用 douyin-mcp-server(免登入);LinkedIn 用 linkedin-mcp-server(瀏覽器自動化)。

免登入 · 09

RSS

訂閱源 feedparser

解析 RSS/Atom 訂閱源。底層 feedparser(約 2.3K stars),適合追蹤部落格與新聞。

哪些通道需要登入?

免登入的通道裝完即用;Cookie 通道需先在瀏覽器登入再匯出 Cookie;MCP 通道透過 mcporter 接入。用 agent-reach doctor 可隨時確認狀態。

類型平台底層工具
免登入Web / YouTube / Bilibili / RSSJina Reader · yt-dlp · feedparser
Cookie 登入Twitter / Reddit / 小紅書twitter-cli · rdt-cli · xhs-cli
MCP 接入Search / TikTok / LinkedInExa · douyin-mcp · linkedin-mcp
官方工具GitHubgh CLI

04上手設定 · 依官方文件

裝完之後, 先把登入設好。

以下要點整理自 Agent-Reach 官方 README 與文件。核心是讓需要登入的通道先過 Cookie 這關,並善用 doctor 排查;細節以 GitHub repo 最新文件為準。

先跑 doctor 看誰沒就緒

安裝後第一件事是 agent-reach doctor。它會逐通道回報狀態,告訴你哪些平台已可用、哪些還缺登入或工具,比逐一試錯快。

來源 · 官方 README · 診斷

免登入通道先用起來

Web(Jina Reader)、YouTube/Bilibili(yt-dlp)、RSS(feedparser)都免登入,裝完即用。先用這些跑通流程,再回頭處理需要 Cookie 的平台。

來源 · 官方 README · 工具表

Cookie 用瀏覽器外掛匯出

Twitter、Reddit、小紅書需登入。官方建議用 Chrome 的 Cookie-Editor 外掛在登入後匯出 Cookie,再依文件填入,比手動抓 header 可靠。

來源 · 官方 README · Cookie 設定

部分平台有專屬登入指令

Reddit 用 rdt login、小紅書用 xhs login 完成各自的登入流程。這些是底層工具自帶的指令,跟著文件跑一次即可。

來源 · 官方 README · 工具表

海外讀 Bilibili 可加代理

從海外伺服器存取 Bilibili 可能受地區限制,官方提到可選用約每月 1 美元的代理。非必要平台可先略過,需要時再加。

來源 · 官方 README · 設定

搜尋走 Exa 免費額度起步

要讓 agent 主動找資料,用內建的 Exa 語意搜尋(透過 mcporter)。免費額度免金鑰,先用免費層驗證需求,再決定是否升級。

來源 · 官方 README · Search

05實戰範例

讓 agent 自己去讀一串推文。

以下示意一段對話:你要 agent 整理某條 X 串文的重點,並補一支相關 YouTube 影片的字幕摘要。裝好 Agent-Reach、Twitter Cookie 已就緒後,agent 直接呼叫對應通道取得內容。指令與輸出為示意,實際結果依平台內容而定。

~/research · agent + agent-reach


$ You ›
  幫我整理這條 X 串文的重點,再補一支相關
  YouTube 影片的字幕摘要。


# [agent 選擇 twitter 通道 · cookie 已就緒]
$ twitter-cli read https://x.com/.../status/...


claude: Agent ›
  已讀到 8 則串文。重點整理:
    hl: · 主張:小團隊用 agent 取代多數重複性後台工作
    hl: · 證據:作者列了 3 個自動化流程與省下的工時
    hl: · 爭議:回覆區質疑可靠度與審核成本


# [agent 選擇 youtube 通道 · 免登入]
$ yt-dlp --write-auto-sub --skip-download "https://youtu.be/..."


# [抽取字幕 · 12,400 字 → 摘要]
claude: Agent ›
  影片字幕摘要(對應串文主題):
    1. 示範把客服分類交給 agent 的完整流程
    2. 強調人工複核仍是必要的一關
    3. 給出可量測的導入指標


$ You › 兩邊有沒有互相矛盾的地方?


claude: Agent ›
  串文把審核講得很輕,影片則明確說人工複核不可省。
  ok: → 兩者對「省工時」一致,對「能省多少審核」分歧。


# [全程零 API 費 · 內容由 agent 自行取得並比對]

同一個 agent,讀了推文、抽了字幕、 比對出兩邊的分歧—— 全程零 API 費。

— Agent-Reach 把「讀網」變成 agent 的內建能力

這段流程的關鍵

關鍵在 agent 能跨平台自行取材:它依任務挑通道(Twitter 用 twitter-cli、YouTube 用 yt-dlp),取得原始內容後直接比對。你不必先手動複製貼上,也不必為每個平台買 API。

對研究、輿情、競品追蹤等需要大量讀取的工作,這把「人去各平台抓資料」收斂成「對 agent 下一句話」。底層仍是成熟的開源工具,Agent-Reach 只是讓 agent 用得順、用得統一。

06先看清楚這些

用之前, 知道這些邊界。

07進階路徑

從讀單一平台, 到串成工作流。

通道跑通之後,下一步是把讀網能力接進你的 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——隨時檢查各通道狀態的第一手診斷。

Give your AI agent eyes to see the entire internet. One CLI, zero API fees.

— Agent-Reach,GitHub README