Urlbox Full Page Screenshots

公式

Urlbox Screenshot API用のMCPサーバーです。クライアントがウェブサイトからスクリーンショットの撮影、PDFの生成、HTML/マークダウンの抽出などを行うことを可能にします。

Urlbox Full Page Screenshots MCPで何ができますか?

  • 全ページスクリーンショットを撮影 — 任意のURLのスクリーンショットをリクエストでき、広告やCookieバナーをブロックするオプションも利用可能です。
  • PDFや動画を生成 — 目次付きのタグ付きPDFや、ページの動画レンダリングをリクエストし、save_render でローカルに保存できます。
  • ページコンテンツを抽出 — 任意の記事やWebページを、クリーンなMarkdown、HTML、またはプレーンテキストに変換します。
  • ページバージョンを比較 — 2つのURLを視覚的に差分比較したり、スマートフォンのビューポートでのサイト表示をキャプチャしたりできます。
  • Urlboxリソースを管理 — 組織キーを使用して、プロジェクトの作成や更新、Webhookの確認、アカウントの使用状況の確認ができます。

ドキュメント

Urlbox スクリーンショット MCP サーバー

image

AIアシスタントに、ウェブサイトのスクリーンショットを撮るための本物のブラウザを提供します。Urlbox MCP サーバーは、スクリーンショットの撮影、PDFや動画の作成、HTML・Markdown・記事テキストの抽出、ページの比較、そして Urlbox プロジェクト・Webhook・使用状況の管理を行います。

ホスト型サーバーを使用する(推奨)

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

  • Claude(claude.ai およびデスクトップ版):設定、コネクタ、カスタムコネクタの追加、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_KEY1.x 用に書かれた設定でも受け付けます。両方が設定されている場合は URLBOX_API_KEY が優先されます。
URLBOX_DOWNLOAD_DIRsave_render がファイルを保存する場所。デフォルトは ~/Downloads です。

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

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

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

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

プロンプトの例

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

開発

npm install
npm test

テストはローカルのフェイクサーバーに対してブリッジを実行するため、Urlbox アカウントは不要です。

ライセンス

MIT