ScreenshotOne

ScreenshotOne MCP Server

ScreenshotOne용 MCP (Model Context Protocol) 서버의 공식 구현입니다.

이 서버를 만든 이유와 MCP의 미래에 대한 몇 가지 생각.

ScreenshotOne은 공식 호스팅 MCP 서버도 제공합니다. 설정 방법과 최신 업데이트는 ScreenshotOne MCP integration을 참조하세요.

도구

• render-website-screenshot: 웹사이트 스크린샷을 렌더링하고 요청된 임시 스크린샷, 콘텐츠 및 슬라이스 URL을 반환합니다.
• render-website-screenshot-as-file: 웹사이트 스크린샷 또는 PDF를 렌더링하고, 임시 URL과 함께 MCP 리소스로 응답에 포함된 파일 자체를 반환합니다.
• extract-website-markdown: 웹사이트를 렌더링하고 정리된 Markdown을 텍스트로 직접 반환합니다.
• get-usage: ScreenshotOne API 할당량 및 동시성 사용량을 확인합니다.

스크린샷 도구는 다음과 같은 용도별 옵션을 제공합니다.

• url
• block_banners (기본값: true)
• block_ads (기본값: true)
• image_quality (기본값: 80)
• full_page (기본값: false)
• full_page_slices (기본값: false; full_page=true 필요)
• metadata_content (기본값: false)
• metadata_content_format (html 또는 markdown; metadata_content=true 필요)

메타데이터 콘텐츠 및 전체 페이지 슬라이스의 옵션 이름과 값은 ScreenshotOne API와 일치합니다. 이 도구는 응답 유형이나 캐시 제어 옵션을 제공하지 않습니다. 항상 API 캐싱을 비활성화한 상태로 JSON 응답을 요청합니다.

스크린샷과 함께 임시 Markdown 콘텐츠 URL을 받으려면 metadata_content=true 및 metadata_content_format=markdown를 설정하세요. 더 작은 세로 스크린샷 URL을 받으려면 full_page=true 및 full_page_slices=true을 설정하세요. AI 에이전트가 하나의 큰 이미지로는 안정적으로 처리하기 어려운 긴 페이지를 분석해야 하는 경우 슬라이스를 사용하는 것이 좋습니다.

캡처가 성공하면 요청된 URL이 텍스트와 구조화된 콘텐츠로 반환됩니다.

{
    "url": "https://<screenshotone-cache-domain>/...",
    "content": {
        "url": "https://<screenshotone-cache-domain>/...",
        "expires": "Sun, 07 Sep 2026 12:00:00 GMT",
        "format": "markdown"
    },
    "slices": [
        {
            "index": 0,
            "offset_y": 0,
            "width": 1280,
            "height": 4000,
            "url": "https://<screenshotone-cache-domain>/..."
        }
    ]
}

URL은 임시로 제공됩니다. 스크린샷 URL은 최대 4시간 동안 사용할 수 있으며, 메타데이터 콘텐츠에는 정확한 만료 시간이 포함됩니다. 보관해야 하는 아티팩트는 다운로드하세요.

render-website-screenshot-as-file은 파일 자체를 저장하거나 첨부하는 등 파일이 필요한 클라이언트 또는 링크를 다운로드할 수 없는 클라이언트를 위한 도구입니다. url, format (기본값은 jpg, png, webp, gif, jp2, tiff, avif, heif 또는 pdf), block_banners, block_ads, image_quality, full_page 및 full_page_max_height (full_page=true 필요)을 받습니다. 파일은 포함된 리소스(type: "resource", base64 blob 및 MIME 유형 포함)로 반환되며, 이름, URI, MIME 유형, 크기 및 임시 URL은 텍스트와 구조화된 콘텐츠로 제공됩니다. 5 MB를 초과하는 파일은 포함되지 않습니다. 이 경우 도구는 더 작은 형식, 품질 또는 높이를 제안하는 오류와 임시 URL을 반환합니다.

extract-website-markdown은 url만 받습니다. ScreenshotOne의 format=markdown API 요청을 간편하게 실행하는 도구로, 결과 Markdown을 하나의 MCP 텍스트 응답으로 직접 반환합니다. 스크린샷 없이 페이지 콘텐츠를 읽거나 분석해야 하는 경우 사용하세요.

사용법

빌드하기

항상 먼저 종속성을 설치하고 빌드하세요.

npm install && npm run build

ScreenshotOne API 키 받기

ScreenshotOne에 가입하고 API 키를 받으세요.

npx로 실행하기

저장소를 복제하지 않고 npm 패키지에서 CLI를 직접 실행하세요.

SCREENSHOTONE_API_KEY=your_api_key npx --yes @screenshotone/mcp

Claude for Desktop 사용

다음 내용을 ~/Library/Application\ Support/Claude/claude_desktop_config.json에 추가하세요.

{
    "mcpServers": {
        "screenshotone": {
            "command": "npx",
            "args": ["--yes", "@screenshotone/mcp"],
            "env": {
                "SCREENSHOTONE_API_KEY": "<your api key>"
            }
        }
    }
}

독립 실행 또는 다른 프로젝트에서 사용

SCREENSHOTONE_API_KEY=your_api_key node build/index.js

라이선스

ScreenshotOne MCP Server은 MIT License에 따라 라이선스가 부여됩니다.