온라인 PDF Repair와 “Recovery Toolbox” 검색: PDF123이 실제로 하는 일
“PDF recovery toolbox” 검색은 대개 구조 복구를 뜻합니다. PDF123의 Repair PDF는 무료 온라인 도구이자 API이며, 데스크톱 제품 Recovery Toolbox for PDF와는 다른 서비스입니다.
PDF가 열리지 않으면 검색 결과가 서로 다른 두 가지를 뒤섞곤 합니다. 하나는 손상된 파일 구조의 복구이고, 다른 하나는 브랜드 데스크톱 “복구” 소프트웨어입니다. PDF Toolbox라는 이름으로 배포되는 PDF123(pdf123.xyz)이 제공하는 것은 전자입니다. 무료 온라인 도구와 Repair PDF API입니다. Recovery Toolbox for PDF라는 이름으로 팔리는 Windows 제품이 아닙니다.
깨진 PDF에서 “복구”가 뜻하는 것
“file is damaged”를 내뱉거나 열기를 거부하는 PDF는 대개 내부 지도(상호 참조와 객체 스트림)가 깨진 것이지, 손으로 다시 그릴 수 있는 페이지 그림이 빠진 게 아닙니다. PDF 복구(POST /api/v1/misc/repair)는 아직 유효한 바이트를 qpdf로 다시 써서 그 구조를 재구성합니다. 복구가 성공하면 뷰어는 원래 의도한 페이지 내용을 바꾸지 않고 파일을 다시 열 수 있습니다.
다음과는 다른 일입니다.
- OCR / 스캔 정리: 파일은 열리지만 텍스트가 이미지뿐일 때입니다. 이 사이트의 OCR은 숨은 텍스트 레이어가 아니라 Markdown을 반환합니다.
- 비밀번호 잠금 해제: 파일이 암호화되어 있고 비밀번호를 이미 아는 경우입니다(비밀번호 해제).
- 데스크톱 복구 제품군: 로컬 머신에서 심층 포렌식 복구를 노리는 설치형 앱입니다.
- 압축 / 변환: 먼저 파싱 가능한 PDF가 있어야 하는 크기·형식 도구입니다.
온라인 도구함과 데스크톱 “Recovery Toolbox” 검색
| 필요한 것 | PDF123 Repair PDF | 일반적인 데스크톱 복구 제품 |
|---|---|---|
| 실행 방식 | 브라우저 업로드 또는 HTTP API | PC에 설치해 실행 |
| 여기서의 주된 작업 | PDF가 열리도록 구조를 복구 | 제품별로 다른 벤더 고유 복구 절차 |
| 자동화 | POST /api/v1/misc/repair의 PDF 복구 API |
대개 GUI나 로컬 배치이며 우리 OpenAPI가 아님 |
| 계정 | 카탈로그 도구에는 불필요 | 벤더에 따라 다름 |
우리는 Recovery Toolbox for PDF의 기능 동등성, 가격, 버전 세부를 주장하지 않습니다. 그 제품은 별개입니다. 이 표는 경로와 의도만 분명히 합니다. 온라인 API 복구와, 사람들이 Google에 입력했을 법한 데스크톱 복구 브랜드는 다릅니다.
복구하기 전에 미리 점검하기
문서 정보는 JSON 사전 점검 결과(FileSize, PageCount, Encrypted, Info 필드, 버전)를 반환합니다. 파서가 파일을 읽을 수 있는지, 암호화가 다른 편집을 막고 있는지 확인하는 데 쓰세요. 복구는 비밀번호를 제거하지 않습니다. “파일이 열리지 않을 때”의 단계별 결정 트리는 파일이 열리지 않을 때에 있습니다.
Repair와 OCR 중 무엇을 언제 쓰는가
- 뷰어가 파일을 전혀 열지 못한다 → PDF 복구를 먼저 시도합니다.
- 파일은 열리지만 스캔본에서 텍스트를 선택하거나 검색할 수 없다 → OCR / 스캔 정리로 Markdown 텍스트를 얻습니다. 크기가 중요하면 압축은 따로 합니다(스캔 묶음: OCR 후 압축).
- 스크립트나 에이전트에서 같은 복구가 필요하다 → Repair PDF API를 호출합니다. 키와 OpenAPI는 개발자를 보세요. 재시도에는
Idempotency-Key를 붙이는 편이 좋습니다(Idempotency-Key).
성공은 어떤 모습인가
복구 후에도 객체가 충분히 남아 있었다면, 뷰어는 “damaged PDF” 오류 없이 파일을 열어야 합니다. 구조가 깨끗하게 복구됐다면 문서 정보의 페이지 수가 원본에서 기대한 값과 맞아야 합니다. 그래도 파일이 열리지 않는다면 압축 / OCR / 변환을 더 호출해도 빠진 바이트가 생기지 않습니다. 멈추고, 정책이 요구한다면 이 카탈로그 밖의 포렌식 도구를 위해 원본을 보관하세요.
사용해 보기
PDF 복구에 손상된 파일을 올리거나, API 키와 함께 POST /api/v1/misc/repair를 호출하세요. 복구본 옆에 손상된 원본을 남겨 두세요. 에이전트 지향 접근(MCP, pipeline, OpenAPI)은 개발자에서 시작하세요.