Agent Reach 是一套開源 CLI 與 Skill，讓 AI Agent 用統一指令搜尋、閱讀網頁、YouTube、GitHub 與其他平台資料。依官方 1.6 系列說明，先用 uv 安裝，再執行 agent-reach setup，即可配置預設渠道與 Agent 使用說明。公開內容先用 Agent 原有工具；缺少正文、字幕或特定站內功能時，再判斷是否需要 Reach 的渠道與登入路徑。來源：官方安裝說明、Skill 選路規則
它替 AI 補的是哪一段？
它把各平台的上游工具、備援路徑與錯誤格式整理成同一個入口：agent-reach <渠道> <動作>，或交給 read 依網址選路。它是第三方搜尋與閱讀工具，不是平台官方授權的總入口；目前 Skill 明訂只讀，不發文、留言、按讚或私訊。公開工具已能取得足夠資料時，官方 Skill 要求直接使用已有結果，不因為看到某個平台名稱就安裝渠道或要求登入。來源：官方 README、Skill
整理判斷一：先寫清楚交付物，再選平台。 「找五支相關影片」和「比較影片中的說法」需要不同證據。前者可用標題、連結與簡介，後者要字幕或轉錄；官方能力表也明確區分字幕清單與字幕正文。這樣能避免為了補一段其實不需要的內容，提早加入登入與工具維護成本。依據：官方能力邊界
哪些平台預設有，哪些要另加？
下表依 v1.6.1 的渠道分類整理。「預設」指 setup 配置的渠道，不代表每個動作都免登入、免 Key，或在你的網路上都可成功；登入欄也不是所有公開內容的前提。未加入的渠道可先走公開網頁路徑，但取得的內容範圍可能較少。來源：官方 README 渠道表、Skill 選路規則
| 分類 | 渠道 | 可用方向與前提 |
|---|---|---|
| 預設 | web、github、v2ex | 網頁搜尋／閱讀、公開 GitHub 倉庫與 Issue／PR、V2EX 主題及回覆；私有 GitHub 權限不能由公開讀取能力推定 |
| 預設 | youtube、bilibili | 搜尋、影片資訊與字幕；B 站字幕需要登入，YouTube 語音轉文字需要 Groq 或 OpenAI Key |
| 可選 | xiaohongshu、reddit、boss | 站內筆記、貼文／評論或職缺；官方渠道表列有登入需求，仍先區分公開備援能否滿足任務 |
| 可選 | linkedin、xueqiu | LinkedIn 公開職缺可先讀，站內搜尋需登入；雪球行情免登入，社群熱帖／熱股需要登入 |
| 可選 | xiaoyuzhou | 播客轉錄，需要 Groq Key |
| 實驗 | twitter、facebook、instagram | 站內搜尋或個人資料等宣告動作，需要登入；官方提醒可能受平台反爬變更影響而失效 |
「支援」也有內容邊界：YouTube 與 B 站沒有統一的留言動作；小紅書的 read 是文字描述，不能因此宣稱理解圖片或影片；Reddit 不保證完整留言樹。請按當次返回的文字、來源與範圍判讀，不把搜尋摘要當作全文。來源：官方能力邊界
安裝與第一次查詢
官方套件要求 Python 3.10 以上，1.6 系列使用 uv 安裝。先閱讀官方安裝文件，確認 Agent 有終端機執行能力、環境有 uv，再依文件配置。PyPI 上同名 agent-reach 套件不是這個專案；不要把 pip install agent-reach 當成官方入口。來源：套件設定、官方安裝說明
官方安裝流程的核心指令如下。latest 會跟隨最新正式版；本頁查證時為 v1.6.1（2026-11-01）。來源：安裝說明、v1.6.1 發布頁
uv tool install https://github.com/Panniantong/Agent-Reach/releases/latest/download/agent-reach.zip
agent-reach setup
agent-reach channels
agent-reach doctor --text
setup 會啟用預設渠道、準備其工具並安裝 Skill，不是只列出變更的乾跑。新增可選渠道也可能下載 Node、OpenCLI、瀏覽器核心或擴充功能；Windows 的 Chrome 備援路徑可能需要本人確認擴充功能。安裝回報列出渠道和後續事項，應按回報處理，不直接等同所有動作都已可用。來源：安裝說明、1.6.0 變更、會話文件
以下是官方命令格式與搜尋範例；實際參數以 channels 顯示的動作為準。回傳中的 ok、內容項目與 error.hint 分別用來辨識結果和下一步。來源：README、Skill
agent-reach bilibili search "大模型"
agent-reach read https://www.v2ex.com/t/123
從 1.5 或更早版本升級，官方另有強制以 uv 重新安裝、確認版本輸出，再執行 setup 的移轉步驟。不要沿用舊頁的 install --system、doctor --live 或獨立 RSS 渠道說明；1.6 已重整入口，RSS 渠道已移除。來源：升級步驟、1.6.0 移除項目
doctor 和 check，分別能證明什麼？
agent-reach doctor --text 顯示離線狀態、工具版本與先前檢查紀錄，不會重新連線證明平台當下可讀。agent-reach check <渠道> --text 才進行連線檢查；若只檢查搜尋，結果不代表字幕、正文或其他動作也成功。來源：CLI 定義、狀態說明
unverified：已配置，但最近 24 小時沒有連線檢查紀錄。search_ready：最近 24 小時的搜尋回傳過非空結果；其他動作要分開看。ready：最近 24 小時通過已記錄的檢查；仍要核對實際涵蓋哪些動作。regressed: true：渠道上的退步標記，表示前一次通過的動作，在最近一次檢查失敗；它不是另一個狀態名稱。
整理判斷二：把「裝好了」和「交付資料完整」拆開驗收。 市場整理至少核對來源網址與日期；比較影片內容要看到字幕或轉錄正文；整理社群意見要標明留言範圍。只有工具存在、Cookie 已儲存或 search_ready，都不足以支持「已讀完整內容」的結論。依據：官方能力邊界、狀態說明
使用前要知道
登入與 Cookie 會如何處理？ 瀏覽器渠道共用 Reach 的專用瀏覽器設定。第一次使用某站時，若日常 Chrome 已連接 OpenCLI 擴充功能，官方文件說程式會把該站 Cookie 複製一份到專用瀏覽器，不複製整個瀏覽器、其他網站或密碼庫，也不改來源瀏覽器。沒有連接來源時不能保證自動複用；保存 Cookie 也不保證登入仍有效。來源：會話文件、會話複用程式
先確認用的是哪個帳號。 複用的可能是日常主帳號；上游建議使用專用小號，因為平台可能限制自動存取。專用瀏覽器並不代表沒有帳號風險；Cookie 仍是登入憑據，宜納入本機權限、備份和分享紀錄的管理。真正需要重新登入時，由本人在官方登入頁完成，不把密碼、Cookie 或 Key 貼給 Agent。來源：README 安全性、會話文件 後一句的本機資料管理為本站整理建議。
遇到 RATE_LIMITED 應等候指定時間；PLATFORM_BLOCKED 要停下並由本人到官方頁面處理；不要換帳號、後端或瀏覽器反覆請求。NEED_LOGIN 也不是拿到摘要後就一律重登的理由，應先確認剩餘任務是否真的需要登入內容。來源：Skill 錯誤處理
費用、更新與常見問題
程式碼為 MIT 授權；這不包含模型、轉錄服務、代理網路或平台本身的費用承諾。YouTube 語音轉文字需要 Groq 或 OpenAI Key，小宇宙需要 Groq Key；是否產生費用，依所選服務的方案與用量判斷。搜尋與閱讀能力也不改變平台條款、資料隱私及內容再利用的要求。來源：MIT、渠道表 費用與資料使用的檢查項目為本站整理。
v1.6.1 的更新說明記錄了幾類常見故障：小紅書結果成功但內容為空、B 站登入未保存卻顯示成功、Windows 小紅書含 & 連結，以及專用瀏覽器的連接埠衝突。這些是上游發布紀錄中的修正，不代表所有帳號、網路與內容都能成功。若 9222 已被另一工具使用，官方提供 agent-reach configure browser-port 9333 的改埠方式，不必關掉其他工具；登入複製失敗則應看錯誤，不把「複製零個 Cookie」當成功。來源：v1.6.1、改埠說明、修正 PR #879
下一步
- 用 Codex 執行安裝前，先讀資料夾、網路與人工確認的權限設定。
- 需要串接自己的郵件與雲端文件，可比較 Google Workspace CLI 的 OAuth 與服務範圍。
- 要管理 AI Coding 工具的端點與供應商，另看 CC Switch。
資料來源與查證日期
查證日期：2026-11-05。正式版本依據：v1.6.1，2026-11-01 發布；1.6 重構背景依 v1.6.0。本文為官方文件、原始碼與發布紀錄的整理，圖解及兩項工作判斷由本站製作。