Claude Code로 PDF 병합·분할·표 추출하기 ― pdf 스킬
機械翻訳 / Machine-translated
원문: Claude Code로 PDF 병합·분할·표 추출하기 ― pdf 스킬(cccskills)
스킬 페이지: pdf
이 글의 결론
pdf 스킬을 도입하면, PDF 병합이나 필요한 페이지 추출, 표의 Excel 변환을, Claude Code에 한국어로 부탁하는 것만으로 처리할 수 있습니다.
텍스트·이미지 추출, 회전, 신규 생성, 폼 입력, 스캔 문서의 문자 인식, 비밀번호 보호도 대상입니다.
이 글에서는 요청문 예시와 설치 방법, 사용 전에 확인할 사항을 소개합니다.
pdf 스킬을 도입하면, PDF 가공을 한국어 요청문으로 부탁할 수 있게 됩니다.
예를 들어 다음과 같이 보냅니다.
매출보고.pdf에 있는 표를 전부 꺼내서, 하나의 Excel 파일로 정리해 줘
에이전트는 pdfplumber라는 Python 라이브러리를 사용해, 각 페이지의 표를 순서대로 읽어 들입니다.
표의 첫 번째 행을 열 이름으로 처리하고, 전 페이지의 표를 세로로 연결해 하나로 만드는 흐름입니다.
결과는 extracted_tables.xlsx와 같은 이름의 Excel 파일로 저장됩니다.
이 스킬은, .pdf 파일 얘기가 나올 때나 PDF 작성을 부탁받았을 때 사용되도록 설계되었습니다.
매번 스킬 이름을 적지 않아도, PDF 얘기를 하면 절차가 호출됩니다.
표를 하나씩 복사해 붙여넣는 작업이, 완성된 Excel을 확인하는 작업으로 바뀝니다.
pdf 스킬은, PDF의 읽기·가공·생성 절차를 하나로 모은 것입니다.
Python 라이브러리와 커맨드라인 툴로 PDF를 다루는 방법이, 작업별로 정리되어 있습니다.
사용자가 하는 작업으로 나누면, 다음 4가지가 됩니다.
PDF의 본문을 텍스트로 추출할 수 있습니다.
레이아웃을 유지한 채 꺼내는 방법이나, 1~5페이지처럼 범위를 좁히는 방법도 포함되어 있습니다.
표는 페이지별로 읽어 들여 Excel 파일로 정리하는 것도 가능합니다.
PDF에 삽입된 이미지는, 연번 JPEG 파일로 출력됩니다.
제목이나 작성자 같은 메타데이터(문서 속성 정보) 읽기도 대상입니다.
여러 PDF를, 지정한 순서대로 하나로 병합할 수 있습니다.
반대로 1페이지씩 별도 파일로 분리하는 처리나, "6~10페이지만"과 같은 범위 추출도 대상입니다.
페이지를 90도 회전시켜 방향을 바로잡는 처리도 포함되어 있습니다.
워터마크용 PDF를 전 페이지에 겹치는 것도 가능합니다.
텍스트를 배치한 PDF를 새로 만들 수 있습니다.
제목과 본문을 나열하고, 페이지 나누기를 넣은 여러 페이지 보고서 형식에도 대응하고 있습니다.
PDF 폼 입력은, 동봉된 FORMS.md의 절차에 따라 진행하는 구성입니다.
입력 항목의 정보를 꺼내는 스크립트와, 입력 항목에 값을 넣는 스크립트가 동봉되어 있습니다.
종이를 스캔한 PDF는, 각 페이지를 이미지로 변환한 후 OCR(이미지 내 문자를 읽는 처리)을 적용하는 흐름입니다.
읽어 들인 텍스트는, 페이지 번호와 함께 순서대로 반환됩니다.
PDF에 비밀번호를 거는 처리와, 비밀번호를 알고 있는 PDF의 보호를 해제하는 처리도 대상입니다.
pdf 스킬은, 커맨드 한 줄 또는 에이전트에 대한 요청문으로 설치할 수 있습니다.
커맨드로 설치하는 경우는 다음과 같습니다.
npx skills add https://github.com/anthropics/skills --skill pdf
이 커맨드에서는, Claude Code나 Codex 등 설치할 에이전트를 선택할 수 있습니다.
에이전트에게 맡기는 경우는, 다음 문구를 그대로 보내 주세요.
次の Agent Skill をインストールしてください。
https://github.com/anthropics/skills/tree/main/skills/pdf
まず SKILL.md と付属ファイルの中身を確認し、不審な処理(外部への送信、認証情報の読み取りなど)がないことを確かめてから、Claude Code なら ~/.claude/skills/pdf/、Codex なら ~/.agents/skills/pdf/ に配置してください。
저장 위치는 다음 표와 같습니다.
모든 프로젝트에서 사용할 경우에는 사용자 단위, 특정 프로젝트에서만 사용할 경우에는 프로젝트 단위로 저장합니다.
| 에이전트 | 사용자 단위 | 프로젝트 단위 |
|---|---|---|
| Claude Code | ~/.claude/skills/ | .claude/skills/ |
| Codex | ~/.agents/skills/ | .agents/skills/ |
배포처는 GitHub의 anthropics/skills입니다.
설치 전에, 이 페이지에서 SKILL.md와 동봉 파일의 내용을 훑어봐 두세요.
요청문에는, 대상 파일명과 원하는 결과를 그대로 적습니다.
자주 사용하는 요청 3가지를 소개합니다.
4월·5월·6월 보고서 PDF를, 이 순서대로 하나로 병합해 줘.
첫 페이지가 가로 방향이니 방향도 바로잡아 줘
3개의 파일이 지정한 순서대로 나열되어, 하나의 PDF로 저장됩니다.
첫 페이지는 90도 회전하여, 다른 페이지와 방향이 맞춰집니다.
출력처는 merged.pdf와 같은 새 파일입니다.
계약서.pdf의 6~10페이지만 추출해서, 별도 PDF로 만들어 줘
지정한 범위의 페이지만, 새 PDF로 출력됩니다.
전 페이지를 한 장씩 별도 파일로 분리하고 싶을 때도, 같은 방식으로 부탁할 수 있습니다.
스캔한 회의록.pdf의 텍스트를 읽어서, 텍스트로 보여 줘
각 페이지를 이미지로 변환한 후 OCR을 적용하므로, "Page 1", "Page 2"처럼 페이지별로 구분된 텍스트가 반환됩니다.
읽기 결과는, 원본 이미지와 비교하여 확인해 주세요.
pdf 스킬을 사용하기 전에, 필요한 툴과 원본 파일 취급 방법을 확인해 주세요.
사용하는 라이브러리와 툴은, 작업 내용에 따라 달라집니다.
주요 조합은 다음 표와 같습니다.
| 작업 | 사용하는 것 |
|---|---|
| 병합·분할·회전·비밀번호 | pypdf、qpdf |
| 텍스트·표 추출 | pdfplumber、pdftotext(poppler-utils) |
| 표의 Excel 변환 | pdfplumber、pandas |
| PDF 신규 생성 | reportlab |
| 스캔 PDF OCR | pytesseract、pdf2image |
| 이미지 추출 | pdfimages(poppler-utils) |
pdftk는, 설치되어 있는 환경에서만 사용하는 방식입니다.
부족한 것이 있으면, 무엇을 설치해야 하는지를 먼저 에이전트에게 설명하게 한 후 도입하세요.
그렇게 하면, 로컬 환경을 파악하기 쉬워집니다.
SKILL.md의 처리 예시에서는, 결과를 다른 이름의 새 파일로 출력합니다.
그래도, 중요한 자료는 복사본을 만들어 두고 부탁하는 편이 안전합니다.
출력처 파일명을 요청문에 지정해 두면, 어느 것이 가공 후 파일인지 헷갈리지 않습니다.
OCR 처리 예시에는, 읽을 언어 지정이 없습니다.
한국어 스캔 문서를 읽힐 때는, 결과를 반드시 확인해 주세요.
reportlab으로 PDF를 만드는 경우, 아래첨자·위첨자의 Unicode 문자는 검은 사각형으로 표시되므로, 전용 태그로 작성해야 합니다.
라이선스는 고유한 조건으로, 전문은 LICENSE.txt에 있습니다.
설치 전에 SKILL.md와 동봉 스크립트를 읽고, 외부 송신 등 의심스러운 처리가 없는지 확인해 주세요.
PDF 전후로 Word 자료도 다룬다면, 같은 저장소의 docx가 도움이 됩니다.
Word 문서나 템플릿의 생성·편집, 내용 추출을 지원하는 스킬입니다.
표와 이미지 배치, 변경 이력과 댓글 처리에도 대응하고 있습니다.
지정하지 않아도 사용됩니다.
pdf 스킬은, .pdf 파일 얘기가 나올 때나 PDF 작성을 부탁받았을 때 사용하도록 설계되어 있습니다.
사용할 수 있습니다.
설치 커맨드에서 설치 대상으로 Codex를 선택하거나, ~/.agents/skills/pdf/에 배치해 주세요.
가능합니다.
폼 입력은, 동봉된 FORMS.md의 절차에 따라 진행하는 구조입니다.
입력 항목의 정보를 꺼내는 스크립트나, 값을 입력하는 스크립트도 동봉되어 있습니다.
pdf 스킬을 도입하면, PDF 병합·분할·회전, 표의 Excel 변환, 스캔 문서 문자 인식을 요청문으로 부탁할 수 있습니다.
신규 생성이나 폼 입력, 비밀번호 보호도 같은 스킬로 처리할 수 있습니다.
사용 전에, 필요한 라이브러리와 동봉 파일의 내용을 확인해 두세요.
설치 방법과 소개 문구는 cccskills 페이지에 정리되어 있습니다.
이 글은 cccskills의 읽을거리 「Claude Code로 PDF 병합·분할·표 추출하기 ― pdf 스킬」의 전재입니다.
스킬 상세 내용과 설치 방법은 cccskills의 pdf 페이지에 있습니다.