CurlShot

Permite que tu agente de IA capture pantallas de cualquier página web: página completa, móvil, modo oscuro, PDF o video. Servidor MCP remoto para la API de capturas de pantalla de CurlShot.

GitHub

Servidor MCP alojado

npx add-mcp 'https://curlshot.com/api/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Servidor MCP de CurlShot

Permite que tu agente de IA tome capturas de pantalla de páginas web. CurlShot ejecuta un servidor alojado de Model Context Protocol, por lo que no hay nada que instalar: apunta tu cliente MCP al endpoint y añade tu clave de API.

https://curlshot.com/api/mcp
  • Transporte: HTTP transmisible (JSON-RPC 2.0 sobre POST). El servidor no tiene estado, por lo que un GET responde a 405.
  • Autenticación: Authorization: Bearer YOUR_API_KEY
  • Versiones de protocolo: 2025-06-18, 2025-03-26, 2024-11-05

Este repositorio contiene la documentación, el manifiesto server.json (formato del Registro MCP) y la licencia. El servidor en sí se ejecuta en curlshot.com.

Herramientas

HerramientaQué hace¿Necesita clave?
take_screenshotRenderiza una página web pública y la devuelve como imagen, PDF o video del desplazamiento de la página. Cada llamada exitosa usa una captura de tu cuota. Los aciertos de caché y los renderizados fallidos son gratuitos.Sí
list_devicesLista los ajustes predefinidos de dispositivos (teléfonos, tabletas, escritorios) que take_screenshot acepta en viewport_device.No

Argumentos de take_screenshot:

ArgumentoSignificado
url (obligatorio)Dirección completa de la página, que comienza con http:// o https://.
formatpng, jpeg (predeterminado), webp, pdf, mp4, webm o gif. Los formatos de video graban el desplazamiento de la página de arriba a abajo, en los planes que incluyen video.
full_pageCaptura toda la página, no solo la primera pantalla.
viewport_deviceUn ajuste predefinido de dispositivo como iphone_15_pro (consulta list_devices).
viewport_width, viewport_heightTamaño de la ventana del navegador en píxeles (predeterminado 1280 x 1024).
dark_modeSolicita a la página su tema oscuro.
block_ads, block_cookie_bannersActivados por predeterminado.
selectorCaptura solo el primer elemento que coincida con este selector CSS.
wait_until, delayCuándo la página se considera cargada, más segundos adicionales de espera.
cacheReutiliza una copia almacenada de la misma solicitud.

Los resultados pequeños se devuelven en línea como una imagen que el modelo puede ver. Los resultados de más de 6 MB se devuelven como un enlace de descarga válido durante aproximadamente un día.

Obtén una clave de API

  1. Regístrate en curlshot.com/register. El plan gratuito incluye 100 capturas al mes, sin necesidad de tarjeta.
  2. Crea una clave de API separada para tu agente en el panel de control, para que puedas revocarla de forma independiente.
  3. Deja desactivada la opción Requerir firma para esa clave. Las llamadas MCP no están firmadas.

Guarda la clave en la configuración de tu cliente, no en un prompt. Los ejemplos siguientes usan YOUR_API_KEY como marcador de posición.

Configuración del cliente

Claude Code

claude mcp add --transport http curlshot https://curlshot.com/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Claude Desktop

Claude Desktop inicia servidores locales (stdio) desde su archivo de configuración, así que conéctate a través del proxy mcp-remote. Edita claude_desktop_config.json (Configuración → Desarrollador → Editar configuración):

{
  "mcpServers": {
    "curlshot": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://curlshot.com/api/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

Reinicia Claude Desktop después de guardar. Esto requiere Node.js.

Cursor

Añade a ~/.cursor/mcp.json (todos los proyectos) o .cursor/mcp.json (un proyecto):

{
  "mcpServers": {
    "curlshot": {
      "url": "https://curlshot.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

VS Code (GitHub Copilot)

Añade a .vscode/mcp.json. VS Code solicita la clave una vez y la almacena de forma segura:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "curlshot-api-key",
      "description": "CurlShot API key",
      "password": true
    }
  ],
  "servers": {
    "curlshot": {
      "type": "http",
      "url": "https://curlshot.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:curlshot-api-key}"
      }
    }
  }
}

Otros clientes

Cualquier cliente que admita servidores remotos sobre HTTP transmisible funciona. La mayoría acepta una configuración como esta:

{
  "mcpServers": {
    "curlshot": {
      "type": "http",
      "url": "https://curlshot.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Los clientes que solo inician servidores locales pueden usar el comando mcp-remote que se muestra para Claude Desktop.

Pruébalo con curl

curl -X POST "https://curlshot.com/api/mcp" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "take_screenshot",
      "arguments": { "url": "https://example.com", "format": "webp" }
    }
  }'

Límites y precios

  • Plan gratuito: 100 capturas al mes, sin tarjeta. Los planes de pago comienzan en $19 al mes. Consulta precios.
  • Solo cuentan los renderizados exitosos. Los aciertos de caché y los renderizados fallidos son gratuitos.
  • El endpoint MCP acepta 120 solicitudes por minuto por dirección IP, además de los límites propios de tu plan.
  • Cuando se alcanza el límite mensual, la herramienta devuelve un error con un enlace de actualización en lugar de una imagen.

Enlaces

Licencia

MIT