English Français العربية

Urlbox

Registre officiel Productivité

Screenshots, PDFs, video, markdown and page data from any website, via Urlbox.

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http urlbox 'https://api.urlbox.com/mcp' --header 'Authorization: <Optional if your client signs in with OAuth. Otherwise '\''Bearer <key>'\'' with a Urlbox organisation API key or project secret key.>'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "urlbox": {
            "type": "http",
            "url": "https://api.urlbox.com/mcp",
            "headers": {
                "Authorization": "<Optional if your client signs in with OAuth. Otherwise 'Bearer <key>' with a Urlbox organisation API key or project secret key.>"
            }
        }
    }
}
NPM package @urlbox/screenshot-mcp
Claude Code 
claude mcp add urlbox -e 'URLBOX_API_KEY=<your urlbox_api_key>' -e 'URLBOX_DOWNLOAD_DIR=<URLBOX_DOWNLOAD_DIR>' -- npx -y @urlbox/screenshot-mcp@2.0.0
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "urlbox": {
            "command": "npx",
            "args": [
                "-y",
                "@urlbox/screenshot-mcp@2.0.0"
            ],
            "env": {
                "URLBOX_API_KEY": "<your urlbox_api_key>",
                "URLBOX_DOWNLOAD_DIR": "<URLBOX_DOWNLOAD_DIR>"
            }
        }
    }
}

Variables d'environnement

  • URLBOX_API_KEY obligatoire secret Urlbox organisation API key (all tools) or project secret key (rendering tools).
  • URLBOX_DOWNLOAD_DIR Folder where save_render saves files. Defaults to ~/Downloads.

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Urlbox Screenshot MCP Server
  2. Use the hosted server (recommended)
  3. Local bridge (this package)
  4. Upgrading from 1.x
  5. Example prompts
  6. Development
  7. License

Urlbox Screenshot MCP Server

Give your AI assistant a real browser for website screenshots. The Urlbox MCP server takes screenshots, makes PDFs and videos, extracts HTML, markdown and article text, compares pages, and manages your Urlbox projects, webhooks and usage.

Connect your client to https://api.urlbox.com/mcp. Nothing to install.

  • Claude (claude.ai and desktop): Settings, Connectors, Add custom connector, enter https://api.urlbox.com/mcp, then sign in to Urlbox.
  • ChatGPT: add a connector with the URL https://api.urlbox.com/mcp, then sign in to Urlbox.
  • Claude Code: claude mcp add --transport http urlbox https://api.urlbox.com/mcp, then run /mcp to sign in.
  • Codex: codex mcp add urlbox --url https://api.urlbox.com/mcp, then codex mcp login urlbox to sign in.
  • Cursor: add this to ~/.cursor/mcp.json:
    {
  "mcpServers": {
    "urlbox": {
      "url": "https://api.urlbox.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_URLBOX_API_KEY" }
    }
  }
}

Clients that can't sign in can send an API key as Authorization: Bearer <key>. An organisation API key (ubx_org_...) unlocks every tool. A project secret key works for the rendering tools only. Find your keys in the Urlbox dashboard.

Local bridge (this package)

Some clients can only start local servers. This package is a small local bridge: it runs on your machine over stdio and forwards everything to the hosted server, so you get exactly the same tools, always up to date.

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

Requires Node.js 20 or later.

VariableDescription
URLBOX_API_KEYYour organisation API key or project secret key.
SECRET_KEYAlso accepted, for configs written for 1.x. URLBOX_API_KEY wins if both are set.
URLBOX_DOWNLOAD_DIRWhere save_render saves files. Defaults to ~/Downloads.

The bridge adds one local tool, save_render, which downloads a render URL returned by any Urlbox tool and saves it to your computer. Just ask, for example "screenshot example.com and save it to my computer". Existing files are never overwritten.

Upgrading from 1.x

Your existing config keeps working: SECRET_KEY is still read and the package name and command are unchanged.

  • Tools now come from the hosted server, so there are many more of them, and they keep improving without an update.
  • render is still there. Its store_renders option and the download tool are replaced by save_render.
  • Files are saved to ~/Downloads instead of ~/Downloads/urlbox-renders. Set URLBOX_DOWNLOAD_DIR to keep the old location.
  • With a project secret key you get the rendering tools. Use an organisation API key to also manage projects, webhooks and usage.
  • Node.js 20 or later is required.

Example prompts

Development

npm install
npm test

The tests run the bridge against a local fake server, so they need no Urlbox account.

License

MIT

Questions fréquentes

Qu'est-ce que Urlbox ?

Screenshots, PDFs, video, markdown and page data from any website, via Urlbox.

Comment installer Urlbox ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http urlbox 'https://api.urlbox.com/mcp' --header 'Authorization: <Optional if your client signs in with OAuth. Otherwise '\''Bearer <key>'\'' with a Urlbox organisation API key or project secret key.>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Urlbox ?

Oui. Il attend URLBOX_API_KEY, Authorization, à renseigner dans sa configuration.

Urlbox est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Urlbox ?

Il est publié par urlbox. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.