agent-browser

Chrome

Chrome（および Chromium）はデフォルトのブラウザエンジンです。agent-browser は、Chrome DevTools Protocol (CDP) を介して自動的に Chrome プロセスを検出・起動・管理します。

バイナリの検出

--executable-path が指定されていない場合、agent-browser は次の順序で Chrome を検索します：

プラットフォーム検索対象の場所
macOS

/Applications/Google Chrome.app, /Applications/Google Chrome Canary.app, /Applications/Chromium.app, Playwright Chromium キャッシュ

Linux

google-chrome, google-chrome-stable, chromium-browser, chromium が PATH 内にある場合, Playwright Chromium キャッシュ

Windows

%LOCALAPPDATA%\Google\Chrome\Application\chrome.exe, C:\Program Files\Google\Chrome\Application\chrome.exe, C:\Program Files (x86)...\chrome.exe

Chrome が見つからない場合は、agent-browser install を実行して Playwright 経由で Chromium をダウンロードしてください。

使用方法

Chrome はデフォルトのエンジンであるため、--engine フラグは必要ありません：

agent-browser open example.com

明示的に指定する場合：

agent-browser --engine chrome open example.com

カスタムバイナリ

--executable-path を使用して、任意の Chromium 基底ブラウザを指定できます：

agent-browser --executable-path /path/to/chromium open example.com

環境変数経由でも可能：

export AGENT_BROWSER_EXECUTABLE_PATH=/path/to/chromium
agent-browser open example.com

Chrome 特有の機能

以下の機能は、Chrome のみで利用可能です：

機能フラグ
ブラウザ拡張機能--extension <path>
永続的プロファイル--profile <path>
ストレージ状態--state <path>
ファイル URL アクセス--allow-file-access
ヘッドモード--headed
カスタム起動引数--args <args>

コンテナと CI

Docker、CI ランナー、またはその他のサンドボックス環境では、Chrome のユーザー名前空間サンドボックスを無効にする必要があります：

agent-browser --args "--no-sandbox" open example.com

agent-browser は、コンテナ環境（Docker、Podman、または root 権限で実行されている）を検出した際に自動的に --no-sandbox を追加します。