AIエージェント向けCDPブラウザ: 開発者ガイド — Clawbrowserの記事カバー

AIエージェント向けCDPブラウザ:開発者ガイド

Clawbrowser Teamai エージェントcdpのガイド

AIエージェントはブラウザが必要です。エージェントがデータをスクレイピングしたり、フォームを埋めたり、複数のアカウントを管理したり、複数のステップのワークフローを操作したりする場合でも、プロトコルを介してブラウザをコントロールします。すべての主要なエージェントフレームワークでは、そのプロトコルはCDP(Chrome DevTools Protocol)です。問題:エージェントを標準のChromiumインスタンスに接続することで、検出され、数分以内にブロックされます。AIエージェント用のCDPブラウザはWebSocketエンドポイントよりも多く必要です。管理された指紋、プロキシルーティング、およびCDPは、既にすべてのエージェントがCDPにアクセスできるようになり、すべてのエージェントは、すべてのエージェントがCDPが同じインターフェイスで使用できます。

TL;DR: CDPは、ブラウザを制御するために使用される標準プロトコルAIエージェントです。 標準のChromeは、アンチボットシステムが即座に検出する自動化信号を公開します。 Clawbrowserは、Native CDP、管理された指紋と20以上の表面、内蔵プロキシルーティングとMCP serverに接続します。 あなたのエージェントはブロックされない実際のブラウザに接続します。


Chrome DevTools Protocolとは何ですか?

CDP は、Chromium ブラウザー上で外部プログラムをフル制御する WebSocket ベースのプロトコルです。Chrome DevTools 用に構築されました(F12 で開く検査官)が、ブラウザの自動化(browser automation)のためのデファクト規格になっています。

CDPを通して、クライアントは次のことができます:

  • URL に移動してタブの管理
  • 任意の JavaScript をページのコンテキストで実行する
  • スクリーンショットとPDFのキャプチャ
  • ネットワークリクエストの傍受と変更
  • クッキー、ストレージ、キャッシュの管理
  • ユーザーの入力を模倣して下さい: かちりと言う音、keypresses、スクロール

接続モデルは簡単です。 デバッグポートでChromeを起動し、任意のWebSocketクライアントが接続できます。

# Start Chrome with CDP enabled
chrome --remote-debugging-port=9222
// Connect from Node.js with Puppeteer
const browser = await puppeteer.connect({
  browserWSEndpoint: 'ws://localhost:9222/devtools/browser/...'
});
const page = await browser.newPage();

1つのプロトコル、1つのエンドポイント、フルブラウザの制御。 つまり、CDPが勝ち取る理由です。


すべてのAIエージェントフレームワークがCDPを使用する理由

CDP は、AI エージェントとブラウザー間でのユニバーサル コネクタです。主要なエージェントのフレームワークは CDP endpointを期待しています。

エージェントフレームワーク CDP接続
Claude Code MCP serverまたは CDP endpoint
OpenAI Codex connect_over_cdp()
Cursor CDP WebSocket
Browser Use CDP endpoint
Hermes Agent CDP endpoint
OpenClaw CDP endpoint
Kilo Code CDP endpoint
Puppeteer Native CDPクライアント
Playwright(Chromium) connect_over_cdp()

エージェントがブラウザを必要とする場合、 ws://localhost:9222. Juggler(Firefoxのプロトコル)ではなく、WebDriver BiDiではなく、独自のREST APIではありません。 CDP。

そのため、Firefox ベースのAnti-Detect Browserは、異なるプロトコルを完全に使用しているため、アダプターレイヤーなしでほとんどのエージェントワークフローに接続できません。スタックがない場合 Agent → CDP → BrowserブラウザはChromiumベースでなければなりません。


問題:標準的なChromeは検出しました得ます

標準的なChromiumと --remote-debugging-port ターゲットサイトが自動化のためにチェックされるまで、正常に動作します。 Cloudflare、DataDome、PerimeterXなどのアンチボットシステムは、複数の信号を介してCDP駆動のChromeを検出します。

1. navigator.webdriver フラグ。 Chromiumはこれを設定します true CDP で制御されるとき。 アンチボットスクリプトが最初にチェックします。

2. CDPのランタイムアーティファクト。Runtime.evaluate 実際のユーザインタラクションとは異なる JavaScript の実行コンテキストでトレースを呼び出します。

3. デフォルトの指紋。 新鮮なChromeインスタンスは、工場出荷時デフォルトキャンバス、WebGL、およびAudioContext値を返します。 実際のブラウザは、GPU、ドライバ、OS設定によって形成されるユニークな指紋を持っています。

4. ブラウザのプロファイルを欠く。 閲覧履歴、クッキー、キャッシュされたフォント、拡張子なし。 クリーンインストールはボット信号です。

5. ヘッドレスモードリーク。 でも --headless=new レンダリングの動作、プラグインの配列およびスクリーン次元の検出可能な相違を作り出して下さい。

その結果: エージェントは、Chromeに接続し、ターゲットに移動して、CAPTCHA壁やサイレントブロックをヒットします。 CDP接続は完全に機能します。 ブラウザは、あなたに失敗するものです。


エージェントをClawbrowserに接続する

Clawbrowser は、このユースケースを正確に作成するために作られたChromiumのフォークです。ブラウザレベルでの反検出を処理するAIエージェント用のCDPブラウザです。あなたのエージェントは、標準的なCDP endpointに接続します。ブラウザは、他のすべてのものを処理します。

