Urlbox Full Page Screenshots

officiel

Un serveur MCP pour l'API Urlbox Screenshot. Il permet à votre client de prendre des captures d'écran, générer des PDFs, extraire du HTML/markdown, et plus encore à partir de sites web.

Que pouvez-vous faire avec Urlbox Full Page Screenshots MCP ?

  • Prendre des captures d’écran en plein écran — Demandez une capture d’écran de n’importe quelle URL, avec des options pour bloquer les publicités ou les bannières de cookies.
  • Générer des PDF et des vidéos — Demandez un PDF balisé avec un sommaire ou un rendu vidéo d’une page, enregistré localement via save_render.
  • Extraire le contenu d’une page — Convertissez n’importe quel article ou page web en markdown propre, en HTML ou en texte brut d’article.
  • Comparer les versions d’une page — Demandez une comparaison visuelle de deux URL ou capturez l’apparence d’un site sur un viewport mobile.
  • Gérer les ressources Urlbox — Avec une clé d’organisation, créez ou mettez à jour des projets, inspectez les webhooks et examinez l’utilisation du compte.

Documentation

Serveur MCP Urlbox Screenshot

image

Donnez à votre assistant IA un vrai navigateur pour des captures d'écran de sites web. Le serveur MCP Urlbox prend des captures d'écran, crée des PDF et des vidéos, extrait du HTML, du markdown et du texte d'articles, compare des pages, et gère vos projets Urlbox, webhooks et votre utilisation.

Utiliser le serveur hébergé (recommandé)

Connectez votre client à https://api.urlbox.com/mcp. Rien à installer.

  • Claude (claude.ai et bureau) : Paramètres, Connecteurs, Ajouter un connecteur personnalisé, saisissez https://api.urlbox.com/mcp, puis connectez-vous à Urlbox.

  • ChatGPT : ajoutez un connecteur avec l'URL https://api.urlbox.com/mcp, puis connectez-vous à Urlbox.

  • Claude Code : claude mcp add --transport http urlbox https://api.urlbox.com/mcp, puis exécutez /mcp pour vous connecter.

  • Codex : codex mcp add urlbox --url https://api.urlbox.com/mcp, puis codex mcp login urlbox pour vous connecter.

  • Cursor : ajoutez ceci à ~/.cursor/mcp.json :

    {
      "mcpServers": {
        "urlbox": {
          "url": "https://api.urlbox.com/mcp",
          "headers": { "Authorization": "Bearer YOUR_URLBOX_API_KEY" }
        }
      }
    }
    

Les clients qui ne peuvent pas se connecter peuvent envoyer une clé API comme Authorization: Bearer <key>. Une clé API d'organisation (ubx_org_...) débloque tous les outils. Une clé secrète de projet fonctionne uniquement pour les outils de rendu. Trouvez vos clés dans le tableau de bord Urlbox.

Pont local (ce paquet)

Certains clients ne peuvent démarrer que des serveurs locaux. Ce paquet est un petit pont local : il s'exécute sur votre machine via stdio et transmet tout au serveur hébergé, vous obtenez ainsi exactement les mêmes outils, toujours à jour.

{
  "mcpServers": {
    "urlbox": {
      "command": "npx",
      "args": ["-y", "@urlbox/screenshot-mcp"],
      "env": {
        "URLBOX_API_KEY": "your_api_key_here"
      }
    }
  }
}

Nécessite Node.js 20 ou version ultérieure.

VariableDescription
URLBOX_API_KEYVotre clé API d'organisation ou clé secrète de projet.
SECRET_KEYÉgalement acceptée, pour les configurations écrites pour 1.x. URLBOX_API_KEY est prioritaire si les deux sont définies.
URLBOX_DOWNLOAD_DIROù save_render enregistre les fichiers. Par défaut, ~/Downloads.

Le pont ajoute un outil local, save_render, qui télécharge une URL de rendu renvoyée par n'importe quel outil Urlbox et l'enregistre sur votre ordinateur. Demandez simplement, par exemple « capture d'écran de example.com et enregistre-la sur mon ordinateur ». Les fichiers existants ne sont jamais écrasés.

Mise à niveau depuis 1.x

Votre configuration existante continue de fonctionner : SECRET_KEY est toujours lu et le nom du paquet ainsi que la commande sont inchangés.

  • Les outils proviennent désormais du serveur hébergé, il y en a donc beaucoup plus, et ils continuent de s'améliorer sans mise à jour.
  • render est toujours là. Son option store_renders et l'outil download sont remplacés par save_render.
  • Les fichiers sont enregistrés dans ~/Downloads au lieu de ~/Downloads/urlbox-renders. Définissez URLBOX_DOWNLOAD_DIR pour conserver l'ancien emplacement.
  • Avec une clé secrète de projet, vous obtenez les outils de rendu. Utilisez une clé API d'organisation pour également gérer les projets, les webhooks et l'utilisation.
  • Node.js 20 ou version ultérieure est requis.

Exemples de commandes

Développement

npm install
npm test

Les tests exécutent le pont contre un faux serveur local, ils ne nécessitent donc pas de compte Urlbox.

Licence

MIT