CurlShot

CurlShot MCP サーバー

AI エージェントにウェブページのスクリーンショットを撮影させましょう。CurlShot はホスト型の Model Context Protocol サーバーを運用しているため、インストールは不要です。MCP クライアントでエンドポイントを指定し、API キーを追加するだけです。

https://curlshot.com/api/mcp

• トランスポート： ストリーム可能な HTTP（POST による JSON-RPC 2.0）。サーバーはステートレスのため、GET には 405 を返します。
• 認証： Authorization: Bearer YOUR_API_KEY
• プロトコルのバージョン： 2025-06-18、2025-03-26、2024-11-05

このリポジトリには、ドキュメント、server.json マニフェスト（MCP Registry 形式）、およびライセンスが含まれています。サーバー本体は curlshot.com で稼働しています。

ツール

ツール	機能	キーが必要
take_screenshot	公開ウェブページをレンダリングし、画像、PDF、またはページをスクロールする動画として返します。成功した呼び出しごとに、利用枠のスクリーンショットを1枚消費します。キャッシュヒットとレンダリング失敗は無料です。	はい
list_devices	take_screenshot の viewport_device で指定できるデバイスプリセット（スマートフォン、タブレット、デスクトップ）を一覧表示します。	いいえ

take_screenshot の引数：

引数	意味
url（必須）	http:// または https:// で始まる、ページの完全なアドレスです。
format	png、jpeg（デフォルト）、webp、pdf、mp4、webm、gif。動画形式では、動画対応プランの場合、ページを上から下までスクロールする様子を記録します。
full_page	最初の画面だけでなく、ページ全体をキャプチャします。
viewport_device	iphone_15_pro などのデバイスプリセットです（list_devices を参照）。
viewport_width、viewport_height	ブラウザーウィンドウのピクセル単位のサイズです（デフォルトは 1280 x 1024）。
dark_mode	ページにダークテーマを要求します。
block_ads、block_cookie_banners	デフォルトで有効です。
selector	この CSS セレクターに一致する最初の要素だけをキャプチャします。
wait_until、delay	ページが読み込み済みとみなされるタイミングと、追加で待機する秒数です。
cache	同じリクエストの保存済みコピーを再利用します。

小さい結果は、モデルが認識できる画像としてインラインで返されます。6 MB を超える結果は、約1日間有効なダウンロードリンクとして返されます。

API キーの取得

1. curlshot.com/register で登録します。無料プランでは、カード登録なしで月100枚のスクリーンショットを利用できます。
2. ダッシュボードでエージェント用の API キーを個別に作成すると、そのキーだけを無効化できます。
3. そのキーでは Require signature をオフにします。MCP の呼び出しには署名がありません。

キーはプロンプトではなく、クライアントの設定に保存してください。以下の例では、プレースホルダーとして YOUR_API_KEY を使用しています。

クライアントの設定

Claude Code

claude mcp add --transport http curlshot https://curlshot.com/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

または、Claude Code プラグイン（MCP サーバーとエージェントスキルを含む）としてインストールできます。事前に環境変数 CURLSHOT_API_KEY を設定してください。プラグインはこれをベアラートークンとして送信します。

/plugin install curlshot --marketplace SergiuPogor/curlshot-mcp

Claude Desktop

Claude Desktop は設定ファイルからローカル（stdio）サーバーを起動するため、mcp-remote プロキシ経由で接続します。claude_desktop_config.json を編集してください（設定 → 開発者 → 設定を編集）。

{
  "mcpServers": {
    "curlshot": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://curlshot.com/api/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

保存後、Claude Desktop を再起動します。Node.js が必要です。

Cursor

~/.cursor/mcp.json（すべてのプロジェクト）または .cursor/mcp.json（1つのプロジェクト）に追加します。

{
  "mcpServers": {
    "curlshot": {
      "url": "https://curlshot.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

VS Code（GitHub Copilot）

.vscode/mcp.json に追加します。VS Code はキーを一度だけ尋ね、安全に保存します。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "curlshot-api-key",
      "description": "CurlShot API key",
      "password": true
    }
  ],
  "servers": {
    "curlshot": {
      "type": "http",
      "url": "https://curlshot.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:curlshot-api-key}"
      }
    }
  }
}

Gemini CLI

このリポジトリは Gemini CLI 拡張機能でもあります。インストールして、要求されたら API キーを入力してください。

gemini extensions install https://github.com/SergiuPogor/curlshot-mcp

キーは CURLSHOT_API_KEY 設定として保存され、Authorization: Bearer ... として送信されます。

エージェントスキル（MCP なし）

MCP ではなく Agent Skills を使用するエージェント向けに、skills/curlshot/SKILL.md では CURLSHOT_API_KEY からキーを読み取り、curl で HTTP API を直接呼び出す方法を説明しています。

npx skills add SergiuPogor/curlshot-mcp

その他のクライアント

ストリーミング可能な HTTP 経由でリモートサーバーに対応しているクライアントであれば、どれでも使用できます。多くのクライアントでは、次のような設定を使用します。

{
  "mcpServers": {
    "curlshot": {
      "type": "http",
      "url": "https://curlshot.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

ローカルサーバーのみを起動するクライアントでは、Claude Desktop 用に示した mcp-remote コマンドを使用できます。

curl で試す

curl -X POST "https://curlshot.com/api/mcp" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "take_screenshot",
      "arguments": { "url": "https://example.com", "format": "webp" }
    }
  }'

制限と料金

• 無料プランでは、クレジットカード不要で月に 100 枚のスクリーンショットを利用できます。有料プランは月額 $19 からです。料金をご覧ください。
• 成功したレンダリングのみがカウントされます。キャッシュヒットとレンダリングの失敗は無料です。
• MCP エンドポイントには、プラン固有の制限に加えて、IP アドレスごとに 1 分あたり 120 件のリクエスト制限があります。
• 月間制限に達すると、画像の代わりにアップグレード用リンクを含むエラーがツールから返されます。

リンク

• ウェブサイト：curlshot.com
• ドキュメント：curlshot.com/docs
• AI エージェント向け MCP ガイド：curlshot.com/docs/guides/ai-agents
• 料金：curlshot.com/pricing
• サーバーカード：curlshot.com/.well-known/mcp.json

ライセンス

MIT