ZennoBrowser MCP Server

ZennoBrowser MCP サーバー — AI エージェント向けアンチディテクトブラウザー自動化

ZennoBrowser Public API 用の MCP（Model Context Protocol）サーバーです。ブラウザー自動化とプロファイル管理の機能を、Claude Desktop、Cursor、VS Code などの MCP クライアントを使用する AI エージェントに提供します。

ZennoBrowser MCP サーバーを選ぶ理由

• Public API を全面的にカバー。 ワークスペース、プロファイル、フォルダー、プロキシ、スレッド、ブラウザーインスタンス、プリセット、拡張機能、製品情報を扱う 57 個のツールを提供します。
• 大規模な運用に対応。 一括操作ツールを使って、1 回の呼び出しで多数のプロファイル、プロキシ、スレッド、ブラウザーインスタンスを作成、更新、起動、停止できます。
• Cookie とフィンガープリント。 プロファイル間で Cookie をインポート、エクスポート、コピーし、任意のプロファイルのフィンガープリントの詳細をすべて取得できます。
• お使いの AI クライアントで動作。 Claude Desktop、Cursor、VS Code でローカルの stdio サーバーとして動作します。
• 無料で利用開始。 ZennoBrowser は Windows で利用できます。START プランには、ローカルプロファイル数無制限と同時に使用できるブラウザー 2 台が含まれます。

クイックスタート

1. お使いのコンピューターで ZennoBrowser を起動し、ZennoLabの個人アカウントで API トークンを取得します。
2. インストールにある設定のいずれかを使って、MCP クライアントにサーバーを追加します。
3. エージェントに、たとえば次のように依頼します：「"Test Profile"という名前の新しいプロファイルを作成し、そのプロファイルのブラウザーインスタンスを起動してください。」

delete_profile、bulk_delete_profile、delete_proxy などのツールによる操作は元に戻せません。削除を伴う呼び出しを承認する前に、エージェントの操作を確認してください。

必要条件

• Node.js 20+
• ローカルで起動している ZennoBrowser
• 有効な ZennoBrowser API トークン

インストール

パッケージは @zennolab/zennobrowser-mcp-server として公開されています。1.0.0 までのバージョンはスコープなしの zennobrowser-mcp-server として公開されていましたが、こちらは更新されなくなったため、MCP クライアントの設定で @zennolab/zennobrowser-mcp-server に置き換えてください。

npx（インストール不要）

Claude Desktop — claude_desktop_config.jsonを編集します：

