BrowserSolver

BrowserSolver MCP サーバー

BrowserSolverのWeb Unlocker API向け公式Model Context Protocolサーバーです。

あらゆるWebサイトのロック解除、レンダリング、クロール、スクリーンショットを実行できます。1つのAPIで、ボット対策の回避とテクノロジーの検出が可能です。

Claude、Cursor、VS Code、Windsurfなど、あらゆるMCPクライアントからツールとしてAPIを呼び出せます。stdio（ローカル）またはStreamable HTTP（セルフホスト可能）で動作します。

要件

• Node.js 20以降
• BrowserSolver APIキー — 登録してから、ダッシュボードでコピーしてください

ホスト型サーバー（推奨）

BrowserSolverは、https://mcp.browsersolver.com/（Streamable HTTP）でこのサーバーを実行します。x-api-keyヘッダーにAPIキーを指定してください。インストールは不要です。

claude mcp add --transport http browsersolver https://mcp.browsersolver.com/ --header "x-api-key: YOUR_API_KEY"

{
  "mcpServers": {
    "browsersolver": {
      "url": "https://mcp.browsersolver.com/",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

ホスト型サーバーとこのパッケージは同じAPIを公開しています。stdio、自分のネットワークからの外部接続、またはセルフホスト可能な環境での運用が必要な場合は、パッケージをローカルで実行してください。

ローカルで実行する

Claude Code

claude mcp add browsersolver --env BROWSERSOLVER_API_KEY=YOUR_API_KEY -- npx -y @browsersolver/mcp

Claude Desktop、Cursor、Windsurfなどのクライアント

クライアントのMCP設定（claude_desktop_config.json、.cursor/mcp.json…）にサーバーを追加します。

{
  "mcpServers": {
    "browsersolver": {
      "command": "npx",
      "args": ["-y", "@browsersolver/mcp"],
      "env": {
        "BROWSERSOLVER_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

VS Code

{
  "servers": {
    "browsersolver": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@browsersolver/mcp"],
      "env": {
        "BROWSERSOLVER_API_KEY": "${input:browsersolver-api-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "browsersolver-api-key",
      "description": "BrowserSolver API key",
      "password": true
    }
  ]
}

Claude Desktop拡張機能

リリースページから.mcpbバンドルをダウンロードして開くと、Claude DesktopがAPIキーを尋ねます。

Docker

docker build -t browsersolver-mcp .
docker run -i --rm -e BROWSERSOLVER_API_KEY=YOUR_API_KEY browsersolver-mcp

ツール

ツール	説明
stats	過去1時間のエンジンまたはエンドポイントのインフラストラクチャの状態を確認します。アカウントやテナント単位の情報ではありません。アカウントごとに有効化されます。HTTP 403が返された場合は、サポートに連絡して有効化してください。
usage	BrowserSolverアカウントのリアルタイムの利用状況とクレジット残高を取得します。
website_antibot	URLの前段にあるボット対策ベンダーを特定する単一パスのスキャンを実行し、次に適切なBrowserSolverのフェッチ階層を選べるようにします。
website_crawler	ブラウザーセッションを使わずに、公開HTMLを高速にHTTPで取得します。最初のレスポンスに必要なコンテンツがすでに含まれている場合に最適です。
website_rendering	公開URLに対して管理されたブラウザーセッションを実行し、クライアント側スクリプトの実行後にHTMLを収集します。静的マークアップにはCrawlerを優先し、承認済みホストでチャレンジが発生する場合はWebUnlockerに切り替えてください。
website_screenshot	公開URLをBrowserSolverでレンダリングし、PNG、JPEG、WebP、またはPDFのアセットに変換します。ローカルのChromium環境を運用する必要はありません。
website_technology	公開URLから確認できるCMS、フレームワーク、分析ツール、CDN、セキュリティツールを特定します。信頼度スコア付きのシンプルなリストまたは専門家向けメタデータを選べます。
website_webunlocker	BrowserSolverで最も高機能なHTML取得階層です。アカウントの許可リストに登録された小売サイトやマーケットプレイスのホストに対応します。Renderingをブロックし続けるボット対策チャレンジを解決します。

APIを呼び出すすべてのツールはクレジットを消費します。JSONの結果はテキストとして返され、画像はインラインで返されます。その他のファイル（PDFなど）は、最大4 MBまで埋め込みリソースとして返されます。

Streamable HTTP

npx @browsersolver/mcp --http --port 3000

エンドポイントは POST /mcp です（ステートレス、JSON レスポンス）。各クライアントは独自のキーを x-api-key ヘッダー（または Authorization: Bearer <key>）で送信します。サーバー自身がキーを使用することはありません。デフォルトでは 127.0.0.1 にバインドし、許可しない限りブラウザーからのオリジンを拒否します。外部に公開する前に、TLS の背後に配置してください。

createHttpHandler() は、Fetch 互換のランタイム（Cloudflare Workers、Deno、Bun）向けにエクスポートされています。

import { createHttpHandler } from "@browsersolver/mcp";

export default { fetch: createHttpHandler({ allowedOrigins: [] }) };

セキュリティ

• API キーは BROWSERSOLVER_API_KEY（stdio）またはリクエストヘッダー（HTTP）から読み取られ、エラーメッセージから削除されます。
• ウェブサイトから取得したコンテンツは信頼できないため、サーバーの指示では、モデルに対して指示ではなくデータとして扱うよう伝えています。
• 脆弱性を報告するには、SECURITY.md をご覧ください。

開発

npm install
npm test
npm run build
npx @modelcontextprotocol/inspector node dist/stdio.js

SDK 上に構築

このサーバーは、公式の Node.js SDK（@browsersolver/sdk）を使用しています。

BrowserSolver のすべての SDK

SDK	パッケージ	インストール
Node.js	@browsersolver/sdk	npm install @browsersolver/sdk
Python	browsersolver	pip install browsersolver
Go	browsersolver-go	go get github.com/browsersolver/browsersolver-go
.NET	BrowserSolver	dotnet add package BrowserSolver
Ruby	browsersolver	gem install browsersolver
PHP	browsersolver/sdk	composer require browsersolver/sdk
Java	browsersolver-java	ソースからビルドしてください。README をご覧ください
CLI	@browsersolver/cli	npm install -g @browsersolver/cli
MCP サーバー	@browsersolver/mcp	npx -y @browsersolver/mcp

ライセンス

MIT — LICENSE をご覧ください。