ScreenshotOne

Servidor MCP do ScreenshotOne

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

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

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

Ferramentas

• render-website-screenshot: Renderiza um screenshot de um site e retorna URLs temporárias de screenshot, conteúdo e fatias, conforme solicitado.
• extract-website-markdown: Renderiza um site e retorna seu Markdown limpo diretamente como texto.
• get-usage: Obtém a cota da API do ScreenshotOne e o uso de concorrência.

A ferramenta de screenshot expõe estas opções focadas:

• url
• block_banners (padrão: true)
• block_ads (padrão: true)
• image_quality (padrão: 80)
• full_page (padrão: false)
• full_page_slices (padrão: false; requer full_page=true)
• metadata_content (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 fatias de página inteira correspondem à API do ScreenshotOne. A ferramenta não expõe controles de tipo de resposta ou cache; ela sempre solicita uma resposta JSON com o cache da API desabilitado.

Defina metadata_content=true e metadata_content_format=markdown para receber uma URL temporária de conteúdo Markdown junto com o screenshot. Defina full_page=true e full_page_slices=true para receber URLs menores de screenshots verticais. As fatias são preferidas quando um agente de IA precisa analisar uma página longa que pode não 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 do screenshot fica disponível por até quatro horas, enquanto o conteúdo de metadados inclui seu horário exato de expiração. Baixe qualquer artefato que precise manter.

extract-website-markdown aceita apenas url. É um atalho focado para a solicitação de 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 um screenshot.

Uso

Compilar

Sempre instale as dependências e compile primeiro:

npm install && npm run build

Obtenha 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 for 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>"
            }
        }
    }
}

Autônomo ou para outros projetos

SCREENSHOTONE_API_KEY=your_api_key node build/index.js

Licença

ScreenshotOne MCP Server é licenciado sob a Licença MIT.