ScreenshotOne

Serveur MCP ScreenshotOne

Une implémentation officielle d’un serveur MCP (Model Context Protocol) pour ScreenshotOne.

Quelques mots supplémentaires sur les raisons de sa création et quelques réflexions sur l’avenir de MCP.

ScreenshotOne propose également un serveur MCP hébergé officiel. Consultez l’intégration MCP de ScreenshotOne pour les instructions de configuration et les dernières mises à jour.

Outils

• render-website-screenshot: Générer une capture d’écran d’un site web et renvoyer les URL temporaires de la capture, du contenu et des segments, selon la demande.
• render-website-screenshot-as-file: Générer une capture d’écran ou un PDF d’un site web et renvoyer le fichier lui-même, intégré à la réponse en tant que ressource MCP, avec une URL temporaire.
• render-html-screenshot-as-file: Générer une capture d’écran du HTML que vous écrivez ou recevez, par exemple une carte pour les réseaux sociaux ou un graphique, et renvoyer la capture sous forme d’image intégrée que l’agent peut voir, avec le nom et la taille du fichier.
• extract-website-markdown: Générer une capture d’un site web et renvoyer directement son Markdown nettoyé sous forme de texte.
• get-usage: Obtenir le quota de l’API ScreenshotOne et l’utilisation de la concurrence.

L’outil de capture d’écran propose les options ciblées suivantes :

• url
• block_banners (par défaut true)
• block_ads (par défaut true)
• image_quality (par défaut 80)
• full_page (par défaut false)
• full_page_slices (par défaut false ; nécessite full_page=true)
• metadata_content (par défaut false)
• metadata_content_format (html ou markdown ; nécessite metadata_content=true)

Les noms et valeurs des options pour le contenu des métadonnées et les segments de page entière correspondent à ceux de l’API ScreenshotOne. L’outil ne propose pas de contrôles du type de réponse ni du cache ; il demande toujours une réponse JSON avec la mise en cache de l’API désactivée.

Définissez metadata_content=true et metadata_content_format=markdown pour recevoir une URL temporaire vers le contenu Markdown avec la capture d’écran. Définissez full_page=true et full_page_slices=true pour recevoir des URL de captures d’écran verticales plus petites. Les segments sont préférables lorsqu’un agent IA doit analyser une longue page qui risque de ne pas être traitée de manière fiable sous la forme d’une seule grande image.

Une capture réussie renvoie les URL demandées sous forme de texte et de contenu structuré :

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

Les URL sont temporaires. L’URL de la capture d’écran est disponible pendant quatre heures maximum, tandis que le contenu des métadonnées indique son heure d’expiration exacte. Téléchargez tout artefact que vous souhaitez conserver.

render-website-screenshot-as-file s’adresse aux clients qui ont besoin du fichier lui-même, par exemple pour l’enregistrer ou le joindre, ou qui ne peuvent pas télécharger de liens. Il accepte url, format (jpg par défaut, png, webp, gif, jp2, tiff, avif, heif ou pdf), block_banners, block_ads, image_quality, full_page et full_page_max_height (nécessite full_page=true). Il renvoie le fichier sous forme de ressource intégrée (type: "resource" avec un blob encodé en base64 et son type MIME), ainsi que son nom, son URI, son type MIME, sa taille et son URL temporaire sous forme de texte et de contenu structuré. Les fichiers de plus de 5 Mo ne sont pas intégrés ; l’outil renvoie une erreur suggérant un format, une qualité ou une hauteur inférieurs, et inclut l’URL temporaire.

render-html-screenshot-as-file génère une image à partir du HTML transmis dans l’appel, par exemple une carte pour les réseaux sociaux, un graphique ou un rapport, afin que l’agent obtienne une image sans lancer de navigateur. Il accepte html (obligatoire, jusqu’à 1 000 000 caractères, transmis exactement tel quel), viewport_width (320–3840, par défaut 1280 ; utilisez la largeur pour laquelle le HTML est conçu), full_page (par défaut true) et image_quality (par défaut 80). Le HTML est envoyé à l’API dans le corps JSON POST, et l’API renvoie directement le JPEG, sans URL temporaire. L’outil le renvoie sous forme d’image intégrée (type: "image" avec data encodé en base64), ainsi que son nom, son type MIME et sa taille sous forme de texte et de contenu structuré. Les images de plus de 5 Mo ne sont pas renvoyées ; l’erreur suggère une qualité inférieure ou full_page=false.

extract-website-markdown accepte uniquement url. Il s’agit d’un raccourci ciblé pour la requête à l’API format=markdown de ScreenshotOne, qui renvoie directement le Markdown obtenu dans une seule réponse textuelle MCP. Utilisez-le lorsque l’agent doit lire ou analyser le contenu d’une page sans capture d’écran.

Utilisation

Le construire

Installez toujours les dépendances et construisez-le d’abord :

npm install && npm run build

Obtenir votre clé API ScreenshotOne

Inscrivez-vous sur ScreenshotOne et obtenez votre clé API.

Exécuter avec npx

Exécutez directement l’interface en ligne de commande depuis le package npm sans cloner le dépôt :

SCREENSHOTONE_API_KEY=your_api_key npx --yes @screenshotone/mcp

Avec Claude pour Desktop

Ajoutez ce qui suit à votre ~/Library/Application\ Support/Claude/claude_desktop_config.json :

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

Autonome ou pour d’autres projets

SCREENSHOTONE_API_KEY=your_api_key node build/index.js

Licence

ScreenshotOne MCP Server est distribué sous licence MIT.