ScreenshotOne

ScreenshotOne MCP Server

Uma implementação oficial de um servidor MCP (Model Context Protocol) para ScreenshotOne.

Mais algumas palavras sobre por que ele foi criado e algumas reflexões sobre o futuro do MCP.

O ScreenshotOne também oferece um servidor MCP oficial hospedado. Consulte a integração do ScreenshotOne MCP para ver as instruções de configuração e as atualizações mais recentes.

Ferramentas

• render-website-screenshot: Captura uma tela de um site e retorna URLs temporárias da captura, do conteúdo e dos recortes, conforme solicitado.
• render-website-screenshot-as-file: Captura uma tela de um site ou PDF e retorna o próprio arquivo, incorporado na resposta como um recurso MCP, com uma URL temporária.
• render-html-screenshot-as-file: Captura HTML que você escreve ou recebe, como um cartão para redes sociais ou um gráfico, e retorna a captura como uma imagem em linha que o agente pode visualizar, com o nome e o tamanho do arquivo.
• extract-website-markdown: Acessa um site e retorna o Markdown limpo diretamente como texto.
• get-usage: Consulta o uso de cota e de concorrência da API do ScreenshotOne.

A ferramenta de captura de tela oferece estas opções específicas:

• url
• block_banners (o padrão é true)
• block_ads (o padrão é true)
• image_quality (o padrão é 80)
• full_page (o padrão é false)
• full_page_slices (o padrão é false; requer full_page=true)
• metadata_content (o padrão é false)
• metadata_content_format (html ou markdown; requer metadata_content=true)

Os nomes e valores das opções para conteúdo de metadados e recortes de página inteira correspondem aos da API do ScreenshotOne. A ferramenta não oferece controles de tipo de resposta nem de cache; ela sempre solicita uma resposta JSON com o cache da API desativado.

Defina metadata_content=true e metadata_content_format=markdown para receber uma URL temporária do conteúdo em Markdown junto com a captura de tela. Defina full_page=true e full_page_slices=true para receber URLs de capturas de tela verticais menores. Os recortes são preferíveis quando um agente de IA precisa analisar uma página longa que talvez não possa ser processada de forma confiável como uma única imagem grande.

Uma captura bem-sucedida retorna as URLs solicitadas como texto e conteúdo estruturado:

{
    "url": "https://<screenshotone-cache-domain>/...",
    "content": {
        "url": "https://<screenshotone-cache-domain>/...",
        "expires": "Sun, 07 Sep 2026 12:00:00 GMT",
        "format": "markdown"
    },
    "slices": [
        {
            "index": 0,
            "offset_y": 0,
            "width": 1280,
            "height": 4000,
            "url": "https://<screenshotone-cache-domain>/..."
        }
    ]
}

As URLs são temporárias. A URL da captura de tela fica disponível por até quatro horas, enquanto o conteúdo dos metadados inclui o horário exato de expiração. Baixe os artefatos que quiser guardar.

render-website-screenshot-as-file é para clientes que precisam do próprio arquivo, por exemplo, para salvá-lo ou anexá-lo, ou que não conseguem baixar links. Aceita url, format (jpg por padrão, png, webp, gif, jp2, tiff, avif, heif ou pdf), block_banners, block_ads, image_quality, full_page e full_page_max_height (requer full_page=true). Retorna o arquivo como um recurso incorporado (type: "resource" com um blob em base64 e seu tipo MIME), além do nome, URI, tipo MIME, tamanho e URL temporária como texto e conteúdo estruturado. Arquivos maiores que 5 MB não são incorporados; a ferramenta retorna um erro que sugere um formato, uma qualidade ou uma altura menor e inclui a URL temporária.

render-html-screenshot-as-file renderiza o HTML enviado na chamada, como um cartão para redes sociais, um gráfico ou um relatório, para que o agente receba uma imagem sem executar um navegador. Aceita html (obrigatório, até 1.000.000 de caracteres, enviado exatamente como fornecido), viewport_width (320–3840, o padrão é 1280; use a largura para a qual o HTML foi projetado), full_page (o padrão é true) e image_quality (o padrão é 80). O HTML é enviado à API no corpo de uma solicitação JSON POST, e a API retorna o JPEG diretamente, sem URL temporária. A ferramenta o retorna como uma imagem em linha (type: "image" com data em base64), além do nome, tipo MIME e tamanho como texto e conteúdo estruturado. Imagens maiores que 5 MB não são retornadas; o erro sugere uma qualidade menor ou full_page=false.

extract-website-markdown aceita apenas url. É um atalho específico para a solicitação à API format=markdown do ScreenshotOne e retorna o Markdown resultante diretamente em uma única resposta de texto MCP. Use-o quando o agente precisar ler ou analisar o conteúdo de uma página sem uma captura de tela.

Uso

Compilar

Sempre instale as dependências e compile primeiro:

npm install && npm run build

Obter sua chave de API do ScreenshotOne

Cadastre-se no ScreenshotOne e obtenha sua chave de API.

Executar com npx

Execute a CLI diretamente do pacote npm sem clonar o repositório:

SCREENSHOTONE_API_KEY=your_api_key npx --yes @screenshotone/mcp

Com o Claude para Desktop

Adicione o seguinte ao seu ~/Library/Application\ Support/Claude/claude_desktop_config.json:

{
    "mcpServers": {
        "screenshotone": {
            "command": "npx",
            "args": ["--yes", "@screenshotone/mcp"],
            "env": {
                "SCREENSHOTONE_API_KEY": "<your api key>"
            }
        }
    }
}

Independente ou para outros projetos

SCREENSHOTONE_API_KEY=your_api_key node build/index.js

Licença

ScreenshotOne MCP Server está licenciado sob a Licença MIT.