localscreenshot

localscreenshot - スクリーンショット API と MCP サーバー

Cookie バナーや広告を非表示にして、227 か国から任意の公開 Web ページのスクリーンショットを撮影できます。REST API を使ってコードから利用することも、Model Context Protocol を通じて AI アシスタントから利用することもできます。

このリポジトリは、ホスト型サービスの公開ドキュメントです。MCP エンドポイント、ツール、クライアントの設定、レジストリーマニフェストが含まれています。サービス本体は localscreenshot.com で稼働し、コマンドラインクライアントは localscreenshot-cli にあります。

API キーなしでクイックスタート

HTTP MCP クライアントならどれでも、無料エンドポイントに接続できます。実際のスクリーンショットを、登録なしで利用できます。

{
  "mcpServers": {
    "localscreenshot": {
      "type": "http",
      "url": "https://api.localscreenshot.com/mcp/free"
    }
  }
}

認証情報なしで initialize、tools/list、prompts/list、resources/list に応答し、3 つのツールを提供します。3 つのサンプルページのいずれかの実際のスクリーンショット、国の一覧、料金です。任意のページを撮影することはできません。

プラグインとして利用する

このリポジトリは Open Plugins 標準に準拠しているため、ディレクトリのスキャンで検出されます。plugin.json に識別情報があり、mcp.json に接続情報が記載されています。どちらも上記の無料エンドポイントを指定しているため、インストール後すぐに利用でき、以下に示す 3 つのデモツールを使えます。

同じプラグインを通じて任意のページを撮影するには、次のセクションにあるキー付きの設定を使い、mcp.json の url を置き換えて headers ブロックを追加します。それ以外に変更はありません。ツールは同じですが、サンプルページだけに制限されなくなります。

独自のキーを使う

無料アカウントでは、カード登録なしで毎月 50 クレジットを利用できます。localscreenshot.com/signup から登録してください。ダッシュボードの「Connect」からキーを作成します。

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

Claude Code では、1 行で設定できます。

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

各ツールのドキュメントに基づく設定については、localscreenshot.com/mcp と docs.localscreenshot.com/agent を参照してください。

ツール

キーを使う場合：

ツール	機能
take_screenshot	スクリーンショットを撮影します。画像、ページタイトル、最終 URL とステータス、残りクレジットを返します。
list_countries	スクリーンショットを撮影できる国の一覧を返します。
get_credits	残りクレジット数を返します。

無料エンドポイントの場合：

ツール	機能
take_demo_screenshot	2 種類のデバイスのいずれかで、3 つのサンプルページのいずれかの実際のスクリーンショットを撮影します。
list_countries	同じ国の一覧を返します。キーは不要です。
get_pricing	サービスのクレジット料金を返します。

take_screenshot は、async と response を除き、API と同じオプションを受け付けます。画像を取得するまでサーバーが待機し、返却方法を決定します。別の幅を指定しない限り、画像は幅 1,568 ピクセルに縮小されます。これにより、ビジョンモデルで読み取れる状態を保ちつつ、不要なトークン消費を抑えられます。PDF、または 4 MB を超える画像は、添付ファイルではなく有効期限付きのダウンロードリンクとして返されます。エラーはコード付きの短い文章で返されます。

オプション

take_screenshot では、API の 28 個のパラメーターを利用できます。ただし、async と response は除きます。サーバーは画像ができるまで待機し、返却方法を決定します。

