웹 페이지를 PDF로 저장하기
URL을 PDF로는 공개 웹 주소를 WeasyPrint로 가져와 페이지를 PDF로 저장합니다. JavaScript는 실행되지 않으므로 스크립트나 로그인이 필요한 페이지는 비거나 불완전하게 나옵니다.
계속하려면 웹페이지 URL을(를) 입력하세요.
URL을 PDF로는 `urlInput`을 WeasyPrint에 넘기고 `output.pdf`를 내려받게 해 줍니다. 파일 업로드는 없습니다. WeasyPrint가 직접 URL을 가져오며, 헤드리스 Chrome도 스크린샷 서비스도 아닙니다.
JavaScript는 실행되지 않습니다. SPA, 봇 차단 벽, 쿠키 동의 화면, 로그인 세션이 필요한 페이지는 대개 비어 있거나 불완전하게 인쇄됩니다. HTTPS 오류와 사설망 대상은 실패합니다.
가져올 권한이 있는 URL만 보내세요. 유료 장벽이나 인증을 우회하는 데 쓰지 마세요. 서버는 입력한 URL을 볼 수 있습니다.
이미 HTML을 가지고 있다면 바이트를 직접 통제할 수 있으므로 HTML을 PDF로가 더 예측하기 쉽습니다.
렌더링하기 전에 서버가 `urlInput`을 검사합니다. `http://`와 `https://` 주소만 받아들이고, 사용자 이름이나 비밀번호가 포함된 URL은 거절하며, 루프백, 사설, 링크 로컬 등 내부 주소는 거절합니다. WeasyPrint가 연결을 열 때마다 같은 공개 주소 규칙이 다시 적용되므로 내부 호스트로의 리다이렉트도 거절됩니다. 페이지가 참조하는 스타일시트, 이미지, 글꼴도 같은 규칙으로 가져오며, 그래서 공개 CDN에서 CSS를 불러오는 페이지도 스타일이 적용된 채로 인쇄됩니다.
가져오기 도구는 제한된 횟수만큼 리다이렉트를 따라가고, 각 리소스를 짧은 시간 기다리며, 너무 큰 페이지나 자산은 포기합니다. 가져오기에 실패하면 페이지가 HTTP 상태를 반환했다, 주소를 찾을 수 없다, 사이트가 응답하는 데 너무 오래 걸렸다, 보안 연결을 맺지 못했다, URL이 너무 많이 리다이렉트된다 같은 알기 쉬운 메시지가 나옵니다. 이 메시지들은 메인 페이지에 대한 것이며, 이미지 하나가 없으면 대개 PDF에 빈 자리가 생길 뿐입니다.
WeasyPrint는 화면용 CSS가 아니라 인쇄용 CSS로 페이지를 배치합니다. `@media print` 안의 규칙이 적용되고, `@page` 규칙으로 여백과 크기를 바꿀 수 있으며, 긴 페이지는 여러 페이지로 나뉩니다. 뷰포트 너비에 의존하는 레이아웃, 고정 머리글, 지연 로딩 이미지, 스크립트가 삽입한 쿠키 배너는 브라우저 탭에서 보는 것과 다르게 보입니다.
기능
- 서버는 HTTP(S)가 아닌 스킴, 포함된 자격 증명, 공개가 아닌 주소를 거절하며 리다이렉트 이후에도 같음
- 인쇄 CSS 레이아웃: `@media print`와 `@page` 규칙이 적용됨
- WeasyPrint가 `urlInput`을 가져오며 파일 업로드 없음
- JavaScript 없음, Chrome 없음, 다운로드 이름은 `output.pdf`로 고정
- 스크린샷이나 인증된 세션 인쇄 도구가 아님
- 익명 API: /api/v1/convert/url/pdf
이런 경우에
- 공개된 정적 기사를 PDF로 인쇄하기
- JS가 필요 없는 CSS 기반 페이지 보관하기
- 간단한 문서 URL을 파일로 만들기
- 공개된 정책이나 약관 페이지의 날짜가 있는 사본을 기록용으로 보관하기. 단 PDF는 정적 HTML만큼만 완전하다는 점을 기억할 것
- 공개된 변경 내역이나 도움말 문서의 인쇄 가능한 버전을 만들어 지원 티켓에 첨부하기
웹 페이지를 PDF로 저장하려면?
- 가져올 권한이 있는 공개 HTTP(S) URL을 붙여 넣습니다.
- 처리를 누릅니다. 용지 크기 필드는 없습니다.
- `output.pdf`를 내려받습니다.
- CSS가 인쇄되었는지 확인하세요. JS로만 구성된 사이트는 그렇지 않습니다.
- 브라우저 주소 표시줄에서 `https://`를 포함한 전체 주소를 복사하세요. `example.com`만 입력하면 전체 URL이 아니라는 이유로 거절됩니다.
- PDF를 열어 끝까지 스크롤해 보세요. 머리글과 바닥글만 보인다면 콘텐츠가 스크립트로 삽입된 것이므로, 페이지 HTML을 저장해 HTML을 PDF로를 대신 쓰세요.
- 오류 메시지가 보이면 다시 시도하기 전에 읽어 보세요. HTTP 상태는 사이트가 오류로 응답했다는 뜻이고, 허용되지 않는다는 메시지는 주소가 사설이거나 자격 증명이 들어 있다는 뜻입니다.
제한과 경계
- JS, 쿠키, 인증 없음
- Chrome 인쇄가 아님
- 다운로드 이름은 항상 output.pdf
- 공개 http/https 호스트만 가능하며 루프백, 사설 대역, 자격 증명이 포함된 URL은 거절됨
- 한 번에 URL 하나이며 용지 크기, 여백, 뷰포트 설정은 없음
예시
- 공개된 정적 블로그 글은 읽을 수 있는 PDF로 인쇄되는 경우가 많음
- JavaScript 대시보드 URL은 빈 페이지로 인쇄되는 경우가 많음
- `http://192.168.1.10/report`를 입력하면 사설 주소와 내부 주소는 허용되지 않는다는 메시지와 함께 거절됨
- `https://user:[email protected]/page`를 입력하면 URL에 사용자 이름과 비밀번호가 들어 있어 거절됨
- 스킴 없이 `example.com`을 입력하면 전체 http:// 또는 https:// URL을 입력하라는 안내와 함께 거절되며, `https://`를 붙이면 해결됨
이 도구의 개인정보 안내
파일은 HTTPS로 업로드되며, 서버 메모리 또는 수명이 짧은 임시 디렉터리에서 처리되고, 결과가 준비되면 삭제됩니다. 이후 열람·학습·광고 프로필용 사본은 보관하지 않습니다. 보관 기간과 AdSense 쿠키 고지는 개인정보 처리방침을 참고하세요.
자주 묻는 질문
- PDF가 비어 있는 이유는 무엇인가요?
- 페이지가 JavaScript로 만들어지거나, 봇을 차단하거나, 로그인으로 리다이렉트되기 때문입니다. WeasyPrint는 내려받을 수 있었던 HTML만 봅니다.
- 로그인해야 하는 페이지를 인쇄할 수 있나요?
- 이 도구로는 안 됩니다. 로그인한 상태에서 HTML을 로컬에 저장한 다음 HTML을 PDF로를 쓰세요.
- Chrome을 실행하나요?
- 아니요. WeasyPrint로 페이지를 렌더링하며, WeasyPrint는 JavaScript를 실행하지 않습니다.
- 파일 이름은 무엇인가요?
- 항상 output.pdf입니다. URL은 이름으로 쓰이지 않습니다.
- 사설 주소나 내부 주소는 허용되지 않는다고 나오는 이유는 무엇인가요?
- 서버는 공개 웹 호스트만 가져옵니다. 루프백 주소, 192.168.x.x나 10.x.x.x 같은 주소, 그런 주소로 확인되는 호스트 이름은 거절되므로 도구가 닿으면 안 되는 네트워크를 가리킬 수 없습니다. 내 컴퓨터나 인트라넷의 페이지를 인쇄하려면 HTML을 저장해 HTML을 PDF로를 쓰세요.
- URL에 사용자 이름과 비밀번호를 넣을 수 있나요?
- 아니요. 자격 증명이 포함된 URL은 거절됩니다. 도구는 쿠키도 보내지 않으므로 로그인이 필요한 페이지를 인쇄할 수 없습니다.
- 'The page at that URL returned HTTP 403'는 무슨 뜻인가요?
- 사이트가 응답은 했지만 요청을 거부했다는 뜻이며, 봇 차단이나 유료 장벽에서 흔합니다. 다시 시도해도 소용없습니다. 브라우저에서 페이지를 저장해 HTML을 PDF로로 변환하세요.
- 레이아웃이 브라우저와 다른 이유는 무엇인가요?
- WeasyPrint는 인쇄 스타일을 적용하고 스크립트를 실행하지 않습니다. JavaScript가 실행될 때까지 콘텐츠를 숨기거나 화면에서만 스타일이 잘 적용되는 사이트는 다르게 인쇄됩니다. 페이지의 인쇄용 스타일시트를 확인하거나 저장한 HTML을 변환하세요.
- URL 여러 개를 한 번에 변환할 수 있나요?
- 아니요. `urlInput` 하나가 `output.pdf` 하나를 만듭니다. 주소마다 따로 변환하고 결과를 PDF 병합으로 합치세요.
최종 업데이트:
코드에서 호출하기
이 사이트의 도구는 모두 일반 REST 엔드포인트입니다. 익명 사용에는 계정이나 API 키가 필요 없습니다. 브라우저뿐 아니라 개발자와 AI 에이전트도 그대로 쓸 수 있습니다.
curl -X POST "https://pdf123.xyz/api/v1/convert/url/pdf" \
-F "urlInput=your-urlInput" \
-o output.pdfModel Context Protocol을 쓰는 에이전트 클라이언트용 MCP 도구로도 제공합니다(JSON-RPC 2.0, POST /mcp). 전체 API 문서
AI 에이전트에서 사용하기
스킬이 스킬을 설치하면 Claude Code, Codex, Cursor 등 AI 에이전트가 'URL을 PDF로' 작업을 대신 실행합니다: /skills/pdf123-url-to-pdf.md
파일은 이번 처리에만 쓰이며, 끝나면 자동으로 삭제됩니다.