ScreenshotOne

公式

ScreenshotOneでウェブサイトのスクリーンショットをレンダリングします

ScreenshotOne MCPで何ができますか?

  • Webサイトのスクリーンショットをレンダリング — render-website-screenshot を使用して、full_page、block_ads、image_quality などのオプションを指定し、任意のURLのスクリーンショットを要求します。
  • ページコンテンツをMarkdownとして抽出 — extract-website-markdown を使用して、任意のWebページのクリーンで読みやすいMarkdown版を取得し、分析に活用します。
  • 全ページスライスを取得 — full_page=true と full_page_slices=true を指定すると、長いページを分析するための小さな縦方向の画像URLを受け取れます。
  • API使用量のクォータを確認 — get-usage を呼び出して、現在のScreenshotOne APIクォータと同時実行使用量を確認します。

ドキュメント

ScreenshotOne MCP サーバー

ScreenshotOne 向けの MCP(Model Context Protocol) サーバーの公式実装です。

なぜこれが作られたのか、そしてMCPの未来についてのいくつかの考え。

ScreenshotOne は公式のホスト型 MCP サーバーも提供しています。セットアップ手順と最新情報については、ScreenshotOne MCP インテグレーション を参照してください。

ScreenshotOne Server MCP server

ツール

  • render-website-screenshot: ウェブサイトのスクリーンショットをレンダリングし、リクエストに応じて一時的なスクリーンショット、コンテンツ、スライスのURLを返します。
  • extract-website-markdown: ウェブサイトをレンダリングし、クリーンな Markdown をテキストとして直接返します。
  • get-usage: ScreenshotOne API のクォータと同時実行数を取得します。

スクリーンショットツールは、以下の焦点を絞ったオプションを公開しています:

  • url
  • block_banners(デフォルトは true)
  • block_ads(デフォルトは true)
  • image_quality(デフォルトは 80)
  • full_page(デフォルトは false)
  • full_page_slices(デフォルトは false; full_page=true が必要)
  • metadata_content(デフォルトは false)
  • metadata_content_format(html または markdown; metadata_content=true が必要)

メタデータコンテンツと全ページスライスのオプション名と値は、ScreenshotOne API と一致しています。このツールは、レスポンスタイプやキャッシュ制御を公開しません。常に API キャッシュを無効にした JSON レスポンスをリクエストします。

metadata_content=true と metadata_content_format=markdown を設定すると、スクリーンショットとともに一時的な Markdown コンテンツ URL を受け取ります。full_page=true と full_page_slices=true を設定すると、より小さな縦長のスクリーンショット URL を受け取ります。AI エージェントが長いページを分析する必要があり、1 枚の大きな画像として確実に処理できない場合には、スライスが推奨されます。

キャプチャが成功すると、リクエストされた URL がテキストと構造化コンテンツとして返されます:

{
    "url": "https://<screenshotone-cache-domain>/...",
    "content": {
        "url": "https://<screenshotone-cache-domain>/...",
        "expires": "Sun, 07 Sep 2026 12:00:00 GMT",
        "format": "markdown"
    },
    "slices": [
        {
            "index": 0,
            "offset_y": 0,
            "width": 1280,
            "height": 4000,
            "url": "https://<screenshotone-cache-domain>/..."
        }
    ]
}

URL は一時的なものです。スクリーンショット URL は最大 4 時間利用可能で、メタデータコンテンツには正確な有効期限が含まれます。保持する必要があるアーティファクトはダウンロードしてください。

extract-website-markdown は url のみを受け付けます。これは ScreenshotOne の format=markdown API リクエストのための焦点を絞ったショートカットであり、結果の Markdown を 1 つの MCP テキストレスポンスで直接返します。エージェントがスクリーンショットなしでページコンテンツを読んだり分析したりする必要がある場合に使用します。

使用方法

ビルド

まず、依存関係をインストールしてビルドしてください:

npm install && npm run build

ScreenshotOne API キーを取得する

ScreenshotOne にサインアップして、API キーを取得してください。

npx で実行する

リポジトリをクローンせずに、npm パッケージから直接 CLI を実行します:

SCREENSHOTONE_API_KEY=your_api_key npx --yes @screenshotone/mcp

Claude for Desktop で使用する

~/Library/Application\ Support/Claude/claude_desktop_config.json に以下を追加してください:

{
    "mcpServers": {
        "screenshotone": {
            "command": "npx",
            "args": ["--yes", "@screenshotone/mcp"],
            "env": {
                "SCREENSHOTONE_API_KEY": "<your api key>"
            }
        }
    }
}

スタンドアロンまたは他のプロジェクトで使用する

SCREENSHOTONE_API_KEY=your_api_key node build/index.js

ライセンス

ScreenshotOne MCP Server は MIT ライセンス の下でライセンスされています。