Show HN: Turbo-Browser-MCP – MCP向けのバッチ処理フォーム、DOMデルタ、送信ガード
Show HN: Turbo-Browser-MCP – Batch forms, DOM deltas and submit guards for MCP (github.com)
要約
Turbo-Browser-MCPは、PlaywrightベースのMCPサーバーで、ブラウザ自動化におけるLLMのトークン無駄遣いとマルチターンの遅延を削減します。DOMデルタスナップショット、フォーム事前入力、直接ファイルアップロード、ネットワークブロック、送信ガードなどの機能を備え、パフォーマンスとトークン効率を大幅に向上させます。
全文翻訳
turbo-browser-mcp
[画像: CI] [画像: Version] [画像: Tests] [画像: Node] [画像: License]
turbo-browser-mcp は、ブラウザ自動化におけるLLMのトークン無駄遣いとマルチターンの遅延を削減するために構築された、PlaywrightベースのModel Context Protocol (MCP) サーバーです。25~33個の細粒度なブラウザプリミティブを、デルタDOMスナップショット、シングルターンのReact/Shadow DOM/iframeフォーム事前入力、直接ディスクファイルアップロード(コンテキスト内にBase64不要)、並列タブセッション、ネットワークブロックプリセット、およびデフォルトの人手による送信ガードを備えた10個のバッチ処理ツールに統合します。
一目でわかるパフォーマンスとトークン採点表
以下のすべての数値は、ローカルでヘッドレスChromiumを使用し、正確なOpenAI o200k_base トークナイゼーション(tiktoken 0.14.0)で実行されたbenchmarks/benchmark.mjs(npm run benchmark)から取得されています。
| 機能 | 通常のベースライン | turbo-browser-mcp | スピード/ターンゲイン | トークン節約(o200k_base) |
|---|---|---|---|---|
| 高密度UIスナップショット(140ボタンSaaSコンソール) | 18,654 トーク HTML / 3,568 トーク フルARIA | 1,135 トーク コンパクト(28 ms) | 1 回の呼び出し | HTML比 93.9%(ARIA比 68.2%) |
クリック後のデルタスナップショット(onlyChanged: true) | 3,582 トーク フルARIA再スキャン | 56 トーク 変更行(18 ms) | 1 回の呼び出し | ARIA比 98.4%(HTML比 99.7%) |
10フィールドの複雑なフォーム+スナップショット(smart_fill_form) | 11 ターン(574 ms、12,197 直接 / 72,614 累積トークン) | 1 ターン(82 ms、811 トーク) | 7倍高速、11 -> 1 ターン | 直接 93.4% / 累積 98.9% |
48 KiB PDFアップロード(49,152 バイト) | 44,728 トーク インラインBase64ツール引数 | 85 トーク ディスクパス(68 ms) | Base64生成なし | 99.8%節約 |
6ステップのインタラクティブUIフロー(batch_actions) | 6 ターン(411 ms、955 直接 / 3,162 累積トークン) | 1 ターン(357 ms、406 トーク) | 1.15倍高速、6 -> 1 ターン | 直接 57.5% / 累積 87.2% |
6タブを同時に開く(open_many) | 6 ターン逐次(998 ms) | 1 ターン バッチ処理(420 ms) | 2.38倍高速、6x 少ないターン数 | 5 回のプロンプトリプレイを削減 |
重いメディアロード(preset: "turbo"、304 KiB アセット) | 252 ms、9 メディアリクエスト(304 KiB) | 165 ms、0 メディアリクエスト(0 KiB) | 1.53倍高速 | メディア帯域幅を100%カット |
記事Markdownスクレイピング(extract_clean_text) | 3,595 トーク 生HTML(10,844 文字) | 156 トーク クリーンなMarkdown(641 文字) | クリーンなリーダー出力 | 95.7%節約 |
診断トリアージ(page_diagnostics エラーのみ) | 3,460 トーク 未フィルタリング(32 リクエスト / 26 コンソール) | 601 トーク デフォルトエラー(2 リクエスト / 6 コンソール) | ノイズスクロールなし | 82.6%節約 |
| 静的MCPツールスキーマ(各ターンのオーバーヘッド) | 3,917 トーク Playwright / 6,737 トーク DevTools | 3,010 トーク 剥ぎ取り(注釈付きフル 3,314) | 25 / 33 に対し 10 ツール | Playwright比 23.2% / DevTools比 55.3% |
LLM推論ターン vs レイテンシに関する注意:10フィールドフォームでの
10回の往復を排除することで、ブラウザ実行で7倍(574 ms -> 82 ms)、および10回の個別のLLM推論往復(エージェントループで2-5s/ターン)と~71,800の再利用履歴トークンが節約されます。
ブラウザエージェントが停滞する理由:サイドバイサイドワークフロー
標準的なMCPサーバーは、すべてのスナップショット、フィールド入力、<select>選択、アップロード、検証チェックに対してLLMの往復を課金します。各ターンは、増大する会話履歴をモデルに再送信します。
sequenceDiagram
autonumber
participant Agent as LLM Agent
participant Std as Standard MCP (Playwright / DevTools)
participant Turbo as turbo-browser-mcp
Note over Agent,Std: 標準MCP(12+ LLMターン、各ステップでフルARIAツリー+履歴リプレイ)
Agent->>Std: 1. snapshot() -> フルARIA (~3,568 トーク)
loop フィールド、セレクト、チェックボックス、アップロードを10回以上繰り返す
Agent->>Std: fill / select_option / click
Std-->>Agent: フルARIAまたは確認が履歴に追加される
end
Agent->>Std: 12. インラインアップロードまたはチョイサーをクリック
Note over Agent,Turbo: turbo-browser-mcp(合計2 LLMターン、デルタ&インラインスナップショット)
Agent->>Turbo: 1. inspect_compact(mode: "forms") -> コンパクトな参照 (1,135 トーク)
Agent->>Turbo: 2. smart_fill_form(fields: [...10フィールド+ディスクPDF...], returnSnapshot: true)
Turbo-->>Agent: 10フィールド入力済み+送信前のガード+インラインスナップショット (811 トーク)
読み込み
turbo-browser-mcp がサポートするもの
1. 接続とセッションの分離
- 4つの接続モード(
--mode auto|cdp|persistent|launch):auto(デフォルト):まず--cdp http://127.0.0.1:9222をプローブし、エージェントが既存のサインイン済みブラウザセッションを再利用できるようにしてから、Chromiumの起動にフォールバックします。cdp:実行中のChromium/Chrome/Edgeリモートデバッグポートに直接アタッチします。persistent:実行間で再利用可能な--user-data-dirプロファイルで起動します。launch:クリーンなブラウザセッションを起動します(デフォルトは--headless、または--headed)。
- 自動バイナリ検出(
src/playwright-loader.mjs):Windows、macOS、Linuxのplaywright-coreキャッシュリビジョン、Google Chrome、Microsoft Edge、Brave、Chromiumのシステムインストール、または明示的な--executable <path>をチェックします。 - タブごとの分離(
tabs_batch):名前付きisolatedContextサンドボックス内でタブを開き、Cookieとストレージを分離します。最大10個の同時URL(open_many)をバッチ処理で開き、アクティブ化、リロード、back/forwardへの移動、ビューポートのresize、およびcolorScheme、media、reducedMotion、contrast、forcedColors、またはカスタムuserAgentのエミュレートを行います。
2. DOM、Iframe、Shadow DOMの検査(inspect_compact)
- スナップショットモード:「
interactive」、「forms」、「article」、「all」。 - 境界を越えたトラバース:メインフレームDOM、子iframe(
includeFrames、frameIdx)、および開いているShadow DOMをフラット化します。初期化後も閉じられたShadowルートを検査可能かつ保護するために、Element.prototype.attachShadowをフックする初期化スクリプトを注入します(WeakMap+WeakRef/FinalizationRegistry+window.__tbmGetShadowRoot)。<slot>のassignedNodes({ flatten: true })をトラバースし、Form-Associated Custom Elementsをサポートします。 - トークン制御:「
onlyChanged: true」は、前のスナップショット以降に追加または変更された要素のみを出力します。「query」は正規表現または部分文字列でフィルタリングします。「boxes: true」は、必要な場合にのみ[box=x,y,w,h]を追加します。「maxChars」はペイロードサイズを制限します。「savePath」は完全な出力をディスクに書き込みます。
3. シングルターン・スマートフォームエンジン(smart_fill_form)
マイクロタスクとマクロタスクを制御された入力間でフラッシュしながら、1回のMCP呼び出しでフォーム全体を事前入力します。
- 標準およびフレームワーク入力:テキスト、メール、パスワード、数値、日付、textarea、
<input type="range">、チェックボックス、ラジオグループ(check、not、overwrite)。ネイティブプロパティセッターと合成イベントを介してReact制御の状態更新をトリガーします。 - セレクトとカスタムウィジェット:「
<select>」と「<select multiple>」(option/values)、ARIAコンボボックス、ARIAスイッチ、contenteditableリッチエディタ、およびGmail作成ダイアログ(gmail: { to, subject, body })。 - フレームとワイルドカードターゲティング:
frameIdxを介して特定のiframeをターゲットにするか、all: trueを設定してフレーム全体で一致するコントロールをすべて入力します。 - 直接ディスクアップロード:バイナリファイルをロードしたり、Base64文字列をLLMコンテキストにロードしたりすることなく、Playwrightの
setInputFilesにfileまたはfilesパスを直接渡します。 - アトミック検証:「
returnSnapshot: true」を渡して、同じツール応答で更新されたフォーム状態を検査します。
4. 16個のインタラクティブアクションとマルチステップチェーン(act_fast、batch_actions)
act_fastアクション:「click」、「dblclick」、「hover」、「focus」、「clear」、「fill」、「type」(slowly、delayMs、submit)、「select」、「check」、「uncheck」、「drag」、「drop」(file、files、またはカスタムMIMEdropData)、「press」(key+modifiers:Alt、Control、ControlOrMeta、Meta、Shift)、「scroll」(dx、dy)、「wait」(ms、state、loadState、text、textGone、url)、および「upload」。- ターゲティングオプション:コンパクトな
[eN]ref、CSSselector、表示されているtext、label、またはビューポートの(x, y)座標。button(left、right、middle)とframeIdxをサポートします。 batch_actions:DOMアクションとネストされたsmart_fill_formステップの順序付けられたリストを1回のMCP呼び出しで実行します。送信ガードによってブロックされた場合は安全に停止するか、オプションでステップエラー時に続行します(continueOnError)。
5. クリーンな抽出、評価、メディアキャプチャ(extract_clean_text、evaluate_js、capture_page)
extract_clean_text:メイン/記事コンテナとiframeから、スクリプトとスタイルのノイズを除去した、読みやすいプレーンテキストまたはコンパクトなMarkdown(format: "text" | "markdown")を抽出します。evaluate_js:任意のフレーム(frameIdx)でJS式または(el, arg)要素関数を実行し、JSONシリアライズされた結果とオプションのsavePathエクスポートを返します。capture_page:フルページまたは要素スコープのスクリーンショット(pngまたはjpeg、quality、cssまたはdeviceスケール、オプションのreturnImage)とPDF生成を、制限されたsavePathに保存します。
6. ネットワークブロック、ストレージ状態、診断(network_session、page_diagnostics)
network_sessionプリセット:「turbo」、「no-images」、「no-media」、「clean」(すべてブロック解除)、およびカスタムblockResourcesとblockUrlsパターン。- セッションとストレージ管理:ブラウザの
cookies、localStorage/sessionStorageの読み取り/書き込み/クリア、および完全なPlaywrightstorageStateJSONファイルのインポートまたはリロード(saveStorageStatePath、loadStorageStatePath)。 page_diagnostics:デフォルトでエラーのみ(level: "errors"、statusFilter: "errors")に設定されており、コンテキストをフラッディングすることなくエラーをクリーンに表面化します。同時にall、includeStatic、urlFilter、詳細なリクエスト/レスポンス検査(reqId+part)、完了したダウンロード、ダイアログの自動処理(dialogPolicy:accept/dismiss)をサポートします。
再現可能なベンチマーク(npm run benchmark)
ChromiumとPlaywrightをインストールして、ベンチマークスイートを自分で実行してください。
npm run benchmark
環境と方法論:playwright-core経由のヘッドレスChromium、Python tiktoken(tiktokenが利用できない場合はapprox-bpeフォールバック)による正確なOpenAI o200k_base トークのカウント。累積ワークフローのトークンは、$N$個の逐次ターンにわたる標準的なチャット履歴リプレイをモデル化します:$\sum ypography{i=1}^{N} (N - i + 1) \cdot T_i$、さらに最初のターンがアクション前にコンテキストをキャプチャするワンショットベースライン。
1. スナップショットとリーダー抽出(文字数と正確なo200k_baseトークン)
| シナリオ | 生HTML | フルPlaywright ARIA | turbo-browser-mcp 出力 | ARIA比節約 | HTML比節約 |
|---|---|---|---|---|---|
140ボタンSaaSコンソール(inspect_compact) | 61,010 文字(18,654 トーク) | 12,771 文字(3,568 トーク) | 3,968 文字(1,135 トーク) | 68.2% | 93.9% |
クリック後のデルタ(onlyChanged: true) | 61,010 文字(18,654 トーク) | 12,825 文字(3,582 トーク) | 168 文字(56 トーク) | 98.4% | 99.7% |
記事Markdown抽出(extract_clean_text) | 10,844 文字(3,595 トーク) | n/a | 641 文字(156 トーク) | n/a | 95.7% |
診断フィルタ(32 リクエスト、26 コンソールログ) | 9,651 文字(3,460 トーク、all) | n/a | 1,761 文字(601 トーク、errors) | n/a | 82.6% |
2. マルチターンのフォーム、ワークフロー、アップロード、ネットワーク速度
| シナリオ | ステップバイステップベースライン | turbo-browser-mcp | 実行速度向上 | トークン節約 |
|---|---|---|---|---|
10フィールドの複雑なフォーム+検証(smart_fill_form) | 11 ターン、574 ms、12,197 直接 / 72,614 累積トークン | 1 ターン、82 ms、811 トーク(filled=10) | 7倍高速 | 直接 93.4% / 累積 98.9% |
48 KiB PDFアップロード(49,152 バイト、file経由) | 65,679 文字(44,728 トーク) Base64ペイロード | 263 文字(85 トーク) ディスクパス(68 ms) | LLM Base64エンコードなし | 99.8% |
6ステップUIフロー(batch_actions) | 6 ターン、411 ms、955 直接 / 3,162 累積トークン | 1 ターン、357 ms、406 トーク | 1.15倍高速 | 直接 57.5% / 累積 87.2% |
6タブを開く(tabs_batch open_many、60 ms TTFB) | 6 ターン逐次(998 ms) | 1 ターン バッチ処理(420 ms) | 2.38倍高速(6 -> 1 ターン) | 5 ターンを削減 |
重いメディアロード(8x32 KiB画像 + 48 KiBフォント) | 252 ms、9 メディアヒット(304 KiB) | 165 ms、0 メディアヒット(0 KiB) | 1.53倍高速 | メディアを100%節約 |
3. 静的MCPツール定義のフットプリント
ディスク上のMCP JSONスキーマ(注釈なしのコンパクトなパラメータスキーマ)に対して測定:
| MCPサーバー | ツール数 | コンパクトスキーマ文字数 | 正確なo200k_baseトークン | turbo-browser-mcpによる節約 |
|---|---|---|---|---|
turbo-browser-mcp | 10(フル 14,186 / コンパクト 12,796) | 12,796 | 3,010(注釈付きフル 3,314) | ベースライン(10ツール) |
@playwright/mcp | 25 | 18,457 | 3,917 | 静的トークンが23.2%少ない |
chrome-devtools-mcp | 33 | 30,252 | 6,737 | 静的トークンが55.3%少ない |
@playwright/mcp および chrome-devtools-mcp との比較
| 機能 | turbo-browser-mcp | @playwright/mcp | chrome-devtools-mcp |
|---|---|---|---|
| ツールサーフェスのサイズ | 10個のバッチ処理ツール | 25個の粒度の細かいツール | 33個の粒度の細かいツール |
デルタスナップショット(onlyChanged) | 内蔵 | 各スナップショットでフルツリー | 各スナップショットでフルツリー |
| 閉じられたShadow DOMフック | 初期化後 attachShadow フック + <slot>フラット化 | 開いているShadow DOM | CDP / 標準DOMアクセス |
| シングルコール・スマートフォーム+Contenteditable | はい(React、Shadow DOM、iframe、Gmail、レンジ) | マルチターンの入力+個別のセレクト呼び出し | 基本的なfill_form |
| ディスクファイルアップロード(Base64不要) | smart_fill_form & act_fast のネイティブfile/filesパス | 専用のbrowser_file_uploadターン | 専用のupload_fileターン |
| デフォルトの人手による送信ガード | はい(allowSubmit=false、フォーム/iframe/Enterフック) | いいえ | いいえ |
並列open_many + isolatedContext | 単一のバッチ処理呼び出し | 個別の逐次タブ呼び出し | 個別のページ呼び出し |
ワンコールturboメディアブロッカー | 内蔵(turbo、no-images、no-media) | 手動JS / ルーティング | ネットワークエミュレーション |
| パフォーマンス/ヒーププロファイリング | 含まれていない | 含まれていない | トレース、Lighthouse、ヒープスナップショット |
Chrome DevTools MCPを
turbo-browser-mcpと併用する場合:chrome-devtools-mcpはLighthouse監査、パフォーマンストレース分析、CSS計算スタイルパネル、V8ヒープスナップショットを提供します。turbo-browser-mcpは、最小限のトークンオーバーヘッドで、高速なマルチステップUI自動化、フォーム、スクレイピングに焦点を当てています。
ツールパリティマップ
| 機能 | turbo-browser-mcp | @playwright/mcp | chrome-devtools-mcp |
|---|---|---|---|
| マルチタブを開く、リスト、切り替え、リサイズ、エミュレート | tabs_batch | browser_tabs, browser_navigate, browser_resize, ... | new_page, list_pages, select_page, resize_page, ... |
| DOM / アクセシビリティ検査 | inspect_compact | browser_snapshot | take_snapshot |
| マルチフィールドフォームとアップロード | smart_fill_form | browser_fill_form + browser_select_option + browser_file_upload | fill_form + upload_file |
| クリック、入力、ドラッグ、プレス、スクロール、待機 | act_fast | browser_click, browser_type, browser_drag, ... | click, type_text, drag, press_key, wait_for |
| マルチステップ逐次マクロ | batch_actions | browser_run_code_unsafe または N ツールの呼び出し | N 個の個別のツール呼び出し |
| クリーンな記事抽出 | extract_clean_text | browser_evaluate カスタムJS | evaluate_script カスタムJS |
| フレーム/要素JS評価 | evaluate_js | browser_evaluate | evaluate_script |
| エラー、ネットワーク、コンソールトリアージ | page_diagnostics | browser_console_messages, browser_network_requests | list_console_messages, list_network_requests, ... |
| スクリーンショットとPDFエクスポート | capture_page | browser_take_screenshot | take_screenshot |
| ブロックプリセット、Cookie、ストレージ | network_session | browser_evaluate + コンテキスト設定 | evaluate_script / emulate を介した部分的なもの |
安全性:人手による送信ガードとパスの制限
- 人手による送信ガード(デフォルトで
allowSubmit=false):smart_fill_form(stopBeforeSubmit: true)、act_fast、batch_actionsは、一致する要素、W3C AccNameラベル(isSafeSubmitter)、暗黙的なHTMLフォームEnter送信、キーコード(Shift+Enter、Enter+Shift)、HTMLFormElement.prototype.submit/requestSubmit、および同一オリジンのiframecontentWindow/contentDocumentプロキシを検査します。Submit、Publish、Send、Post、Apply、Confirm、または支払いトリガーに類似した最終アクションは、allowSubmit: trueが明示的に渡されるか、起動時に--allow-submitが有効にされない限りブロックされます。- トレードオフ:既に開いているCDPタブ上の既存の閉じられたShadowルート(初期化スクリプト実行前にアタッチされたもの)または厳密なクロスオリジンサンドボックス化されたフレームは、Playwrightフレームハンドル、座標アクション、キーボード入力にフォールバックします。
- ワークスペースパスの制限(
TURBO_BROWSER_SAVE_ROOT):- ファイル出力(
savePath、saveStorageStatePath)および状態入力(loadStorageStatePath)は、現在の作業ディレクトリまたはTURBO_BROWSER_SAVE_ROOTに厳密に制限されます。 - 字句チェック、
lstatSync/readlinkSyncシンボリックリンク検証、およびrealpathSync検証により、..トラバーサル、UNCネットワークパス、ダングリングシンボリックリンク、循環シンボリックリンク、およびWindowsジャンクションが、読み書き前にブロックされます。
- ファイル出力(
全10ツールのリファレンス
| ツール | 用途 | 主要パラメータ |
|---|---|---|
tabs_batch | 順序付けられたタブとブラウザのライフサイクル | operations[](list、open、open_many、navigate、activate、resize、emulate、reload、back、forward、close、close_browser)、isolatedContext、concurrency(1-10) |
inspect_compact | トークン制限付き要素/フォーム/記事スナップショット | mode(interactive、forms、article、all)、onlyChanged、query、boxes、maxChars、includeFrames、savePath |
smart_fill_form | バッチフォーム、エディタ、ディスクファイル事前入力 | fields[](ref、selector、value、option、values、check、not、keys、file、files、frameIdx、all)、gmail、overwrite、stopBeforeSubmit、returnSnapshot |
act_fast | 単一のターゲットページアクション | action(16アクション)、ref/selector/text/label/(x, y)、modifiers、dropData、allowSubmit、returnSnapshot |
batch_actions | アクションとフォームステップの順序付けられたチェーン | steps[]、continueOnError、allowSubmit、returnSnapshot、snapshotMaxChars |
extract_clean_text | クリーンなテキストまたはコンパクトなMarkdownリーダー | format(text、markdown)、selector、includeFrames、maxChars、savePath |
evaluate_js | スコープ付きJS式または(el, arg)呼び出し | expression、arg、frameIdx、ref/selector/text、savePath |
page_diagnostics | コンソール、ネットワーク、ダウンロード、ダイアログ | level(errors、all)、statusFilter(errors、all)、includeStatic、urlFilter、reqId、part、dialogPolicy、clear、savePath |
capture_page | PNG/JPEGスクリーンショットとPDFエクスポート | mode(screenshot、pdf)、type、quality、fullPage、scale(css、device)、ref/selector/text、returnImage、savePath |
network_session | リソースブロッカー、Cookie、ストレージ | preset(turbo、no-images、no-media、clean)、blockResources、blockUrls、cookieAction、storageAction、loadStorageStatePath、saveStorageStatePath |
コピペ用JSON例
1. 10フィールドフォームをディスクPDFで入力し、結果を1ターンで検査
{
"name": "smart_fill_form",
"arguments": {
"fields": [
{ "selector": "#full_name", "value": "Alex Nguyen" },
{ "selector": "#email", "value": "alex@example.com" },
{ "selector": "#country", "option": "United States" },
{ "selector": "#skills", "values": ["TypeScript", "Playwright"] },
{ "selector": "#agree_terms", "check": true },
{ "selector": "#resume_pdf", "file": "./assets/resume.pdf" }
],
"stopBeforeSubmit": true,
"returnSnapshot": true
}
}
2. モーダルを開いた後の変更されたコントロールのみを読み取る(onlyChanged)
{
"name": "inspect_compact",
"arguments": {
"mode": "interactive",
"onlyChanged": true,
"maxChars": 3000
}
}
3. 独立したコンテキストでタブを並列に開き、turboでロードを高速化
{
"name": "tabs_batch",
"arguments": {
"operations": [
{ "action": "open", "url": "https://example.com/app", "isolatedContext": "acct-a" },
{ "action": "open_many", "urls": ["https://example.com/docs", "https://example.com/pricing"], "concurrency": 4 }
]
}
}
クイックスタート
インストールと環境チェック
git clone https://github.com/Tthanh2k6/turbo-browser-mcp.git
cd turbo-browser-mcp
npm install
npm run doctor
PlaywrightバンドルChromiumが必要な場合(またはシステムにChrome/Edge/Braveがインストールされていない場合):
npx playwright-core install chromium
MCPクライアント設定(Claude Code、Cursor、Antigravity、Codex)
ローカルクローンを使用する場合:
{
"mcpServers": {
"turbo-browser": {
"command": "node",
"args": ["/absolute/path/to/turbo-browser-mcp/src/index.mjs"],
"env": {
"TURBO_BROWSER_SAVE_ROOT": "/absolute/path/to/allowed/workspace"
}
}
}
}
npx / バイナリエントリーポイントを使用する場合:
{
"mcpServers": {
"turbo-browser": {
"command": "npx",
"args": ["-y", "turbo-browser-mcp"]
}
}
}
CLIオプションと環境変数
| CLIフラグ | 環境変数 | デフォルト | 説明 |
|---|---|---|---|
| `--mode <auto | cdp | persistent | launch>` |
--cdp <url> | TURBO_BROWSER_CDP_URL | http://127.0.0.1:9222 | Chrome DevTools Protocol HTTPエンドポイント |
--user-data-dir <path> | TURBO_BROWSER_USER_DATA_DIR | "" | 永続プロファイルディレクトリパス |
--executable <path> | - | 自動検出 | カスタムChromium、Chrome、Edge、またはBrave実行可能ファイル |
--timeout <ms> | TURBO_BROWSER_TIMEOUT_MS | 15000 | デフォルトのPlaywrightアクション/ナビゲーションタイムアウト(ミリ秒) |
--headless / --headed | TURBO_BROWSER_HEADLESS | true(ヘッドレス) | ヘッドレスまたは表示されるブラウザウィンドウを実行(ヘッドレスの場合は"false") |
--allow-submit | - | false | デフォルトの送信/公開確認ガードを無効化 |
--doctor | - | - | Node、Playwright、Chromium、CDPの診断情報をJSONで表示 |
--bridge | TURBO_BROWSER_BRIDGE_PORT | 9224 | 永続CDPキープアライブブリッジデーモンを起動/検証(Chrome 144+ DevToolsActivePort用、一度承認すればAFKでも無制限に再接続可能) |
--launch-chrome | - | ~/.turbo-browser-mcp/chrome-profile | 専用プロファイルと--remote-debugging-port=9222でChromeを起動(承認プロンプトは一切なし) |
--version / -v | - | - | サーバーバージョンを表示(0.4.0) |
--help / -h | - | - | CLI使用法の概要を表示 |
| - | TURBO_BROWSER_SAVE_ROOT | process.cwd() | savePathおよびstorageStateファイルを制限するルートディレクトリ |
| - | PLAYWRIGHT_CORE_PATH | 自動解決 | playwright-core/index.mjsへの明示的なパス |
非監視型オーバーナイト/AFK自動化(Chrome 144+の承認プロンプトの排除)
Chrome 136+/144+では、デフォルトのUser Dataディレクトリでchrome://inspect/#remote-debuggingを有効にすると、DevToolsActivePortにWebSocketが表示され、新しいWebSocketクライアントが接続するたびに「リモートデバッグを許可しますか?」というプロンプトが表示されます。turbo-browser-mcpは、オーバーナイトAFKマルチエージェント実行がプロンプトでハングしないように、2つの組み込みソリューションを提供しています。
- 自動CDPキープアライブブリッジデーモン(
npm run bridge/--bridge、DevToolsActivePortで自動有効化):- バックグラウンドで分離されたマルチプレクサ(
http://127.0.0.1:9224上のsrc/cdp-bridge.mjs)を起動し、Chromeへの1つの永続的なアップストリームWebSocketを無期限に開いたままにし、Browser.closeをインターセプトして、ダウンストリームスクリプトがブラウザを終了させないようにします。 - セッション開始時に一度「許可」をクリックするだけで、その後、任意の数のMCPサーバー、CLIスクリプト、またはサブエージェントが、追加のプロンプトなしで一晩中接続および切断できます。
- バックグラウンドで分離されたマルチプレクサ(
- ゼロプロンプト専用プロファイルランチャー(
npm run launch-chrome/--launch-chrome):--remote-debugging-port=9222と専用の--user-data-dir(~/.turbo-browser-mcp/chrome-profile)でChromeを起動します。これにより、Chromeは標準のHTTP/WS CDPを最初の接続でも確認ダイアログなしで公開します。
検証
npm test # 86スイートにわたる407個のテストパス(test/*.test.mjs下の26テストファイル)
npm run doctor # Node、Playwright、Chromium、CDPの環境チェック
npm run bridge # 永続CDPキープアライブブリッジデーモンを起動/検証
npm run benchmark # ローカルChromiumの速度と正確なo200k_baseトークンベンチマーク
GitHub Actions(ubuntu-latest)で、Node 20およびNode 22で自動テスト済み。