待翻譯：Agent Reach: An open-source CLI that gives AI agents access to the internet

AI 服務暫時不可用，以下為來源正文，待恢復後補全翻譯。

Notifications You must be signed in to change notification settings Fork 5.7k Star 68k BranchesTags Open more actions menu Folders and files NameName Last commit message Last commit date Latest commit History 370 Commits 370 Commits .github/workflows .github/workflows .openteams/specs .openteams/specs agent_reach agent_reach config config docs docs scripts scripts tests tests .env.example .env.example .gitignore .gitignore CHANGELOG.md CHANGELOG.md CLAUDE.md CLAUDE.md CONTRIBUTING.md CONTRIBUTING.md LICENSE LICENSE README.md README.md SECURITY.md SECURITY.md constraints.txt constraints.txt llms.txt llms.txt pyproject.toml pyproject.toml test.sh test.sh Repository files navigation 給你的 AI Agent 一鍵裝上互聯網能力 當下最穩的接入方式，替你選好、裝好、體檢好——接入方式會換代，你不用操心 快速開始 · English · 日本語 · 한국어 · 支持平台 · 設計理念 ❤️贊助商 想出現在這裏？ 點擊摺疊 BrowserAct 支持從 Amazon、LinkedIn、X、Google Maps 等複雜網站提取你需要的任意數據。你只需用自然語言描述抓取需求，Agent 就會基於真實瀏覽器自動探索並測試頁面流程，生成可靠、可複用的數據採集 Bot，並返回結構化結果。無需手動構建爬蟲，無需編寫代碼。BrowserAct 內置隱身瀏覽、驗證碼處理和高質量住宅代理，幫助你更穩定地完成複雜網頁數據採集。新用户註冊即送 1000 積分，立即免費試用。 在騰訊雲 Lighthouse 秒級部署 OpenClaw 全能助手，可通過對話絲滑接入 Agent Reach，給你的 OpenClaw 一鍵裝上互聯網能力。 CoreClaw | 網頁抓取平台與現成數據採集工具，CoreClaw 提供 100+ 現成數據採集工具，支持 Amazon、TikTok、Google Maps、Instagram、Facebook、YouTube 等平台，無需代碼，支持 JSON/CSV 導出，僅對成功結果計費。免費$3測試！ 為什麼需要 Agent Reach？ AI Agent 已經能幫你寫代碼、改文檔、管項目——但你讓它去網上找點東西，它就抓瞎了： 📺 "幫我看看這個 YouTube 教程講了什麼" → 看不了，拿不到字幕 🐦 "幫我搜一下推特上大家怎麼評價這個產品" → 搜不了，Twitter API 要付費 📖 "去 Reddit 上看看有沒有人遇到過同樣的 bug" → 403 被封，服務器 IP 被拒 📕 "幫我看看小紅書上這個品的口碑" → 打不開，必須登錄才能看 📺 "B站上有個技術視頻，幫我總結一下" → 拿不到，通用下載工具被 B站風控全面攔截 🔍 "幫我在網上搜一下最新的 LLM 框架對比" → 沒有好用的搜索，要麼付費要麼質量差 🌐 "幫我看看這個網頁寫了啥" → 抓回來一堆 HTML 標籤，根本沒法讀 📦 "這個 GitHub 倉庫是幹嘛的？Issue 裏説了什麼？" → 能用，但認證配置很麻煩 📡 "幫我訂閲這幾個 RSS 源，有更新告訴我" → 要自己裝庫寫代碼 這些不難實現，但是需要自己折騰配置 每個平台都有自己的門檻——要付費的 API、要繞過的封鎖、要登錄的賬號、要清洗的數據。你要一個一個去踩坑、裝工具、調配置，光是讓 Agent 能讀個推特就得折騰半天。 Agent Reach 把這件事變成一句話： 幫我安裝 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md 複製給你的 Agent，幾分鐘後它就能讀推特、搜 Reddit、看 YouTube、刷小紅書了。 已經裝過了？更新也是一句話： 幫我更新 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md ⭐ Star 這個項目，我們會持續追蹤各平台的變化、接入新的渠道。你不用自己盯——平台封了我們修，有新渠道我們加。 ✅ 在你用之前，你可能想知道 💰 完全免費 所有工具開源、所有 API 免費。唯一可能花錢的是服務器代理（$1/月），本地電腦不需要 🔒 隱私安全 Cookie 只存在你本地，不上傳不外傳。代碼完全開源，隨時可審查 🔄 持續換代 每個平台都是「首選 + 備選」多後端路由。某個接入方式失效了，我們換下一個，你無感（2026-06 實例：yt-dlp 被 B站風控封死 → 已切換 bili-cli，用户零操作） 🤖 兼容所有 Agent Claude Code、OpenClaw、Cursor、Windsurf……任何能跑命令行的 Agent 都能用 🩺 自帶診斷 agent-reach doctor 一條命令告訴你哪個通、哪個不通、怎麼修 支持的平台 平台 裝好即用 配置後解鎖 怎麼配 🌐 網頁 閲讀任意網頁 — 無需配置 📺 YouTube 字幕提取 + 視頻搜索 — 無需配置 📡 RSS 閲讀任意 RSS/Atom 源 — 無需配置 🔍 全網搜索 — 全網語義搜索 自動配置（MCP 接入，免費無需 Key） 📦 GitHub 讀公開倉庫 + 搜索 私有倉庫、提 Issue/PR、Fork 告訴 Agent「幫我登錄 GitHub」 🐦 Twitter/X 讀單條推文 搜索推文、瀏覽時間線、讀長文 告訴 Agent「幫我配 Twitter」 📺 B站 搜索 + 視頻詳情（bili-cli，無需登錄） 字幕（OpenCLI） 告訴 Agent「幫我配 B站」 📖 Reddit —（沒有零配置路徑：匿名接口已被封） 搜索 + 讀帖子和評論 桌面裝 OpenCLI 用瀏覽器登錄態；或 rdt-cli + Cookie 📘 Facebook — 搜索、主頁、Feed、羣組列表 桌面裝 OpenCLI（複用 Chrome 登錄態） 📷 Instagram — 用户搜索、Profile、用户最近帖子、Explore 桌面裝 OpenCLI（複用 Chrome 登錄態） 📕 小紅書 — 搜索、閲讀、評論 OpenCLI 只用用户已有 Chrome 會話；MCP/存量工具用 Cookie-Editor 💼 LinkedIn Jina Reader 讀公開頁面 Profile 詳情、公司頁面、職位搜索 告訴 Agent「幫我配 LinkedIn」 💻 V2EX 熱門帖子、節點帖子、帖子詳情+回覆、用户信息 — 無需配置 📈 雪球 股票行情、搜索股票、熱門帖子、熱門股票排行 — 告訴 Agent「幫我配雪球」 🎙️ 小宇宙播客 — 播客音頻轉文字（Whisper 轉錄，免費 Key） 告訴 Agent「幫我配小宇宙播客」 不知道怎麼配？不用查文檔。 直接告訴 Agent「幫我配 XXX」，它知道需要什麼、會一步一步引導你。 🍪 Twitter 只接受用户通過 Cookie-Editor 手工導出的內容。Agent Reach 不替用户執行小紅書登錄，也不讀取小紅書瀏覽器 Cookie；OpenCLI 只使用用户已經存在且明確控制的 Chrome 會話。agent-reach configure xhs-cookies 不會把 Cookie 注入 OpenCLI / Chrome；沒有現成會話時，改用 Cookie-Editor 導出後配置 xiaohongshu-mcp / 存量工具。 Twitter Cookie 保存後僅供 agent-reach doctor 檢查配置是否齊全；直接運行上游 twitter 命令前，仍需在當前進程環境中顯式設置 TWITTER_AUTH_TOKEN 和 TWITTER_CT0。 🔒 Cookie 只存在你本地，不上傳不外傳。代碼完全開源，隨時可審查。 💻 本地電腦不需要代理。代理只有部署在服務器上才需要（~$1/月）。 快速上手 ⚠️ OpenClaw 用户請先確認 exec 權限已開啓 Agent Reach 依賴 Agent 執行 shell 命令（pip install、mcporter、twitter 等）。如果你的 OpenClaw 使用了默認的 messaging 工具配置，Agent 將無法執行命令。安裝前請先開啓 exec 權限： openclaw config set tools.profile "coding" 或在 ~/.openclaw/openclaw.json 中設置 "tools": { "profile": "coding" }。 設置後重啓 Gateway（openclaw gateway restart）並開啓新對話即可。其他平台（Claude Code、Cursor、Windsurf 等）不受此限制。 複製這句話給你的 AI Agent（Claude Code、OpenClaw、Cursor 等）： 幫我安裝 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md 就這一步。Agent 會自己完成剩下的所有事情。 🔄 已安裝過？ 更新也是一句話： 幫我更新 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md 🛡️ 默認安全： agent-reach install 默認只檢查環境，不會自動裝系統包或寫入配置： 幫我安全檢查並安裝 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md 只有在你明確允許修改系統後，才使用 agent-reach install --system。 它會做什麼？（點擊展開） 安裝 CLI 工具 — 從本倉庫安裝 agent-reach 命令行（自帶 yt-dlp、feedparser；不要從 PyPI 安裝同名包，它不是本項目） 檢查系統基建 — 檢查 Node.js、gh CLI、mcporter，並給出缺失項的安裝方式 按授權安裝與配置 — 僅在顯式傳入 --system 時安裝依賴並通過 MCP 接入 Exa 檢測環境 — 判斷是本地電腦還是服務器，給出對應的配置建議 按授權註冊 SKILL.md — 僅在顯式 --system 時寫入 Agent 的 skills 目錄；默認檢查不改文件 問你要不要更多 — 默認只激活 6 個零配置渠道；小紅書、Twitter、Reddit、Facebook、Instagram 這些需要登錄態的，Agent 會列菜單問你要哪些，點名才裝 安裝完之後，agent-reach doctor 一條命令告訴你每個渠道的狀態、當前走哪條路。 裝好就能用 不需要任何配置，告訴 Agent 就行： "幫我看看這個鏈接" → curl https://r.jina.ai/URL 讀任意網頁 "這個 GitHub 倉庫是做什麼的" → gh repo view owner/repo "這個 YouTube 視頻講了什麼" → yt-dlp 提取字幕 "B站搜一下 AI 教程" → bili search（無需登錄） "全網搜一下 LLM 框架對比" → Exa 語義搜索 "訂閲這個 RSS" → feedparser 解析 不需要記命令。 Agent 讀了 SKILL.md 之後自己知道該調什麼。需要登錄的平台（小紅書、Twitter、Reddit、Facebook、Instagram），告訴 Agent「幫我配 XXX」即可解鎖。 設計理念 Agent Reach 是一個能力層（capability layer），不是又一個工具。 它比任何具體實現高一層——負責選型、安裝、體檢、路由，不負責底層讀取本身。讀取由 Agent 直接調用上游工具完成，沒有包裝層。 你給一個新 Agent 裝環境的時候，總要花時間去找工具、裝依賴、調配置——Twitter 用什麼讀？Reddit 怎麼登錄？小紅書的 CLI 停更了換什麼？每次都要重新踩一遍。Agent Reach 做的事情很簡單：當下最穩的接入方式，我們替你選好、裝好、體檢好。接入方式會換代（2026 年 3 月一批單平台 CLI 集體停更，我們換了路由），你不用操心。 🔌 每個平台 = 首選 + 備選的有序後端列表 換接入方式 = 調整列表順序，不是重寫代碼。agent-reach doctor 會告訴你每個平台當前在用哪個後端。 channels/ ├── web.py → Jina Reader ├── twitter.py → twitter-cli ▸ OpenCLI ▸ bird ├── youtube.py → yt-dlp ├── github.py → gh CLI ├── bilibili.py → bili-cli ▸ OpenCLI ▸ 搜索 API（yt-dlp 已被 B站風控封死，退役） ├── reddit.py → OpenCLI ▸ rdt-cli（無零配置路徑，必須登錄態） ├── facebook.py → OpenCLI（桌面瀏覽器登錄態） ├── instagram.py → OpenCLI（桌面瀏覽器登錄態） ├── xiaohongshu.py → OpenCLI ▸ xiaohongshu-mcp ▸ xhs-cli ├── linkedin.py → mcp-server-linkedin ▸ Jina Reader ├── rss.py → feedparser ├── exa_search.py → Exa via mcporter └── init.py → 渠道註冊（doctor 檢測用） 每個渠道文件按序真實探測各候選後端（不只是看命令存不存在），第一個完整可用的當選；壞掉的會給出修復處方。實際的讀取和搜索由 Agent 直接調用上游工具完成。 當前選型 場景 首選 備選 為什麼這麼選 讀網頁 Jina Reader — 免費，不需要 API Key 讀推特 twitter-cli OpenCLI 實測搜索穩定；OpenCLI 走瀏覽器登錄態兜底 Reddit OpenCLI（桌面） rdt-cli 匿名接口已被封、官方 API 審批制——只剩登錄態路線 Facebook OpenCLI（桌面） — Graph API/Groups API 權限收緊；瀏覽器登錄態是當前最實用路徑 Instagram OpenCLI（桌面） 官方 Graph API（Business/Creator + 審批） instaloader 類路徑不穩定；OpenCLI 複用真實瀏覽器會話 YouTube 字幕 + 搜索 yt-dlp — 154K Star，YouTube 仍是最佳（注意：不再用於 B站） B站 bili-cli OpenCLI ▸ 搜索 API yt-dlp 被 B站風控 412 封死（2026-06 實測），bili-cli 無登錄可搜可讀 搜全網 Exa via mcporter — AI 語義搜索，MCP 接入免 Key GitHub gh CLI — 官方工具，認證後完整 API 能力 讀 RSS feedparser — Python 生態標準選擇 小紅書 OpenCLI（桌面） xiaohongshu-mcp（服務器）▸ xhs-cli OpenCLI 只用用户已有會話；其餘後端用 Cookie-Editor 手工導出 LinkedIn mcp-server-linkedin Jina Reader MCP 服務，瀏覽器自動化 📌 這些都是「當前選型」，基於真機實測定期複核。某條路失效了我們換下一條——agent-reach doctor 永遠告訴你現在走的是哪條。 安全性 Agent Reach 在設計上重視安全： 措施 説明 🔒 憑據本地存儲 Cookie、Token 只存在你本機 ~/.agent-reach/config.yaml，文件權限 600（僅所有者可讀寫），不上傳不外傳 🛡️ 默認安全 agent-reach install 默認不修改系統；只有顯式 --system 才安裝外部工具和寫入配置 👀 完全開源 代碼透明，隨時可審查。所有依賴工具也是開源項目 🔍 Dry Run agent-reach install --dry-run 預覽所有操作，不做任何改動 🧩 可插拔架構 不信任某個組件？換掉對應的 channel 文件即可，不影響其他 🍪 Cookie 安全建議 ⚠️ 封號風險提醒： 使用 Cookie 登錄的平台（Twitter、小紅書等），通過腳本/API 調用存在被平台檢測並封號的風險。請務必使用專用小號，不要用你的主賬號。 需要 Cookie 或登錄態的平台（Twitter、小紅書、Reddit、Facebook、Instagram 等）建議使用專用小號，不要用主賬號。原因有二： 封號風險 — 平台可能檢測到非正常瀏覽器的 API 調用行為，導致賬號被限制或封禁 安全風險 — Cookie 等同於完整登錄權限，用小號可以在憑據泄露時限制影響範圍 📦 安裝方式 方式 命令 適合場景 默認安全檢查 agent-reach install --env=auto 所有環境；只讀檢查並列出缺失項 顯式安裝系統依賴 agent-reach install --env=auto --system 你明確允許修改當前機器時 兼容安全參數 agent-reach install --env=auto --safe 與默認行為相同 僅預覽 agent-reach install --env=auto --dry-run 先看看會做什麼 🗑️ 卸載 agent-reach uninstall 會清除：~/.agent-reach/（含所有 token/cookie）、各 Agent 的 skill 文件、mcporter 中的 MCP 配置。 # 只預覽，不實際刪除 agent-reach uninstall --dry-run # 只刪 skill 文件，保留 token 配置（重裝時用） agent-reach uninstall --keep-config 卸載 Python 包本身：pip uninstall agent-reach ⭐ 為什麼值得 Star 這個項目我自己每天在用，所以我會一直維護它。 有新需求或者大家提了想要的渠道，我會陸續加上 每個渠道我會盡量保證能用、好用、免費 平台改了反爬或者 API 變了，我會想辦法解決 為 Web 4.0 基建貢獻一份自己的力量。 Star 一下，下次需要的時候能找到。⭐ 致謝 OpenCLI · twitter-cli · rdt-cli · xiaohongshu-mcp · xhs-cli · bili-cli · yt-dlp · Jina Reader · Exa · mcporter · feedparser · mcp-server-linkedin 聯繫 📧 Email: [email protected] 🐦 Twitter/X: @Neo_Reidlab 業務合作 / Agent 落地 我正在承接 Agent 相關的定製與落地合作。 如果你在企業生產、運營、市場、投研、數據處理、內容處理或其他業務流程裏，有希望用 Agent 自動化的環節，歡迎加我微信交流。 不需要你已經想清楚方案。只要你有真實流程、真實問題或真實需求，我可以一起判斷 Agent 能不能解決、怎麼做。 加好友請備註：業務 + 你想讓 Agent 幫你做什麼 Builder 也歡迎備註：Builder + 你在做什麼 只是想進交流羣，備註：加羣 Bug 反饋和功能請求請用 GitHub Issues，更容易跟蹤。 License MIT 友情鏈接 Agent Skills Hub — 找 Claude 技能和 MCP 服務器，不用猜哪個安全：133,000+ 個條目全部安全分級、質量評分，每 8 小時刷新。 AtomGit 鏡像 — Agent Reach 的 AtomGit 同步鏡像，便於國內訪問與克隆。 Star History Resources Readme MIT license Contributing Contributing Security policy Security policy Activity Stars 68.0k stars Watchers 234 watching Forks 5.7k forks Report repository