Scrappey MCP サーバー

Scrappey.comのウェブ自動化およびスクレイピング機能と連携するためのモデルコンテキストプロトコル（MCP）サーバーです。smithery.ai/server/@ pim97/ mcp-server-scrappey で直接お試しください。

概要

この MCP サーバーは、AI モデルと Scrappey の Web 自動化プラットフォーム間のブリッジを提供し、次のことが可能になります。

ブラウザセッションの作成と管理
Scrappeyのインフラストラクチャを介してHTTPリクエストを送信する
ブラウザアクション（クリック、入力、スクロールなど）を実行します
さまざまなボット対策を自動的に処理

設定

Scrappey.comからScrappey APIキーを取得します。
環境変数を設定します。

SCRAPPEY_API_KEY=your_api_key_here

利用可能なツール

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

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

{
  "proxy": "http://user:pass@ip:port"  // Optional: Custom proxy, leave empty for default
}

2. セッションを破棄する ( `scrappey_destroy_session` )

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

{
  "session": "session_id_here"  // Required: The session ID to destroy
}

3. リクエストを送信する ( `scrappey_request` )

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

{
  "cmd": "request.get",  // Required: request.get, request.post, etc.
  "url": "https://example.com",  // Required: Target URL
  "session": "session_id_here",  // Required: Session ID to use
  "postData": "key=value",  // Optional: POST data
  "customHeaders": {  // Optional: Custom headers
    "User-Agent": "custom-agent"
  }
}

4. ブラウザアクション（ `scrappey_browser_action` ）

ブラウザ自動化アクションを実行します。

{
  "session": "session_id_here",  // Required: Session ID to use
  "browserActions": [  // Required: Array of actions to perform
    {
      "type": "click",  // Action type: click, hover, type, scroll, wait
      "cssSelector": ".button",  // CSS selector for element
      "text": "Hello",  // Text to type (for type action)
      "wait": 1000  // Wait time in ms
    }
  ]
}

典型的なワークフロー

セッションを作成します。

{
  "name": "scrappey_create_session"
}

返されたセッション ID を後続のリクエストに使用します。

{
  "name": "scrappey_request",
  "cmd": "request.get",
  "url": "https://example.com",
  "session": "returned_session_id"
}

必要に応じてブラウザアクションを実行します。

{
  "name": "scrappey_browser_action",
  "session": "returned_session_id",
  "browserActions": [
    {
      "type": "click",
      "cssSelector": "#login-button"
    },
    {
      "type": "type",
      "cssSelector": "#username",
      "text": "myuser"
    }
  ]
}

完了したらセッションを破棄してクリーンアップします。

{
  "name": "scrappey_destroy_session",
  "session": "returned_session_id"
}

特徴

状態を維持するためのセッション永続性
自動ボット対策処理
カスタムプロキシのサポート
ブラウザ自動化機能
HTTP リクエストメソッド (GET、POST、PUT、DELETE、PATCH)
カスタムヘッダーとCookieのサポート

ベストプラクティス

セッションが終わったら必ず破棄する
同じサイトに複数のリクエストを行うときにセッションを再利用する
より人間らしい行動をとるために、アクション間に適切な待機時間を設ける
使用する前にセッションが存在するかどうかを確認する

エラー処理

何か問題が発生した場合、サーバーは詳細を含むエラーメッセージを返します。よくあるエラーには以下のようなものがあります。

無効なセッションID
ネットワークタイムアウト
ブラウザアクションの無効なセレクタ
ボット対策の失敗

リソース

ライセンス

MITライセンス

Scrappey MCP Server

Integrations

Scrappey MCP サーバー

概要

設定

利用可能なツール

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

2. セッションを破棄する ( `scrappey_destroy_session` )

3. リクエストを送信する ( `scrappey_request` )

4. ブラウザアクション（ `scrappey_browser_action` ）

典型的なワークフロー

特徴

ベストプラクティス

エラー処理

リソース

ライセンス

Integrations

Scrappey MCP サーバー

概要

設定

利用可能なツール

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

2. セッションを破棄する ( scrappey_destroy_session )

3. リクエストを送信する ( scrappey_request )

4. ブラウザアクション（ scrappey_browser_action ）

典型的なワークフロー

特徴

ベストプラクティス

エラー処理

リソース

ライセンス

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

2. セッションを破棄する ( `scrappey_destroy_session` )

3. リクエストを送信する ( `scrappey_request` )

4. ブラウザアクション（ `scrappey_browser_action` ）