Procesamiento de Documentos con Nutrient
Nota: Esta habilidad se integra con la API comercial de Nutrient. Revisa sus términos antes de usarla.
Procesa documentos con la API de Nutrient DWS Processor. Convierte formatos, extrae texto y tablas, aplica OCR a documentos escaneados, redacta información personal, añade marcas de agua, firma digitalmente y rellena formularios PDF.
Configuración
Obtén una clave API gratuita en nutrient.io
export NUTRIENT_API_KEY="pdf_live_..."
Todas las solicitudes se envían a https://api.nutrient.io/build como POST multipart con un campo JSON instructions.
Operaciones
Convertir Documentos
# DOCX a 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 a 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 a 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
Entradas compatibles: PDF, DOCX, XLSX, PPTX, DOC, XLS, PPT, PPS, PPSX, ODT, RTF, HTML, JPG, PNG, TIFF, HEIC, GIF, WebP, SVG, TGA, EPS.
Extraer Texto y Datos
# Extraer texto plano
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
# Extraer tablas como Excel
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 en Documentos Escaneados
# OCR a PDF buscable (soporta más de 100 idiomas)
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
Idiomas: Soporta más de 100 idiomas mediante códigos ISO 639-2 (ej., eng, deu, fra, spa, jpn, kor, chi_sim, chi_tra, ara, hin, rus). También funcionan nombres completos de idiomas como english o german. Consulta la tabla completa de idiomas OCR para todos los códigos compatibles.
Redactar Información Sensible
# Basado en patrones (SSN, correo electrónico)
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
# Basado en expresiones regulares
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
Valores predefinidos: 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.
Añadir Marcas de Agua
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":"CONFIDENCIAL","fontSize":72,"opacity":0.3,"rotation":-45}]}' \
-o watermarked.pdf
Firmas Digitales
# Firma CMS autofirmada
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
Rellenar Formularios 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":"Juan Pérez","email":"[email protected]","date":"2026-02-06"}}]}' \
-o filled.pdf
Servidor MCP (Alternativa)
Para integración nativa con herramientas, utiliza el servidor MCP en lugar de curl:
{
"mcpServers": {
"nutrient-dws": {
"command": "npx",
"args": ["-y", "@nutrient-sdk/dws-mcp-server"],
"env": {
"NUTRIENT_DWS_API_KEY": "TU_API_KEY",
"SANDBOX_PATH": "/ruta/al/directorio/de/trabajo"
}
}
}
}
Cuándo Usarlo
- Convertir documentos entre formatos (PDF, DOCX, XLSX, PPTX, HTML, imágenes)
- Extraer texto, tablas o pares clave-valor de PDFs
- Aplicar OCR a documentos escaneados o imágenes
- Redactar información personal antes de compartir documentos
- Añadir marcas de agua a borradores o documentos confidenciales
- Firmar digitalmente contratos o acuerdos
- Rellenar formularios PDF programáticamente