본문으로 건너뛰기
PPDF123

PDF 정보 확인하기

문서 정보는 PDF를 읽어 파일 크기, 페이지 수, PDF 버전, 암호화 상태, 제목과 저자를 JSON 보고서로 돌려줍니다. 디지털 서명은 감지하지 않습니다.

여기에 파일을 끌어다 놓거나, 클릭해 고릅니다

PDF 지원 · 파일당 최대 500.0 MB · 한 번에 최대 20개 파일

Ctrl/Cmd+V 또는 클립보드 메뉴로 파일을 붙여넣을 수도 있습니다.

문서 정보는 JSON을 반환합니다. `FileSize`, `PageCount`, `Encrypted`, `Info`(있으면 title/author/subject/creator/producer), `Version`, `{page: n}` 자리표시 형태의 `Pages`, `root`가 들어 있습니다. `IsSigned`는 항상 `false`입니다. 서명 감지기가 아닙니다.

웹사이트는 PDF와 같은 blob 흐름으로 이 JSON을 내려받습니다. 화면에 바로 보여 주는 보고서 UI는 없습니다.

Encrypted는 trailer에 `/Encrypt`가 있는지 확인할 뿐 전체 권한을 디코딩하는 것이 아닙니다. 웹 페이지는 비밀번호를 물어 파일을 대신 해제해 주며, API 호출자는 다른 대부분의 도구에 앞서 비밀번호 해제를 실행합니다.

암호화 서명의 세부 정보는 PDF 서명 확인을, JavaScript는 JavaScript 보기를 쓰세요.

Info 블록에는 문서의 Info 사전에 있는 키만 들어갑니다. 스크립트로 내보낸 PDF에는 `title`이나 `author`가 전혀 없을 수 있고, 그럴 때 `Info`는 추측으로 채워지지 않고 그냥 비어 있습니다. `Version`은 1.7 같은 파일의 헤더 버전으로, 생성기가 목표로 한 형식 수준을 알려 줄 뿐 어떻게 만들어졌는지를 알려 주지는 않습니다.

`FileSize`는 업로드한 바이트 수, `PageCount`는 페이지 트리에서 찾은 페이지 수, `root`는 trailer가 카탈로그를 가리키는지를 나타냅니다. `PageCount`가 0이거나 업로드에서 오류가 나면 대개 파일이 손상된 것이니 다음으로 PDF 복구를 써 보세요.

다른 도구를 고르기 전의 빠른 선별 단계로 문서 정보를 쓰세요. 비밀번호가 필요한지, `1-5` 같은 범위가 몇 페이지까지 닿는지, 메타데이터에 지우려던 이름이 아직 남아 있는지 알려 줍니다.

`Pages` 배열은 편의 기능이며 기하 정보 보고서가 아닙니다. 페이지마다 `{page: n}` 스텁을 하나씩 나열하고 미디어 박스, 크롭 박스, 회전은 일부러 빼놓았습니다. 그래서 페이지가 세로인지 가로인지, 인쇄하면 얼마나 커질지는 알 수 없습니다. 그런 수치가 필요하다면 이 엔드포인트는 페이지 기하를 제공하지 않습니다. 페이지를 래스터화하거나 데스크톱 도구에서 확인하세요. 이 배열은 인덱스가 붙은 페이지 수일 뿐이라고 생각하세요.

출력이 순수 JSON이라 스크립트로 다루기 쉽습니다. 셸 한 줄로 `PageCount`를 읽어 파일을 나눠야 하는지 판단하거나, `Encrypted`를 읽어 파일을 먼저 잠금 해제로 보내야 하는지 판단할 수 있습니다. 응답이 작고 안정적이므로 자동화 파이프라인 맨 앞의 상태 점검 단계로 적합합니다. 호출한 뒤 필드에 따라 분기하고 알맞은 도구로 넘기세요.

기능

  • Info에는 파일에 있는 키만 나열되고 없는 키는 생략됨
  • `root` 플래그로 카탈로그를 찾았는지 표시
  • JSON으로 크기, 페이지 수, 암호화 플래그, Info, 버전 보고
  • `IsSigned`는 false로 고정. Pages는 순번 자리표시
  • 네이티브 lopdf. 외부 바이너리 없음
  • 익명 API: /api/v1/security/get-info-on-pdf

이런 경우에

  • PDF 분할 전에 페이지 수를 읽음
  • 비밀번호가 필요한지 확인
  • 데스크톱 앱을 열지 않고 Info 제목·저자를 확인
  • 게시하기 전에 내보낸 파일 묶음에 남은 저자 이름이 없는지 점검
  • 제출 포털이 버전을 물을 때 `Version`을 읽어 파일이 PDF 1.4인지 1.7인지 확인

