Urlbox Full Page Screenshots

oficial

Um servidor MCP para a API de Screenshot do Urlbox. Ele permite que seu cliente tire screenshots, gere PDFs, extraia HTML/markdown e muito mais de sites.

O que você pode fazer com Urlbox Full Page Screenshots MCP?

  • Capturar capturas de tela de página inteira — Solicite uma captura de tela de qualquer URL, com opções para bloquear anúncios ou banners de cookies.
  • Gerar PDFs e vídeos — Solicite um PDF com marcadores ou uma renderização em vídeo de uma página, salva localmente via save_render.
  • Extrair conteúdo da página — Converta qualquer artigo ou página da web em markdown limpo, HTML ou texto simples do artigo.
  • Comparar versões de página — Peça para comparar visualmente duas URLs ou capturar como um site aparece em uma viewport de celular.
  • Gerenciar recursos do Urlbox — Com uma chave de organização, crie ou atualize projetos, inspecione webhooks e revise o uso da conta.

Documentação

Servidor MCP de Screenshots Urlbox

image

Dê ao seu assistente de IA um navegador real para capturas de tela de sites. O servidor MCP Urlbox tira screenshots, gera PDFs e vídeos, extrai HTML, markdown e texto de artigos, compara páginas e gerencia seus projetos, webhooks e uso do Urlbox.

Use o servidor hospedado (recomendado)

Conecte seu cliente a https://api.urlbox.com/mcp. Nada para instalar.

  • Claude (claude.ai e desktop): Configurações, Conectores, Adicionar conector personalizado, insira https://api.urlbox.com/mcp e faça login no Urlbox.

  • ChatGPT: adicione um conector com a URL https://api.urlbox.com/mcp e faça login no Urlbox.

  • Claude Code: claude mcp add --transport http urlbox https://api.urlbox.com/mcp, depois execute /mcp para fazer login.

  • Codex: codex mcp add urlbox --url https://api.urlbox.com/mcp, depois codex mcp login urlbox para fazer login.

  • Cursor: adicione isto a ~/.cursor/mcp.json:

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

Clientes que não conseguem fazer login podem enviar uma chave de API como Authorization: Bearer <key>. Uma chave de API de organização (ubx_org_...) desbloqueia todas as ferramentas. Uma chave secreta de projeto funciona apenas para as ferramentas de renderização. Encontre suas chaves no painel do Urlbox.

Ponte local (este pacote)

Alguns clientes só conseguem iniciar servidores locais. Este pacote é uma pequena ponte local: ele roda na sua máquina via stdio e encaminha tudo para o servidor hospedado, então você tem exatamente as mesmas ferramentas, sempre atualizadas.

{
  "mcpServers": {
    "urlbox": {
      "command": "npx",
      "args": ["-y", "@urlbox/screenshot-mcp"],
      "env": {
        "URLBOX_API_KEY": "your_api_key_here"
      }
    }
  }
}

Requer Node.js 20 ou posterior.

VariávelDescrição
URLBOX_API_KEYSua chave de API de organização ou chave secreta de projeto.
SECRET_KEYTambém aceita, para configurações escritas para 1.x. URLBOX_API_KEY tem prioridade se ambos estiverem definidos.
URLBOX_DOWNLOAD_DIROnde save_render salva arquivos. O padrão é ~/Downloads.

A ponte adiciona uma ferramenta local, save_render, que baixa uma URL de renderização retornada por qualquer ferramenta Urlbox e a salva no seu computador. Basta pedir, por exemplo, "tire um screenshot de example.com e salve no meu computador". Arquivos existentes nunca são sobrescritos.

Atualizando da versão 1.x

Sua configuração existente continua funcionando: SECRET_KEY ainda é lido e o nome do pacote e o comando permanecem inalterados.

  • As ferramentas agora vêm do servidor hospedado, então há muito mais delas, e elas continuam melhorando sem necessidade de atualização.
  • render ainda está lá. A opção store_renders e a ferramenta download são substituídas por save_render.
  • Os arquivos são salvos em ~/Downloads em vez de ~/Downloads/urlbox-renders. Defina URLBOX_DOWNLOAD_DIR para manter o local antigo.
  • Com uma chave secreta de projeto, você obtém as ferramentas de renderização. Use uma chave de API de organização para também gerenciar projetos, webhooks e uso.
  • Node.js 20 ou posterior é necessário.

Exemplos de comandos

Desenvolvimento

npm install
npm test

Os testes executam a ponte contra um servidor falso local, então não precisam de uma conta Urlbox.

Licença

MIT