Panniantong/Agent-Reach

Agent Reach – 為您的 AI 代理提供一鍵式網路能力增強

它是什麼 – 一個基於 Python 的能力層，為任何命令列驅動的 AI 代理（如 Claude Code、OpenClaw、Cursor、Windsurf 等）配備即用型的多種網路服務存取能力。它能為每個平台（YouTube 字幕、Twitter 推文、Reddit 貼文、GitHub 資料、RSS 訂閱等）發現、安裝並配置最可靠的工具，並在網站更改 API 或封鎖爬蟲時保持路由更新。

為什麼重要 – 現代代理雖然能編寫程式碼或管理專案，但在被要求「上網查詢」時往往會受阻。Agent Reach 消除了手動且易出錯的設定工作（安裝 CLI 工具、處理 Cookie、應對驗證碼），讓代理能專注於更高層級的任務。

主要功能

• 零配置頻道：支援許多熱門網站（網頁、YouTube、RSS、GitHub、LinkedIn 等）。
• 可選的登入頻道：Twitter/X、Reddit、Facebook、Instagram、小紅書等，可透過簡單的「幫我配 XXX」提示啟用；工具會引導使用者進行 Cookie 匯出或瀏覽器工作階段連結。
• 自動後端選擇：每個頻道定義了主要與備用實作（例如 twitter-cli → OpenCLI → bird）。CLI 會探測環境並選擇第一個可用的後端，並透過 agent-reach doctor 回報選擇結果。
• 安全優先安裝：agent-reach install 預設僅檢查環境，除非使用者加上 --system 參數。試運行模式（dry-run）可精確顯示將安裝的內容。
• 僅限本地的憑證儲存：Cookie 與 Token 儲存在 ~/.agent-reach/config.yaml 中，權限設為 600；不會上傳任何資料。
• 自我診斷：agent-reach doctor 會告知您哪些頻道功能正常，以及如何修復損壞的頻道。
• 跨代理相容性：適用於任何能執行 Shell 指令的代理；OpenClaw 使用者唯一的要求是啟用 exec 工具設定檔。

如何使用

1. 將以下單行指令複製到您的代理對話框中：

   幫我安裝 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
   

2. 代理會執行安裝腳本，該腳本會：
   • 安裝 agent-reach CLI（包含 yt-dlp、feedparser 等）
   • 檢查必要的系統工具（Node.js、gh CLI、mcporter）
   • 註冊 SKILL.md 檔案，讓代理知道該呼叫哪些指令。
3. 安裝完成後，只需要求代理「閱讀此連結」、「總結 YouTube 影片」、「搜尋 Reddit 關於…」，系統會自動呼叫適當的後端。
4. 若要更新，請發送相同的單行提示並附上更新 URL。

支援平台（摘要）

平台	開箱即用	需要額外配置
網頁	✅ (Jina Reader)	—
YouTube	✅ (yt‑dlp subtitles)	—
RSS/Atom	✅ (feedparser)	—
GitHub (公開)	✅ (gh CLI)	私有儲存庫需登入
Twitter/X	✅ (tweet fetch)	搜尋/時間軸需登入
Reddit	✅ (post fetch)	完整搜尋需登入
Bilibili	✅ (bili‑cli)	—
Facebook / Instagram	✅ (OpenCLI)	需登入
小紅書	✅ (OpenCLI)	需登入
LinkedIn	✅ (mcp‑server‑linkedin)	需登入
其他 (Snowball, Boss直聘等)	✅ (特定 CLI)	可能需手動 Chrome 工作階段

設計理念 – Agent Reach 不是另一個爬蟲；它是一個能力層，抽象化了工具選擇、安裝與健康檢查的過程。每個頻道都是一個小型 Python 模組，列出主要與備用後端；doctor 指令會探測它們並回報目前啟用的後端。當後端失效（例如 yt‑dlp 被 Bilibili 封鎖）時，專案只需重新排序列表，使用者無需更改任何程式碼。

安全與隱私

• 所有 Cookie/Token 均保留在使用者機器上；儲存庫絕不會傳輸它們。
• 除非傳入 --system，否則安裝過程不會修改系統檔案。
• README 警告了使用登入型頻道時可能導致帳號被封鎖的風險，並建議使用免洗帳號。

開始使用 – 儲存庫包含：

• docs/install.md 與 docs/update.md（您提供給代理的 URL）。
• channels/ 目錄，包含各平台的轉接器。
• CLI 指令：agent-reach install, agent-reach doctor, agent-reach uninstall。

誰適合使用 – 開發自訂 AI 助理的開發者、部署內部資料收集代理的團隊，或是希望代理能瀏覽網頁而無需編寫爬蟲程式的愛好者。

---

以上所有資訊均直接取自專案的 README；未推論任何額外功能。