browser_visible について
`browser_use.start` の起動オプションについて、ブラウザーウィンドウの表示や Playwright 管理モードを説明するスキルです。各設定の使い分けに加え、前提条件と制約も示します。
主な機能
- 01headed と private モードの説明
- 02起動パラメーターの組み合わせ例
- 03private モードを選ぶ条件
- 04ブラウザーと環境の要件
- 05モード切り替え時の動作説明
活用シーン
- 01表示ウィンドウでのブラウザー起動
- 02要望に応じた Playwright 管理モードの利用
- 03headed ブラウジングに対応する環境の確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ agentscope-ai/ qwenpaw --skill browser_visibleインストール後、Claude Code で/browser_visibleを入力して読み込まれたか確認します。
詳細
ブラウザーの起動モード
browser_use.startには、次の2つの起動モードしかありません。
- デフォルト:管理対象のCDP
private_mode=true:Playwrightによる管理
パラメーターの意味:
headed:ブラウザーウィンドウを表示するかどうかprivate_mode:CDPを無効にしてPlaywrightを使用するかどうか
この2つのパラメーターは独立しており、自由に組み合わせられます。
一般的な使い方
デフォルトで起動:
{"action": "start"}
ウィンドウを表示して起動:
{"action": "start", "headed": true}
CDPを使用せずに起動:
{"action": "start", "private_mode": true}
ウィンドウを表示し、CDPを使用せずに起動:
{"action": "start", "headed": true, "private_mode": true}
private_modeを使用する場合
ユーザーが次のいずれかを明示的に希望した場合にのみ、private_mode=trueを設定してください。
- CDP経由でブラウザーを管理したくない
- 代わりにPlaywrightを使用したい
- 他のローカルツールがCDP経由で接続する可能性を減らしたい
それ以外の場合は、必要に応じてheaded=trueを設定してください。
注意事項
- デフォルトでは、CDPによる管理が使用されます
- 起動モードは、呼び出しパラメーターだけで決まります
- CDPによる管理には、Chrome/Chromium/Edgeがローカルにインストールされている必要があります
private_mode=trueは、完全に検出不可能という意味ではありません。Playwrightによる管理に切り替えるだけです- ユーザーが表示されたブラウザーを手動で操作した場合、アイドルタイマーがリセットされないことがあります
private_modeはstartの呼び出しごとに明示的に指定するパラメーターであり、保持されません- ブラウザーがすでに起動している場合、起動モードまたはウィンドウの表示設定を切り替えるには、いったん
stopしてから再度startする必要があります - 表示モードではデスクトップを占有し、グラフィカル環境が必要です。サーバーやヘッドレス環境では動作しない場合があります
コメント
Markdown 対応