capmonster-mcp-patchright-captcha-solver について
AI エージェント向けの Patchright ベースのブラウザー自動化 MCP サーバーです。自動化シグナルを抑えた実行と 66 種類のブラウザーツールを備え、CAPTCHA の解決には CapMonster Cloud MCP サーバーとの併用が必要です。
主な機能
- 0166 種類のブラウザー自動化ツール
- 02ページ本来の実行環境を選択
- 03ARIA スナップショット検索と抽出
- 04プロファイルの永続化とタブ管理
- 05ネットワーク傍受とセッション保存
- 06PDF、動画、Blob の保存
活用シーン
- 01保護されたサイトのブラウザー操作
- 02ページをまたぐクリックやフォーム入力
- 03ブラウザーセッションを使った API 呼び出し
- 04ページ内容の取得とファイル保存
MCP 対応
MCP クライアントにブラウザー制御ツールを提供し、stdio、SSE、Streamable HTTP に対応します。単体では CAPTCHA を解決せず、CapMonster Cloud MCP サーバーと連携できます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
66掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| proxy | object | いいえ | このセッションのプロキシ(永続起動のみ)。ボット検出を避けるため、IP の国をロケール、タイムゾーン、位置情報と一致させてください。 |
| proxy.bypass | string | いいえ | バイパスするホストをカンマ区切りで指定します |
| proxy.server | string | はい | 例:http://host:port または socks5://host:port |
| proxy.password | string | いいえ | |
| proxy.username | string | いいえ | |
| width | number | いいえ | |
| device | string | いいえ | Playwright レジストリのデバイスをエミュレートします。例:"iPhone 15"、"Pixel 7"。ビューポート、UA、スケール係数、タッチを設定します。 |
| height | number | いいえ | |
| locale | string | いいえ | |
| mobile | boolean | いいえ | 完全なデバイス記述子を使わずに、モバイルエミュレーション(タッチ + モバイルヒント)を有効にします。 |
| browser | enum | いいえ | chromium | firefox | webkit |
| channel | enum | いいえ | chrome | chrome-beta | chrome-dev | chrome-canary | msedge |
| headless | boolean | いいえ | |
| userAgent | string | いいえ | |
| timezoneId | string | いいえ | |
| cdpEndpoint | string | いいえ | 既存の Chrome リモートデバッグエンドポイント。例:http://127.0.0.1:9222 |
| colorScheme | enum | いいえ | light | dark | no-preference |
| geolocation | object | いいえ | 位置情報を偽装します。位置情報の権限を自動的に許可します。 |
| geolocation.accuracy | number | いいえ | |
| geolocation.latitude | number | はい | |
| geolocation.longitude | number | はい | |
| recordVideo | any | いいえ | セッション全体の動画を録画します。デフォルト設定を使うには true を渡し、カスタマイズするにはオブジェクトを渡します。.webm として保存され、ファイルは browser_close 時に確定します。cdpEndpoint では利用できません。 |
| userDataDir | string | いいえ |
詳細
capmonster-mcp-patchright:AI エージェント向けステルスブラウザー MCP サーバー
ボット対策で保護されたサイトで動作する必要がある AI エージェントを構築していますか? このステルスブラウザーを、費用対効果の高い capsolver の代替および 2captcha の代替であるCapMonster Cloud MCP サーバーと組み合わせましょう。reCAPTCHA v3 は 1,000 回の認証につき $0.90から利用でき、2Captcha より最大 38%安く、Capsolver より 10%安くなります。組み合わせ例と以下の比較をご覧ください。
AI エージェント向けステルスブラウザー MCP サーバー — Patchright を搭載した、CDP 自動化シグナルを低減する 66 個のツールです。
Cloudflare、Akamai、Kasada、DataDome で保護されたサイトでの自動化向けに構築されています。
ページに CAPTCHA が表示されたら、
CapMonster Cloud MCP サーバーと組み合わせてください。
このサーバーがブラウザーを操作し、CapMonster Cloud が CAPTCHA を解決します。Patchright を活用した 66 個の browser_* ツールで、Claude、GPT、その他の MCP クライアントを使った AI エージェントによるウェブスクレイピングとブラウザー自動化を実現できます。Patchright は、自動化シグナルを低減するようパッチを適用した Playwright です。
詳細を見る
mcp-patchrightのフォークで、呼び出しごとに browser_evaluate / browser_run_code_unsafe で world: "main" オプションを追加しています。これにより、ページで定義された window グローバルにアクセスして呼び出せるようになります。デフォルトでは Patchright の分離されたステルスワールドを使用します(上流版と同じ動作です)。ページ独自のスクリプトから評価コードを参照する、または評価コードからページ独自のスクリプトを呼び出す必要がある場合にのみ、main を指定してください。それ以外は上流版の mcp-patchright と同じです。
Playwright ではなく Patchright を選ぶ理由
| Playwright | Patchright | |
|---|---|---|
Runtime.enable | ✅ 送信する(検出可能) | ❌ 削除済み |
Console.enable | ✅ 送信する | ❌ 削除済み |
--enable-automation フラグ | ✅ あり | ❌ 削除済み |
navigator.webdriver | true | false / undefined |
| ボット対策の回避 | ❌ | ✅ |
詳細は比較の全容をご覧ください。
クイックスタート
npm i -g capmonster-mcp-patchright
capmonster-mcp-patchright --port 9321 --host 127.0.0.1
Claude / GPT / エージェントでの利用
{
"mcpServers": {
"patchright": {
"command": "npx",
"args": ["capmonster-mcp-patchright", "--port", "9321", "--host", "127.0.0.1"]
}
}
}
🔗 CAPTCHA 解決のために CapMonster Cloud MCP と連携する
このサーバーがブラウザーを操作し、CapMonster Cloud MCP サーバーが CAPTCHA を解決します。その後、エージェントがトークンをページに注入します。MCP クライアントの設定に両方のサーバーを追加してください。
{
"mcpServers": {
"patchright": {
"command": "npx",
"args": ["capmonster-mcp-patchright", "--port", "9321", "--host", "127.0.0.1"]
},
"capmonster": {
"command": "uvx",
"args": ["capmonster-mcp"],
"env": {
"CM_API_KEY": "your_api_key_here"
}
}
}
}
CapMonster Cloud ダッシュボードでキーを取得してください。
CAPTCHA 解決 MCP サーバーの比較
| パラメーター | CapMonster Cloud MCP | CapSolver MCP | 2Captcha mcp-captcha-solver |
|---|---|---|---|
| MCP で利用できる CAPTCHA の種類 | reCAPTCHA v2 / v2 Enterprise / v3、Cloudflare Turnstile and Challenge、FunCaptcha、GeeTest v3 / v4、AWS WAF、DataDome、Imperva、TSPD、Binance、Prosopo、Yidun、TenDI、Hunt、Altcha、Basilisk、画像タスク | reCAPTCHA v2、reCAPTCHA v3、Cloudflare Turnstile | reCAPTCHA v2 |
| reCAPTCHA v3 の 1,000 回あたりの料金(最低) | $0.90 | $1.00 | $1.45 |
免責事項:CapSolver および 2Captcha は、それぞれの所有者の商標です。CapMonster Cloud はこれらの事業者とは提携していません。他サービスの MCP 対応状況は、2026 年 10 月 27 日時点で公開されているドキュメントおよびリポジトリに基づいており、変更される場合があります。料金の比較は、2026 年 9 月 27 日に実施した公開データと社内ベンチマークに基づいています。
機能
- 66 個の MCP ツール — ブラウザー自動化の機能一式
world: "main"のオプトイン —browser_evaluate/browser_run_code_unsafeをページの実際のワールドで実行し、ページで定義されたグローバルを参照・呼び出せます(デフォルトでは分離/ステルス状態を維持)browser_find— 現在の aria スナップショットからテキスト/正規表現を検索します。完全なbrowser_snapshotより低コストですbrowser_save_blob— ページコードが生成した Blob/data URL をディスクに保存します- 3 種類のトランスポート — stdio、SSE、Streamable HTTP(
/mcp) - 永続プロファイル — 実際の Chrome プロファイルを使用し、セッション間で再利用できます
- 複数ページ — タブ管理(新規作成、一覧表示、切り替え、閉じる)
- 所有者ごとに分離された HTTP セッション —
ownerクエリ/ヘッダーで呼び出し元ごとにタブを分離します - CDP 接続 — すでに実行中の Chrome を操作します
- ネットワーク追跡とインターセプト — リクエスト一覧/詳細、オフライン切り替え、ルートのブロック/モック
- セッションのインポート/エクスポート —
browser_storage_save/browser_storage_load(Cookie + localStorage) - ストレージの詳細操作 — Cookie/localStorage/sessionStorage のキー単位の CRUD(
browser_cookie_*、browser_localstorage_*、browser_sessionstorage_*) - 認証済み API リクエスト —
browser_api_requestはセッション Cookie を再利用します(ハイブリッドスクレイピング) - テキスト/HTML 抽出 —
browser_get_visible_text/_html(トークン消費を抑制) - iframe 対応 — 任意の要素ツール(click/fill/type/hover/press/wait_for/select/drag)に
frameSelectorを渡すと、iframe 内で操作できます - PDF エクスポート — CDP 経由の
browser_save_pdf(ヘッド付き/ステルスモードで動作) - 動画録画 —
recordVideoを指定したbrowser_start、browser_video_save。.webmはbrowser_close時に書き込みが完了します - 要素のハイライト — スクリーンショットや録画用のオーバーレイを表示する
browser_highlight/browser_hide_highlight - ステルスプロファイル — プロキシ/位置情報/ロケール/タイムゾーン/colorScheme
- コンソールのキャプチャ — コンソールメッセージのリアルタイムストリーム
- フィンガープリントチェック —
browser_fingerprint_checkによる診断 - 仮想パスキー — WebAuthn 認証情報の作成、インポート、一覧表示、削除(デフォルトでは秘密鍵を非表示)
ツール
完全版の比較用 HTML は /docs/tool-comparison.html にあります。
browser_startbrowser_statusbrowser_navigatebrowser_new_pagebrowser_pagesbrowser_switch_pagebrowser_close_pagebrowser_snapshotbrowser_findbrowser_take_screenshotbrowser_clickbrowser_fillbrowser_typebrowser_hoverbrowser_press_keybrowser_wait_forbrowser_evaluatebrowser_fingerprint_checkbrowser_navigate_backbrowser_select_optionbrowser_handle_dialogbrowser_file_uploadbrowser_network_requestsbrowser_network_requestbrowser_console_messagesbrowser_resizebrowser_dragbrowser_fill_formbrowser_run_code_unsafebrowser_add_init_scriptbrowser_network_state_setbrowser_api_requestbrowser_get_visible_textbrowser_get_visible_htmlbrowser_iframe_clickbrowser_iframe_fillbrowser_route_blockbrowser_route_mockbrowser_route_clearbrowser_storage_savebrowser_storage_loadbrowser_cookie_listbrowser_cookie_getbrowser_cookie_setbrowser_cookie_deletebrowser_cookie_clearbrowser_localstorage_listbrowser_localstorage_getbrowser_localstorage_setbrowser_localstorage_deletebrowser_localstorage_clearbrowser_sessionstorage_listbrowser_sessionstorage_getbrowser_sessionstorage_setbrowser_sessionstorage_deletebrowser_sessionstorage_clearbrowser_passkey_installbrowser_passkey_createbrowser_passkey_listbrowser_passkey_deletebrowser_video_savebrowser_highlightbrowser_hide_highlightbrowser_save_blobbrowser_save_pdfbrowser_close
開発
オーナー単位の HTTP セッション
HTTP モードでは、MCP URL(?owner=<id>)または X-Browser-Owner ヘッダーで安定したオーナーを指定する必要があります。ページの一覧表示、切り替え、ナビゲーション、終了は、そのオーナーのタブに制限されます。/owners?owner=<id> を削除すると、ブラウザーを停止したりプロファイルを消去したりせずに、呼び出し元 1 つが所有するすべてのタブを閉じられます。
npm install
npm run build
node dist/index.js
リリース
対応する Chromium ビルドを一度インストールし、package-lock.json に記載された正確な依存関係バージョンを使ってリリースを準備し、検証スイート全体を実行してから、公開せずにパッケージを確認してください。
npx patchright install chromium
npm run release:check
npm publish
デフォルトでは、browser_start は patchright を介して Chromium を実際の Chrome としてヘッド付きで起動し、永続プロファイルを次の場所に保存します。
~/.maestro/stealth-playwright-mcp/profiles/default
userDataDir ツール引数または STEALTH_PLAYWRIGHT_USER_DATA_DIR で上書きできます。
Chrome を起動する代わりに、すでに実行中の Chrome に接続するには、リモートデバッグを有効にして Chrome を起動し、browser_start に cdpEndpoint を渡します。
google-chrome --remote-debugging-port=9222 --user-data-dir=$HOME/.maestro/stealth-playwright-mcp/profiles/cdp
{ "cdpEndpoint": "http://127.0.0.1:9222" }
browser_snapshot は Playwright の AI aria スナップショットを返します。このスナップショットの [ref=eN] 値を使い、{ "ref": "eN" } を渡すことで、browser_click、browser_fill、browser_type、browser_hover、browser_press、browser_wait_for を実行できます。CSS セレクターも引き続き { "selector": "..." } で使用できます。
MCP 設定の例:
{
"mcpServers": {
"patchright": {
"command": "node",
"args": ["/path/to/capmonster-mcp-patchright/dist/index.js"]
}
}
}
今後の方針
提供済み:
- ✅ 永続ユーザーデータディレクトリ
- ✅ 実際の Chrome への CDP 接続
- ✅ プロキシ/タイムゾーン/ロケール/位置情報プロファイル
- ✅ LLM から操作しやすいアクセシビリティスナップショット
- ✅ フィンガープリント診断
- ✅ ネットワークインターセプト(ブロック/モック)
- ✅ セッションのインポート/エクスポート(storageState)
- ✅ PDF エクスポート
- ✅ 認証済み API リクエスト(ブラウザーの Cookie を再利用)
- ✅ 軽量なテキスト/HTML 抽出
- ✅ iframe 操作
- ✅
browser_evaluate/browser_run_code_unsafe用のworld: "main"オプトイン - ✅ aria スナップショット検索(
browser_find) - ✅ Blob/data URL の出力をディスクに保存(
browser_save_blob)
次の予定:
- rebrowser-playwright バックエンド
- codegen セッション
- 座標ベース(ビジョン)のクリック
- トレース/動画録画
❓ FAQ
capmonster-mcp-patchrightとは何ですか? Patchrightを基盤とする、AIエージェント向けのステルスブラウザーMCPサーバーです。Patchrightは、CDPの自動化シグナルを低減したPlaywrightのパッチ適用版です。66個のツールを備えています。
CAPTCHAを解決できますか? いいえ。このサーバーはブラウザーを操作します。reCAPTCHA、Cloudflare Turnstile、DataDomeなどのCAPTCHAを解決するには、CapMonster Cloud MCP serverと組み合わせてください。
CapMonster Cloudは、AIエージェント向けのcapsolverや2captchaの代替になりますか?
CAPTCHAの解決機能については、はい。CapMonster Cloud MCPサーバーは、CapSolver MCPサーバー(reCAPTCHA v2、v3、Turnstile)や2Captchaのmcp-captcha-solverプロジェクト(reCAPTCHA v2)よりも多くの種類のCAPTCHAに対応しており、reCAPTCHA v3の料金は1,000回あたり$0.90からです。上記の比較と免責事項をご覧ください。
Playwrightとはどのように違いますか?
PatchrightはRuntime.enableとConsole.enableの呼び出し、および--enable-automationフラグを取り除いており、navigator.webdriverはtrueになりません。上記の比較表をご覧ください。
すでに起動しているChromeを操作できますか?
はい。リモートデバッグを有効にしてChromeを起動し、browser_startにcdpEndpointを渡してください。
⚖️ 責任ある利用
このサーバーは、ご自身が所有するウェブサイト、または自動化の許可を得ているウェブサイトでのみ使用し、 各ウェブサイトの利用規約および適用される法律に従ってください。Patchrightは一般的な 自動化シグナルを低減しますが、すべてのサイトで自動化されたトラフィックが許可されるとは限りません。
📚 関連情報
- CapMonster Cloud MCP Server — ワークフローのCAPTCHA解決部分
- CapMonster Cloud MCPページ
- CapMonster Cloudドキュメント
- Model Context Protocol(MCP)ドキュメント
📄 ライセンス
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。