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 등)에서 직접 호출할 수 있는 세 가지 MCP 도구로 노출합니다.

⚡ 대부분의 사용자는 이 패키지가 필요 없습니다

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자리 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를 가리키고 SCREENSHOT_API_KEY를 env로 전달하기만 하면 됩니다.

구성 파일을 편집한 후 호스트를 재시작하면 세 가지 도구가 도구 팔레트에 표시됩니다.

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`	먼저 쿠키 배너 닫기
`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