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ライセンス