Browserless.io 用の MCP (Model Context Protocol) サーバー — Browserless のスマートスクレイパー API を、Claude Desktop、Cursor、VS Code、Windsurf などの LLM クライアントに公開します。
browserless.io から API トークンを取得し(無料枠あり)、MCP クライアントをホスト型サーバーに接続します:
{
"mcpServers": {
"browserless": {
"url": "https://mcp.browserless.io/mcp?token=your-token-here"
}
}
}ローカルインストールは不要です。クライアント別の設定スニペットは 設定 を参照してください。
Related MCP server: Pinchtab MCP Wrapper
ツール | 説明 |
| 単一の Web ページをスクレイピングし、そのコンテンツを markdown または HTML として返します。JavaScript を多用したページやアンチボット対策を自動的に処理します。複数ページにまたがるコンテンツには |
| Browserless を使用して Web を検索し、必要に応じて各結果をスクレイピングします。地理的ターゲティングと時間フィルターに対応した Web 検索、ニュース検索、画像検索をサポートします。 |
| Web サイト上のすべての URL を発見してマッピングします。サイトマップとリンク抽出でスキャンします。URL を、必要に応じてタイトルと説明付きで返します。サイト監査やコンテンツの発見に役立ちます。 |
| Web サイトをクロールし、発見したすべてのページをスクレイピングします。深度制御、パスフィルタリング、サイトマップ戦略、設定可能なスクレイピングオプションに対応しています。各ページのスクレイピング済みコンテンツとメタデータを返します。 |
| 任意の URL に対して Lighthouse 監査を実行します。アクセシビリティ、ベストプラクティス、パフォーマンス、PWA、SEO のスコアとメトリクスを返します。カテゴリによるフィルタリングやパフォーマンスバジェットの指定も可能です。 |
| Browserless クラウド上でカスタムの Puppeteer JavaScript を実行します。関数は |
| Browserless の |
| ReAct ループで永続的なブラウザセッションを操作します。ページのスナップショット取得、計画、操作の一括実行(クリック、入力、スクロール、評価など)、再スナップショット取得を行います。スナップショットから導出された ref ベースのセレクタを使用し、マルチタブワークフロー、スクリーンショット、CAPTCHA 解決、ライブ URL、ファイルのアップロード/ダウンロードに対応しています(取得したダウンロードはハンドルとして自動的に表示され、バイトデータがコンテキストに入ることはありません)。 |
| 複雑なページの仕組み(シャドウ DOM、Cookie 同意、モーダル、CAPTCHA、動的コンテンツ、スナップショットの取得漏れ、スクリーンショット、タブ)に対するオンデマンドのレシピを読み込みます。 |
| 現在のトークンに保存されている認証プロファイルを、Cookie 数とオリジン数とともに一覧表示します。プロファイル名を |
| 現在のトークンの背後にあるアカウントを読み取ります。プラン、ユニット残高、請求期間、API キー名などです。API トークンの値が返されることはありません。 |
| リクエストとユニットの消費量を読み取ります。成功、エラー、タイムアウト、キューイング、ピーク同時実行数、CAPTCHA、プロキシのバイト数とユニットなどです。必要に応じて特定の API キーに限定できます。 |
| アカウントのセッションを検査します — 現在実行中のブラウザ、専用ワーカー上の永続セッション、記録済みのセッションリプレイ、1Password の認証情報連携などです。また、リプレイを、レンダリングにネットワークを必要としない完全自己完結型の rrweb プレイヤーページとしてダウンロードします( |
| Browserless 自身による最近のリクエストの記録を読み取ります。何が試行されたか、失敗したかどうか、なぜ停止したか、どれだけの時間がかかり、どれだけのコストが発生したかなどです。Browserless 側で失敗した実行を診断するためのツールです。利用可能な期間はプランによって異なります。 |
サーバーには組み込みのスキルライブラリが同梱されています — エージェントが複雑なページの仕組みに対処するために読み込めるオンデマンドのレシピです。スキルは、トリガーが発火すると(エージェントが Cookie バナーに遭遇した場合など)browserless_agent のレスポンスに自動的に注入され、browserless_skill ツールを使って手動で読み込むこともできます。
スキル | ソース | 目的 |
| シャドウルート越しのディープセレクタと iframe ターゲティング。 | |
| ベンダー固有の閉じるレシピ(OneTrust、Cookiebot、Didomi、TrustArc など)。 | |
| ダイアログ、アラートダイアログのクローズ、オーバーレイの閉じるボタンのヒューリスティック。 | |
|
| |
| async/AJAX/SPA コンテンツに適した | |
| 切り詰められた/空のスナップショットと、画像としてレンダリングされたコンテンツの処理。 | |
| スクリーンショットを撮るべきかスナップショットを撮るべきかの判断、スコープと形式の選択。 | |
| マルチタブワークフローと、 |
スキルを明示的に読み込む:
{
"method": "tools/call",
"params": {
"name": "browserless_skill",
"arguments": { "id": "cookie-consent" },
},
}browserless_agent)browserless_agent にトップレベルの proxy オブジェクトを渡すと、セッションをリジデンシャル IP 経由でルーティングできます。対象サイトがデータセンターからのトラフィックを IP ブロックする場合に使用します。
{
"method": "tools/call",
"params": {
"name": "browserless_agent",
"arguments": {
"method": "goto",
"params": { "url": "https://example.com" },
"proxy": {
"proxy": "residential",
"proxyCountry": "us",
"proxySticky": true,
},
},
},
}フィールド | 備考 |
|
|
| ISO-2 国コード( |
| 空白をアンダースコアに置き換えた米国の州名( |
| 都市ターゲット。有料/エンタープライズプラン限定 — 対象外のトークンには 401 が返されます。 |
| 基盤となる WebSocket が開いている間は安定した IP を維持します。再接続(アイドル切断、ネットワークの瞬断、ブラウザのクラッシュ)が発生すると、新しいスティッキー ID と新しい IP が割り当てられます。 |
|
|
| 名前付きプリセット(例: |
| 自前のアップストリームを指定します(例: |
注:
proxyCountry/proxyState/proxyCity/proxySticky/proxyLocaleMatch/proxyPresetを使用するには、proxy: "residential"またはexternalProxyServerのいずれかが設定されている必要があります。MCP は検証時にこの組み合わせを拒否します。この設定がない場合、API はこれらを黙って無視します。
proxy オブジェクトはセッション作成時に一度だけ読み取られます。これを変更するには、close を呼び出して新しいセッションを開始してください。エージェントクライアントはプロキシのフィンガープリントでセッションを識別するため、異なる設定を渡すと新しい WebSocket に接続されます。
サーバーは https://mcp.browserless.io/mcp でホストされています。ヘッダー（推奨）または ?token= クエリパラメータで認証します。
AI エージェント経由でインストールしますか？エージェントが読み取れるセットアップ手順については install.md を参照してください。
ヘッダーの使用（ヘッダーをサポートするクライアントに推奨）:
{
"mcpServers": {
"browserless": {
"url": "https://mcp.browserless.io/mcp",
"headers": {
"Authorization": "Bearer your-token-here"
}
}
}
}URL クエリパラメータの使用（URL のみを受け付ける Claude.ai カスタムコネクタなどのクライアント向け）:
https://mcp.browserless.io/mcp?token=your-token-here特定の Browserless リージョナルエンドポイントに接続するには、x-browserless-api-url ヘッダーまたは browserlessUrl クエリパラメータを追加します:
{
"mcpServers": {
"browserless": {
"url": "https://mcp.browserless.io/mcp",
"headers": {
"Authorization": "Bearer your-token-here",
"x-browserless-api-url": "https://production-lon.browserless.io"
}
}
}
}https://mcp.browserless.io/mcp?token=your-token-here&browserlessUrl=https://production-lon.browserless.ioヘッダーとクエリパラメータの両方が存在する場合、ヘッダーが優先されます。
claude_desktop_config.json に追加します:
{
"mcpServers": {
"browserless": {
"url": "https://mcp.browserless.io/mcp?token=your-token-here"
}
}
}Cursor の MCP 設定に追加します:
{
"mcpServers": {
"browserless": {
"url": "https://mcp.browserless.io/mcp?token=your-token-here"
}
}
}VS Code の設定（settings.json）に追加します:
{
"mcp": {
"servers": {
"browserless": {
"url": "https://mcp.browserless.io/mcp",
"headers": {
"Authorization": "Bearer your-token-here"
}
}
}
}
}Windsurf の MCP 設定に追加します:
{
"mcpServers": {
"browserless": {
"url": "https://mcp.browserless.io/mcp?token=your-token-here"
}
}
}サーバーはローカルでも実行できます。エアギャップ環境でのデプロイや、セルフホストされた Browserless インスタンスを指定する場合に便利です。このリポジトリをクローンして Docker イメージをビルドします:
docker build -f docker/Dockerfile -t browserless-mcp .
docker run \
-e BROWSERLESS_TOKEN=your-token \
-e BROWSERLESS_API_URL=https://your-browserless-instance.example.com \
-p 8080:8080 \
browserless-mcpその後、上記と同じヘッダー/クエリパラメータ認証を使用して、MCP クライアントを http://localhost:8080/mcp に接続します。
Variable | Required | Default | Description |
| Yes | — | あなたの Browserless API トークン |
| No |
| API エンドポイント（セルフホストの Browserless 用） |
| No |
| アカウント API ホスト — |
| No |
| セッションリプレイアーティファクトを提供するオリジン。リプレイパスはこれに対してオリジンチェックされます |
| No |
| トランスポートタイプ: |
| No |
| HTTP サーバーポート（ |
| No |
| リクエストタイムアウト（ミリ秒） |
| No |
| 失敗したリクエストの最大再試行回数 |
| No |
| キャッシュ TTL（ミリ秒）（0 で無効） |
| No | — | Amplitude プロジェクト API キー。MCP 使用状況分析を送信します — SDK ライフサイクルイベントに加えて、当社独自のツール/スキルイベント |
| No | 未設定（フルサーフェス） | 縮小されたディレクトリ準拠のサーフェスを提供します。フェイルクローズ: |
Resource URI | 説明 |
| スマートスクレイパー API ドキュメント |
| サービスの稼働状況 |
Prompt | 説明 |
| ウェブページをスクレイピングしてコンテンツを要約する |
| ウェブページから特定の情報を抽出する |
npm install
npm run build
npm test
npm run coverageテストスイートは Mocha と Chai、Sinon を使用しています。スペックはコードと同じ場所の test/（test/lib/、test/tools/、test/prompts/、test/resources/、test/integration/）にあり、build/ のコンパイル済み出力に対して実行されます。
npm test — TypeScript をコンパイルし、build/test/ 配下のすべての *.spec.js を実行します。外部サービスや BROWSERLESS_TOKEN は不要です。API クライアントはスタブ化されています。
npm run coverage — package.json で設定されたしきい値（行 ≥ 80%、ブランチ ≥ 70%、関数 ≥ 80%）で c8 の下でスイートを実行します。
テストは Test workflow により Node 24 上で、すべてのプルリクエストで自動的に実行されます。PR はマージする前にスイートをグリーンに保つ必要があります。
API トークンは browserless.io で取得できます。このトークンは Browserless API へのすべてのリクエストを認証します。
SSPL-1.0
Zenrows MCP server — Fetch, Extract, Batch, and Browser Sessions for AI coding assistants
Official Octoparse MCP server for template discovery, cloud tasks, and structured data export.
Hosted real Google Chrome MCP with per-user persistent state. Navigate, click, type, screenshot.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/browserless/browserless-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server