{
  "mcpServers": {
    "zennobrowser": {
      "command": "npx",
      "args": ["-y", "@zennolab/zennobrowser-mcp-server@latest"],
      "env": {
        "ZB_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Cursor — MCP 設定（.cursor/mcp.jsonまたは「Settings」→「MCP」）に追加します：

{
  "mcpServers": {
    "zennobrowser": {
      "command": "npx",
      "args": ["-y", "@zennolab/zennobrowser-mcp-server@latest"],
      "env": {
        "ZB_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

VS Code（GitHub Copilot の MCP サポートを使用）— .vscode/mcp.jsonに追加します：

{
  "servers": {
    "zennobrowser": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@zennolab/zennobrowser-mcp-server@latest"],
      "env": {
        "ZB_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

グローバルインストール

npm install -g @zennolab/zennobrowser-mcp-server@latest

次に、npx ... @zennolab/zennobrowser-mcp-serverの代わりに、コマンドとしてzennobrowser-mcp-serverを使用します：

{
  "mcpServers": {
    "zennobrowser": {
      "command": "zennobrowser-mcp-server",
      "env": {
        "ZB_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

環境変数

変数	必須	デフォルト	説明
ZB_API_TOKEN	はい	—	ZennoBrowser Public API の認証トークン
ZB_API_BASE_URL	いいえ	http://localhost:8160	ZennoBrowser Public API のベース URL

ツール

ワークスペース

ツール	説明
get_workspaces	アクセス可能なワークスペースの一覧を取得します

プロファイル

ツール	説明
get_profiles	フィルタリングと並べ替えを指定してプロファイルを一覧表示
get_profile	フィンガープリントの詳細情報を含む単一のプロファイルを取得
create_profile	新しいプロファイルを作成
bulk_create_profile	複数のプロファイルを一度に作成
update_profile	プロファイルの設定を更新
delete_profile	プロファイルを削除
bulk_delete_profile	複数のプロファイルを削除
move_profile	プロファイルをフォルダーに移動
recover_profile	無効な状態のプロファイルを復元
force_unlock_profile	クラウドロックされたプロファイルを強制的にロック解除
import_cookies	Cookieをインポート（JSONまたはNetscape形式）
export_cookies	CookieをJSON形式でエクスポート
copy_cookies	あるプロファイルから別のプロファイルにCookieをコピー
bulk_update_profile_preset	複数のプロファイルにプリセットを割り当て
bulk_update_profile_proxy	複数のプロファイルのプロキシを更新
bulk_update_profile_tags	複数のプロファイルのタグを更新
cleanup_profile	プロファイルのキャッシュを消去

プロファイルフォルダー

ツール	説明
get_profile_folders	プロファイルフォルダーを一覧表示
create_profile_folder	プロファイルフォルダーを作成
update_profile_folder	プロファイルフォルダーの名前を変更
delete_profile_folder	プロファイルフォルダーを削除

プロキシ

ツール	説明
get_proxies	プロキシを一覧表示
create_proxy	プロキシを作成
bulk_create_proxy	複数のプロキシを作成
update_proxy	プロキシを更新
delete_proxy	プロキシを削除
bulk_delete_proxy	複数のプロキシを削除
change_mobile_proxy_ip	モバイルプロキシのIPローテーションを実行

プロキシフォルダー

ツール	説明
get_proxy_folders	プロキシフォルダーを一覧表示
create_proxy_folder	プロキシフォルダーを作成
update_proxy_folder	プロキシフォルダーの名前を変更
delete_proxy_folder	プロキシフォルダーを削除

スレッド

ツール	説明
get_threads	スレッドを一覧表示
create_thread	スレッドを作成
bulk_create_thread	複数のスレッドを作成
continue_use_thread	スレッドの有効期間を延長
bulk_continue_use_thread	複数のスレッドの有効期間を延長
stop_thread	スレッドを停止
bulk_stop_thread	複数のスレッドを停止

ブラウザーインスタンス

ツール	説明
get_browser_instances	アクティブなブラウザーインスタンスを一覧表示
start_browser_instance	プロファイル用のブラウザーインスタンスを起動
bulk_start_browser_instance	複数のプロファイル用のブラウザーインスタンスを起動
stop_browser_instance	ブラウザーインスタンスを停止
bulk_stop_browser_instance	複数のブラウザーインスタンスを停止
set_browser_instance_visibility	ブラウザーウィンドウを表示または非表示に設定

プリセットと拡張機能

ツール	説明
get_presets	プリセットを一覧表示
create_preset	プリセットを作成
delete_preset	プリセットを削除
get_extensions	拡張機能を一覧表示
create_extension_from_web	Chrome ウェブストアから拡張機能を追加
create_extension_from_file	ローカルの .crx または .zip ファイルから拡張機能を追加
delete_extension	拡張機能を削除

製品

ツール	説明
get_product_version	ZennoBrowser のバージョンを取得
get_browser_version	ブラウザーエンジンのバージョンを取得
get_limits	ワークスペースのリソース上限を取得
get_tariff	現在の料金プラン情報を取得

プロンプトの例

プロフィールを作成してブラウザーを起動する：

「Test Profile」という名前の新しいプロフィールを作成し、そのプロフィール用のブラウザーインスタンスを起動してください。

最初から最後までの一連の操作：

「Scraper」という名前のプロフィールを作成し、URI が「socks5://user:[email protected]:1080」のプロキシを作成してプロフィールに割り当て、スレッドを作成してから、そのスレッドを使用してプロフィール用のブラウザーインスタンスを起動してください。

一括操作：

デフォルトのワークスペース内にあるすべてのプロフィールを一覧表示し、過去30日間に使用されていないものを削除してください。

Cookie の管理：

プロフィール「Session A」から Cookie をエクスポートし、プロフィール「Session B」にインポートしてください。

トラブルシューティング

Error: Missing required environment variable ZB_API_TOKEN ZB_API_TOKEN 環境変数に ZennoBrowser API トークンを設定してください。

Error: connect ECONNREFUSED 127.0.0.1:8160 ZennoBrowser が実行されていないか、Public API が機能していません。API が別のポートで実行されている場合は、ZB_API_BASE_URL=http://localhost:<port> を設定してください。

Tool calls return errors with "Unauthenticated" API トークンが無効か、有効期限が切れています。ZennoLab の個人アカウントで新しいトークンを生成してください。

npx downloads the package every time 起動のたびに再ダウンロードされないよう、npm install -g @zennolab/zennobrowser-mcp-server@latest でグローバルにインストールしてください。

関連情報

• ZennoBrowser — このサーバーが操作するアンチディテクトブラウザー
• ZennoLab のドキュメント — 製品ガイド（ロシア語）
• ZennoBrowser コミュニティフォーラム — 質問、バグ報告、機能リクエスト
• zennoposter-mcp — ZennoPoster と ZennoDroid 用の MCP サーバー

ライセンス

MIT