前言¶
讓 AI 操作瀏覽器時，常見做法是直接調用 Playwright、Puppeteer 或各類 MCP 瀏覽器工具。這些方案往往自帶瀏覽器啓動邏輯，和本機已開的 Chrome、固定調試端口 9222 不一定對齊。若你希望 Agent 先確認調試端口、接管已有 Chrome，或在已知可執行路徑下拉起帶 CDP 的實例，再去做 tab 選擇與頁面腳本，就需要一層「運行時準備」說明，而不是散落的臨時命令。
下面介紹 SkillHub 上的 Chrome調用（座標 @user_2a19425c/chrome-cdp-runtime，版本 1.0.0）。它用通用 SKILL.md 約束 Agent 的行爲：只走 Chrome CDP、固定關注 9222，併爲上層業務 Skill 提供可複用的連接與 tab 操作前提。
這是什麼¶
Chrome調用（包內 Display Name 爲 Chrome CDP Runtime）由社區發佈者 user_2a19425c 維護，分類爲 dev-programming，來源爲 community。SkillHub 頁面標註 requires_api_key=false，安裝與使用不依賴額外 API Key。
一句話定位：在 Agent 側規範 Chrome DevTools Protocol（CDP）的運行時準備——檢查 9222、接管已有實例或按已知路徑啓動調試 Chrome，並完成基礎頁面連接與 tab 操作。
核心功能¶
以下能力均來自該 Skill 的 SKILL.md 與 SkillHub 簡介，不含未在文檔中出現的接口或腳本名。
- 檢查 9222：判斷本機調試端口是否已監聽、是否可訪問。
- 接管已有實例：若 9222 已在用，優先連接已存在的 Chrome CDP，不要求提供 Chrome 可執行路徑。
- 按路徑啓動調試實例：若 9222 未監聽且調用方提供了已確認的
chromeExecutablePath，則按該路徑啓動 Chrome 並開啓 9222。 - tab 與頁面基礎操作：連接 CDP 後列出 tab、選擇目標頁面，支持基礎頁面讀取、導航與腳本執行。
- 環境不滿足時明確失敗：Chrome 路徑未知、未安裝或 9222 無法使用時，只報告阻塞原因，不擅自換瀏覽器或猜路徑。
硬約束（文檔明確要求）
- 僅使用 Chrome CDP，調試端口僅使用 9222（
debugPort可選，默認 9222）。 - 不使用 Edge 或其他未授權的瀏覽器替代方案。
- 自動啓動 Chrome 時不得硬編碼路徑；路徑必須由輸入提供且已確認。
可選輸入字段
| 字段 | 說明 |
|---|---|
chromeExecutablePath |
Chrome 可執行文件路徑；僅接管已有 CDP 時可省略 |
targetUrl |
目標 URL（可選） |
userDataDir |
用戶數據目錄（可選） |
debugPort |
調試端口，默認 9222 |
建議觸發場景（When to use）
- Chrome CDP 調試與瀏覽器自動化前的環境準備
- 接管已有 9222 實例
- 啓動 Chrome 調試實例
- 列出/選擇瀏覽器 tab
- 通過 CDP 執行頁面腳本
安裝與啓用¶
SkillHub 官方頁面給出的安裝方式是：讓 Agent 依照 SkillHub 安裝說明 安裝座標 @user_2a19425c/chrome-cdp-runtime。
若本機已安裝 skillhub CLI，可先確認版本，再安裝到當前 Agent 的 skills 目錄（安裝時必須使用 --dir，否則默認目錄可能不會被 Agent 加載）：
command -v skillhub && skillhub --version
未安裝 CLI 時，可按 SkillHub 文檔執行完整安裝（節選）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
將本 Skill 安裝到對應客戶端的 skills 目錄，例如 Cursor 常用路徑爲 ~/.cursor/skills/：
skillhub install chrome-cdp-runtime --namespace user_2a19425c --dir ~/.cursor/skills/
其他客戶端的 skills 路徑以 skillhub.cn/install/skillhub.md 第四節爲準（如 Claude Code：~/.claude/skills/，Codex：~/.codex/skills/ 等）。安裝後按各客戶端要求刷新或重啓，使新 Skill 生效。
也可將下面提示詞發給支持 Skill 安裝的 AI，由其按官方文檔完成安裝：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_2a19425c/chrome-cdp-runtime`。
典型用法¶
本 Skill 不附帶獨立 CLI 腳本，用法體現在 Agent 遵循 SKILL.md 中的執行流程。下面按文檔順序說明可復現的邏輯（具體 CDP 命令由 Agent 在合規前提下選用，本文不編造未出現的工具名）。
流程 1：優先接管已有 Chrome
- 檢查
9222是否已監聽。 - 若可訪問，連接已有 Chrome CDP，列出 tab 並選擇目標 tab。
- 在目標頁面上執行讀取、導航或腳本執行。
此時無需 chromeExecutablePath。
流程 2：需要 Agent 拉起 Chrome
- 檢查
9222未監聽。 - 調用方提供已確認的
chromeExecutablePath（以及可選的userDataDir、targetUrl）。 - 按路徑啓動 Chrome，開啓 9222，再連接 tab 並操作頁面。
若未提供路徑且 9222 不可用，Agent 應停止並說明環境不滿足，而不是猜測系統 Chrome 位置或改用 Edge。
流程 3：爲上層 Skill 提供運行時
完成標準爲文檔中的四條：成功接管或啓動 Chrome CDP；9222 可訪問；能列出並連接目標 tab；能執行基礎頁面操作。滿足後，其他依賴瀏覽器的業務 Skill 可在該運行時之上繼續工作。
適用場景與注意¶
適合誰
- 已在本機用 9222 做 Chrome 遠程調試，希望 Agent 先「接上」再幹活。
- 需要統一約束：只用 Chrome CDP、固定 9222，避免 Agent 自行換瀏覽器或亂寫路徑。
- 想把「瀏覽器環境準備」與「業務自動化」拆成兩層 Skill 的開發者。
限制與注意
- 端口策略寫死爲 9222；若本機該端口被佔用或防火牆攔截，需先處理環境，Skill 不會自動改端口策略（除非在輸入中顯式使用
debugPort且與文檔默認一致）。 - 不能替代完整 E2E 框架：它聚焦 CDP 運行時與基礎 tab/頁面能力，複雜場景仍要由上層邏輯或專用工具承擔。
- 自動啓動依賴調用方提供真實 Chrome 路徑；在 CI 或無圖形環境的機器上，通常更適合預先啓動好帶 9222 的 Chrome，再走接管流程。
- SkillHub 統計（以頁面抓取爲準）：評分 100000，下載約 2991，安裝約 8；數據會隨時間變化，以 SkillHub 頁面爲準。
結尾¶
Chrome調用 把 Chrome CDP 在 Agent 側的準備步驟寫進 Skill：先 9222，再接管或按路徑啓動，最後連接 tab 與基礎頁面操作，並明確禁止換瀏覽器與硬編碼路徑。若你的自動化要從「本機調試 Chrome」起步，可以在 SkillHub 安裝 @user_2a19425c/chrome-cdp-runtime。
- SkillHub 頁面：https://www.skillhub.cn/skills/user_2a19425c/chrome-cdp-runtime
- API 座標頁：https://api.skillhub.cn/user_2a19425c/chrome-cdp-runtime
- 安裝說明：https://skillhub.cn/install/skillhub.md
