Urlbox Full Page Screenshots
oficialUm 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
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/mcpe faça login no Urlbox. -
ChatGPT: adicione um conector com a URL
https://api.urlbox.com/mcpe faça login no Urlbox. -
Claude Code:
claude mcp add --transport http urlbox https://api.urlbox.com/mcp, depois execute/mcppara fazer login. -
Codex:
codex mcp add urlbox --url https://api.urlbox.com/mcp, depoiscodex mcp login urlboxpara 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ável | Descrição |
|---|---|
URLBOX_API_KEY | Sua chave de API de organização ou chave secreta de projeto. |
SECRET_KEY | Também aceita, para configurações escritas para 1.x. URLBOX_API_KEY tem prioridade se ambos estiverem definidos. |
URLBOX_DOWNLOAD_DIR | Onde 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.
renderainda está lá. A opçãostore_renderse a ferramentadownloadsão substituídas porsave_render.- Os arquivos são salvos em
~/Downloadsem vez de~/Downloads/urlbox-renders. DefinaURLBOX_DOWNLOAD_DIRpara 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
- Tire um screenshot de https://example.com sem anúncios ou banners de cookies.
- Salve https://urlbox.com como um PDF com marcadores e sumário e baixe para o meu computador.
- Transforme este artigo em markdown: https://example.com/blog/post
- Como https://example.com fica em um celular?
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
