제품이 웹 페이지라면 Puppeteer는 훌륭합니다
Puppeteer는 실제 Chromium 브라우저를 구동합니다. 이것이 Puppeteer의 힘입니다. 기준 원본이 기존 HTML 페이지, JavaScript 차트가 들어간 대시보드, 렌더링된 웹 앱의 법적 스냅샷, 화면 캡처형 내보내기라면 Puppeteer가 올바른 제품 선택인 경우가 많습니다.
제품 관점의 질문은 PDF가 정말 웹 페이지인지, 아니면 구조화된 업무 문서인지입니다. 인보이스, 배송 라벨, 명세서, 영수증, 티켓, 양식은 보통 실제 DOM이 아니라 데이터에서 나옵니다. 이런 흐름에서는 브라우저 전체를 돌리는 것이 문서가 필요로 하는 것보다 큰 아키텍처가 될 수 있습니다.
같은 산출물, 다른 제품 경계
Puppeteer는 Chromium을 통해 HTML을 인쇄용 PDF로 바꿉니다. 애플리케이션은 HTML 템플릿, 인쇄 CSS 규칙, 폰트 설치, 브라우저 실행 환경, 워커 용량, 재시도, 리전 배포를 직접 맡습니다.
gPdf는 구조화된 JSON을 PDF로 직접 바꿉니다. 애플리케이션은 DocumentRequest 또는 template_id + data를 보내고, Edge 렌더러가 레이아웃 실행, 번들 폰트, 바코드 기본 요소, PDF/A 프로필, 전자 인보이스 패키징을 맡습니다. 브라우저 프로세스도, CSS 캐스케이드도, 따뜻하게 유지해야 할 Chromium 컨테이너도 없습니다.
제품 적합성: 웹 캡처 vs 문서 생성
문서가 기존 웹 페이지와 정확히 같아야 하거나 클라이언트 JavaScript가 최종 시각 상태를 만든다면 Puppeteer를 고르세요. 웹 아카이브, 동적 대시보드, DOM이 많은 보고서, 레이아웃을 JSON으로 다시 작성하는 편이 오히려 위험한 흐름이 여기에 해당합니다.
제품이 문서 생성이라면 gPdf를 고르세요. 배송 라벨, 인보이스, 티켓, 명세서, 증명서, 영수증, 컴플라이언스 패키지처럼 깨끗한 데이터에서 매번 같은 방식으로 생성되어야 하는 문서입니다.
개발 시간: HTML 인쇄 디버깅 vs API 템플릿
HTML이 이미 있다면 Puppeteer는 빠르게 시작할 수 있습니다. 실제 개발 시간은 나중에 드러납니다. 인쇄 CSS, 페이지 나눔, 컨테이너 안의 폰트 설치, 헤더/푸터 예외, 바코드 크기, 브라우저 버전 차이가 그 비용입니다.
gPdf는 구조화된 템플릿에서 시작합니다. 팀은 JSON을 직접 쓸 수도 있고, AI로 gPdf schema에 맞는 레이아웃 초안을 만들 수도 있으며, gPdf Studio에서 텍스트, 표, 이미지, 도형, 헤더, 푸터, 바코드를 시각적으로 추가하고 배치할 수도 있습니다. 템플릿이 저장되면 운영 호출은 template_id + data로 유지됩니다.
가격 모델: 무료 자동화 라이브러리 vs 운영해야 하는 브라우저 플릿
Puppeteer에는 라이선스 비용이 없습니다. 그렇다고 운영용 Puppeteer PDF 서비스가 무료가 되는 것은 아닙니다.
비용은 Chromium 주변 서비스에서 발생합니다.
- 브라우저 바이너리를 위한 컨테이너 또는 서버리스 실행 환경.
- 콜드 스타트를 흡수하기 위한 워밍 풀 또는 큐.
- 페이지, 폰트, 이미지, PDF 바이트를 위한 메모리 여유.
- 창고나 고객이 전 세계에 있으면 리전 배포.
- 모니터링, 재시도, 브라우저 업그레이드, 보안 패치.
gPdf는 PDF 생성 기능에 직접 가격을 매깁니다. Basic 플랜은 월 5달러에 10만 페이지부터 시작하고, 공개 페이지 단가는 페이지당 0.00005달러부터 시작합니다. 좌석 과금도, 별도 test/prod 환경 비용도, 운영해야 할 Chromium 풀도 없습니다.
Edge 생성은 지연 시간과 비용 구조를 바꿉니다
Puppeteer에서는 브라우저가 보통 여러분이 배포한 리전에 있습니다. 창고, 고객, 백엔드 작업이 그 리전에서 멀리 떨어져 있으면 렌더링 경로에는 네트워크 지연과 브라우저 작업이 모두 들어갑니다. 리전을 추가하면 브라우저 서비스, 배포 파이프라인, 모니터링, 용량 계획을 복제해야 합니다.
gPdf는 Cloudflare Workers V8 isolate에서 실행됩니다. 구조화 PDF에서는 렌더러가 작아서 모든 렌더링을 한 리전에 집중시키지 않고 호출자 가까이에서 실행할 수 있습니다. 비즈니스 효과는 p50 숫자가 빨라지는 것만이 아니라, 제품에서 리전별 Chromium 플릿을 제거하는 것입니다.
비교를 실제로 결정하는 제품 기능
운영 문서에서는 원시 렌더링 속도만큼 기능 목록도 중요합니다.
- 라벨, 티켓, 창고 문서를 위한 기본 제공 바코드 요소.
- 번들 CJK 및 다국어 대체 폰트 처리.
- 보관 요구를 위한 PDF/A 출력 프로필.
- Factur-X/ZUGFeRD 전자 인보이스 패키징.
- 상위 티어의 비밀번호 보호 PDF와 메타데이터 제어.
- gPdf Studio를 통한 시각적 레이아웃 반복.
Puppeteer도 페이지 코드, 브라우저 설정, 후처리로 이 중 많은 것을 지원할 수 있습니다. 질문은 그 스택을 팀이 직접 맡고 싶은가입니다.
Puppeteer가 여전히 정답인 경우
gPdf가 경쟁하지 않는 영역이 있습니다. 임의의 HTML-PDF 변환입니다. 문서가 이미 렌더링되어 있고, 디자인 기준 원본이 HTML이며, JavaScript 실행이나 DOM 일치가 필요하다면 Puppeteer가 여전히 맞는 도구입니다.
워크로드가 작고 지연 시간이 중요하지 않다면 운영 비용도 받아들일 만할 수 있습니다. 하루에 몇 건의 내부 내보내기 때문에 안정적인 HTML을 JSON으로 다시 작성할 필요는 없습니다.
마이그레이션 형태
인보이스나 라벨 워크로드를 Puppeteer에서 gPdf로 옮기는 팀의 경우, 마이그레이션은 보통 이런 형태입니다.
- // Before: render an HTML template through Chromium
- const browser = await puppeteer.launch({ headless: 'new' });
- const page = await browser.newPage();
- await page.setContent(invoiceHtml);
- const pdf = await page.pdf({ format: 'A4' });
+ // After: POST the structured DocumentRequest
+ const res = await fetch('https://api.gpdf.com/api/v1/template-render', {
+ method: 'POST',
+ headers: { Authorization: `Bearer ${KEY}`, 'Content-Type': 'application/json' },
+ body: JSON.stringify({ template_id: 'invoice-v2', data }),
+ });
+ const pdf = Buffer.from(await res.arrayBuffer());작업의 핵심은 API 호출이 아니라 템플릿을 한 번 제대로 작성하는 데 있습니다. 그 다음부터 모든 렌더링 호출은 HTTPS POST 한 번입니다.
관련 PDF 생성 시나리오
Puppeteer와 gPdf를 비교하는 팀은 보통 Headless Chrome PDF 대안, 서버리스 PDF 생성, Edge PDF 생성, Chromium 없는 PDF API, 인보이스 PDF API, 배송 라벨 API, 바코드 PDF 생성, HTML-PDF 전환, JSON-PDF 변환 API, 대규모 PDF 생성 비용을 함께 검토합니다. 구조화된 문서라면 JSON-PDF 변환 API와 템플릿 PDF API를 먼저 보세요. 실제 워크로드는 인보이스 PDF API, 배송 라벨 API, GS1 바코드 API가 기준이 됩니다. 보관이나 전자 인보이스가 필요하면 PDF/A API와 Factur-X API도 비교하세요.
FAQ
Puppeteer는 무료인가요?
Puppeteer는 라이브러리로는 무료입니다. 운영 비용은 브라우저 서비스, 즉 컨테이너, 메모리, 콜드 스타트, 리전별 용량, 모니터링, 재시도, 유지보수입니다.
gPdf가 임의의 HTML 페이지를 렌더링할 수 있나요?
아니요. gPdf는 JSON 기반입니다. 기준 원본이 임의의 HTML 또는 실제 웹 페이지라면 Puppeteer가 더 잘 맞습니다.
왜 Studio를 Puppeteer와 비교하나요?
많은 팀이 결과를 눈으로 보며 만들 수 있어서 HTML을 선택합니다. gPdf Studio는 구조화 PDF 템플릿에도 시각적 편집 표면을 제공하면서 실행 환경을 브라우저로 만들지 않습니다.
관련
- gPdf API 레퍼런스 전문 — 엔드포인트, 요청 형태, 오류.
- 하루 1만 건의 인보이스를 넘는 순간 Edge PDF 렌더링이 왜 중요한가 — 자세한 지연 시간 계산.
- 엔지니어를 위한 PDF/A와 Factur-X 설명 — EU 전자 인보이스 의무가 워크로드에 해당된다면 관련 있습니다.