Screenshot Scout

Screenshot Scout MCP サーバー

MCP クライアントから Screenshot Scout を使用して、 HTTP または HTTPS のウェブページを画像または PDF としてキャプチャします。

このサーバーは、capture_screenshot という 1 つのツールを公開します。ページ全体や 要素のキャプチャ、デバイスとビューポートの制御、場所の選択、ページ操作とブロックの オプション、画像のサイズと品質、PDF のレイアウト、キャッシュ、一時的な結果 URL、 および条件を満たす MCP 画像コンテンツに対応しています。

必要なもの

• Screenshot Scout アカウントと、 API キーページから取得した アクセスキー。
• npm/stdio でインストールする場合は Node.js 22 以降。Claude Desktop の MCPB ランタイムは Claude に同梱されています。
• 選択した API キーで署名付き Screenshot Scout リクエストが必要な場合のみ、 オプションのシークレットキー。

すべてのキャプチャは Screenshot Scout アカウントを使用し、プラン、クォータ、 レート制限が適用されます。

npm を使用したローカル stdio

次のローカル stdio 設定から始めてください。

{
  "mcpServers": {
    "screenshotscout": {
      "command": "npx",
      "args": ["-y", "@screenshotscout/mcp"],
      "env": {
        "SCREENSHOTSCOUT_ACCESS_KEY": "YOUR_ACCESS_KEY"
      }
    }
  }
}

アクセスキーでリクエストの署名が必要な場合は、シークレットをローカルに追加します。

"SCREENSHOTSCOUT_SECRET_KEY": "YOUR_SECRET_KEY"

個人用の設定ファイルはソース管理の対象外にしてください。認証情報はプロセスの 環境変数であり、ツール引数ではありません。Claude Desktop、Claude Code、Cursor、 VS Code/GitHub Copilot、Devin、Cline 向けの クライアント別のコピー＆ペースト設定を参照してください。

ソースのチェックアウトから実行する

npm ci
npm run build

クライアントで node を使用して dist/stdio.js の絶対パスを指定し、上記と同じ 環境変数を設定してください。

Claude Desktop MCPB

Claude Desktop 拡張機能をインストールするには：

1. そのバージョンの GitHub リリースから screenshotscout-mcp-<version>.mcpb を ダウンロードします。
2. Claude Desktop で Settings → Extensions → Advanced settings を開き、 Install Extension… を選択します。
3. ダウンロードしたファイルを選択します。
4. 必須のアクセスキーを入力します。シークレットキーは、署名付きリクエストが必要な API キーの場合にのみ入力してください。

Claude Desktop は両方のフィールドを機密設定として扱います。v0.2.0 MCPB は Windows に対応しています。

ホスト型 Streamable HTTP

ホスト型 API キーエンドポイントは次のとおり利用できます。

https://mcp.screenshotscout.com/mcp/api-key

静的 HTTP ヘッダーを付与できるクライアント専用のエンドポイントです。

Authorization: Bearer YOUR_ACCESS_KEY

このエンドポイントが受け付けるのはアクセスキーのみです。Screenshot Scout の シークレットキーを送信したり、いずれかのキーを URL やツール引数に含めたりしないで ください。静的な Bearer ヘッダーを付与できないクライアントは、このエンドポイントを 使用できません。

リクエスト署名が必要な API キーは、代わりにローカル stdio または MCPB を使用するか、 ホスト型エンドポイント専用の署名不要なアクセスキーを使用してください。

Docker を使用したローカル stdio

ソースのチェックアウトから本番用イメージをビルドします。

docker build --tag screenshotscout-mcp:local .

ローカル環境から認証情報を渡し、MCP stdio トラフィックのために stdin を接続したままに してください。

docker run --rm -i --init --cap-drop=ALL --security-opt=no-new-privileges --read-only \
  -e SCREENSHOTSCOUT_ACCESS_KEY \
  -e SCREENSHOTSCOUT_SECRET_KEY \
  screenshotscout-mcp:local

SCREENSHOTSCOUT_SECRET_KEY は引き続きオプションです。このイメージは非特権 ユーザーとして実行され、コンパイル済みの stdio サーバーと本番用依存関係のみを 含みます。ポートもコンテナのヘルスチェックも宣言しません。MCP クライアントが stdio プロセスを管理し、MCP の初期化を完了して準備状態を確認します。このイメージと docker-mcp-catalog.yaml 内の Docker MCP Catalog メタデータはローカルでの準備用 であり、これらのコマンドによって公開イメージが作成されるわけではありません。

ツール：capture_screenshot

capture_screenshot は、指定された URL とオプションを使用して 1 件のキャプチャ リクエストを送信します。対象のウェブページは外部のものであり、返されるコンテンツは 信頼できないものとして扱う必要があります。

入力

