smart-ocr은(는) 무엇을 하나요?
스마트 OCR 기술을 활용하여 이미지, PDF, 스캔된 문서에서 텍스트를 추출하고 구조화된 데이터로 변환합니다.
기능
- 고성능 텍스트 인식: 손글씨, 인쇄체, 다국어 텍스트를 높은 정확도로 인식합니다.
- 다양한 입력 형식 지원: JPEG, PNG, PDF, TIFF 등 주요 이미지 및 문서 형식을 지원합니다.
- 구조화된 데이터 출력: 추출된 텍스트를 JSON, CSV, 마크다운 테이블 등으로 변환합니다.
- 자동 처리: Claude Code의 에이전트가 사용자 요청에 따라 자동으로 OCR을 수행하고 결과를 제공합니다.
사용 방법
Claude Code에서 다음 명령어를 사용하거나, 자연어 프롬프트로 OCR을 요청할 수 있습니다.
# 이미지 파일에서 텍스트 추출
claude code ocr --image path/to/image.png
# PDF 파일 처리
claude code ocr --pdf path/to/document.pdf
# 출력 형식 지정
claude code ocr --image receipt.jpg --format json
자연어 프롬프트 예시:
- "이 영수증 이미지에서 텍스트를 추출해줘"
- "명함.jpg에 있는 정보를 JSON 형식으로 변환해줘"
- "계약서.pdf의 내용을 마크다운 테이블로 정리해줘"
지원 플랫폼
- Claude Code (권장)
- Cursor
- Codex
구성
이 스킬은 다음과 같은 구성 요소를 포함합니다:
ocr-engine/: 핵심 OCR 처리 모듈formatters/: 데이터 출력 형식 변환기preprocessors/: 이미지 전처리 (노이즈 제거, 이진화 등)config/: 언어 및 성능 설정 파일
환경 변수
| 변수명 | 설명 | 기본값 |
|---|---|---|
OCR_LANGUAGE | 인식할 언어 설정 | eng+kor |
OCR_DPI | 이미지 해상도 설정 | 300 |
OUTPUT_FORMAT | 기본 출력 형식 | json |
예제
입력 이미지
추출 결과 (JSON)
{
"store": "ABC 마트",
"date": "2025-02-15",
"items": [
{"name": "우유", "price": 2500},
{"name": "빵", "price": 1800}
],
"total": 4300
}
참고 사항
- 저품질 이미지의 경우 사전 전처리를 통해 인식률을 높일 수 있습니다.
- 한 번에 여러 문서를 처리하려면 와일드카드(
*)를 사용하세요. - 보안이 중요한 문서는 로컬 처리 모드를 활성화하세요.
연락처
문제가 발생하면 GitHub Issues를 통해 알려주세요.