ZenLink MCP

ZenLink MCP

ZenLink 経由でブラウザーを自動化する MCP サーバーです。Zen Browser（Firefox ベース）を通じて、Claude Desktop やその他の MCP クライアントからブラウザーを直接操作できます。

v2.0.0 では、並列エージェント処理のための新しいツールが約50個追加されました。実際のマルチタブ並列処理、タブのアンローダー対策、セッションの保存と復元、Readability と Markdown による抽出、リクエストのインターセプト、Cookie とストレージの操作、オーケストレーションのプリミティブ（ブロードキャスト、同期バリア、タブプール、名前付きタグ）に対応しています。全項目については、CHANGELOG.md をご覧ください。

インストール

pip install zenlink-mcp

必要条件

• Zen Browser に ZenLink ブラウザー拡張機能 v2.0.0+ がインストールされていること
• ZenLink ブリッジが実行中であること（python native/bridge.py）

ツール一覧（75個以上）

以下のタブ対応ツールはすべて、任意の tab_id パラメーターを受け付けます。これを指定すると、フォーカスを奪わずに特定のタブを操作できます。これは、マルチタブの並列処理の基盤となります。

コア

zen_status、zen_health、zen_tabs、zen_new_tab、zen_close_tab、zen_switch_tab、zen_navigate、zen_screenshot

コンテンツ抽出（一度読み取れば、効率よく作業できます）

zen_page_text、zen_page_info、zen_readability、zen_markdown、zen_query、zen_html、zen_links、zen_images、zen_meta、zen_structured_data、zen_bounds、zen_computed_style、zen_dom、zen_forms、zen_iframes、zen_explain_selector、zen_full_page_metrics

操作

zen_click、zen_trusted_click、zen_double_click、zen_type、zen_fill、zen_form_fill、zen_set_editable_content、zen_select_option、zen_check、zen_focus、zen_blur、zen_keypress、zen_submit_form、zen_drag、zen_hover、zen_scroll、zen_find、zen_highlight、zen_click_and_wait_navigation

ビジュアル

zen_screenshot、zen_element_screenshot、zen_full_page_screenshot

タブとウィンドウの管理

zen_pin_tab、zen_mute_tab、zen_duplicate_tab、zen_reload_tab、zen_back、zen_forward、zen_get_zoom、zen_set_zoom、zen_windows、zen_create_window、zen_close_window、zen_focus_window、zen_move_tab、zen_detach_tab

ネットワーク、Cookie、状態

zen_cookies、zen_storage（local/session）、zen_clipboard、zen_downloads、zen_clear_browsing_data、zen_intercept、zen_capture_network、zen_wait_for_network_idle、zen_wait_for_url、zen_wait_for_title、zen_watch_console、zen_console_logs

セッション（認証は一度だけ、何度でも利用）

zen_save_session、zen_load_session、zen_list_sessions、zen_delete_session

オーケストレーション（マルチタブ並列処理）

zen_keep_alive、zen_keep_alive_stop、zen_wake_tab、zen_broadcast、zen_sync_barrier、zen_tag_tab、zen_resolve_tag、zen_list_tags、zen_untag_tab、zen_tab_pool、zen_pool_acquire、zen_pool_release、zen_parallel

バッチ／スクリプト

zen_batch（parallel、if、while、try、sequence、retry、${$N.field} による変数置換に対応）

可観測性／ポリシー

zen_logs、zen_audit、zen_set_policy、zen_get_policy、zen_retry、zen_reload_extension

待機用プリミティブ

zen_wait_for_element、zen_wait_for_result、zen_wait_for_url、zen_wait_for_title、zen_wait_for_network_idle

ワークフロー

zen_workflows、zen_workflow、zen_cache、zen_wp_html

zen_wait_for_element

CSS セレクターがページに表示されるまで待機します。一定時間スリープするのではなく、要素が見つかるとすぐに返されます。動的コンテンツや JavaScript で描画されるコンテンツを待つ場合は、sleep の代わりに使用してください。

{"action": "waitForElement", "selector": ".tracking-events", "timeout": 10000}

パラメーター	型	デフォルト	説明
selector	string	必須	待機する CSS セレクター
timeout	int	10000	最大待機時間（ミリ秒）
poll_interval	int	200	確認間隔（ミリ秒）

成功時は { ok: true, found: true, elapsed: 342, ref: "r12", tag: "div" } を返し、タイムアウト時は { ok: false, found: false, error: "Timed out after 10000ms" } を返します。

zen_batch

1 回のリクエストで複数のコマンドを実行します。waitForElement、trustedClick、sleep を含むすべてのアクションに対応しています。

[
  {"action": "navigate", "url": "https://example.com"},
  {"action": "waitForElement", "selector": ".results", "timeout": 8000},
  {"action": "pageText"}
]

Claude Desktop のセットアップ

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "zenlink": {
      "command": "zenlink-mcp"
    }
  }
}

変更履歴

全履歴は CHANGELOG.md を参照してください。v2.0.0 の主な変更点：

• コンテンツ抽出、操作、ネットワーク、セッション、オーケストレーションに関する MCP ツールを約 50 個追加
• zen_parallel と zen_keep_alive による、実際の複数タブ並列処理
• 一度認証すれば何度でも利用できるフローに対応する、セッションの保存と復元
• 分析や広告をブロックする zen_intercept（エージェントの実行時にページ速度が 3～10 倍向上）
• トークン効率の高いページ抽出を実現する zen_readability と zen_markdown
• zen_reload_extension によるホットリロード

リンク

• ZenLink ブリッジと拡張機能
• MCP レジストリ

_{mcp-name: io.github.JayQuan-McCleary/zenlink-mcp}