Patchright Stealth Browser

🚀 Patchright 軽量級 MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）を実装した軽量級のサーバーで、Patchright Node.js SDK をラップし、AI モデルにブラウザ自動化機能を提供します。このプロジェクトは、ブラウザ自動化タスクを実行しながら、ターゲットウェブサイトに検知されないことに焦点を当てています。

🚀 クイックスタート

このサーバーは、ブラウザ自動化機能を AI モデルに提供し、ターゲットウェブサイトに検知されることを避けます。以下の手順で簡単に始めることができます。

✨ 主な機能

• シンプルなインターフェース：使いやすい API を提供し、ブラウザ自動化を迅速に実現します。
• 隠れた自動化：ターゲットウェブサイトの反クローラーメカニズムを効果的に回避します。
• モデルコンテキストプロトコル (MCP)：AI モデルとのやり取りをサポートする標準インターフェースを備えています。
• 標準入出力 (Stdio) 転送：データのやり取りプロセスを簡素化します。

📦 インストール

前提条件

• Node.js バージョン >= 14.0.0
• npm または Yarn パッケージ管理ツール

インストール手順

# リポジトリをローカルにクローンする
git clone https://github.com/your-repository.git
cd patchright-mcp

# 依存関係をインストールする
npm install

# プロジェクトをビルドする
npm run build

💻 使用例

サーバーの起動

# MCP サーバーを起動する
npm start

Claude Desktop の設定

config.json に以下の内容を追加します。

{
  "mcp": {
    "serverUrl": "http://localhost:3000"
  }
}

VS Code with GitHub Copilot の設定

Model Context Protocol プラグインをインストールし、以下のように設定します。

{
  "modelContextProtocol": {
    "servers": [
      {
        "url": "http://localhost:3000",
        "label": "Patchright MCP Server"
      }
    ]
  }
}

ブラウザ操作

// ブラウザを起動してページにアクセスする
await page.load('https://example.com');

// ユーザー入力をシミュレートする
await page.type('#searchInput', 'test');
await page.click('#submitBtn');

属性チェック

// 検出を回避する属性設定
document.addEventListener('DOMContentLoaded', function() {
  console.log(window);
});

一般的な使用手順

1. ブラウザを起動してターゲットページにアクセスする
2. ユーザー入力とインタラクションをシミュレートする
3. 検証情報を抽出する
4. ブラウザを閉じる

セキュリティ上の注意事項

⚠️ 重要提示

関連する法律および規制を遵守し、技術を悪用して違法活動を行わないでください。

💡 使用建议

過度な自動化を避け、ウェブサイトのサービスに影響を与えないようにしてください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。

謝辞

以下のプロジェクトの貢献に感謝します。

• Patchright-nodejs は Kaliiiiiiiiii-Vinyzu によって開発されました。
• モデルコンテキストプロトコル (MCP) は技術的なサポートを提供しています。

Docker の使用方法

クイックスタート

docker run -it --rm dylangroos/patchright-mcp

イメージのビルド

docker build -t patchright-mcp .

コンテナの起動

docker run -it --rm patchright-mcp

Docker Hub イメージ

最新バージョンは自動的に Docker Hub に公開されています。アクセス先：dylangroos/patchright-mcp