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
- Obtén tu clave API de Scrappey en Scrappey.com
- 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
- Crear una sesión:
{
"name": "scrappey_create_session"
}
- Utilice el ID de sesión devuelto para solicitudes posteriores:
{
"name": "scrappey_request",
"cmd": "request.get",
"url": "https://example.com",
"session": "returned_session_id"
}
- 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"
}
]
}
- 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
- Destruye siempre las sesiones cuando hayas terminado con ellas
- Reutilizar sesiones al realizar múltiples solicitudes al mismo sitio
- Utilice tiempos de espera adecuados entre acciones para lograr un comportamiento más humano
- 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