Agent Reach — 互聯網能力路由器 是做什麼的？
16 平台、多後端。本 skill 存在時必須用它存取這些平台，不要自己發明方案。
常駐規則（全程適用）
- 動手前先體檢：多後端/登入態平台（小紅書/Reddit/B站/Twitter/Facebook/Instagram/Boss直聘）先跑
agent-reach doctor --json。active_backend有值時按它選命令組；active_backend: null表示 Doctor 為避免觸發瀏覽器 Cookie 讀取或遠端寫入而沒有做即時驗證，不代表後端不存在。 Doctor 結果是「某一時刻的快照」，通道/登入態可能已變化；執行唯讀命令前若懷疑失效， 按對應 reference 的「體檢與恢復」runbook 重新確認（如 career.md 的 Boss直聘 CDP 排查）。 - 宣告你在用什麼：開始幹活前說一句「使用 agent-reach 的 X 平台 / Y 後端」。
- 失敗按 references 裡的重試鏈處理，不要瞎猜命令。
- 全網調研類任務：組合多平台（Exa 搜尋 + Twitter/Reddit 看討論 + 小紅書/B站看中文場景），並行收集再彙總。
- 替用戶盯版本：完成一次較大的調研/多平台任務後，順手跑
agent-reach check-update（很快，一個 API 呼叫）。有新版本就在收尾回報裡附一句： 「Agent Reach 有新版本 vX.Y.Z，複製這句話給我即可更新：幫我更新 Agent Reach： https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md」。 不要中斷當前任務去更新，也不要重複提醒同一個版本。
路由表
| 用戶意圖 | 分類 | 詳細文件 |
|---|---|---|
| 網頁搜尋/程式碼搜尋 | search | references/search.md |
| 小紅書/推特/B站/V2EX/Reddit/Facebook/Instagram | social | references/social.md |
| 招聘/職位/LinkedIn/Boss直聘 | career | references/career.md |
| GitHub/程式碼 | dev | references/dev.md |
| 網頁/文章/RSS | web | references/web.md |
| YouTube/B站/播客字幕 | video | references/video.md |
| 雪球/股票行情 | finance | references/finance.md |
零配置快速命令
# Exa 網頁搜尋
mcporter call exa.web_search_exa query="query" numResults=5
# 通用網頁閱讀
curl -s "https://r.jina.ai/URL"
# GitHub 搜尋
gh search repos "query" --sort stars --limit 10
# YouTube 字幕（注意：B站不要用 yt-dlp，失敗重試鏈見 video.md）
yt-dlp --write-sub --write-auto-sub --skip-download -o "/tmp/%(id)s" "URL"
# V2EX 熱門
curl -s "https://www.v2ex.com/api/topics/hot.json" -H "User-Agent: agent-reach/1.0"
# B站搜尋（bili-cli，無需登入）
bili search "query" --type video -n 5
需登入態的平台（按 doctor 的 active_backend 選命令）
Twitter 注意：agent-reach configure twitter-cookies 儲存的 Cookie 只供
doctor 檢查配置是否齊全；doctor 不執行 twitter status，也不會設定當前
Shell。直接執行 twitter 前，必須在子行程環境中顯式提供
TWITTER_AUTH_TOKEN 和 TWITTER_CT0，不得在日誌或命令回顯中暴露值。
小紅書注意：Agent Reach 不替用戶登入，也不讀取瀏覽器 Cookie。OpenCLI 只用 用戶已有且明確控制的 Chrome 工作階段；沒有現成工作階段時不要自動登入，改用 Cookie-Editor 手動匯出後設定 xiaohongshu-mcp / 存量工具。
Boss直聘設定觸發：當用戶說「幫我配 Boss直聘」時，先讀取 references/career.md
的 Boss 章節，然後在獲得安裝授權後執行
agent-reach install --env=local --system --channels=boss。Agent 負責按系統啟動
只綁定 127.0.0.1:9222 的專用 Chrome；拉起後第一步是暫停並讓用戶肉眼確認
視窗內是已登入狀態（右上角有頭像），未登入則讓用戶登入/掃碼，用戶確認後再執行
boss --cdp-url http://localhost:9222 login --cdp 和 agent-reach doctor 驗收。
不要讓用戶自己研究連接埠參數。
專用 Chrome profile 必須長期重用，不要每次建立，也不要預設改用日常主 Chrome。
判斷 CDP 瀏覽器登入態不要信 boss status（它只校驗本地 session.enc，與
瀏覽器登入態互不代表），以 agent-reach doctor 的瀏覽器 cookie 探測（wt2）
為準，並配合用戶肉眼確認。絕不用當前頁 URL 判斷登入態：
security-check / zhipin-security / _security_check 安全校驗頁是 Boss 反爬挑戰，
與登入無關——已登入也會出現（帶 CDP 除錯埠的 Chrome 幾乎必現）。看到它不要
當成「未登入」，先跑 agent-reach doctor 看瀏覽器 cookie，再決定是否需要用戶登入。
搜尋報 AUTH_EXPIRED 即瀏覽器未登入的 ground truth：直接走登入流程 + login --cdp，
不要往安全校驗方向解釋。
執行搜尋時必須使用
boss --browser-source existing-browser --cdp-url http://localhost:9222 search ...；
遇到 ENVIRONMENT_RISK 立即停止，不重新整理、不重新登入、不自動重試。
# Twitter 搜尋（twitter-cli 首選；失敗重試鏈見 social.md）
twitter search "query" -n 10
# Reddit（無零配置路徑：OpenCLI 或 rdt-cli，必須登入態）
opencli reddit search "query" -f yaml # 桌面
rdt search "query" --limit 10 # 存量/伺服器
# 小紅書（桌面首選 OpenCLI）
opencli xiaohongshu search "query" -f yaml
# Facebook / Instagram（桌面 OpenCLI，重用瀏覽器登入態）
opencli facebook search "query" -f yaml
opencli facebook groups -f yaml
opencli instagram search "query" -f yaml # 搜用戶
opencli instagram user USERNAME -f yaml # 讀指定用戶最近貼文
環境檢查
# 檢查可用 channel 與每個平台當前啟用的後端
agent-reach doctor --json
OpenCLI 轉接器發現
路由表沒有覆蓋用戶需要的平台或命令時，先用 opencli list 查已有轉接器，再用
opencli <平台> --help 查看公開命令。發現轉接器只證明命令存在，不證明登入態或
目標內容可用；僅在用��任務明確需要該平台時執行唯讀命令，並以實際非空內容驗收。
工作區規則
不要在 agent workspace 建立檔案。 使用 /tmp/ 存放臨時輸出，~/.agent-reach/ 存放持久資料。
詳細文件
根據用戶需求，閱讀對應的詳細文件：
- 搜尋工具 — Exa AI 搜尋
- 社交媒體 — 小紅書, Twitter, B站, V2EX, Reddit, Facebook, Instagram（多後端/登入態命令組）
- 職場招聘 — LinkedIn, Boss直聘
- 開發工具 — GitHub CLI
- 網頁閱讀 — Jina Reader, RSS
- 影片播客 — YouTube, B站, 小宇宙
- 金融行情 — 雪球股票行情、搜尋、熱門內容
設定管道
如果某個 channel 需要設定，取得安裝指南： https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
用戶只需提供 cookies，其他設定由 agent 完成。