PagePixels 스크린샷 MCP 서버

PagePixels 스크린샷 API를 위한 Model Context Protocol (MCP) 서버입니다. AI 어시스턴트가 즉시 및 예약된 스크린샷을 캡처하고, 원시 HTML에서 이미지를 생성하며, 브라우저 작업을 수행한 후 스크린샷을 찍고, 자연어를 사용하여 AI 기반 웹사이트 도메인 조사를 실행할 수 있도록 합니다.

주요 기능

• 즉시 스크린샷 — 모든 URL을 캡처하거나 원시 HTML을 요청 시 이미지로 렌더링

• 다단계 브라우저 작업 — 클릭, 입력, 양식 제출, 페이지 탐색 및 캡처 전 요소 대기

• 예약된 스크린샷 — 분, 시간, 일, 주, 월 또는 연 단위로 반복 캡처 구성 생성

• 실제 위치 스크린샷 — 150개 이상의 지리적 위치(국가, 미국 주 및 주요 도시)에서 스크린샷 캡처

• AI 분석 스크린샷 — 스크린샷을 캡처하고 사용자 지정 텍스트 프롬프트에 따라 AI가 이미지를 분석하도록 설정

• 사용자 지정 HTML 스크린샷 — MCP 클라이언트에서 사용 가능한 HTML 및 데이터로 스크린샷 생성

• 다중 이미지 AI 분석 — AI가 최대 5개의 이미지와 5개의 프롬프트를 비교하도록 설정

• HTML 추출 — AI가 CSS 선택기를 찾고 JavaScript를 사용하여 HTML을 생성하는 웹사이트에서 HTML 콘텐츠를 가져오도록 지원

• 웹사이트 도메인 조사 — 여러 도메인에 걸친 AI 기반 구조화된 데이터 추출

• 전체 구성 관리 — 프로그래밍 방식으로 스크린샷 구성 생성, 읽기, 업데이트, 삭제 및 나열

• OAuth 2.1 인증 — Streamable HTTP 전송을 통한 안전하고 사양을 준수하는 MCP 인증

요구 사항

• PagePixels 계정 (무료 티어 제공 — 결제 정보 불필요)

빠른 시작

MCP 서버 URL

클라이언트를 다음 주소로 지정하여 Streamable HTTP를 통해 연결하세요:

https://mcp.pagepixels.com/mcp

OAuth를 지원하는 원격 MCP 서버용 클라이언트의 경우, 인증은 PKCE를 사용하는 표준 MCP OAuth 2.1 흐름을 통해 처리됩니다. 처음 연결할 때 브라우저 프롬프트를 통해 승인하세요.

예시: Claude.ai 웹

1. 설정(왼쪽 하단)을 엽니다.

2. 커넥터를 선택합니다.

3. 사용자 지정 커넥터 추가를 클릭합니다.

4. 서버 URL을 입력합니다:

   https://mcp.pagepixels.com/mcp

5. 브라우저에서 메시지가 표시되면 OAuth 승인을 완료합니다.

연결되면 모든 새 대화에서 PagePixels 도구를 사용할 수 있습니다.

도구

스크린샷 캡처

스크린샷 구성 관리

스크린샷 기록

변경 알림

도메인 조사

다중 이미지 AI 분석

계정 및 유틸리티

사용 예시

연결되면 AI 어시스턴트와 자연스럽게 상호작용하세요:

스크린샷 찍기:

"https://example.com의 스크린샷을 PNG 형식, 540px 너비로 찍고 쿠키 배너를 제거해 줘"

다단계 캡처:

"https://example.com으로 이동해서 로그인 버튼을 클릭하고, 이메일 필드에 test@example.com을 입력한 뒤 양식을 제출하고 전체 페이지 스크린샷을 찍어 줘"

예약된 모니터링:

"https://example.com/pricing에 대해 6시간마다 캡처하는 스크린샷 구성을 만들어 줘"

지리적 위치 캡처:

"일본에서 https://example.com의 스크린샷을 찍고 6000ms 대기한 후 캡처해 줘"

도메인 조사:

"이 5개의 경쟁사 도메인을 조사해서 가격 책정 계층, 설립 연도, 팀 규모를 추출해 줘"

계정 개요:

"현재 사용량과 남은 크레딧을 보여 줘"

캡처 옵션

snap 및 snap_html 도구는 광범위한 구성을 지원합니다:

• 뷰포트: page_width, page_height, scale_factor (1x 또는 2x Retina)

• 출력: image_format (jpeg, png, webp), quality (JPEG의 경우 1–100), 썸네일

• 전체 페이지: fullpage, fullpage_advanced, 지연 로드 콘텐츠를 위한 incremental_scroll

• 타이밍: wait (캡처 전 ms 지연), wait_for (나타날 CSS 선택기)

• 주입: 사용자 지정 페이지 수정을 위한 js_inject, css_inject

• 개인정보 보호: no_ads, no_cookie_banners, no_tracking

• 지리적 위치: real_location (150개 이상의 위치)

• AI 분석: 사용자 지정 텍스트 프롬프트에 따라 스크린샷을 분석하는 analyze_image_with_ai 및 ai_prompt

• 사용자 지정 쿠키 및 헤더: cookies, headers

• 요소 캡처: 특정 DOM 요소를 캡처하기 위한 selectors

• HTML 추출: 이미지가 아닌 완전히 렌더링된 HTML을 반환하는 html_only

• 캐싱: 캐시 기간을 제어하는 ttl (0은 항상 최신 상태)

전체 스크린샷 옵션 목록 보기.

다단계 작업

multi_step_actions를 사용하여 캡처하기 전에 브라우저 상호작용을 자동화하세요:

[
  { "type": "click", "selector": "#login-btn" },
  { "type": "text_field", "selector": "#email", "value": "user@example.com" },
  { "type": "text_field", "selector": "#password", "value": "secret" },
  { "type": "submit" },
  { "type": "wait_for_selector", "selector": ".dashboard" }
]

지원되는 작업 유형: click, hover, change, redirect, javascript, evaluateJs, css, text_field, select, checkbox, submit, wait, wait_for_selector

인증

인증은 PKCE를 사용하는 표준 MCP OAuth 2.1 흐름을 통해 처리됩니다. Claude.ai, Cursor 또는 기타 OAuth 지원 MCP 클라이언트를 통해 연결할 때 처음 연결 시 브라우저 프롬프트를 통해 승인하세요. 수동 API 키 구성은 필요하지 않습니다.

MCP 외부의 프로그래밍 방식 액세스는 PagePixels API 문서를 참조하세요.

전송

이 서버는 다음 주소에서 호스팅되는 MCP Streamable HTTP 전송을 사용합니다:

https://mcp.pagepixels.com/mcp

원격 Streamable HTTP 서버를 지원하는 모든 MCP 클라이언트는 직접 연결할 수 있습니다. 모든 연결에 PKCE를 사용하는 OAuth 2.1이 적용됩니다.

관련 항목

• PagePixels 문서 — 전체 API 참조

• screenshots-pagepixels — Node.js API 클라이언트

• screenshots-pagepixels (PyPI) — Python API 클라이언트

• screenshots_pagepixels (RubyGems) — Ruby API 클라이언트

• Model Context Protocol — MCP 사양

라이선스

MIT