scrape-do-mcp

scrape-do-mcp

中文文档 | English

Un servidor MCP que envuelve las APIs documentadas de Scrape.do en un solo paquete: la API principal de scraping, la API de Búsqueda de Google, la API de Amazon Scraper, la API Async y un asistente de configuración del Modo Proxy.

Documentación oficial: https://scrape.do/documentation/

Cobertura

• scrape_url: API principal de Scrape.do con renderizado JS, segmentación geográfica, persistencia de sesión, capturas de pantalla, ReturnJSON, interacciones con el navegador, cookies y reenvío de encabezados.
• google_search: API estructurada de SERP de Google con google_domain, location, uule, lr, cr, safe, nfpr, filter, paginación y HTML sin procesar opcional.
• amazon_product: Endpoint de PDP de Amazon.
• amazon_offer_listing: Endpoint de listado de ofertas de Amazon.
• amazon_search: Endpoint de búsqueda/categoría de Amazon.
• amazon_raw_html: Endpoint de Amazon con HTML sin procesar y segmentación geográfica.
• async_create_job, async_get_job, async_get_task, async_list_jobs, async_cancel_job, async_get_account: Cobertura de la API Async con alias compatibles con MCP y nombres de campos oficiales.
• proxy_mode_config: Construye detalles de conexión oficiales del Modo Proxy, cadenas de parámetros predeterminadas y referencias de certificados CA.

Notas de Compatibilidad

• scrape_url admite tanto alias compatibles con MCP como nombres de parámetros oficiales:
  • render_js o render
  • super_proxy o super
  • screenshot o screenShot
• google_search admite:
  • query o q
  • country o gl
  • language o hl
  • domain o google_domain
  • includeHtml o include_html
• async_create_job acepta tanto campos de alias como targets, render, webhookUrl como campos oficiales de la API Async como Targets, Render, WebhookURL.
• async_get_job, async_get_task y async_cancel_job aceptan tanto jobId/taskId como los oficiales jobID/taskID.
• async_list_jobs acepta tanto pageSize como el oficial page_size.
• Para el reenvío de encabezados en scrape_url, pase headers más header_mode (custom, extra o forward).
• Las respuestas de capturas de pantalla conservan el cuerpo JSON oficial de Scrape.do y también adjuntan contenido de imagen MCP cuando hay capturas de pantalla presentes.
• scrape_url ahora tiene como valor predeterminado output="raw" para coincidir más estrechamente con la API oficial.
• scrape_url incluye metadatos de respuesta en structuredContent, lo que ayuda a exponer pureCookies, transparentResponse y respuestas binarias dentro de MCP.

Instalación

Instalación Rápida

claude mcp add-json scrape-do --scope user '{
  "type": "stdio",
  "command": "npx",
  "args": ["-y", "scrape-do-mcp"],
  "env": {
    "SCRAPE_DO_TOKEN": "YOUR_TOKEN_HERE"
  }
}'

Claude Desktop

Agregue esto a ~/.claude.json:

{
  "mcpServers": {
    "scrape-do": {
      "command": "npx",
      "args": ["-y", "scrape-do-mcp"],
      "env": {
        "SCRAPE_DO_TOKEN": "YOUR_TOKEN_HERE"
      }
    }
  }
}

Obtenga su token en https://app.scrape.do

Herramientas Disponibles

Herramienta	Propósito
scrape_url	Envoltorio principal de la API de scraping de Scrape.do
google_search	Resultados estructurados de búsqueda de Google
amazon_product	Datos estructurados de PDP de Amazon
amazon_offer_listing	Ofertas de vendedores de Amazon
amazon_search	Resultados de palabras clave/categorías de Amazon
amazon_raw_html	HTML sin procesar de Amazon con segmentación geográfica
async_create_job	Crear trabajos de la API Async
async_get_job	Obtener detalles de trabajos Async
async_get_task	Obtener detalles de tareas Async
async_list_jobs	Listar trabajos Async
async_cancel_job	Cancelar trabajos Async
async_get_account	Obtener información de cuenta/concurrencia de Async
proxy_mode_config	Generar configuración del Modo Proxy

Ejemplos de Prompts

Scrape https://example.com with render=true and wait for #app.

Search Google for "open source MCP servers" with google_domain=google.co.uk and lr=lang_en.

Get the Amazon PDP for ASIN B0C7BKZ883 in the US with zipcode 10001.

Create an async job for these 20 URLs and give me the job ID.

Desarrollo

npm install
npm run build
npm run dev

Licencia

MIT