ScreenshotOne

officiel

Rendre des captures d'écran de sites web avec ScreenshotOne

GitHub
38
Essayer ce MCPSponsorisé

Que pouvez-vous faire avec ScreenshotOne MCP ?

  • Rendre des captures d’écran de sites web — Demandez une capture d’écran de n’importe quelle URL avec des options comme full_page, block_ads et image_quality via render-website-screenshot.
  • Extraire le contenu d’une page en Markdown — Utilisez extract-website-markdown pour obtenir une version Markdown nettoyée et lisible de n’importe quelle page web à des fins d’analyse.
  • Obtenir des tranches de page entière — Demandez full_page=true et full_page_slices=true pour recevoir des URL d’images verticales plus petites afin d’analyser les pages longues.
  • Vérifier le quota d’utilisation de l’API — Appelez get-usage pour voir le quota actuel de l’API ScreenshotOne et l’utilisation de la concurrence.

Documentation

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 du MCP.

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

ScreenshotOne Server MCP server

Outils

  • render-website-screenshot : Génère une capture d'écran de site web et renvoie des URL temporaires de capture, de contenu et de tranches selon la demande.
  • extract-website-markdown : Génère un site web et renvoie son Markdown nettoyé directement sous forme de texte.
  • get-usage : Obtient le quota API ScreenshotOne et l'utilisation de la concurrence.

L'outil de capture expose ces options ciblées :

  • 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 tranches pleine page correspondent à l'API ScreenshotOne. L'outil n'expose pas les contrôles de type de réponse ou de cache ; il demande toujours une réponse JSON avec la mise en cache API désactivée.

Définissez metadata_content=true et metadata_content_format=markdown pour recevoir une URL de contenu Markdown temporaire avec la capture. Définissez full_page=true et full_page_slices=true pour recevoir des URL de captures verticales plus petites. Les tranches sont préférées lorsqu'un agent IA doit analyser une longue page qui pourrait ne pas être traitée de manière fiable comme 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 capture est disponible jusqu'à quatre heures, tandis que le contenu des métadonnées inclut son heure d'expiration exacte. Téléchargez tout artefact que vous souhaitez conserver.

extract-website-markdown accepte uniquement url. C'est un raccourci ciblé pour la requête API format=markdown de ScreenshotOne et renvoie le Markdown résultant directement dans une seule réponse texte MCP. Utilisez-le lorsque l'agent doit lire ou analyser le contenu d'une page sans capture d'écran.

Utilisation

Compilation

Installez toujours les dépendances et compilez d'abord :

npm install && npm run build

Obtenez votre clé API ScreenshotOne

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

Exécution avec npx

Exécutez le CLI directement depuis le paquet 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 licencié sous la licence MIT.