ScreenshotOne

Servidor MCP de ScreenshotOne

Una implementación oficial de un servidor MCP (Model Context Protocol) para ScreenshotOne.

Algunas palabras más sobre por qué se creó y algunas reflexiones sobre el futuro de MCP.

ScreenshotOne también ofrece un servidor MCP oficial alojado. Consulta la integración de ScreenshotOne MCP para obtener instrucciones de configuración y las últimas novedades.

Herramientas

• render-website-screenshot: Captura una imagen de un sitio web y devuelve las URL temporales de la captura, el contenido y los fragmentos, según se solicite.
• render-website-screenshot-as-file: Captura una imagen de un sitio web o un PDF y devuelve el archivo en sí, incrustado en la respuesta como recurso MCP, junto con una URL temporal.
• extract-website-markdown: Procesa un sitio web y devuelve directamente su contenido Markdown depurado como texto.
• get-usage: Consulta la cuota de la API de ScreenshotOne y el uso de concurrencia.

La herramienta de captura de pantalla ofrece estas opciones específicas:

• url
• block_banners (el valor predeterminado es true)
• block_ads (el valor predeterminado es true)
• image_quality (el valor predeterminado es 80)
• full_page (el valor predeterminado es false)
• full_page_slices (el valor predeterminado es false; requiere full_page=true)
• metadata_content (el valor predeterminado es false)
• metadata_content_format (html o markdown; requiere metadata_content=true)

Los nombres y valores de las opciones para el contenido de metadatos y los fragmentos de página completa coinciden con los de la API de ScreenshotOne. La herramienta no ofrece controles de tipo de respuesta ni de caché; siempre solicita una respuesta JSON con la caché de la API desactivada.

Configura metadata_content=true y metadata_content_format=markdown para recibir una URL temporal del contenido Markdown junto con la captura de pantalla. Configura full_page=true y full_page_slices=true para recibir URL de capturas de pantalla verticales más pequeñas. Se prefieren los fragmentos cuando un agente de IA necesita analizar una página larga que quizá no pueda procesarse de forma fiable como una sola imagen grande.

Una captura correcta devuelve las URL solicitadas como texto y contenido estructurado:

{
    "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>/..."
        }
    ]
}

Las URL son temporales. La URL de la captura de pantalla está disponible durante un máximo de cuatro horas, mientras que el contenido de metadatos incluye su hora exacta de vencimiento. Descarga los archivos que quieras conservar.

render-website-screenshot-as-file está pensada para clientes que necesitan el archivo en sí, por ejemplo, para guardarlo o adjuntarlo, o que no pueden descargar enlaces. Acepta url, format (jpg de forma predeterminada, png, webp, gif, jp2, tiff, avif, heif o pdf), block_banners, block_ads, image_quality, full_page y full_page_max_height (requiere full_page=true). Devuelve el archivo como recurso incrustado (type: "resource" con un blob en base64 y su tipo MIME), además de su nombre, URI, tipo MIME, tamaño y URL temporal como texto y contenido estructurado. Los archivos de más de 5 MB no se incrustan; la herramienta devuelve un error que sugiere usar un formato, una calidad o una altura menores, e incluye la URL temporal.

extract-website-markdown solo acepta url. Es un acceso directo específico a la solicitud de la API format=markdown de ScreenshotOne y devuelve el Markdown resultante directamente en una única respuesta de texto MCP. Úsala cuando el agente necesite leer o analizar el contenido de una página sin una captura de pantalla.

Uso

Compilar

Instala siempre las dependencias y compílalo primero:

npm install && npm run build

Obtener tu clave de API de ScreenshotOne

Regístrate en ScreenshotOne y obtén tu clave de API.

Ejecutar con npx

Ejecuta la CLI directamente desde el paquete npm sin clonar el repositorio:

SCREENSHOTONE_API_KEY=your_api_key npx --yes @screenshotone/mcp

Con Claude para Desktop

Añade lo siguiente a tu ~/Library/Application\ Support/Claude/claude_desktop_config.json:

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

Independiente o para otros proyectos

SCREENSHOTONE_API_KEY=your_api_key node build/index.js

Licencia

ScreenshotOne MCP Server está bajo la Licencia MIT.