de en es ja ko ru zh

WebsiteScreenshot.online MCP Server

Name: WebsiteScreenshot.online MCP Server
Author: Website-Screenshot-Online

Official

by Website-Screenshot-Online

Overview Schema Related Servers Score Discussions

TypeScript

Remote

WebsiteScreenshot.online MCP サーバー

License: MIT Node >= 18.18 MCP

Model Context Protocol サーバーです。WebsiteScreenshot.online の REST API をラップし、MCP 互換のホスト（Claude Desktop、Claude Code、Cursor、Cline、Continue、Zed、Raycast など）から直接呼び出せる 3 つの MCP ツールとして公開します。

⚡ ほとんどのユーザーはこのパッケージを必要としません

AI アシスタントにスクリーンショットの撮影や動画の録画をさせたいだけなら、ホスト型エンドポイントを使用してください — インストール不要、JSON 1 行で完了します：

https://websitescreenshot.online/api/mcp

Claude Code、Claude Desktop、Cursor、Cline、Codex CLI、Gemini CLI、Continue、Windsurf、Zed 向けのホスト別設定スニペットを参照してください。

この npm パッケージが必要なのは、以下のいずれかに該当する場合のみです：

🛰️ エアギャップ環境または制限付きネットワーク — AI ホストが websitescreenshot.online に直接アクセスできない場合。
🏠 WebsiteScreenshot のセルフホスト — 独自インスタンスを運用しており、SCREENSHOT_API_BASE でそれを指定する必要がある場合。
🔧 サーバーを監査・変更したい場合 — これはホスト型エンドポイントが実行しているものと同じコードで、Next.js ラッパーがないだけです。

それ以外の場合はすべて、ホスト型エンドポイントの方が優れています（Node 依存なし、自動更新、メンテナンス不要）。

Related MCP server: MCP Browser Screenshot Server

1. 前提条件

Node.js ≥ 18.18（LTS 推奨）
無料または有料の WebsiteScreenshot.online アカウント
WebsiteScreenshot.online の API キー（§ 2 を参照）

2. API キーの取得

https://websitescreenshot.online にサインアップします（GitHub OAuth またはメール）。
必要に応じてロケールを切り替えます（例：/en/dashboard/api-keys、/zh-CN/dashboard/api-keys）。
ダッシュボード → API キー → 新しいキーを作成 を開きます。
キーをコピーします。ws_ で始まり、その後に 64 桁の 16 進文字が続きます（例：ws_<your-key-here>）。このキーは一度だけ表示されるため、安全な場所に保管してください。

MCP サーバーは環境変数からのみキーを読み取ります。ログに記録されることも、モデルに送信されることも、このパッケージによってディスクに書き込まれることもありません。

3. インストールとビルド

git clone https://github.com/Website-Screenshot-Online/websitescreenshot-mcp.git
cd websitescreenshot-mcp
npm install
npm run build

これで完了です — build/index.js は自己完結型の実行可能ファイルで、任意の MCP ホストに組み込めます。

4. MCP ホストの設定

Claude Desktop — `claude_desktop_config.json`

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%/Claude/claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "websitescreenshot": {
      "command": "node",
      "args": ["/absolute/path/to/websitescreenshot-mcp/build/index.js"],
      "env": {
        "SCREENSHOT_API_KEY": "ws_replace_with_your_real_api_key",
        "SCREENSHOT_REQUEST_TIMEOUT_MS": "60000"
      }
    }
  }
}

Claude Code — `~/.claude.json`

{
  "mcpServers": {
    "websitescreenshot": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/websitescreenshot-mcp/build/index.js"],
      "env": {
        "SCREENSHOT_API_KEY": "ws_replace_with_your_real_api_key"
      }
    }
  }
}

Cursor / VS Code（`.cursor/mcp.json`）

{
  "mcpServers": {
    "websitescreenshot": {
      "command": "node",
      "args": ["/absolute/path/to/websitescreenshot-mcp/build/index.js"],
      "env": { "SCREENSHOT_API_KEY": "ws_replace_with_your_real_api_key" }
    }
  }
}

Cline / Continue / Zed / Raycast

いずれも同じ command + args + env 形式を受け付けます — build/index.js を指定し、env 経由で SCREENSHOT_API_KEY を渡すだけです。

設定編集後、ホストを再起動すると、3 つのツールがツールパレットに表示されます。

5. セルフホスト型 WebsiteScreenshot

独自の WebsiteScreenshot インスタンスを運用している場合は、サーバーをそのインスタンスに向けます：

"env": {
  "SCREENSHOT_API_KEY": "ws_replace_with_your_real_api_key",
  "SCREENSHOT_API_BASE": "https://your-self-hosted.example.com"
}

6. 使用例

JSON を手動で書く必要はありません — モデルが行います。以下はモデルが実際に送信するペイロードです。

スクリーンショット — ランディングページのビューポート

take_screenshot({
  url: "https://example.com",
  resolution: { width: 1440, height: 900 },
  format: "png",
  fullSize: false,
  blockAds: true,
  blockCookiesGdpr: true,
  delay: 1
})

スクリーンショット — アーカイブ用の全ページ PDF

take_screenshot({
  url: "https://news.ycombinator.com",
  fullSize: true,
  format: "pdf"
})

同期動画（6 分以内）

record_website_video({
  url: "https://stripe.com",
  format: "mp4",
  scrollMode: "smooth",
  smoothScrollSpeed: "normal",
  resolution: { width: 1280, height: 720 }
})

非同期動画 + ステータスポーリング

record_website_video({ url: "https://stripe.com", async: true })
// → { "success": true, "requestId": "f7c1..." }

