Community画像github.com

steipete/browser-use

既存のChromeセッションに対するブラウザ自動化:Chromeプラグインを優先し、mcporterフォールバックを使用。

browser-use とは?

このスキルは、ユーザーの既存のChromeセッションに対してブラウザ操作を実行するために設計されています。ログイン状態やプロファイル情報を保持する必要があるタスク(例:ログインが必要なWebサイトのテスト、スクリーンショットの撮影、UI検証)に最適です。CodexのChromeプラグインが利用可能な場合はそれを優先し、利用できない場合はmcporterの`chrome-devtools`ルートを介したフォールバック経路を使用します。このアプローチは、孤立したブラウザプロファイル(PlaywrightやPuppeteerなど)で頻繁に発生するキャプチャやデバイスチェック、SSO/拡張機能の欠落といった問題を回避します。主な機能には、タブ一覧表示、ページナビゲーション、スナップショット取得、クリック、入力、JavaScript評価が含まれます。また、Chromeのデバッグアタッチ許可ダイアログを処理するための堅牢なリカバリーメカニズムも備えており、シークレット情報がログや出力に漏洩しないように保護します。

対応~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に質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Browser Use

既存のChromeセッションに対するブラウザタスクにこれを使用します。

設定修復の詳細はmcporter-config.mdにあります。

ルート

  1. 現在のセッションでCodexのChromeまたはChrome [Internal]プラグインが呼び出し可能な場合、そのバンドルされたChrome制御スキルを使用します。
  2. それ以外の場合は、以下のmcporter chrome-devtoolsルートを使用します。

ディスクにバンドルまたはインストールされていても利用可能とは限りません。プラグインはアクティブセッションで呼び出し可能である必要があります。両方のルートでユーザーの既存のChromeプロファイルを使用する必要があります。

mcporterフォールバックには、以下のターゲットを使用します。

mcporter call chrome-devtools.<tool>

ログインが必要なほとんどのサイトは、孤立したプロファイルでは失敗します。新しいセッションではキャプチャ、デバイスチェック、SSO/拡張機能の状態の欠落が発生するためです。ログインが必要なWebサイトでは、既存の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のAllowボタンを押すには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/ブラウザ自動化アタッチメントを許可するよう求めていることが明確に示されている場合、表示されているAllowボタンを1回クリックし、その後list_pagesを再実行します。ボタンが表示されていないか、プロンプトがあいまいな場合は停止して質問してください。黙ってPlaywright/Puppeteerに切り替えないでください。

list_pagesがDevToolsActivePortで失敗した場合、ユーザーにChromeまたはDevToolsブリッジの再起動を依頼し、その後1回再試行します:

mcporter daemon restart
mcporter call chrome-devtools.list_pages --args '{}' --output text

それでも失敗する場合は停止し、Chrome DevTools MCPが利用不可であると報告してください。AppleScriptは使用しないでください。

ノイズの多いリカバリループは避けてください。MCP/ブラウザの再起動を繰り返すと、再接続/ログインプロンプトやアラートが発生する可能性があります。1回試行したら一時停止し、より静かなパスを選択してください。

一般的なフロー

# 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.

関連スキル