Urlbox Full Page Screenshots

Urlbox Screenshot MCP Server

AI アシスタントに、ウェブサイトのスクリーンショットを撮影できる実際のブラウザーを提供します。Urlbox MCP サーバーは、スクリーンショットの撮影、PDF や動画の作成、HTML、マークダウン、記事テキストの抽出、ページの比較を行い、Urlbox のプロジェクト、ウェブフック、使用状況を管理します。

ホスト型サーバーを使う（推奨）

クライアントを https://api.urlbox.com/mcp に接続します。インストールは不要です。

• Claude（claude.ai およびデスクトップ）：Settings、Connectors、Add custom connector の順に選択し、https://api.urlbox.com/mcp を入力してから、Urlbox にサインインします。

• ChatGPT：URL https://api.urlbox.com/mcp を使ってコネクターを追加し、Urlbox にサインインします。

• Claude Code：claude mcp add --transport http urlbox https://api.urlbox.com/mcp を実行してから、/mcp を実行してサインインします。

• Codex：codex mcp add urlbox --url https://api.urlbox.com/mcp を実行してから、codex mcp login urlbox を実行してサインインします。

• Cursor：以下を ~/.cursor/mcp.json に追加します。

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

サインインできないクライアントは、API キーを Authorization: Bearer <key> として送信できます。組織の API キー（ubx_org_...）を使うと、すべてのツールを利用できます。プロジェクトのシークレットキーで利用できるのは、レンダリングツールのみです。Urlbox ダッシュボードでキーを確認できます。

ローカルブリッジ（このパッケージ）

ローカルサーバーしか起動できないクライアントもあります。このパッケージは小規模なローカルブリッジです。お使いのマシン上で stdio 経由で動作し、すべてのリクエストをホスト型サーバーに転送するため、常に最新の同じツールを利用できます。

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

Node.js 20 以降が必要です。

変数	説明
URLBOX_API_KEY	組織の API キーまたはプロジェクトのシークレットキーです。
SECRET_KEY	1.x 向けに記述された設定でも使用できます。両方が設定されている場合は、URLBOX_API_KEY が優先されます。
URLBOX_DOWNLOAD_DIR	save_render がファイルを保存する場所です。デフォルトは ~/Downloads です。

ブリッジはローカルツール save_render を 1 つ追加します。このツールは、Urlbox の任意のツールから返されたレンダリング URL をダウンロードして、お使いのコンピューターに保存します。たとえば、「example.com のスクリーンショットを撮って、コンピューターに保存して」と頼むだけです。既存のファイルが上書きされることはありません。

1.x からのアップグレード

既存の設定は引き続き動作します。SECRET_KEY は引き続き読み込まれ、パッケージ名とコマンドも変更されません。

• ツールはホスト型サーバーから提供されるため、利用できるツールが大幅に増え、更新しなくても継続的に改善されます。
• render は引き続き利用できます。store_renders オプションと download ツールは save_render に置き換えられました。
• ファイルは ~/Downloads/urlbox-renders ではなく ~/Downloads に保存されます。以前の保存場所を使うには、URLBOX_DOWNLOAD_DIR を設定してください。
• プロジェクトのシークレットキーでは、レンダリングツールを利用できます。プロジェクト、ウェブフック、使用状況も管理するには、組織の API キーを使用してください。
• Node.js 20 以降が必要です。

プロンプトの例

• 広告や Cookie バナーなしで https://example.com のスクリーンショットを撮影して。
• https://urlbox.com をアウトライン付きのタグ付き PDF として保存し、コンピューターにダウンロードして。
• この記事をマークダウンに変換して：https://example.com/blog/post
• https://example.com はスマートフォンで見るとどのように表示されますか？

開発

npm install
npm test

テストでは、ローカルの偽サーバーを使ってブリッジを実行するため、Urlbox アカウントは必要ありません。

ライセンス

MIT