必須なのは url のみです。キャプチャのビューポートはデフォルトで 1280×720 です。形式が指定されていない場合、ツールは品質 60 の JPEG を返します。resultMode のデフォルト値は "auto" です。

グループ	入力
対象と出力	url；format（png、jpg、jpeg、webp、gif、tiff、pdf）；resultMode（auto、url_only）
場所とビューポート	country（2 文字の国コード）、device、deviceViewportWidth、deviceViewportHeight、colorScheme（auto、dark、light）、fullPage
ページの準備	blockCookieBanners、blockAds、blockChatWidgets、selector、hideSelectors、clickSelectors
タイミング	waitUntil（load、domcontentloaded、networkidle0、networkidle2）、delay（0～30 秒）、navigationTimeout（5～90 秒）、timeout（1～240 秒）
キャッシュ	cache、cacheTtl（14,400～2,592,000 秒）
出力サイズの変更	imageWidth、imageHeight（1～8,192。画像のみ）
画像のみ	imageQuality（0～100。JPEG／WebP のみ）
PDF のみ	pdfPaperFormat（letter、legal、tabloid、a3、a4、a5、a6）、pdfLandscape、pdfPrintBackground、pdfMargin、辺ごとの余白フィールド、pdfScale（0.1～2）、pdfPageRanges（例：1-3,5）

出力寸法を両方指定する場合、その積は 64,000,000 ピクセルを超えることはできません。PDF の余白には、px、in、mm、cm 単位の 0 以上の値を指定できます。別の形式向けの入力は無視されます。imageQuality は JPEG と WebP にのみ適用され、PDF 用の入力は format: "pdf" の場合にのみ適用されます。PDF には常にページ全体が含まれるため、PDF では fullPage、selector、imageWidth、imageHeight は無視されます。

結果

• resultMode が auto で、MIME タイプが対象となり、寸法が判明していて各辺が 8,000 ピクセル以下、元データが 5 MiB 以下、かつシリアライズ後の結果全体が現在のサーバー上限である 128,000 バイト以内の場合、PNG、JPEG、WebP、GIF は MCP の画像コンテンツとして含められることがあります。
• 埋め込みの対象とならないキャプチャも成功として扱われ、一時 URL と実行可能な省略理由が返されます。
• TIFF は URL のみです。
• PDF のバイトデータは埋め込まれません。PDF の結果には、安全なテキストと構造化メタデータのほか、Screenshot Scout が結果 URL を提供する場合はリソースリンクが含まれます。
• resultMode: "url_only" の場合、すべての形式で画像バイトデータが省略されます。

返された画像コンテンツやリソースリンクを表示するか、モデルに利用可能にするかは、MCP クライアントが制御します。

構造化メタデータには、screenshotUrl、screenshotUrlExpiresAt、cacheStatus、format、mimeType、imageWidth、imageHeight、inlineImageIncluded、inlineImageOmissionReason が含まれることがあります。

結果 URL は機密性の高い一時リンクとして扱い、報告された有効期限を守ってください。

プロンプトの例

• 「https://example.com をダークモードでページ全体の PNG としてキャプチャしてください。URL のみを返してください。」
• 「https://example.com/pricing の 1280×720 の JPEG スクリーンショットを撮影し、Cookie バナーと広告をブロックして、品質を 80 に設定してください。」
• 「背景を有効にし、余白を 10 mm に設定して、https://example.com/report の A4 PDF を作成してください。」

プライバシーとセキュリティ

サーバーは対象の URL と選択されたキャプチャオプションを Screenshot Scout に送信し、Screenshot Scout が対象のウェブサイトを読み込みます。非公開または規制対象の情報をキャプチャする前に、 Screenshot Scout のプライバシーポリシー をご確認ください。

• アクセスを許可されていないページをキャプチャしないでください。
• 認証情報をプロンプト、ツール入力、URL、イシューレポート、ログに貼り付けないでください。
• ローカルアクセス情報とシークレットキーは、クライアントが管理するシークレットストレージまたは非公開の環境設定に保存してください。
• ローカルの stdio サーバーはテレメトリーを追加しません。ホスト型サービスのアプリケーションログには、リクエストメソッド、レスポンスステータス、所要時間、サニタイズされた予期しないエラーのみが記録されます。認証情報、対象の URL、スクリーンショットの URL、リクエストまたはレスポンスの内容、画像データは含めないように設計されています。
• ツールの使用を許可する前に、対象とキャプチャリクエストを確認してください。このツールはオープンワールドで、クォータを消費し、外部のウェブサイトとやり取りします。
• 脆弱性はSECURITY.mdの説明に従って非公開で報告してください。

開発

npm ci
npm run format:check
npm run lint
npm run typecheck
npm test
npm run metadata:check
npm run registry:validate
npm run mcpb:validate
npm run mcpb:pack

ライセンス

MIT © Oleksii Velykyi