Skip to main content
Glama
enesjakozh

Scrappey MCP Server

by pim97
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Remote

Scrappey MCP Server

A Model Context Protocol (MCP) server for interacting with Scrappey.com's web automation and scraping capabilities. Try it out directly at smithery.ai/server/@pim97/mcp-server-scrappey.

Overview

This MCP server provides a bridge between AI models and Scrappey's web automation platform, allowing you to:

  • Create and manage browser sessions

  • Send HTTP requests through Scrappey's infrastructure

  • Execute browser actions (clicking, typing, scrolling, etc.)

  • Handle various anti-bot protections automatically

Related MCP server: Prysm MCP Server

Setup

  1. Get your Scrappey API key from Scrappey.com

  2. Set up your environment variable:

SCRAPPEY_API_KEY=your_api_key_here

Available Tools

1. Create Session (scrappey_create_session)

Creates a new browser session that persists cookies and other state.

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

2. Destroy Session (scrappey_destroy_session)

Properly closes a browser session.

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

3. Send Request (scrappey_request)

Send HTTP requests through the Scrappey infrastructure.

{ "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. Browser Actions (scrappey_browser_action)

Execute browser automation actions.

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

Typical Workflow

  1. Create a session:

{ "name": "scrappey_create_session" }

  1. Use the returned session ID for subsequent requests:

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

  1. Perform browser actions if needed:

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

  1. Clean up by destroying the session when done:

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

Features

  • Session persistence for maintaining state

  • Automatic anti-bot protection handling

  • Support for custom proxies

  • Browser automation capabilities

  • HTTP request methods (GET, POST, PUT, DELETE, PATCH)

  • Custom headers and cookies support

Best Practices

  1. Always destroy sessions when you're done with them

  2. Reuse sessions when making multiple requests to the same site

  3. Use appropriate wait times between actions for more human-like behavior

  4. Check if a session exists before using it

Error Handling

The server will return error messages with details when something goes wrong. Common errors include:

  • Invalid session IDs

  • Network timeouts

  • Invalid selectors for browser actions

  • Anti-bot protection failures

Resources

License

MIT License

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

Resources

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/pim97/mcp-server-scrappey'

If you have feedback or need assistance with the MCP directory API, please join our Discord server