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 サーバー
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_KEY | 1.x 用に書かれた設定でも受け付けます。両方が設定されている場合は URLBOX_API_KEY が優先されます。 |
URLBOX_DOWNLOAD_DIR | save_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
