@copperline/rendex-mcp

npm version npm downloads License: MIT

Rendex용 MCP 서버 — Model Context Protocol을 사용하여 AI 에이전트를 통해 모든 웹페이지의 스크린샷과 PDF를 캡처합니다.

빠른 시작

Claude Desktop / Cursor / Windsurf (npx)

MCP 클라이언트 설정에 추가하세요:

{
  "mcpServers": {
    "rendex": {
      "command": "npx",
      "args": ["-y", "@copperline/rendex-mcp"],
      "env": {
        "RENDEX_API_KEY": "your-api-key"
      }
    }
  }
}

추가 위치:

클라이언트	설정 위치
Claude Desktop	`~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
Cursor	프로젝트 루트의 `.cursor/mcp.json` 또는 설정 > MCP
Windsurf	설정 > MCP 서버

Claude Code (CLI)

위와 동일한 설정으로 프로젝트 루트에 .mcp.json을 추가하세요. 그런 다음 Claude Code를 재시작하세요.

중요: .mcp.json에는 API 키가 포함되어 있으므로 .gitignore에 추가하세요.

원격 (설치 불필요)

직접 연결하세요 — 설치가 필요 없습니다 (Claude Desktop 전용):

{
  "mcpServers": {
    "rendex": {
      "url": "https://mcp.rendex.dev/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key"
      }
    }
  }
}

도구

`rendex_screenshot`

모든 웹페이지나 원시 HTML의 스크린샷 또는 PDF를 캡처합니다.

"Take a screenshot of https://example.com"
"Capture the full page of https://news.ycombinator.com in dark mode"
"Generate a PDF of https://github.com with A4 page size"
"Capture https://amazon.de as seen from Germany"
"Render this HTML invoice as a PDF"

매개변수:

매개변수	유형	기본값	설명
`url`	string	필수*	캡처할 웹페이지 URL. `html`과 동시에 사용할 수 없습니다.
`html`	string	—	렌더링할 원시 HTML. `url`과 동시에 사용할 수 없습니다.
`format`	`"png"`	`"jpeg"`	`"webp"`	`"pdf"`	`"png"`	출력 형식
`fullPage`	boolean	`false`	스크롤 가능한 전체 페이지 캡처
`darkMode`	boolean	`false`	다크 모드 색상 체계 에뮬레이션
`width`	number	`1280`	뷰포트 너비 (320-3840)
`height`	number	`800`	뷰포트 높이 (240-2160)
`quality`	number	`80`	이미지 품질 1-100 (JPEG/WebP 전용, 기본값 80)
`delay`	number	`0`	캡처 전 대기 시간(ms)
`blockAds`	boolean	`true`	광고 및 추적기 차단
`blockResourceTypes`	string[]	—	차단할 리소스 유형: `font`, `image`, `media`, `stylesheet`
`deviceScaleFactor`	number	`2`	장치 픽셀 비율 (1-3). 기본값은 2× Retina
`timeout`	number	`30`	페이지 로드 대기 최대 시간(초) (5-60)
`waitUntil`	string	`"networkidle2"`	페이지 준비 상태: `load`, `domcontentloaded`, `networkidle0`, `networkidle2`
`waitForSelector`	string	—	캡처 전 대기할 CSS 선택자
`bestAttempt`	boolean	`true`	타임아웃 시 실패 대신 부분 렌더링 반환
`selector`	string	—	전체 페이지 대신 캡처할 요소의 CSS 선택자
`css`	string	—	캡처 전 주입할 사용자 정의 CSS (최대 50KB)
`js`	string	—	캡처 전 실행할 사용자 정의 JavaScript (최대 50KB)
`cookies`	array	—	인증된 캡처를 위해 설정할 쿠키 (최대 50개)
`headers`	object	—	페이지 요청을 위한 사용자 정의 HTTP 헤더
`userAgent`	string	—	브라우저 사용자 에이전트 문자열 재정의
`pdfFormat`	string	—	PDF 페이지 크기: `A4`, `Letter`, `Legal`, `Tabloid`, `A3`
`pdfLandscape`	boolean	—	PDF 가로 방향
`pdfPrintBackground`	boolean	`true`	PDF에 배경 인쇄
`pdfScale`	number	`1`	PDF 배율 (0.1-2)
`pdfMargin`	object	—	PDF 여백: CSS 값으로 `{top, right, bottom, left}`
`geo`	string	—	지리적 타겟팅 캡처를 위한 ISO 국가 코드 (Pro/Enterprise)
`geoCity`	string	—	지리적 타겟팅을 위한 도시 (`geo` 필요)
`geoState`	string	—	지리적 타겟팅을 위한 주 (`geo` 필요)
`async`	boolean	—	비동기 처리 (작업 ID 반환)
`webhookUrl`	string	—	비동기 캡처 완료 시 콜백을 받을 URL
`cacheTtl`	number	—	결과 캐시 시간(초) (3600-2592000)

인증

rendex.dev에서 API 키를 받으세요.

MCP 클라이언트 설정에서 RENDEX_API_KEY 환경 변수를 설정하세요.

요금제

플랜	호출/월	속도
Free	500	10/분
Starter	10,000	60/분
Pro	100,000	300/분
Enterprise	사용자 정의	1,000/분

라이선스

MIT — Copperline Labs LLC

rendex-mcp

@copperline/rendex-mcp

빠른 시작

Claude Desktop / Cursor / Windsurf (npx)

Claude Code (CLI)

원격 (설치 불필요)

도구

`rendex_screenshot`

인증

요금제

라이선스

Resources

Tools

Latest Blog Posts

MCP directory API