Browser Use
針對現有 Chrome 工作階段的瀏覽器任務使用此技能。
設定修復細節請見 mcporter-config.md。
路由
- 若當前工作階段可呼叫 Codex 的
Chrome或Chrome [Internal]外掛,則使用其內建的 Chrome 控制技能。 - 否則使用以下的 mcporter
chrome-devtools路由。
已安裝或存在於磁碟上不代表可用;外掛必須在活動工作階段中可呼叫。兩種路由都必須使用使用者現有的 Chrome 設定檔。
對於 mcporter 備援,請使用以下目標:
mcporter call chrome-devtools.<tool>
大多數需要登入的網站會在隔離設定檔中失敗,因為全新的工作階段會觸發驗證碼、裝置檢查或遺失的 SSO/擴充功能狀態。強烈建議對任何需要登入的網站優先使用現有的 Chrome 設定檔。
除非使用者明確要求使用隔離/全新的瀏覽器,否則絕對不要使用 chrome-isolated、Playwright、Puppeteer、Codex 應用程式內瀏覽器、AppleScript、osascript、GUI 腳本或 macOS open 來控制瀏覽器。
螢幕截圖/即時 UI 錯誤需要此現有 Chrome 路徑。curl、原始碼檢查、Worker 煙霧測試或本地 Playwright 僅能作為輔助證據;當使用者顯示的是渲染後的瀏覽器問題或頁面可能依賴登入/設定檔狀態時,不要將其視為同等方案。
檢查 MCP
mcporter list chrome-devtools --schema
mcporter call chrome-devtools.list_pages --args '{}' --output text
list_pages 必須顯示使用者實際開啟的分頁。如果顯示空白/預設的隔離 Chrome,請停止並回報重新連接失敗。
如果呼叫似乎在 Chrome 顯示驗證/附加/更新提示時掛起,請在備援前先處理該附加提示。當畫面中出現可見的 Chrome「允許」按鈕時,優先使用 Peekaboo 點擊;否則等待使用者操作。不要因為第一次輸出慢就重新啟動背景服務或終止 MCP 程序。
經過測試的附加提示復原方式:
PB="${PEEKABOO_BIN:-$HOME/bin/peekaboo}"
[ -x "$PB" ] || PB="$(command -v peekaboo)"
"$PB" permissions status --json
"$PB" see --app frontmost --path /tmp/chrome-attach.png --json --annotate
# 如果 UI 顯示 Chrome「允許遠端偵錯?」,僅點擊可見的「允許」按鈕。
"$PB" click --coords <allow_x>,<allow_y> --json
mcporter call chrome-devtools.list_pages --args '{}' --output text
請使用當前 Peekaboo 快照中的座標,而非過時的記錄。成功意味著 list_pages 返回使用者真實的 Chrome 分頁。
附加提示規則:當當前快照清楚顯示 Chrome 要求允許 DevTools/MCP/瀏覽器自動化附加時,僅點擊一次可見的「允許」按鈕,然後重新執行 list_pages。如果按鈕不可見或提示不明確,請停止並詢問;不要默默切換到 Playwright/Puppeteer。
如果 list_pages 因 DevToolsActivePort 失敗,請要求使用者重新啟動 Chrome 或 DevTools 橋接器,然後重試一次:
mcporter daemon restart
mcporter call chrome-devtools.list_pages --args '{}' --output text
如果仍然失敗,請停止並回報 Chrome DevTools MCP 不可用。不要使用 AppleScript。
避免嘈雜的復原循環。重複的 MCP/瀏覽器重啟可能會觸發重新連線/登入提示和警報。嘗試一次,然後暫停並選擇更安靜的路徑。
典型流程
# 從 list_pages 選取分頁 ID
mcporter call chrome-devtools.select_page --args '{"pageId":9}' --output text
# 檢查頁面
mcporter call chrome-devtools.take_snapshot --args '{}' --output text
# 導覽選取的分頁
mcporter call chrome-devtools.navigate_page --args '{"url":"https://example.com"}' --output text
# 點擊最新快照中的某個元素 uid
mcporter call chrome-devtools.click --args '{"uid":"1_38","includeSnapshot":true}' --output text
# 輸入/填寫
mcporter call chrome-devtools.fill --args '{"uid":"1_13","value":"text","includeSnapshot":true}' --output text
# 執行 JS,將機密資訊排除在輸出之外
mcporter call chrome-devtools.evaluate_script --args '{"function":"() => document.title"}' --output json
在執行操作前請使用 take_snapshot,並僅使用當前的 uid 值。除非視覺佈局至關重要,否則避免使用 take_screenshot。
即時 UI 驗證
針對螢幕截圖迴歸、已部署的儀表板檢查,或任何與渲染瀏覽器相關的錯誤:
mcporter call chrome-devtools.list_pages --args '{}' --output text
mcporter call chrome-devtools.select_page --args '{"pageId":9}' --output text
mcporter call chrome-devtools.navigate_page --args '{"url":"https://example.com"}' --output text
mcporter call chrome-devtools.take_snapshot --args '{}' --output text
mcporter call chrome-devtools.evaluate_script --args '{"function":"() => document.body.innerText"}' --output json
請使用現有已登入/攜帶設定檔的分頁集合。如果瀏覽器自動化不可用,請將其報告為驗證缺口,而不是替換為隔離的瀏覽器工具。
機密資訊處理
切勿從頁面 DOM、網路記錄或輸入中列印代碼/密碼。對於代碼檢查,僅返回形狀資訊:存在/不存在、長度、狀態碼、帳戶/組織名稱。