convez.ai
PluginAutomaçãoIntermediário
jeongph

PDF Scan Audit

jeongph/pdf-scan-audit

Diagnóstico automático de qualidade em PDFs escaneados com verificação visual

Ver no GitHub
InicialPluginScore · de 0 a 100

Plugin que realiza diagnóstico preciso de PDFs escaneados, detectando automaticamente páginas faltantes, ordem incorreta, rotações, cortes e problemas de resolução. Processa documentos inteiros em minutos, gera relatórios visuais em PNG para verificação manual e entrega resultado formatado em tabela clara.

Instalação

$npx convez-ai jeongph/pdf-scan-audit

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 1 mês
Versão
v0.1.3
Issues abertas
0
Contribuidores
1

Casos de uso

  • Validar integridade de livros digitalizados por scanner
  • Detectar páginas rotacionadas ou cortadas em lotes de PDF
  • Mapear sequência de página-número e identificar gaps reais vs OCR incorreto
  • Gerar relatórios de qualidade antes de arquivamento ou publicação

Veredito

Ferramenta especializada e bem-executada para quem processa PDFs escaneados em volume. A abordagem de verificação visual assistida (extrai PNGs suspeitas para Claude validar) é sensata; o suporte a múltiplos scanners e offsets dinâmicos de página demonstra maturidade. Ideal para workflows de digitalização profissional, menos útil para PDFs nativos.

README

A tradução para o português deste README ainda está na fila.

pdf-scan-audit

스캔 PDF 품질 정밀 진단 — 페이지 누락·순서·회전·잘림·해상도 결함을 자동 검출하고 표로 보고합니다.

스캐너로 읽은 책이 한 권 들어왔을 때, 메타데이터만 훑지 말고 회전 의심·페이지번호 연속성·이미지 잘림까지 정밀하게 검사하는 Claude Code 플러그인입니다. 612페이지짜리 책도 5분 안에 진단하고, 의심 페이지만 골라 시각 검증한 뒤 가독성 좋은 표로 보고합니다.

설치

마켓플레이스 등록(최초 1회):

/plugin marketplace add jeongph/claude-plugins

플러그인 설치:

/plugin install pdf-scan-audit@jeongph-claude-plugins

사용 예

자연어로 호출:

이 PDF 스캔 검사해줘
스캐너로 읽은 책 한 권 점검해줘
PDF 페이지 누락이나 회전 잘못된 거 있나 봐줘

슬래시 명령:

/audit-pdf book1.pdf
/audit-pdf book1.pdf book2.pdf

검사 항목

항목설명
페이지 메타페이지 크기 분포·회전 메타·portrait/landscape 방향
해상도(DPI)페이지별 임베디드 이미지 기준 DPI 추정·일관성
빈 페이지이미지·텍스트 모두 거의 없는 페이지 검출
회전 의심텍스트 줄 종횡비로 추정. 의심 페이지는 시각 검증
이미지 커버리지이미지가 페이지 경계 밖으로 잘리거나 큰 여백이 한쪽으로 쏠림
페이지번호 연속성헤더/푸터에서 추출한 페이지번호 시퀀스의 갭 분석
OCR 오인식 vs 진짜 누락갭 크기로 자동 분류 후 의심 구간만 시각 재검증

작동 방식

  1. 의존성 확인 — python3 -c "import fitz" 체크. 없으면 pip install pymupdf 안내
  2. 임시 디렉토리 — mktemp -d -t pdf-scan-audit-XXXXXX. 작업 디렉토리는 손대지 않음
  3. 메타 검사 — 612페이지 한 번 순회로 크기·회전·DPI·빈페이지·이미지 통계 수집
  4. 콘텐츠 검사 — 텍스트 줄 bbox로 회전 의심, 이미지 bbox로 잘림 검출
  5. 페이지번호 분석 — 헤더/푸터 영역(상하단 10%)에서 숫자만 있는 줄 추출. 동적 추적으로 가장 그럴듯한 시퀀스 선택. PDF↔책 페이지 오프셋 자동 추정
  6. 의심 페이지 시각 검증 — 회전 의심·페이지번호 갭 양옆을 PNG로 추출해 Claude가 직접 보고 판정
  7. 표로 보고 — 검사 대상·핵심 결론·메타 검사·책 구조 매핑·시각 재검증·종합 진단·권장 사항 순
  8. 정리 — 임시 디렉토리 자동 삭제. --keep 옵션으로 보존 가능

적용 대상

  • 메인 타겟: 종이책을 스캐너로 읽은 PDF (Epson ScanSmart, ScanSnap, FineReader 등 출력)
  • 부분 적용: 디지털 PDF — 회전·페이지 크기·페이지번호 연속성은 의미 있음. 빈 페이지·이미지 커버리지 등은 자동 스킵

의존성

  • Python 3.8+
  • PyMuPDF (pip install pymupdf)

디렉토리 구조

pdf-scan-audit/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   └── pdf-scan-audit/
│       ├── SKILL.md
│       ├── scripts/
│       │   ├── inspect_meta.py
│       │   ├── inspect_content.py
│       │   ├── pagenum_check.py
│       │   └── extract_pages.py
│       └── references/
│           ├── interpretation.md
│           └── output-format.md
├── commands/
│   └── audit-pdf.md
├── requirements.txt
└── README.md

라이선스

MIT

Ver o original no GitHub

Bom para

Relacionados