管理された指紋でセッションを開始

# Start Clawbrowser with a managed fingerprint profile
clawctl session start --profile residential-us-1

# CDP endpoint is immediately available
# ws://localhost:9222/devtools/browser/...

PlaywrightまたはPuppeteerから接続

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    # Connect to Clawbrowser's CDP endpoint, same as any Chrome
    browser = p.chromium.connect_over_cdp("ws://localhost:9222")
// Puppeteer: zero changes to existing code
const browser = await puppeteer.connect({
  browserWSEndpoint: 'ws://localhost:9222/devtools/browser/...'
});
const page = await browser.newPage();

プロキシルーティングで複数の独立したセッションを実行

# Session 1: US residential proxy, unique fingerprint
clawctl session start --profile us-east --proxy socks5://us-proxy:1080

# Session 2: EU residential proxy, different fingerprint
clawctl session start --profile eu-west --proxy socks5://eu-proxy:1080

すべてのセッションは、内部的に一貫した指紋プロファイルを取得します。 キャンバスは、報告されたGPUと一致します。 WebGLパラメータは、グラフィックスカードに一致します。 Navigatorプロパティは、OSとブラウザのバージョンに一致します。 Timezoneはプロキシの場所と一致します。 すべての表面が同じ物語を語るので、アンチボットシステムは、実際のブラウザを参照してください。


CDP + MCP: 2 つのプロトコル、1 つの Clawbrowser

CDP は低レベルのブラウザ制御を提供します。MCP (Model Context Protocol) は、AI エージェントの高レベルのツールアクセスを提供します。Clawbrowser は同じインスタンスで両方のサポートをサポートしています。

CDP では、エージェントは granular コマンドを送信します: URL に移動し、要素を座標でクリックし、この JavaScript を実行します。 完全な制御、完全な柔軟性、より多くのコード。

MCP では、エージェントはツール関数を呼び出します。 navigate, screenshot, extract_text. MCP serverは、これらを内部でCDP操作に変換します。コードを少なくし、統合が高速化しますが、詳細な制御が少ないです。

実用的な割れ目:

  • エージェントがカスタムオートメーションスクリプトを実行したときにCDP を使用して、ネットワークのインターセプションやPuppeteer/Playwrightを直接使用してください。
  • ツールレベルのブラウザアクセス(Claude Code、Codex、またはMCP互換エージェント)を必要とするLLMである場合、MCP を使用します。
  • CDP 上でセッションを管理するオーケストラが MCP を介して対話しながら、両方の を使用します。

他のAnti-Detect Browserは同じインスタンスで両方のプロトコルを提供しています。


CDPブラウザのオプション比較

スタッフ Clawbrowser Chrome Browserbase Steel Camoufox
CDP ネイティブ はい はい はい はい ノー(Juggler)
断食防止 20以上の表面 None はい はい はい
管理された指紋 はい なし はい はい はい (BrowserForge)
プロキシルーティング 作り付け なし はい はい マニュアル
MCP server 作り付け なし なし なし なし
採用 ローカル/自家用 ローカル クラウドのみ クラウドのみ ローカル
価格 無料 無料 から $150/月 $99 /月 無料

Clawbrowserは、Native CDP、管理された指紋、組み込みプロキシルーティングとMCP serverを組み合わせる唯一のオプションであり、それは自由です。 クラウドの代替(Browserbase、スチール)のパーセッションを充電し、エージェントとブラウザ間でネットワークレイテンシを追加します。 Camoufoxは無料で使用できますが、FirefoxとJugglerは、エージェントフレームワークとのCDP互換性を意味しません。


はじめる

# Install Clawbrowser
clawctl install

# Start a session with default fingerprint
clawctl session start --profile default

既存のCDPコードは変更されません。エンドポイントでエージェントをポイントします。ブラウザは指紋、プロキシルーティング、anti-detectを自動的に処理します。


よくある質問

ClawbrowserはPuppeteerとPlaywrightで動作しますか?

はい。Clawbrowserは標準的なCDP endpointを公開します。 puppeteer.connect() または playwright.chromium.connect_over_cdp() 通常のChromeと同じようにWebSocket URLを正確に使用してください。コードの変更は必要ありません。

複数のセッションを同時に実行できますか?

はい。各セッションは、独自のCDP endpoint、指紋プロファイル、クッキー、オプションのプロキシを取得します。 ハードウェアがサポートしているように、多くのセッションを実行します。 セッションは、それらの間で共有された状態なしで完全に隔離されます。

Clawbrowserは商用利用は無料ですか?

はい。Clawbrowserは無料でオープンソースです。使用制限、セッションごとの価格設定、APIキーは必要ありません。CI/CDまたはローカルマシンで生産、使用してください。

CDPとMCPの違いは?

CDP(Chrome DevTools Protocol)は、低レベルのブラウザ制御を提供します。 ナビゲーション、クリック、JavaScriptを実行し、ネットワークリクエストを介入します。 MCP(Model Context Protocol)は、高レベルのツールアクセスを提供します。 ナビゲーション、スクリーンショット、抽出テキスト。 Clawbrowserは、同じブラウザインスタンスで同時にサポートします。

Docker と headless モードで動作しますか?

はい。Clawbrowser は、同じ CDP endpointが露出している Docker で動作します。 --headless サーバ環境のため。すべての指紋管理は、ヘッドレスモードで同じように動作します。

続きを読む

すべての記事 →