Panniantong/Agent-Reach

Agent Reach – 為您的 AI 代理提供一鍵式網際網路存取

是什麼 – 一個基於 Python 的命令列工具，為任何 LLM 驅動的「代理」（Claude Code、OpenClaw、Cursor、Windsurf 等）提供開箱即用、持續更新的網頁閱讀、YouTube 字幕取得、Reddit 查詢、GitHub 數據拉取、Twitter/X 抓取等主流平台存取方式。它不自行實作爬取或解析；而是為每個服務自動選擇、安裝並健康檢查最佳的開源工具，並透過一個簡單的 技能 檔案將它們整合到代理中。

為何需要它 – 現代代理可以撰寫程式碼或管理專案，但當被要求「上網查一下」時就會卡住。每個網站通常需要不同的 CLI 工具、API 金鑰、登入 Cookie 或脆弱的變通方案。Agent Reach 抽象掉了這些繁瑣的底層邏輯：只需一條自然語言命令，例如

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

即可讓代理自動安裝所需二進位檔，配置憑證（若您提供 Cookie），並註冊一個 SKILL.md，使代理知道針對特定請求應調用哪個命令。

核心功能（如 README 所述）

• 零設定通道：網頁、YouTube 字幕、RSS/Atom 訂閱源、公開 GitHub 儲存庫 – 無需設定，開箱即用。
• 可選登入通道（Twitter/X、Reddit、Facebook、Instagram、小紅書、LinkedIn 等）– 代理可引導您完成 Cookie 導出或登入狀態設定。
• 自動後端選擇：每個平台都有優先級工具清單（如 twitter-cli → OpenCLI → bird）。優先使用首個功能完整的後端；若失效，agent-reach doctor 會顯示備用方案。
• 自診斷功能：agent-reach doctor 可報告哪些通道健康、當前活躍的後端是哪個，以及如何修復問題。
• 安全優先安裝：預設 install 僅檢查環境；真實系統變更僅在使用 --system 時發生。
• 跨代理相容：適用於任何能執行 shell 命令的代理，不綁定特定 LLM。
• 開源且免費：MIT 許可，所有底層工具均為開源；若在遠端機器上執行代理，唯一可能的成本是廉價代理伺服器。

支援平台（快速概覽）

平台	即時可用	預設設定
網頁	✅	–
YouTube（字幕）	✅	–
RSS/Atom	✅	–
GitHub（公開）	✅	–
Twitter/X（單條推文）	✅	導出 Cookie
Twitter/X（搜尋、時間軸）	❌	agent-reach configure twitter
Reddit	❌	透過 OpenCLI 或 rdt-cli 登入
Facebook / Instagram	❌	透過 OpenCLI（Chrome 會話）登入
Bilibili	✅	–
LinkedIn	✅（公開）	完整資料存取需 agent-reach configure linkedin
小紅書、小宇宙播客、雪球、V2EX 等	✅（基礎）	可選憑證步驟

工作原理

1. 安裝 – pip install -e .（或提供的安裝腳本）將 agent-reach CLI 加入系統。
2. 相依性檢查 – 工具會驗證 Node、gh CLI、mcporter 等是否存在，並建議缺失的安裝。
3. 通道註冊 – channels/ 下的 Python 模組宣告每個服務的首選和備用後端。
4. 技能產生 – 執行 agent-reach install 時，會在目標代理的技能目錄中產生 SKILL.md，將自然語言意圖對應到合適的 shell 命令。
5. 執行時 – 代理讀取 SKILL.md，決定呼叫哪個命令（如 YouTube 字幕用 yt-dlp），執行並回傳結構化結果給 LLM。

安全與隱私

• Cookie/token 儲存在本地 ~/.agent-reach/config.yaml，權限為 600；不會上傳任何資料。
• 安裝程式除非您傳入 --system，否則不會修改系統檔案。
• 幹運行模式（--dry-run）會在執行前顯示所有操作。
• README 提醒使用登入 Cookie 可能導致帳號封禁，建議使用專用的臨時帳號。

典型工作流程

使用者：幫我看看這個連結
代理：(讀取 SKILL.md) → 執行 `curl https://r.jina.ai/URL`

使用者：幫我搜尋 Reddit 上關於 LLM 的討論
代理：要求您設定 Reddit → 您執行 `agent-reach configure reddit`
代理：然後使用您的瀏覽器會話執行 `opencli` 並回傳文章。

誰可能使用它

• 需要即時網路資料的客製化 AI 助手開發者。
• 在內部伺服器部署代理的團隊，希望以單一、可維護的方式保持網路存取能力最新。
• 希望個人 Claude/ChatGPT 風格機器人能瀏覽網際網路而無需撰寫爬蟲的愛好者。

如何開始

1. 克隆倉儲。
2. 執行 agent-reach install --env=auto（新增 CLI 並檢查相依性）。
3. 將一行安裝命令複製到您的代理聊天中。
4. 使用 agent-reach doctor 驗證每個通道。

---

總結 – Agent Reach 是一個實用、開源的能力層，消除了 LLM 代理取得現實世界資料所需的繁瑣設定。它扎根於 AI 代理生態系，而非無關的教學或清單，因此完全契合前沿 AI 工具的範疇。