ScreenshotOne

ScreenshotOne MCP 서버

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

서버가 만들어진 이유와 MCP의 미래에 대한 몇 가지 생각.

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

도구

• render-website-screenshot: 웹사이트 스크린샷을 렌더링하고 요청에 따라 임시 스크린샷, 콘텐츠, 슬라이스 URL을 반환합니다.
• 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 응답을 요청합니다.

metadata_content=true 및 metadata_content_format=markdown을 설정하면 스크린샷과 함께 임시 Markdown 콘텐츠 URL을 받을 수 있습니다. full_page=true 및 full_page_slices=true를 설정하면 더 작은 세로 스크린샷 URL을 받을 수 있습니다. 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시간 동안 사용할 수 있으며, 메타데이터 콘텐츠에는 정확한 만료 시간이 포함됩니다. 보관해야 할 아티팩트는 다운로드하세요.

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 라이선스에 따라 라이선스가 부여됩니다.