check_video_status({ requestId: "f7c1..." })
// → { "status": "pending", ... }  // poll again
// → { "status": "completed", "videoUrl": "https://...", ... }

7. ツールリファレンス

`take_screenshot`

フィールド	型	デフォルト	備考
`url`	string (URL)	—	必須
`resolution`	`{ width, height }`	1920×1080	任意のプリセットまたはカスタムサイズ
`fullSize`	bool	`false`	スクロール可能なページ全体をキャプチャ
`format`	`png` \| `jpeg` \| `pdf`	`png`
`blockCookiesGdpr`	bool	`true`	先に Cookie バナーを閉じる
`blockAds`	bool	`true`	広告ネットワークをブロック
`delay`	int（0〜10 秒）	`1`	キャプチャ前に待機する時間

レスポンス形式：

{
  "success": true,
  "imageUrl": "https://websitescreenshot.online/screenshots/abc.png",
  "filename": "abc.png"
}

`record_website_video`

上記と同じフィールドに加えて：

フィールド	型	デフォルト
`format`	`webm` \| `mp4` \| `gif`	`webm`
`scrollMode`	`step` \| `smooth`	`step`
`smoothScrollSpeed`	`slow` \| `normal` \| `fast`	`normal`
`scrollDistance`	int 100〜1000（px）	`500`
`scrollDelay`	int 200〜5000（ms）	`1000`
`async`	bool	`false`

同期レスポンス：

{ "success": true, "videoUrl": "https://…/abc.webm", "filename": "abc.webm" }

非同期レスポンス：

{ "success": true, "requestId": "f7c1…" }

`check_video_status`

フィールド	型
`requestId`	string

レスポンス：

{
  "status": "completed",
  "siteUrl": "https://…",
  "result": { "success": true, "videoUrl": "https://…", "filename": "abc.webm" },
  "updatedAt": 1730000000000
}

status は pending | completed | error のいずれかです。結果は 24 時間保持された後、削除されます。

8. エラーハンドリング

すべての API エラーは、code、status、error フィールドを含む MCP の isError: true 結果にマッピングされます。一般的なコード：

コード	意味
`UNAUTHORIZED`	キーが無い、または失効している
`RATE_LIMITED`	キー単位または IP 単位の制限に達した。後で再試行
`USAGE_LIMIT_EXCEEDED`	プランの割り当て量を使い切った
`INVALID_PARAMETERS`	入力が Zod バリデーションに失敗した
`INTERNAL_ERROR`	サーバー側のバグ。バックオフ付きで再試行
`TIMEOUT`	リクエストが `SCREENSHOT_REQUEST_TIMEOUT_MS` より長くかかった
`NOT_FOUND`	`requestId` が不明、または期限切れ

レート制限：API キーあたりスクリーンショット 10 件 / 分、動画 5 件 / 分。

9. 環境変数

変数	必須	デフォルト	目的
`SCREENSHOT_API_KEY`	はい	—	API に送信される Bearer トークン
`SCREENSHOT_API_BASE`	いいえ	`https://websitescreenshot.online`	セルフホスト / ステージング用の上書き
`SCREENSHOT_REQUEST_TIMEOUT_MS`	いいえ	`60000`	リクエストごとの中断タイムアウト（ms）

10. 開発

npm run dev       # tsx, hot reload stdio
npm run lint      # type-check only
npm run build     # emit build/index.js

開発サーバーをセルフホスト型 API に向けるには：

SCREENSHOT_API_BASE=http://localhost:3000 \
SCREENSHOT_API_KEY=ws_dev_replace_me \
npm run dev

11. ライセンス

ウェブサイト：https://websitescreenshot.online ホスト型 MCP：https://websitescreenshot.online/api/mcp ドキュメント：https://websitescreenshot.online/en/docs/mcp サポート：support@websitescreenshot.online

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

Webpage Screenshot MCP Server
Web Scraping Browser Automation
ananddtyagi
A
license
A
quality
D
maintenance
Captures screenshots of web pages using Puppeteer, allowing AI agents to visually verify web applications and see their progress when generating web apps.
Updated a year ago (2025-06-29 03:57 UTC)
5
57
MIT
MCP Browser Screenshot Server
Browser Automation Web Scraping Testing & QA Tools
seabassgonzalez
A
license
A
quality
D
maintenance
Enables AI assistants to capture screenshots of web pages using automated browser sessions. Supports full-page and element-specific screenshots, device simulation, and JavaScript execution for comprehensive web testing and monitoring.
Updated a year ago (2025-08-28 00:50 UTC)
6
10
MIT
PagePixels Screenshots MCPofficial
Browser Automation Web Scraping Monitoring
PagePixels
A
license
Not graded
quality
D
maintenance
Enables AI assistants to capture website screenshots, automate browser interactions, and manage recurring screenshot configurations across 150+ global locations. It also supports AI-powered domain research and visual change monitoring for any web page.
Updated 4 months ago (2026-05-02 03:17 UTC)
15
MIT
ScreenshotRender MCP Server
Browser Automation Web Scraping
faridmth
A
license
A
quality
B
maintenance
Enables AI assistants to capture screenshots of any public URL, returning images inline with page metadata. Supports full-page captures, custom wait times, and timeouts.
Updated 3 months ago (2026-06-02 13:38 UTC)
1
29
MIT

View all related MCP servers

Related MCP Connectors

mcp
Generate images, GIFs, and PDFs from HTML, URLs, or templates — from your AI agent.
mcp
Screenshot, diff, audit and sitemap-capture any web page — 5 MCP tools for AI agents.
Pagewatch
Read a URL as clean markdown, screenshot a website, url to PDF. Web access for agents, no signup.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Website-Screenshot-Online/websitescreenshot-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server