CurlShot

Deixe seu agente de IA capturar telas de qualquer página da web: página inteira, mobile, modo escuro, PDF ou vídeo. Servidor MCP remoto para a API de captura de telas CurlShot.

GitHub

Servidor MCP hospedado

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

Instala no Claude Code, Codex, Cursor e outros

Documentação

Servidor MCP CurlShot

Deixe seu agente de IA tirar capturas de tela de páginas da web. O CurlShot executa um servidor Model Context Protocol hospedado, então não há nada para instalar: aponte seu cliente MCP para o endpoint e adicione sua chave de API.

https://curlshot.com/api/mcp

Transporte: HTTP streamable (JSON-RPC 2.0 sobre POST). O servidor não tem estado, então um GET responde a 405.
Autenticação: Authorization: Bearer YOUR_API_KEY
Versões do protocolo: 2025-06-18, 2025-03-26, 2024-11-05

Este repositório contém a documentação, o manifesto server.json (formato do MCP Registry) e a licença. O servidor em si roda em curlshot.com.

Ferramentas

Ferramenta	O que faz	Precisa de chave
`take_screenshot`	Renderiza uma página da web pública e a retorna como imagem, PDF ou vídeo da página rolando. Cada chamada bem-sucedida usa uma captura de tela da sua cota. Acertos de cache e renderizações com falha são gratuitos.	Sim
`list_devices`	Lista os presets de dispositivos (celulares, tablets, desktops) que o `take_screenshot` aceita em `viewport_device`.	Não

Argumentos do take_screenshot:

Argumento	Significado
`url` (obrigatório)	Endereço completo da página, começando com `http://` ou `https://`.
`format`	`png`, `jpeg` (padrão), `webp`, `pdf`, `mp4`, `webm` ou `gif`. Os formatos de vídeo gravam a página rolando de cima para baixo, nos planos que incluem vídeo.
`full_page`	Capturar a página inteira, não apenas a primeira tela.
`viewport_device`	Um preset de dispositivo como `iphone_15_pro` (veja `list_devices`).
`viewport_width`, `viewport_height`	Tamanho da janela do navegador em pixels (padrão 1280 x 1024).
`dark_mode`	Pedir à página o tema escuro.
`block_ads`, `block_cookie_banners`	Ativados por padrão.
`selector`	Capturar apenas o primeiro elemento que corresponda a este seletor CSS.
`wait_until`, `delay`	Quando a página é considerada carregada, mais segundos extras de espera.
`cache`	Reutilizar uma cópia armazenada da mesma solicitação.

Resultados pequenos voltam inline como uma imagem que o modelo pode ver. Resultados acima de 6 MB voltam como um link de download válido por cerca de um dia.

Obtenha uma chave de API

Cadastre-se em curlshot.com/register. O plano gratuito inclui 100 capturas de tela por mês, sem necessidade de cartão.
Crie uma chave de API separada para seu agente no painel, para que você possa revogá-la de forma independente.
Deixe Exigir assinatura desativado para essa chave. Chamadas MCP não são assinadas.

Mantenha a chave na configuração do seu cliente, não em um prompt. Os exemplos abaixo usam YOUR_API_KEY como espaço reservado.

Configuração do cliente

Claude Code

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

Claude Desktop

O Claude Desktop inicia servidores locais (stdio) a partir do arquivo de configuração, então conecte-se por meio do proxy mcp-remote. Edite claude_desktop_config.json (Configurações → Desenvolvedor → Editar Config):

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

Reinicie o Claude Desktop após salvar. Isso requer Node.js.

Cursor

Adicione a ~/.cursor/mcp.json (todos os projetos) ou .cursor/mcp.json (um projeto):

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

VS Code (GitHub Copilot)

Adicione a .vscode/mcp.json. O VS Code pede a chave uma vez e a armazena com segurança:

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

Outros clientes

Qualquer cliente que suporte servidores remotos via HTTP streamable funciona. A maioria aceita uma configuração como esta:

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

Clientes que só iniciam servidores locais podem usar o comando mcp-remote mostrado para o Claude Desktop.

Experimente com 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" }
    }
  }'

Limites e preços

Plano gratuito: 100 capturas de tela por mês, sem cartão. Planos pagos começam em US$ 19 por mês. Veja preços.
Apenas renderizações bem-sucedidas contam. Acertos de cache e renderizações com falha são gratuitos.
O endpoint MCP aceita 120 solicitações por minuto por endereço IP, além dos limites do seu próprio plano.
Quando o limite mensal é atingido, a ferramenta retorna um erro com um link de upgrade em vez de uma imagem.

Licença

MIT