Undetected ChromeDriver

🚀 MCP-未被検出のChromeDriver

undetected-chromedriverをベースに構築されたMCPサービスで、包括的なブラウザ制御インターフェースを提供し、Chromeブラウザの自動操作を行い、反ボット検出メカニズムを回避します。

日本語ドキュメント

🚀 クイックスタート

MCP-未被検出のChromeDriverは、undetected-chromedriverをベースに構築されたMCPサービスで、包括的なブラウザ制御インターフェースを提供します。このサービスは、CloudflareやDistil Networksなどの現代的なウェブサイトの反ボット検出メカニズムを回避することを目的としており、データ収集や自動テストのシナリオに適しています。

✨ 主な機能

• 全面的なブラウザ制御インターフェースを提供します。
• 現代的なウェブサイトの反ボット検出メカニズムを回避します。
• データ収集や自動テストのシナリオに適しています。

📦 インストール

Smitheryを使用した自動インストール

Smitheryを使用して、Claude Desktopで使用するMCP-未被検出のChromeDriverを自動的にインストールします。

npx -y @smithery/cli install @dragons96/mcp-undetected-chromedriver --client claude

手動インストール

以下のコマンドを使用してインストールします。

pip install mcp-wf

仮想環境を作成してアクティブ化することもできます（オプション）。

uv venv
source venv/bin/activate  # Windowsでは：.venv\Scripts\activate

💻 使用例

サービスの起動

mcp-wf start

利用可能なAPIインターフェース

基本的な使用法

# 指定したURLにナビゲートする
from mcp import client

cli = client.Client()
cli.navigation.goto("https://example.com")

高度な使用法

# ページの内容を取得する
content = cli.executor.execute("return document.body.innerHTML;")
print(content)

# ブラウザインスタンスを閉じる
cli.executor.close()

📚 ドキュメント

設定

Claude DesktopでUndetected Chromedriverサーバーを設定するには、以下のようにします。

{
  "mcp": {
    "servers": [
      {
        "id": "undetected-chromedriver",
        "url": "http://localhost:9001"
      }
    ],
    "options": {
      "browser": "chrome",
      "serverId": "undetected-chromedriver"
    }
  }
}

要件

• Pythonバージョン：Python 3.8以上
• ブラウザ：最新バージョンのChromeブラウザをインストールする必要があります。

仕組み

このサービスは、undetected-chromedriverを使用して反ボット検出メカニズムを回避し、MCPプロトコルを利用して一連のAPIインターフェースを提供し、ブラウザ操作のプロセスを簡素化します。

今後の予定

• Firefoxブラウザをサポートする。
• マルチスレッドサポートを実装する。
• ログ記録機能を追加する。
• エラー処理メカニズムを最適化する。

よくある質問（FAQ）

Q: なぜ標準のSelenium Webdriverではなくundetected-chromedriverを選んだのですか？ A: undetected-chromedriverは、CloudflareやDistil Networksなどの現代的なウェブサイトの反ボット検出メカニズムを回避するために設計されており、データ収集や自動テストのシナリオでより信頼性が高いです。

Q: サービスはブラウザインスタンスをどのように処理しますか？ A: このサービスはグローバルなブラウザインスタンスを維持し、ブラウザが必要な操作を最初に呼び出したときに自動的に作成されます。browser_close APIを使用してブラウザを明示的に閉じることができます。

Q: iframe内の要素はどのように処理しますか？ A: browser_iframe_click APIを使用すると、手動でフレームコンテキストを切り替えることなく、iframe内の要素を直接操作することができます。

📄 ライセンス

このプロジェクトはMIT Licenseに準拠しています。詳細については、LICENSEファイルを参照してください。

貢献ガイド

バグレポートや機能リクエストの提出を歓迎します！コードを貢献する場合は、まず計画を我々と議論してください。