HN 日本語サマリー

← 一覧へ戻る
プログラミング

Show HN: Turbo-Browser-MCP – MCP向けのバッチ処理フォーム、DOMデルタ、送信ガード

Show HN: Turbo-Browser-MCP – Batch forms, DOM deltas and submit guards for MCP (github.com)

40 pointsby tthanh2k68 コメント

要約

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 トーク フルARIA1,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 トーク DevTools3,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、またはカスタムMIME dropData)、「press」(key + modifiers:Alt、Control、ControlOrMeta、Meta、Shift)、「scroll」(dx、dy)、「wait」(ms、state、loadState、text、textGone、url)、および「upload」。
  • ターゲティングオプション:コンパクトな[eN] ref、CSS selector、表示されている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の読み取り/書き込み/クリア、および完全なPlaywright storageState JSONファイルのインポートまたはリロード(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 ARIAturbo-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/a641 文字(156 トーク)n/a95.7%
診断フィルタ(32 リクエスト、26 コンソールログ)9,651 文字(3,460 トーク、all)n/a1,761 文字(601 トーク、errors)n/a82.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-mcp10(フル 14,186 / コンパクト 12,796)12,7963,010(注釈付きフル 3,314)ベースライン(10ツール)
@playwright/mcp2518,4573,917静的トークンが23.2%少ない
chrome-devtools-mcp3330,2526,737静的トークンが55.3%少ない

@playwright/mcp および chrome-devtools-mcp との比較

機能turbo-browser-mcp@playwright/mcpchrome-devtools-mcp
ツールサーフェスのサイズ10個のバッチ処理ツール25個の粒度の細かいツール33個の粒度の細かいツール
デルタスナップショット(onlyChanged)内蔵各スナップショットでフルツリー各スナップショットでフルツリー
閉じられたShadow DOMフック初期化後 attachShadow フック + <slot>フラット化開いているShadow DOMCDP / 標準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/mcpchrome-devtools-mcp
マルチタブを開く、リスト、切り替え、リサイズ、エミュレートtabs_batchbrowser_tabs, browser_navigate, browser_resize, ...new_page, list_pages, select_page, resize_page, ...
DOM / アクセシビリティ検査inspect_compactbrowser_snapshottake_snapshot
マルチフィールドフォームとアップロードsmart_fill_formbrowser_fill_form + browser_select_option + browser_file_uploadfill_form + upload_file
クリック、入力、ドラッグ、プレス、スクロール、待機act_fastbrowser_click, browser_type, browser_drag, ...click, type_text, drag, press_key, wait_for
マルチステップ逐次マクロbatch_actionsbrowser_run_code_unsafe または N ツールの呼び出しN 個の個別のツール呼び出し
クリーンな記事抽出extract_clean_textbrowser_evaluate カスタムJSevaluate_script カスタムJS
フレーム/要素JS評価evaluate_jsbrowser_evaluateevaluate_script
エラー、ネットワーク、コンソールトリアージpage_diagnosticsbrowser_console_messages, browser_network_requestslist_console_messages, list_network_requests, ...
スクリーンショットとPDFエクスポートcapture_pagebrowser_take_screenshottake_screenshot
ブロックプリセット、Cookie、ストレージnetwork_sessionbrowser_evaluate + コンテキスト設定evaluate_script / emulate を介した部分的なもの

安全性:人手による送信ガードとパスの制限

  1. 人手による送信ガード(デフォルトでallowSubmit=false):
    • smart_fill_form(stopBeforeSubmit: true)、act_fast、batch_actionsは、一致する要素、W3C AccNameラベル(isSafeSubmitter)、暗黙的なHTMLフォームEnter送信、キーコード(Shift+Enter、Enter+Shift)、HTMLFormElement.prototype.submit/requestSubmit、および同一オリジンのiframe contentWindow/contentDocumentプロキシを検査します。
    • Submit、Publish、Send、Post、Apply、Confirm、または支払いトリガーに類似した最終アクションは、allowSubmit: trueが明示的に渡されるか、起動時に--allow-submitが有効にされない限りブロックされます。
    • トレードオフ:既に開いているCDPタブ上の既存の閉じられたShadowルート(初期化スクリプト実行前にアタッチされたもの)または厳密なクロスオリジンサンドボックス化されたフレームは、Playwrightフレームハンドル、座標アクション、キーボード入力にフォールバックします。
  2. ワークスペースパスの制限(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_pagePNG/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 <autocdppersistentlaunch>`
--cdp <url>TURBO_BROWSER_CDP_URLhttp://127.0.0.1:9222Chrome DevTools Protocol HTTPエンドポイント
--user-data-dir <path>TURBO_BROWSER_USER_DATA_DIR""永続プロファイルディレクトリパス
--executable <path>-自動検出カスタムChromium、Chrome、Edge、またはBrave実行可能ファイル
--timeout <ms>TURBO_BROWSER_TIMEOUT_MS15000デフォルトのPlaywrightアクション/ナビゲーションタイムアウト(ミリ秒)
--headless / --headedTURBO_BROWSER_HEADLESStrue(ヘッドレス)ヘッドレスまたは表示されるブラウザウィンドウを実行(ヘッドレスの場合は"false")
--allow-submit-falseデフォルトの送信/公開確認ガードを無効化
--doctor--Node、Playwright、Chromium、CDPの診断情報をJSONで表示
--bridgeTURBO_BROWSER_BRIDGE_PORT9224永続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_ROOTprocess.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つの組み込みソリューションを提供しています。

  1. 自動CDPキープアライブブリッジデーモン(npm run bridge / --bridge、DevToolsActivePortで自動有効化):
    • バックグラウンドで分離されたマルチプレクサ(http://127.0.0.1:9224上のsrc/cdp-bridge.mjs)を起動し、Chromeへの1つの永続的なアップストリームWebSocketを無期限に開いたままにし、Browser.closeをインターセプトして、ダウンストリームスクリプトがブラウザを終了させないようにします。
    • セッション開始時に一度「許可」をクリックするだけで、その後、任意の数のMCPサーバー、CLIスクリプト、またはサブエージェントが、追加のプロンプトなしで一晩中接続および切断できます。
  2. ゼロプロンプト専用プロファイルランチャー(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で自動テスト済み。

ライセンス

MIT