Site-Shot MCP 서버

Claude, Cursor 및 기타 AI 에이전트에게 모든 웹 페이지를 볼 수 있는 기능을 제공하세요 — Model Context Protocol을 통해 Site-Shot으로 웹사이트 스크린샷을 찍으세요.

실제 Chromium 렌더링 · 전체 페이지 캡처 · 국가별 프록시 · 자동 광고 및 쿠키 배너 제거(더 깨끗한 이미지, 더 적은 비전 토큰).

빠른 시작 (Claude Desktop)

1. https://www.site-shot.com/start/에서 Site-Shot API 키를 받으세요.

2. Claude Desktop 설정(claude_desktop_config.json)에 다음을 추가하세요:

{
  "mcpServers": {
    "site-shot": {
      "command": "npx",
      "args": ["-y", "site-shot-mcp"],
      "env": { "SITESHOT_API_KEY": "YOUR_API_KEY" }
    }
  }
}

3. Claude Desktop을 다시 시작하세요. *"https://news.ycombinator.com의 전체 페이지 스크린샷을 찍어줘"*라고 요청하면 서버를 호출하고 이미지를 보여줍니다.

모든 MCP 클라이언트(Cursor, Cline, VS Code, LangChain, CrewAI)에서 동일하게 작동합니다 — 환경에 SITESHOT_API_KEY를 설정하고 클라이언트를 npx -y site-shot-mcp로 지정하세요.

Related MCP server: ScreenshotOne MCP Server

도구

capture_screenshot

웹 페이지를 스크린샷합니다(기본적으로 뷰포트).

스크린샷을 MCP 이미지로 반환합니다.

"API 기본값"은 이 패키지가 명시할 수 있는 숫자가 아닙니다. width, height, wait_ms는 직접 전달할 때만 전달되므로, 전달하지 않을 때 적용되는 값은 Site-Shot API가 결정하며 이 패키지의 릴리스 없이 변경될 수 있습니다. 1.1.0까지의 버전은 API가 사용하지 않는 width / height의 픽셀 크기를 명시했습니다. 이를 생략하고 "기본값"을 사용한 에이전트는 다른 뷰포트를 받았고, 반환된 이미지에는 이를 드러낼 정보가 없었습니다. 크기가 중요한 경우에는 항상 명시적인 값을 전달하세요.

국가 코드는 ISO 코드이며 이름이 아닙니다. "DE"를 전달하세요. "Germany"가 아니라. API는 코드를 정확히 일치시키며, 그렇지 않으면 알려주지 않고 미국 프록시를 통해 렌더링할 것이므로 서버는 렌더링을 소모하기 전에 전체 이름을 거부합니다. strict_country(기본적으로 켜짐)도 마찬가지로 사용할 수 없는 국가를 조용한 미국 스크린샷 대신 오류로 처리합니다. false를 전달하면 대체 동작을 다시 선택할 수 있습니다. 지원 국가 →

capture_full_page

전체 페이지 캡처가 활성화된 capture_screenshot과 동일합니다.

에이전트 자체 브라우저 대신 이 서버를 호출해야 하는 이유는 무엇인가요?

에이전트가 브라우저를 직접 제어한다면 페이지를 직접 스크린샷할 수 있습니다. 로그인이 필요하거나 특정 흐름을 거쳐야 하는 페이지라면 그것이 올바른 도구입니다. 공개 URL의 경우 캡처를 이 서버에 위임하는 것이 일반적으로 더 나은 설계입니다. 모든 캡처가 동일한 파이프라인을 실행하고(실행 간 재계획 불필요), 일치하는 로캘과 시간대를 가진 특정 국가에서 캡처할 수 있으며(country + strict_country), 반환되기 전에 단계적으로 강화되는 재시도 계층을 갖춘 이미지 분류기로 평가되고, 매번 확인할 때 브라우저 세션과 비전 토큰을 소모하는 대신 1센트의 일부만 비용이 듭니다. 양방향을 정직하게 논한 전체 비교: AI 에이전트 vs. 스크린샷 API — 누가 페이지를 캡처해야 하는가.

구성

이 서버는 기존 Site-Shot HTTP API(https://api.site-shot.com/)를 얇게 감싼 래퍼입니다. 별도의 백엔드가 없습니다.

로컬 개발

npm install
npm run check   # syntax check
npm run smoke   # offline tests (stubbed fetch, no API key needed)
SITESHOT_API_KEY=yourkey npm start   # run the server on stdio

요구 사항

Node.js ≥ 18(내장 fetch 사용).

라이선스

MIT