SnapRender について
SnapRender Integrationsは、AIエージェントやMCPクライアントをSnapRender Screenshot APIに接続します。ホスト型またはローカルのMCPサーバーを通じて、ページのキャプチャ、コンテンツ抽出、バッチ処理、Webhook管理を行えます。
主な機能
- 01ページを画像またはPDFでキャプチャ
- 02複数形式でページ内容を抽出
- 03最大50件のURLを一括処理
- 04キャッシュと使用量の確認
- 05バッチ・クォータWebhookの管理
活用シーン
- 01公開ページをキャプチャして視覚的に確認
- 02ページをMarkdownやテキストとして抽出
- 03複数URLのキャプチャを実行
- 04バッチ完了時にワークフローへ通知
MCP 対応
ホスト型のStreamable HTTP MCPサーバーと、stdioを使うローカルnpmサーバーで同じ11種類のツールを提供します。ホスト型ではOAuth 2.0またはAPIキー、ローカルではAPIキーで認証します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
11掲載時のツール一覧 · 3 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| url | string | いいえ | キャプチャする URL(http:// または https:// で始まる必要があります)。html および markdown とは同時に指定できません。 |
| html | string | いいえ | レンダリングしてキャプチャする Raw HTML コンテンツ(最大 2MB)。url および markdown とは同時に指定できません。 |
| markdown | string | いいえ | シンプルなスタイルのテンプレートでレンダリングしてキャプチャする Markdown コンテンツ(最大 500KB)。url および html とは同時に指定できません。 |
| format | enum | いいえ | 出力形式(デフォルト:png)png | jpeg | webp | pdf |
| width | integer | いいえ | ビューポートの幅(ピクセル単位、デフォルト:1280) |
| height | integer | いいえ | ビューポートの高さ(ピクセル単位、デフォルト:800) |
| full_page | boolean | いいえ | スクロール可能なページ全体をキャプチャします(デフォルト:false) |
| quality | integer | いいえ | JPEG/WebP の画質。1~100(デフォルト:90) |
| delay | integer | いいえ | ページ読み込み後の待機時間(ミリ秒)(デフォルト:0) |
| dark_mode | boolean | いいえ | ダークモードの CSS エミュレーションを有効にします(デフォルト:false) |
| block_ads | boolean | いいえ | 広告とトラッカーをブロックします(デフォルト:true) |
| block_cookie_banners | boolean | いいえ | Cookie 同意バナーを削除します(デフォルト:true) |
| device | enum | いいえ | モバイル/タブレットのエミュレーション用デバイスプリセットiphone_14 | iphone_15_pro | pixel_7 | ipad_pro | macbook_pro |
| hide_selectors | string | いいえ | キャプチャ前に非表示にする、カンマ区切りの CSS セレクター |
| click_selector | string | いいえ | キャプチャ前にクリックする CSS セレクター |
| user_agent | string | いいえ | リクエストに使用するカスタム User-Agent 文字列 |
| cache | boolean | いいえ | キャッシュ結果があれば使用します。キャッシュを有効にするには true に設定します(デフォルト:false) |
| cache_ttl | integer | いいえ | キャッシュ TTL(秒)、0-2592000。プランの上限に制限されます(デフォルト:86400) |
詳細
SnapRender のインテグレーション
SnapRender Screenshot API の公式インテグレーションです。AI エージェントに目を与えます。公開されている任意のウェブページを PNG、JPEG、WebP、PDF としてキャプチャするか、読みやすい Markdown として取得できます。
リモート MCP サーバー(推奨)
SnapRender はホスト型 MCP サーバーを提供しています。インストール不要で、任意の MCP クライアントから接続できます。
https://app.snap-render.com/mcp
- トランスポート: Streamable HTTP
- サインイン: OAuth 2.0(クライアントが SnapRender のサインインウィンドウを開きます。Google、GitHub、またはメールに対応)、または
Authorization: BearerヘッダーかX-API-Keyヘッダーで API キーを使用 - ツール(11 個): キャプチャ、キャッシュ確認、使用状況、署名付きリンク、コンテンツ抽出、バッチ、Webhook(全リストは以下)
- プロンプト:
screenshot_website、compare_devices - 無料プラン: 月 200 枚のスクリーンショット、クレジットカード不要
- ディレクトリ掲載: Glama の SnapRender(稼働状況の確認済み、ツール品質を評価済み)
Claude(claude.ai および Claude Desktop)
「Customize」を開いてから「Connectors」を選択し、「+ Add」をクリックして「Add custom connector」を選択し、https://app.snap-render.com/mcp を貼り付けます。Claude が SnapRender のサインインウィンドウを開くので、承認するとツールを利用できます。手順ガイド:snap-render.com/claude。
Cursor、VS Code、Windsurf、その他のクライアント
各クライアントのセットアップページをご覧ください。クライアントが対応している場合は、ワンクリックでインストールできます:snap-render.com/ai-connectors。
OAuth の代わりにヘッダーを使用するクライアントの場合:
{
"mcpServers": {
"snaprender": {
"url": "https://app.snap-render.com/mcp",
"headers": {
"Authorization": "Bearer sk_live_your_key_here"
}
}
}
}
任意の MCP クライアント(curl)
# Initialize a session
curl -X POST https://app.snap-render.com/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "X-API-Key: sk_live_your_key_here" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'
サーバーは Mcp-Session-Id ヘッダーを返します。セッションを再利用するには、以降のリクエストにこのヘッダーを含めてください。
Smithery
Smithery 経由でインストールすると、任意の MCP クライアントで自動セットアップできます。
ローカル MCP サーバー(npm)
stdio トランスポートを使ってローカルで実行する場合:
{
"mcpServers": {
"snaprender": {
"command": "npx",
"args": ["-y", "snaprender-mcp"],
"env": {
"SNAPRENDER_API_KEY": "sk_live_your_key_here"
}
}
}
}
詳しいドキュメントは mcp-server/ をご覧ください。
リモートとローカルの比較
| リモート(ホスト型) | ローカル(npx) | |
|---|---|---|
| インストール | 不要。HTTPS URL のみ | Node.js + npx が必要 |
| トランスポート | Streamable HTTP | stdio |
| サインイン | OAuth または API キー | API キー(SNAPRENDER_API_KEY) |
| 用途 | Claude、ChatGPT、Cursor、任意の MCP クライアント | ローカルサーバーのみを実行するクライアント |
MCP ツール
ホスト型サーバーと npm パッケージでは、同じ 11 個のツールを利用できます。パラメーターは各ツールのスキーマと API ドキュメントに記載されています。
| ツール | 機能 | コスト |
|---|---|---|
take_screenshot | URL を PNG、JPEG、WebP または PDF としてキャプチャします。デバイスのプリセット、ページ全体、ダークモード、広告や Cookie バナーの削除、セレクターの非表示やクリックに対応します | 1 回のキャプチャ(キャッシュされたコピーは無料) |
check_screenshot_cache | 指定したオプションでのキャプチャがすでにキャッシュされているかを確認します | 無料 |
get_usage | 今月のキャプチャ使用数と残数、上限、リセット日を確認します | 無料 |
sign_screenshot_url | 開くとスクリーンショットをレンダリングする署名付きリンクを作成します。API キーは不要です | 開いたときに 1 回のキャプチャ |
extract_content | ページを Markdown、テキスト、HTML、記事、リンクまたはメタデータとして読み取ります | 1 回のキャプチャ(失敗は無料) |
batch_screenshots | 1 つのバックグラウンドジョブで最大 50 個の URL をキャプチャします | URL ごとに 1 回のキャプチャ(失敗分は返金) |
get_batch_status | バッチジョブのステータスを確認し、ダウンロードリンクを取得します | 無料 |
list_webhooks | Webhook サブスクリプションを一覧表示します | 無料 |
create_webhook | バッチの完了、クォータの残量低下、またはスケジュールされたキャプチャの変更時に通知を受け取ります | 無料 |
delete_webhook | Webhook サブスクリプションを削除します | 無料 |
test_webhook | Webhook にテストペイロードを送信します | 無料 |
エージェントフレームワークとの連携
| フレームワーク | ディレクトリ | 説明 |
|---|---|---|
| LangChain Python | langchain/ | LangChain/LangGraph エージェント向けの @tool デコレーター付き関数(PyPI) |
| LangChain.js | langchain-js/ | LangChain.js エージェント向けの StructuredTool クラス(npm) |
| CrewAI | crewai/ | CrewAI エージェント向けの BaseTool サブクラス(PyPI) |
| AutoGen | autogen/ | Microsoft AutoGen エージェント向けの FunctionTool ラッパー(PyPI) |
| n8n | 別リポジトリ | n8n ワークフロー向けのコミュニティノード(npm) |
その他の連携
| 連携 | 説明 | セットアップ時間 |
|---|---|---|
| OpenClaw Skill | OpenClaw AI エージェント向けのスキルファイル | 5 分 |
| ChatGPT Actions | Custom GPT と OpenAI の関数呼び出し向けの OpenAPI 仕様 | 5 分 |
| Postman Collection | Postman 用の事前構築済み API リクエスト | 1 分 |
SDK
# Node.js
npm install snaprender
# Python
pip install snaprender
API を直接利用する
curl "https://app.snap-render.com/v1/screenshot?url=https://example.com" \
-H "X-API-Key: sk_live_your_key_here" \
-o screenshot.png
API キーを取得する
snap-render.com で無料登録してください。月 200 枚のスクリーンショットを利用でき、クレジットカードは不要です。
リンク
- ドキュメント
- リモート MCP サーバー:ストリーミング可能な HTTP エンドポイント
- Glama の MCP コネクター
- npm の MCP サーバー (
npx snaprender-mcp) - Smithery の MCP サーバー
- Node.js SDK (
npm install snaprender) - Python SDK (
pip install snaprender) - LangChain Python ツール (
pip install langchain-snaprender) - LangChain.js ツール (
npm install langchain-snaprender) - CrewAI ツール (
pip install crewai-snaprender) - AutoGen ツール (
pip install autogen-ext-snaprender) - n8n コミュニティノード (
npm install n8n-nodes-snaprender) - OpenAPI 仕様
- Postman コレクション
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。