Scrappey MCP Server

by pim97
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Allows selection of HTML elements using CSS selectors for browser automation actions like clicking, hovering, typing, and scrolling.

  • Enables creation and management of persistent browser sessions that maintain cookies and state across multiple requests and actions.

Servidor MCP de Scrappey

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con las funciones de automatización web y scraping de Scrappey.com. Pruébelo directamente en smithery.ai/server/@pim97/mcp-server-scrappey .

Descripción general

Este servidor MCP proporciona un puente entre los modelos de IA y la plataforma de automatización web de Scrappey, lo que le permite:

  • Crear y administrar sesiones del navegador
  • Enviar solicitudes HTTP a través de la infraestructura de Scrappey
  • Ejecutar acciones del navegador (hacer clic, escribir, desplazarse, etc.)
  • Manejar varias protecciones anti-bot automáticamente

Configuración

  1. Obtén tu clave API de Scrappey en Scrappey.com
  2. Configure su variable de entorno:
SCRAPPEY_API_KEY=your_api_key_here

Herramientas disponibles

1. Crear sesión ( scrappey_create_session )

Crea una nueva sesión de navegador que conserva las cookies y otros estados.

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

2. Destruir sesión ( scrappey_destroy_session )

Cierra correctamente una sesión del navegador.

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

3. Enviar solicitud ( scrappey_request )

Envía solicitudes HTTP a través de la infraestructura de Scrappey.

{ "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. Acciones del navegador ( scrappey_browser_action )

Ejecutar acciones de automatización del navegador.

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

Flujo de trabajo típico

  1. Crear una sesión:
{ "name": "scrappey_create_session" }
  1. Utilice el ID de sesión devuelto para solicitudes posteriores:
{ "name": "scrappey_request", "cmd": "request.get", "url": "https://example.com", "session": "returned_session_id" }
  1. Realice acciones del navegador si es necesario:
{ "name": "scrappey_browser_action", "session": "returned_session_id", "browserActions": [ { "type": "click", "cssSelector": "#login-button" }, { "type": "type", "cssSelector": "#username", "text": "myuser" } ] }
  1. Limpiar destruyendo la sesión cuando haya terminado:
{ "name": "scrappey_destroy_session", "session": "returned_session_id" }

Características

  • Persistencia de la sesión para mantener el estado
  • Manejo automático de protección anti-bots
  • Soporte para proxies personalizados
  • Capacidades de automatización del navegador
  • Métodos de solicitud HTTP (GET, POST, PUT, DELETE, PATCH)
  • Soporte para encabezados personalizados y cookies

Mejores prácticas

  1. Destruye siempre las sesiones cuando hayas terminado con ellas
  2. Reutilizar sesiones al realizar múltiples solicitudes al mismo sitio
  3. Utilice tiempos de espera adecuados entre acciones para lograr un comportamiento más humano
  4. Comprueba si existe una sesión antes de usarla

Manejo de errores

El servidor devolverá mensajes de error con detalles cuando algo salga mal. Los errores comunes incluyen:

  • ID de sesión no válidos
  • Tiempos de espera de la red
  • Selectores no válidos para acciones del navegador
  • Fallos de protección anti-bots

Recursos

Licencia

Licencia MIT

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

Un servidor que conecta los modelos de IA con la plataforma de automatización web de Scrappey, lo que permite la creación de sesiones de navegador, la ejecución de solicitudes HTTP y la automatización de las acciones del navegador mientras se manejan las protecciones anti-bots.

  1. Overview
    1. Setup
      1. Available Tools
        1. 1. Create Session (scrappey_create_session)
        2. 2. Destroy Session (scrappey_destroy_session)
        3. 3. Send Request (scrappey_request)
        4. 4. Browser Actions (scrappey_browser_action)
      2. Typical Workflow
        1. Features
          1. Best Practices
            1. Error Handling
              1. Resources
                1. License
                  ID: wlt8ef3tcu