Nutrient Document Processing

1---2name: nutrient-document-processing3description: Process, convert, OCR, extract, redact, sign, and fill documents using the Nutrient DWS API. Works with PDFs, DOCX, XLSX, PPTX, HTML, and images.4origin: ECC5---6 7# Nutrient Document Processing8 9> **Note:** This skill integrates with the Nutrient commercial API. Review their terms before use.10 11Process documents with the [Nutrient DWS Processor API](https://www.nutrient.io/api/). Convert formats, extract text and tables, OCR scanned documents, redact PII, add watermarks, digitally sign, and fill PDF forms.12 13## Setup14 15Get a free API key at **[nutrient.io](https://dashboard.nutrient.io/sign_up/?product=processor)**16 17```bash18export NUTRIENT_API_KEY="pdf_live_..."19```20 21All requests go to `https://api.nutrient.io/build` as multipart POST with an `instructions` JSON field.22 23## Operations24 25### Convert Documents26 27```bash28# DOCX to PDF29curl -X POST https://api.nutrient.io/build \30  -H "Authorization: Bearer $NUTRIENT_API_KEY" \31  -F "document.docx=@document.docx" \32  -F 'instructions={"parts":[{"file":"document.docx"}]}' \33  -o output.pdf34 35# PDF to DOCX36curl -X POST https://api.nutrient.io/build \37  -H "Authorization: Bearer $NUTRIENT_API_KEY" \38  -F "document.pdf=@document.pdf" \39  -F 'instructions={"parts":[{"file":"document.pdf"}],"output":{"type":"docx"}}' \40  -o output.docx41 42# HTML to PDF43curl -X POST https://api.nutrient.io/build \44  -H "Authorization: Bearer $NUTRIENT_API_KEY" \45  -F "index.html=@index.html" \46  -F 'instructions={"parts":[{"html":"index.html"}]}' \47  -o output.pdf48```49 50Supported inputs: PDF, DOCX, XLSX, PPTX, DOC, XLS, PPT, PPS, PPSX, ODT, RTF, HTML, JPG, PNG, TIFF, HEIC, GIF, WebP, SVG, TGA, EPS.51 52### Extract Text and Data53 54```bash55# Extract plain text56curl -X POST https://api.nutrient.io/build \57  -H "Authorization: Bearer $NUTRIENT_API_KEY" \58  -F "document.pdf=@document.pdf" \59  -F 'instructions={"parts":[{"file":"document.pdf"}],"output":{"type":"text"}}' \60  -o output.txt61 62# Extract tables as Excel63curl -X POST https://api.nutrient.io/build \64  -H "Authorization: Bearer $NUTRIENT_API_KEY" \65  -F "document.pdf=@document.pdf" \66  -F 'instructions={"parts":[{"file":"document.pdf"}],"output":{"type":"xlsx"}}' \67  -o tables.xlsx68```69 70### OCR Scanned Documents71 72```bash73# OCR to searchable PDF (supports 100+ languages)74curl -X POST https://api.nutrient.io/build \75  -H "Authorization: Bearer $NUTRIENT_API_KEY" \76  -F "scanned.pdf=@scanned.pdf" \77  -F 'instructions={"parts":[{"file":"scanned.pdf"}],"actions":[{"type":"ocr","language":"english"}]}' \78  -o searchable.pdf79```80 81Languages: Supports 100+ languages via ISO 639-2 codes (e.g., `eng`, `deu`, `fra`, `spa`, `jpn`, `kor`, `chi_sim`, `chi_tra`, `ara`, `hin`, `rus`). Full language names like `english` or `german` also work. See the [complete OCR language table](https://www.nutrient.io/guides/document-engine/ocr/language-support/) for all supported codes.82 83### Redact Sensitive Information84 85```bash86# Pattern-based (SSN, email)87curl -X POST https://api.nutrient.io/build \88  -H "Authorization: Bearer $NUTRIENT_API_KEY" \89  -F "document.pdf=@document.pdf" \90  -F 'instructions={"parts":[{"file":"document.pdf"}],"actions":[{"type":"redaction","strategy":"preset","strategyOptions":{"preset":"social-security-number"}},{"type":"redaction","strategy":"preset","strategyOptions":{"preset":"email-address"}}]}' \91  -o redacted.pdf92 93# Regex-based94curl -X POST https://api.nutrient.io/build \95  -H "Authorization: Bearer $NUTRIENT_API_KEY" \96  -F "document.pdf=@document.pdf" \97  -F 'instructions={"parts":[{"file":"document.pdf"}],"actions":[{"type":"redaction","strategy":"regex","strategyOptions":{"regex":"\\b[A-Z]{2}\\d{6}\\b"}}]}' \98  -o redacted.pdf99```100 101Presets: `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`.102 103### Add Watermarks104 105```bash106curl -X POST https://api.nutrient.io/build \107  -H "Authorization: Bearer $NUTRIENT_API_KEY" \108  -F "document.pdf=@document.pdf" \109  -F 'instructions={"parts":[{"file":"document.pdf"}],"actions":[{"type":"watermark","text":"CONFIDENTIAL","fontSize":72,"opacity":0.3,"rotation":-45}]}' \110  -o watermarked.pdf111```112 113### Digital Signatures114 115```bash116# Self-signed CMS signature117curl -X POST https://api.nutrient.io/build \118  -H "Authorization: Bearer $NUTRIENT_API_KEY" \119  -F "document.pdf=@document.pdf" \120  -F 'instructions={"parts":[{"file":"document.pdf"}],"actions":[{"type":"sign","signatureType":"cms"}]}' \121  -o signed.pdf122```123 124### Fill PDF Forms125 126```bash127curl -X POST https://api.nutrient.io/build \128  -H "Authorization: Bearer $NUTRIENT_API_KEY" \129  -F "form.pdf=@form.pdf" \130  -F 'instructions={"parts":[{"file":"form.pdf"}],"actions":[{"type":"fillForm","formFields":{"name":"Jane Smith","email":"jane@example.com","date":"2026-02-06"}}]}' \131  -o filled.pdf132```133 134## MCP Server (Alternative)135 136For native tool integration, use the MCP server instead of curl:137 138```json139{140  "mcpServers": {141    "nutrient-dws": {142      "command": "npx",143      "args": ["-y", "@nutrient-sdk/dws-mcp-server"],144      "env": {145        "NUTRIENT_DWS_API_KEY": "YOUR_API_KEY",146        "SANDBOX_PATH": "/path/to/working/directory"147      }148    }149  }150}151```152 153## When to Use154 155- Converting documents between formats (PDF, DOCX, XLSX, PPTX, HTML, images)156- Extracting text, tables, or key-value pairs from PDFs157- OCR on scanned documents or images158- Redacting PII before sharing documents159- Adding watermarks to drafts or confidential documents160- Digitally signing contracts or agreements161- Filling PDF forms programmatically162 163## Links164 165- [API Playground](https://dashboard.nutrient.io/processor-api/playground/)166- [Full API Docs](https://www.nutrient.io/guides/dws-processor/)167- [npm MCP Server](https://www.npmjs.com/package/@nutrient-sdk/dws-mcp-server)