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 construyó y algunas reflexiones sobre el futuro de MCP.

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

Herramientas

• render-website-screenshot: Renderiza una captura de pantalla de un sitio web y devuelve URLs temporales de la captura, el contenido y las secciones según lo solicitado.
• extract-website-markdown: Renderiza un sitio web y devuelve su Markdown limpio directamente como texto.
• get-usage: Obtiene la cuota de la API de ScreenshotOne y el uso de concurrencia.

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

• url
• block_banners (por defecto true)
• block_ads (por defecto true)
• image_quality (por defecto 80)
• full_page (por defecto false)
• full_page_slices (por defecto false; requiere full_page=true)
• metadata_content (por defecto false)
• metadata_content_format (html o markdown; requiere metadata_content=true)

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

Configura metadata_content=true y metadata_content_format=markdown para recibir una URL temporal de contenido Markdown junto con la captura de pantalla. Configura full_page=true y full_page_slices=true para recibir URLs de capturas verticales más pequeñas. Las secciones son preferibles cuando un agente de IA necesita analizar una página larga que podría no manejarse de manera confiable como una sola imagen grande.

Una captura exitosa devuelve las URLs 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 URLs son temporales. La URL de la captura de pantalla está disponible hasta por cuatro horas, mientras que el contenido de metadatos incluye su tiempo de expiración exacto. Descarga cualquier artefacto que necesites conservar.

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

Uso

Compilarlo

Instala siempre las dependencias y compílalo primero:

npm install && npm run build

Obtén 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

Agrega 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á licenciado bajo la Licencia MIT.