Parameter	Type	What it does
url	string	キャプチャする公開 http または https ページです。
country	string	指定した国からページを読み込みます。ISO 3166-1 alpha-2 コードを指定します。料金は 1 クレジットではなく 2 クレジットです。レスポンスには実際に確認された国が記載されます。取得できない場合、リクエストは失敗し、課金されません。
viewport	string	WIDTHxHEIGHT 形式の画面サイズです。例：1440x900。下記 2 つのパラメーターをまとめて指定するショートカットです。
viewport_width	integer	ブラウザーウィンドウの幅をピクセル単位で指定します。
viewport_height	integer	ブラウザーウィンドウの高さをピクセル単位で指定します。full_page を指定した場合、画像の高さはこの値より大きくなります。
full_page	boolean	表示部分だけでなく、スクロール可能なページ全体をキャプチャします。
device	string	画面サイズ、ピクセル密度、モバイルブラウザーを指定し、そのデバイスとしてキャプチャします。desktop、desktop_hd、laptop、ipad、ipad_pro、ipad_mini、iphone_15、iphone_15_pro_max、iphone_se、pixel_8、galaxy_s24 のいずれかを指定します。
orientation	string	スマートフォンまたはタブレットを縦向き（portrait）または横向き（landscape）にします。スマートフォンまたはタブレットのデバイスが必要です。
device_scale_factor	number	ピクセル密度です。2 を指定すると、より鮮明で大きな画像になります。
format	string	png、jpeg、webp、またはページ全体をドキュメントとして保存する pdf です。
quality	integer	jpeg と webp の品質です。png と pdf では無視されます。
selector	string	この CSS セレクターに一致する最初の要素だけをキャプチャします。
max_width	integer	画像をこの幅まで縮小します。ビジョンモデル向けに画像サイズを小さくする場合に便利です。
click_text	string	訪問者に表示されるテキストで指定して、表示中のボタン、タブ、その他のクリック可能な要素を 1 つクリックします。例：「すべて表示」。クリックは 1 回で、文字入力はしません。追加で 1 クレジットかかります。
click_selector	string	CSS セレクターで指定して、同じクリック操作を行います。コードが分かっているページで使います。クリックは 1 回で、文字入力はしません。追加で 1 クレジットかかります。
wait_for	string	この CSS セレクターに一致する要素が表示されるまで待機します。
delay_ms	integer	キャプチャ前に追加で待機する時間をミリ秒単位で指定します。
block_cookie_banners	boolean	ほとんどの Cookie バナーを削除します。フィルターが認識しないバナーは画像に残ります。
block_ads	boolean	広告をブロックします。
block_chat_widgets	boolean	チャットの吹き出しを非表示にします。
close_popups	boolean	ポップアップとニュースレターのオーバーレイを閉じます。
hide_sticky_elements	boolean	画面に固定表示されるヘッダー、バー、ボタンを非表示にします。
hide_selectors	array	これらの CSS セレクターに一致するすべての要素を非表示にします。
disable_animations	boolean	アニメーションとトランジションを停止します。
color_scheme	string	ページに light または dark テーマを指定します。
language	string	ブラウザーの言語です。例：fr または fr-FR。指定しない場合、特定の国からのスクリーンショットでは、その国の主要言語が使われます。
timezone	string	ブラウザーのタイムゾーンです。例：Europe/Paris。指定しない場合、特定の国からのスクリーンショットでは、その国の主要なタイムゾーンが使われます。
user_agent	string	ページに送信する User-Agent です。プリセット（googlebot、googlebot_mobile）または任意の文字列を指定します。クローラーと訪問者にサイトが表示する内容を比較する場合に便利です。クローラーのアドレスを確認するサイトを欺くことはできません。

詳細はこちら：スクリーンショットを撮る。

料金

• スクリーンショット 1 回につき 1 クレジット、指定した国からの場合は 2 クレジットです。失敗したスクリーンショットは課金されません。
• 毎月 50 クレジットを無料で利用できます。カードは不要です。未使用のクレジットは翌月に繰り越されません。
• 無料アカウントでは、1 分あたり 10 件のリクエストを送信でき、同時に 2 件のスクリーンショットを実行できます。
• プランとクレジットパック：localscreenshot.com/pricing。

国

AD のアンドラから始まる 227 か国の一覧です。この一覧は GET https://localscreenshot.com/v1/countries で提供され、国とアテステーション に説明があります。国を指定したキャプチャのレスポンスには、実際に確認された国が報告されます。その国から取得できなかったキャプチャは失敗となり、課金されません。

REST API

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://localscreenshot.com/v1/screenshot?url=https://example.com"

レスポンスは画像です。response=json を追加すると、画像へのリンクに加えてページの詳細とアテステーションが返されます。JSON ボディを指定した POST も同様に動作します。バックグラウンドキャプチャでは ID が返されます。/v1/screenshots/{id} で取得してください。

• OpenAPI：localscreenshot.com/v1/openapi.json
• ドキュメント：docs.localscreenshot.com/overview
• AI ツール向け：llms.txt

コマンドライン

npx localscreenshot https://example.com --full-page
pipx run localscreenshot https://example.com --country BR

両方のパッケージは localscreenshot-cli からビルドされており、依存関係もテレメトリーもありません。キーは LOCALSCREENSHOT_API_KEY から取得するか、localscreenshot login を実行して取得します。

できないこと

ウェブサイトへのサインイン、CAPTCHA の解決、ペイウォールの回避はできません。公開ページのみをキャプチャします。

リンク

• サービス：localscreenshot.com
• ドキュメント：docs.localscreenshot.com
• ダッシュボードと API キー：localscreenshot.com/dashboard
• コマンドラインクライアント：localscreenshot-cli
• MCP レジストリエントリー：com.localscreenshot/localscreenshot

ライセンス

MIT。詳細は LICENSE をご覧ください。