Skip to main content
Glama
Scrappey MCP Server

Scrappey MCP Server

by pim97

Scrappey MCP サーバー

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

概要

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

  • ブラウザセッションの作成と管理

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

  • ブラウザアクション(クリック、入力、スクロールなど)を実行します

  • さまざまなボット対策を自動的に処理

Related MCP server: MCP Operator

設定

  1. Scrappey.comからScrappey APIキーを取得します。

  2. 環境変数を設定します。

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
    }
  ]
}

典型的なワークフロー

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

{
  "name": "scrappey_create_session"
}
  1. 返されたセッション ID を後続のリクエストに使用します。

{
  "name": "scrappey_request",
  "cmd": "request.get",
  "url": "https://example.com",
  "session": "returned_session_id"
}
  1. 必要に応じてブラウザアクションを実行します。

{
  "name": "scrappey_browser_action",
  "session": "returned_session_id",
  "browserActions": [
    {
      "type": "click",
      "cssSelector": "#login-button"
    },
    {
      "type": "type",
      "cssSelector": "#username",
      "text": "myuser"
    }
  ]
}
  1. 完了したらセッションを破棄してクリーンアップします。

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

特徴

  • 状態を維持するためのセッション永続性

  • 自動ボット対策処理

  • カスタムプロキシのサポート

  • ブラウザ自動化機能

  • HTTP リクエストメソッド (GET、POST、PUT、DELETE、PATCH)

  • カスタムヘッダーとCookieのサポート

ベストプラクティス

  1. セッションが終わったら必ず破棄する

  2. 同じサイトに複数のリクエストを行うときにセッションを再利用する

  3. より人間らしい行動をとるために、アクション間に適切な待機時間を設ける

  4. 使用する前にセッションが存在するかどうかを確認する

エラー処理

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

  • 無効なセッションID

  • ネットワークタイムアウト

  • ブラウザアクションの無効なセレクタ

  • ボット対策の失敗

リソース

ライセンス

MITライセンス

Available Tools

7 tools
scrappey_browser_actionC

Execute browser automation actions in a session. Supports clicking, typing, scrolling, waiting, JavaScript execution, captcha solving, and more.

Inputs: session (required), url (required), cmd (required), browserActions (required), +28 more.

scrappey_create_sessionB

Create a new browser session in Scrappey. Sessions persist browser state (cookies, localStorage) across requests.

Inputs: proxy, proxyCountry, premiumProxy, mobileProxy, +4 more.

scrappey_destroy_sessionB

Destroy an existing browser session in Scrappey to free resources

Inputs: session (required).

scrappey_list_sessionsB

List all active sessions for the current user

Inputs: no named parameters.

scrappey_requestC

Send an HTTP request using Scrappey with antibot bypass capabilities. Supports GET, POST, PUT, DELETE, PATCH methods.

Inputs: cmd (required), url (required), session, postData, +37 more.

scrappey_screenshotC

Take a screenshot of a webpage. Optionally execute browser actions before capturing.

Inputs: url (required), session, screenshotWidth, screenshotHeight, +11 more.

scrappey_session_activeC

Check if a specific session is currently active

Inputs: session (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no ambiguity. scrappey_browser_action handles automation interactions, scrappey_request manages HTTP requests, scrappey_screenshot captures visual content, and the session tools (create, destroy, list, active) each manage specific session lifecycle aspects without overlap.

    Naming Consistency5/5

    All tools follow a perfect 'scrappey_verb_noun' pattern with consistent snake_case throughout. The naming convention is predictable and uniform across all seven tools, making them easily identifiable as part of the same server.

    Tool Count5/5

    Seven tools is well-scoped for a browser automation and web scraping server. Each tool earns its place by covering distinct aspects: session management, browser automation, HTTP requests, and screenshot capabilities without being overwhelming or insufficient.

    Completeness5/5

    The toolset provides complete coverage for browser automation and web scraping workflows. It includes full session lifecycle management (create, destroy, list, check), core automation actions, HTTP requests with antibot bypass, and screenshot functionality, leaving no obvious gaps for the domain.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • -
      license
      Not graded
      quality
      F
      maintenance
      This server provides cloud browser automation capabilities using Browserbase, Puppeteer, and Stagehand. This server enables LLMs to interact with web pages, take screenshots, and execute JavaScript in a cloud browser environment.
      1,489 npm
      3,397
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      A web browser automation server that allows AI assistants to control Chrome with persistent state management, enabling complex browsing tasks through asynchronous browser operations.
      2
      -
    • A
      license
      D
      quality
      D
      maintenance
      AI-driven browser automation server that implements the Model Context Protocol to enable natural language control of web browsers for tasks like navigation, form filling, and visual interaction.
      1
      2
      MIT
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      A server that enables AI assistants to control a browser through tools, allowing them to perform web automation tasks like navigation, typing, clicking, and taking screenshots.
      Apache 2.0