MCP Server Scrappey

🚀 Scrappey MCP サーバー

Model Context Protocol (MCP) サーバーは、Scrappey.com のウェブ自動化およびスクレイピング機能とやり取りするためのものです。smithery.ai/server/@pim97/mcp-server-scrappey で直接試すことができます。

🚀 クイックスタート

この MCP サーバーは、AI モデルと Scrappey のウェブ自動化プラットフォームの間に架ける橋となり、以下のことが可能になります。

• ブラウザセッションの作成と管理
• Scrappey のインフラストラクチャを通じて HTTP リクエストを送信
• ブラウザ操作（クリック、入力、スクロールなど）の実行
• さまざまな反ロボット保護の自動処理

✨ 主な機能

• ブラウザセッションの作成と破棄をサポート
• カスタムプロキシによるネットワークリクエストの設定
• カスタム HTTP ヘッダーのサポート
• 反ロボット保護メカニズムの自動処理

📦 インストール

1. Scrappey.com で Scrappey API キーを取得します。
2. 環境変数を設定します。

SCRAPPEY_API_KEY=your_api_key_here

💻 使用例

基本的な使用法

1. セッションの作成 (scrappey_create_session)

新しいブラウザセッションを作成し、cookie やその他の状態を保持します。

{
  "proxy": "http://user:pass@ip:port"  // オプション: カスタムプロキシ、空白の場合はデフォルトを使用
}

2. セッションの破棄 (scrappey_destroy_session)

ブラウザセッションを適切に閉じます。

{
  "session": "session_id_here"  // 必須: 破棄するセッション ID
}

3. リクエストの送信 (scrappey_request)

Scrappey のインフラストラクチャを通じて HTTP リクエストを送信します。

{
  "cmd": "request.get",  // 必須: request.get、request.post など
  "url": "https://example.com",  // 必須: ターゲット URL
  "session": "session_id_here",  // 必須: 使用するセッション ID
  "postData": "key=value",  // オプション: POST データ
  "customHeaders": {  // オプション: カスタムヘッダー
    "User-Agent": "custom-agent"
  }
}

4. ブラウザ操作 (scrappey_browser_action)

ブラウザの自動化操作を実行します。

{
  "session": "session_id_here",  // 必須: 使用するセッション ID
  "browserActions": [  // 必須: 実行する操作の配列
    {
      "type": "click",  // 操作タイプ: click、hover、type、scroll、wait
      "cssSelector": ".button",  // 要素を特定するための CSS セレクター
      "text": "Hello",  // 入力するテキスト（type 操作の場合）
      "wait": 1000  // 待機時間（ミリ秒）
    }
  ]
}

高度な使用法

以下はこれらのツールを使用する典型的な手順です。

1. セッションの作成：新しいブラウザセッションを初期化します。
2. リクエストの送信：セッションを通じて HTTP リクエストを送信します。
3. 操作の実行：セッション内でクリックや入力などのブラウザ操作を実行します。

📚 ドキュメント

ベストプラクティス

1. リソース管理：不要になったセッションはすぐに破棄してリソースを解放します。
2. エラー処理：発生する可能性のある例外をキャッチして処理します。
3. セキュリティ：API キーを安全に保管し、漏洩を防ぎます。

よくある質問

• セッションを作成できない場合は、API キーが有効かどうかを確認してください。
• リクエストの送信に失敗した場合は、ターゲット URL とネットワーク設定を確認してください。

リソース情報

• 公式ドキュメント：Scrappey ドキュメント
• サポート連絡先：support@scrappey.com

📄 ライセンス

このプロジェクトは MIT ライセンスに準拠しており、詳細は LICENSE ファイルを参照してください。