MCP Server Scrappey

🚀 Scrappey MCP Server

The Model Context Protocol (MCP) server that interacts with Scrappey.com's web automation and scraping capabilities. Try it directly on smithery.ai/server/@pim97/mcp-server-scrappey.

🚀 Quick Start

This MCP server bridges the gap between AI models and Scrappey's web automation platform, enabling you to:

• Create and manage browser sessions
• Send HTTP requests through Scrappey's infrastructure
• Perform browser actions (clicking, typing, scrolling, etc.)
• Automatically handle various anti-bot protections

📦 Installation

1. Obtain your Scrappey API key at Scrappey.com.
2. Configure the environment variables:

SCRAPPEY_API_KEY=your_api_key_here

💻 Usage Examples

Basic Usage

Here are the typical steps for using these tools:

1. Create a session: Initialize a new browser session.
2. Send a request: Send an HTTP request through the session.
3. Perform actions: Execute browser actions such as clicking or typing within the session.

Advanced Usage

1. Create Session (scrappey_create_session)

Create a new browser session to persist cookies and other states.

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

2. Destroy Session (scrappey_destroy_session)

Properly close the browser session.

{
  "session": "session_id_here"  // Required: The ID of the session to be destroyed
}

3. Send Request (scrappey_request)

Send an HTTP request through Scrappey's infrastructure.

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

4. Browser Actions (scrappey_browser_action)

Perform browser automation actions.

{
  "session": "session_id_here",  // Required: The ID of the session to use
  "browserActions": [  // Required: An array of actions to perform
    {
      "type": "click",  // Action type: click, hover, type, scroll, wait
      "cssSelector": ".button",  // CSS selector to locate the element
      "text": "Hello",  // Text to input (for type action)
      "wait": 1000  // Waiting time in milliseconds
    }
  ]
}

✨ Features

• Support for creating and destroying browser sessions
• Configuration of network requests through custom proxies
• Support for custom HTTP headers
• Automatic handling of anti-bot protection mechanisms

📚 Documentation

Best Practices

1. Resource Management: Destroy sessions that are no longer in use in a timely manner to free up resources.
2. Error Handling: Catch and handle possible exceptions.
3. Security: Ensure the security of your API key and avoid disclosure.

Frequently Asked Questions

• If you cannot create a session, check if your API key is valid.
• If sending a request fails, verify the target URL and network configuration.

Resources

• Official Documentation: Scrappey Documentation
• Support Contact: support@scrappey.com

📄 License

This project is licensed under the MIT License. Please refer to the LICENSE file for details.