Site-Shot MCP サーバー

Claude、Cursor、および他のAIエージェントに任意のWebページを見る能力を提供します — Site-Shot を Model Context Protocol 経由でウェブサイトのスクリーンショットを撮ります。

実際のChromiumレンダリング・全ページキャプチャ・国別プロキシ・自動広告・Cookieバナー除去（よりクリーンな画像、より少ないビジョントークン）。

クイックスタート (Claude Desktop)

1. Site-Shot APIキーを https://www.site-shot.com/start/ で取得します。

2. これをClaude Desktopの設定（claude_desktop_config.json）に追加します：

{
  "mcpServers": {
    "site-shot": {
      "command": "npx",
      "args": ["-y", "site-shot-mcp"],
      "env": { "SITESHOT_API_KEY": "YOUR_API_KEY" }
    }
  }
}

3. Claude Desktopを再起動します。"https://news.ycombinator.com の全ページスクリーンショットを撮って" と依頼すると、サーバーを呼び出して画像を表示します。

他のMCPクライアント（Cursor、Cline、VS Code、LangChain、CrewAI）でも同様に動作します — 環境変数に SITESHOT_API_KEY を設定し、クライアントを npx -y site-shot-mcp に向けます。

Related MCP server: ScreenshotOne MCP Server

ツール

capture_screenshot

Webページのスクリーンショットを撮ります（デフォルトはビューポート）。

スクリーンショットをMCP画像として返します。

「APIデフォルト」はこのパッケージが指定できる数値ではありません。 width、height、wait_ms は渡した場合のみ転送されるため、渡さなかった場合に適用される値はSite-Shot APIが決定し、ここでのリリースなしに変更される可能性があります。1.1.0までのバージョンでは、APIが使用しない width / height のピクセルサイズを出力していました — それらを省略して「デフォルト」を取得したエージェントは、返された画像にそれを示すものがないまま、異なるビューポートを取得していました。サイズが重要になる場合は、常に明示的な値を渡してください。

国コードはISOコードであり、国名ではありません。 "DE" を渡し、"Germany" は渡さないでください。APIはコードを完全一致で照合するため、国名を渡すと米国プロキシ経由でレンダリングされ、そのことを通知しません。そのため、サーバーはレンダリングを消費する前に完全な国名を拒否します。strict_country（デフォルトでオン）も同様に、利用できない国を黙って米国スクリーンショットにする代わりにエラーにします — フォールバックを希望する場合は false を渡してください。対応国 →

capture_full_page

capture_screenshot と同じですが、全ページキャプチャが有効です。

エージェント自身のブラウザではなく、このサーバーを呼ぶ理由

エージェントがブラウザを操作する場合、ページ自体をスクリーンショットできます — ログインが必要なページやフローをステップ実行する必要があるページには、それが適切なツールです。公開URLの場合、キャプチャをこのサーバーに委任する方が通常は優れたエンジニアリングです。各キャプチャは同じパイプラインで実行され（実行間の再計画なし）、一致するロケールとタイムゾーンを持つ特定の国から取得でき（country + strict_country）、返される前に画像分類器とその背後にあるエスカレーション式リトライラダーによってスコアリングされ、ブラウザセッションと毎回のビジョントークンではなく、1セント未満のコストで済みます。両方向を正直に論じた完全な比較: AIエージェント vs スクリーンショットAPI — 誰がページをキャプチャすべきか。

設定

このサーバーは既存のSite-Shot HTTP API（https://api.site-shot.com/）の薄いラッパーです — 別のバックエンドはありません。

ローカル開発

npm install
npm run check   # syntax check
npm run smoke   # offline tests (stubbed fetch, no API key needed)
SITESHOT_API_KEY=yourkey npm start   # run the server on stdio

要件

Node.js ≥ 18（組み込みの fetch を使用）。

ライセンス

MIT