Community影像github.com

steipete/browser-use

現有 Chrome 自動化:優先使用 Chrome 外掛,mcporter 備援。

browser-use 是什麼?

此技能為 AI 代理提供了一種可靠的方式來控制使用者的現有 Chrome 瀏覽器工作階段,而非啟動一個隔離的瀏覽器。它首先嘗試呼叫 Codex 環境中可用的「Chrome」或「Chrome [Internal]」外掛(如果處於活動狀態),否則會退回到 mcporter 的 chrome-devtools 工具。主要用例是與需要登入的網站互動,因為隔離的設定檔會觸發驗證碼、裝置檢查或遺失的 SSO 狀態。該技能包含詳細的程序來驗證 MCP 連線、處理 Chrome 的「允許遠端偵錯?」附件提示(使用 Peekaboo),以及執行常見的瀏覽器操作,例如導覽、快照、點擊、填寫表單和執行 JavaScript。它特別強調使用使用者的真實 Chrome 設定檔和打開的分頁,避免使用 Playwright、Puppeteer 或 AppleScript 等工具,除非使用者明確要求一個全新的瀏覽器。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/browser-use

Installed? Explore more 影像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Browser Use

針對現有 Chrome 工作階段的瀏覽器任務使用此技能。

設定修復細節請見 mcporter-config.md。

路由

  1. 若當前工作階段可呼叫 Codex 的 Chrome 或 Chrome [Internal] 外掛,則使用其內建的 Chrome 控制技能。
  2. 否則使用以下的 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、網路記錄或輸入中列印代碼/密碼。對於代碼檢查,僅返回形狀資訊:存在/不存在、長度、狀態碼、帳戶/組織名稱。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

steipete/nano-banana-pro

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

相關技能