CDP モード
Chrome DevTools Protocol (CDP) を介して既存のブラウザに接続します：
# Chrome を起動する際：google-chrome --remote-debugging-port=9222
# 一度接続後、--cdp を指定せずにコマンドを実行
agent-browser connect 9222
agent-browser snapshot
agent-browser tab
agent-browser close
# または各コマンドに --cdp を指定
agent-browser --cdp 9222 snapshotリモートの WebSocket URL
WebSocket URL を介してリモートのブラウザサービスに接続します：
# リモートのブラウザサービスに接続
agent-browser --cdp "wss://browser-service.com/cdp?token=..." snapshot
# 任意の CDP 対応サービスと互換性あり
agent-browser --cdp "ws://localhost:9222/devtools/browser/abc123" open example.com--cdp フラグは以下のいずれかを受け入れます：
- ローカル接続用のポート番号（例：
9222）→http://localhost:{port}を経由 - リモートのブラウザサービス用の完全な WebSocket URL（例：
wss://...またはws://...）
オート接続
--auto-connect を使用すると、ポートを明示せずに実行中の Chrome インスタンスを自動検出・接続できます：
# 実行中の Chrome とリモートデバッグを自動検出
agent-browser --auto-connect open example.com
agent-browser --auto-connect snapshot
# 環境変数経由でも可能
AGENT_BROWSER_AUTO_CONNECT=1 agent-browser snapshotオート接続は以下の手順で Chrome を発見します：
- デフォルトのユーザーデータディレクトリから Chrome の
DevToolsActivePortファイルを読み込む - 共通のデバッグポート（9222, 9229）をプローブするようにフォールバック
この機能は以下のシナリオで便利です：
- Chrome 144+ 以降で
chrome://inspect/#remote-debuggingを通じてリモートデバッグが有効化された場合（動的なポートを使用） - 既存のブラウザへのゼロ構成接続を希望する場合
- Chrome が使用しているポートを追跡したくない場合
色調設定
CDP で接続する際に、Playwright はデフォルトでブラウザの色調を light に上書きします。永続的な好みを設定するには --color-scheme を使用してください：
agent-browser --cdp 9222 --color-scheme dark open https://example.com
agent-browser --cdp 9222 snapshot # ダークモードを維持または、設定ファイルや環境変数経由でグローバルに設定することも可能です：
AGENT_BROWSER_COLOR_SCHEME=dark agent-browser --cdp 9222 open https://example.com利用事例
これにより以下を制御できます：
- Electron アプリ
- リモートデバッグが有効な Chrome/Chromium
- WebView2 アプリケーション
- リモートのブラウザサービス（WebSocket URL 経由）
- 任意の CDP エンドポイントを公開するブラウザ
グローバルオプション
| オプション | 説明 |
|---|---|
--session <name> | 隔離セッションを使用 |
--profile <path> | 永続的なブラウザプロファイルディレクトリ |
-p <provider> | クラウドブラウザプロバイダー（browserbase, browseruse, kernel） |
--headers <json> | オリジンスコープの HTTP ヘッダー |
--executable-path | カスタムブラウザ実行ファイル |
--args <args> | ブラウザ起動引数（コンマ区切り） |
--user-agent <ua> | カスタム User-Agent 文字列 |
--proxy <url> | プロキシサーバーの URL |
--proxy-bypass <hosts> | プロキシをバイパスするホスト |
--json | スクリプト用の JSON 出力 |
--full, -f | 全ページスクリーンショット |
--name, -n | ロケーター名フィルター |
--exact | 正確なテキスト一致 |
--headed | ブラウザウィンドウを表示 |
--cdp <port|url> | CDP 接続（ポートまたは WebSocket URL） |
--auto-connect | 実行中の Chrome を自動検出・接続 |
--color-scheme <scheme> | 永続的な色調設定（dark, light, no-preference） |
--debug | デバッグ出力 |
クラウドプロバイダー
ローカルブラウザが利用できない場合に、クラウドブラウザインフラを活用できます：
# Browserbase
export BROWSERBASE_API_KEY="your-api-key"
export BROWSERBASE_PROJECT_ID="your-project-id"
agent-browser -p browserbase open https://example.com
# Browser Use
export BROWSER_USE_API_KEY="your-api-key"
agent-browser -p browseruse open https://example.com
# Kernel
export KERNEL_API_KEY="your-api-key"
agent-browser -p kernel open https://example.com
# 環境変数経由でも可能
export AGENT_BROWSER_PROVIDER=browserbase
agent-browser open https://example.com-p フラグは AGENT_BROWSER_PROVIDER に優先されます。