Nutrient 문서 처리
참고: 이 스킬은 Nutrient 상용 API와 통합됩니다. 사용 전에 해당 이용 약관을 확인하세요.
Nutrient DWS Processor API로 문서를 처리하세요. 형식 변환, 텍스트 및 표 추출, 스캔 문서 OCR, 개인정보 편집, 워터마크 추가, 디지털 서명, PDF 폼 작성을 수행할 수 있습니다.
설정
**nutrient.io**에서 무료 API 키를 받으세요.
export NUTRIENT_API_KEY="pdf_live_..."
모든 요청은 https://api.nutrient.io/build로 멀티파트 POST 방식으로 전송되며, instructions JSON 필드를 포함합니다.
작업
문서 변환
# DOCX → PDF
curl -X POST https://api.nutrient.io/build \
-H "Authorization: Bearer $NUTRIENT_API_KEY" \
-F "[email protected]" \
-F 'instructions={"parts":[{"file":"document.docx"}]}' \
-o output.pdf
# PDF → DOCX
curl -X POST https://api.nutrient.io/build \
-H "Authorization: Bearer $NUTRIENT_API_KEY" \
-F "[email protected]" \
-F 'instructions={"parts":[{"file":"document.pdf"}],"output":{"type":"docx"}}' \
-o output.docx
# HTML → PDF
curl -X POST https://api.nutrient.io/build \
-H "Authorization: Bearer $NUTRIENT_API_KEY" \
-F "[email protected]" \
-F 'instructions={"parts":[{"html":"index.html"}]}' \
-o output.pdf
지원 입력 형식: PDF, DOCX, XLSX, PPTX, DOC, XLS, PPT, PPS, PPSX, ODT, RTF, HTML, JPG, PNG, TIFF, HEIC, GIF, WebP, SVG, TGA, EPS.
텍스트 및 데이터 추출
# 일반 텍스트 추출
curl -X POST https://api.nutrient.io/build \
-H "Authorization: Bearer $NUTRIENT_API_KEY" \
-F "[email protected]" \
-F 'instructions={"parts":[{"file":"document.pdf"}],"output":{"type":"text"}}' \
-o output.txt
# 표를 엑셀로 추출
curl -X POST https://api.nutrient.io/build \
-H "Authorization: Bearer $NUTRIENT_API_KEY" \
-F "[email protected]" \
-F 'instructions={"parts":[{"file":"document.pdf"}],"output":{"type":"xlsx"}}' \
-o tables.xlsx
스캔 문서 OCR
# OCR → 검색 가능한 PDF (100개 이상 언어 지원)
curl -X POST https://api.nutrient.io/build \
-H "Authorization: Bearer $NUTRIENT_API_KEY" \
-F "[email protected]" \
-F 'instructions={"parts":[{"file":"scanned.pdf"}],"actions":[{"type":"ocr","language":"english"}]}' \
-o searchable.pdf
언어: ISO 639-2 코드(예: eng, deu, fra, spa, jpn, kor, chi_sim, chi_tra, ara, hin, rus)를 사용하여 100개 이상의 언어를 지원합니다. english 또는 german과 같은 전체 언어 이름도 사용 가능합니다. 지원되는 모든 코드는 OCR 언어 지원 전체 표를 참조하세요.
민감 정보 편집
# 패턴 기반 (SSN, 이메일)
curl -X POST https://api.nutrient.io/build \
-H "Authorization: Bearer $NUTRIENT_API_KEY" \
-F "[email protected]" \
-F 'instructions={"parts":[{"file":"document.pdf"}],"actions":[{"type":"redaction","strategy":"preset","strategyOptions":{"preset":"social-security-number"}},{"type":"redaction","strategy":"preset","strategyOptions":{"preset":"email-address"}}]}' \
-o redacted.pdf
# 정규식 기반
curl -X POST https://api.nutrient.io/build \
-H "Authorization: Bearer $NUTRIENT_API_KEY" \
-F "[email protected]" \
-F 'instructions={"parts":[{"file":"document.pdf"}],"actions":[{"type":"redaction","strategy":"regex","strategyOptions":{"regex":"\\b[A-Z]{2}\\d{6}\\b"}}]}' \
-o redacted.pdf
사전 설정: social-security-number, email-address, credit-card-number, international-phone-number, north-american-phone-number, date, time, url, ipv4, ipv6, mac-address, us-zip-code, vin.
워터마크 추가
curl -X POST https://api.nutrient.io/build \
-H "Authorization: Bearer $NUTRIENT_API_KEY" \
-F "[email protected]" \
-F 'instructions={"parts":[{"file":"document.pdf"}],"actions":[{"type":"watermark","text":"CONFIDENTIAL","fontSize":72,"opacity":0.3,"rotation":-45}]}' \
-o watermarked.pdf
디지털 서명
# 자체 서명 CMS 서명
curl -X POST https://api.nutrient.io/build \
-H "Authorization: Bearer $NUTRIENT_API_KEY" \
-F "[email protected]" \
-F 'instructions={"parts":[{"file":"document.pdf"}],"actions":[{"type":"sign","signatureType":"cms"}]}' \
-o signed.pdf
PDF 폼 채우기
curl -X POST https://api.nutrient.io/build \
-H "Authorization: Bearer $NUTRIENT_API_KEY" \
-F "[email protected]" \
-F 'instructions={"parts":[{"file":"form.pdf"}],"actions":[{"type":"fillForm","formFields":{"name":"Jane Smith","email":"[email protected]","date":"2026-02-06"}}]}' \
-o filled.pdf
MCP 서버 (대안)
curl 대신 네이티브 도구 통합을 위해 MCP 서버를 사용할 수 있습니다:
{
"mcpServers": {
"nutrient-dws": {
"command": "npx",
"args": ["-y", "@nutrient-sdk/dws-mcp-server"],
"env": {
"NUTRIENT_DWS_API_KEY": "YOUR_API_KEY",
"SANDBOX_PATH": "/path/to/working/directory"
}
}
}
}
사용 시점
- 문서 형식 간 변환이 필요할 때 (PDF, DOCX, XLSX, PPTX, HTML, 이미지)
- PDF에서 텍스트, 표, 키-값 쌍을 추출할 때
- 스캔 문서나 이미지에 OCR을 적용할 때
- 문서 공유 전 개인정보(PII)를 편집할 때
- 초안 또는 기밀 문서에 워터마크를 추가할 때
- 계약서나 합의서를 디지털 서명할 때
- PDF 폼을 프로그래밍 방식으로 채울 때