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

一个封装了 WebsiteScreenshot.online REST API 的 Model Context Protocol 服务器，将其以三个 MCP 工具的形式暴露出来，任何兼容 MCP 的主机（Claude Desktop、Claude Code、Cursor、Cline、Continue、Zed、Raycast 等）都可以直接调用。

⚡ 大多数用户不需要这个包

如果你只是想让 AI 助手截图和录制视频，请改用托管端点——零安装，只需一行 JSON：

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 个十六进制字符（例如 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。

编辑配置后重启主机，这三个工具就会出现在其工具面板中。

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`	单请求中止超时时间（毫秒）

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