PDF의 페이지 수와 메타데이터를 확인하려면?

  1. 검사할 PDF를 업로드하세요. 비밀번호가 필요 없는 작업이므로 암호화되어 있어도 됩니다.
  2. 처리를 누르고 `.json`을 내려받습니다.
  3. 다음 도구를 고르기 전에 PageCount와 Encrypted를 봅니다.
  4. IsSigned는 무시하세요. 서명이 중요하면 PDF 서명 확인을 실행하세요.
  5. `Info.producer`와 `Info.creator`를 예상과 비교해 보세요. 뜻밖의 저자나 제목이 보이면 공유하기 전에 메타데이터 편집으로 고치라는 신호입니다.
  6. PageCount가 0이거나 업로드에서 오류가 나면 PDF 복구를 실행하고, 복구한 파일에 문서 정보를 다시 호출하세요.

제한과 경계

  • IsSigned는 자리표시
  • 페이지별 기하 정보 없음
  • 서명 검증기가 아님
  • 문서 언어, 태그 구조, 글꼴, 이미지 목록은 없음
  • 출력은 형식을 갖춘 보고서 페이지가 아니라 JSON
  • 이 사이트의 업로드 한도는 파일당 500MB이며, 약 95MB를 넘으면 나누어 전송합니다. API 직접 요청 한 건의 본문은 100MB까지입니다.

예시

  • 12페이지 파일은 PageCount 12와 Pages 자리표시 열두 개를 보고함
  • 서명된 PDF도 IsSigned false를 보고함
  • Info 사전이 없는 스캔 파일은 비어 있는 `Info` 객체와 정확한 `PageCount`, `FileSize`를 반환함
  • 암호화된 PDF는 `Encrypted: true`를 보고하면서도 페이지 수를 반환함. 그러면 PDF 분할이나 PDF 병합 전에 잠금을 풀어야 한다는 것을 알 수 있음

이 도구의 개인정보 안내

파일은 HTTPS로 업로드되며, 서버 메모리 또는 수명이 짧은 임시 디렉터리에서 처리되고, 결과가 준비되면 삭제됩니다. 이후 열람·학습·광고 프로필용 사본은 보관하지 않습니다. 보관 기간과 AdSense 쿠키 고지는 개인정보 처리방침을 참고하세요.

자주 묻는 질문

IsSigned가 항상 false인 이유는요?
필드가 고정값입니다. 서명 사전에서 계산하지 않습니다.
Pages에 무엇이 있나요?
{page: 1}, {page: 2}, … 배열이며 상자나 회전 정보는 없습니다.
Encrypted가 true면 비밀번호가 필요 없다는 뜻인가요?
아닙니다. trailer에 Encrypt가 있다는 뜻입니다. 다른 도구는 여전히 비밀번호가 필요합니다. 웹 페이지가 비밀번호를 묻고, API 호출자는 먼저 비밀번호 해제를 실행합니다.
qpdf --json인가요?
아닙니다. lopdf로 만든 작은 객체입니다.
PDF의 페이지 수는 어떻게 알아내나요?
내려받은 JSON의 `PageCount`를 읽으세요. 아무 텍스트 편집기로 열면 됩니다. 일반 JSON입니다.
Info 객체가 비어 있는 이유는요?
PDF에 Info 사전이 없거나, title, author, subject, creator, producer가 하나도 설정되어 있지 않은 것입니다. 존재하는 키만 나열됩니다.
PDF를 누가 어떤 소프트웨어로 만들었는지 볼 수 있나요?
파일에 기록되어 있다면 대개 가능합니다. `Info.creator`는 작성 응용 프로그램을, `Info.producer`는 PDF를 쓴 라이브러리를 알려 줍니다. 이 값들은 스스로 보고한 것이라 편집되었거나 비어 있을 수 있습니다.
문서 정보가 내 파일을 바꾸나요?
아닙니다. PDF를 읽고 보고서를 돌려줄 뿐 업로드한 파일은 수정되지 않습니다.
보여 주는 메타데이터를 지우는 도구는 무엇인가요?
제목이나 저자를 바꾸려면 메타데이터 편집을 쓰세요. 문서 정보는 보고만 합니다.

최종 업데이트:

코드에서 호출하기

이 사이트의 도구는 모두 일반 REST 엔드포인트입니다. 익명 사용에는 계정이나 API 키가 필요 없습니다. 브라우저뿐 아니라 개발자와 AI 에이전트도 그대로 쓸 수 있습니다.

curl -X POST "https://pdf123.xyz/api/v1/security/get-info-on-pdf" \
  -F "[email protected]"

Model Context Protocol을 쓰는 에이전트 클라이언트용 MCP 도구로도 제공합니다(JSON-RPC 2.0, POST /mcp). 전체 API 문서

AI 에이전트에서 사용하기

스킬

이 스킬을 설치하면 Claude Code, Codex, Cursor 등 AI 에이전트가 '문서 정보' 작업을 대신 실행합니다: /skills/pdf123-get-info.md

전체 에이전트 스킬

파일은 이번 처리에만 쓰이며, 끝나면 자동으로 삭제됩니다.