Repite la cadena todos los días: de lo manual a CLI y a MCP/API
Objetivo
Tomar una cadena que has demostrado a mano en el navegador y hacer que se ejecute otra vez con menos clics, paso a paso, sin fingir que es más automática de lo que es.
El escenario. Cada lunes, recepción escanea los albaranes de la semana en una carpeta. Durante tres semanas has ejecutado Combinar, Quitar la primera página, OCR y Comprimir en el navegador. Funciona, lleva 15 minutos y estás harto.
Punto de partida
- Una cadena que ya funciona a mano (consulta diseña la tuya), con un archivo de prueba de dos o tres páginas del que conoces el resultado correcto.
- Una decisión sobre adónde pueden ir los archivos (consulta Qué canal y cuándo).
La escalera
Aplicación web (manual) → Plugins CLI (script local) → MCP (un asistente de IA lo ejecuta) → API REST (tu programa lo ejecuta)
demostrar la cadena repetir en tu máquina conversacional, en la nube integrar, en la nube
No te saltes peldaños. Cada uno reutiliza lo que te enseñó el de abajo: el orden de los pasos y los valores de las opciones.
Peldaño 1: manual, por escrito
- Escribe la cadena con los valores de las opciones (una línea por paso). Las recetas de este capítulo están escritas así.
- Cuenta el tiempo y anota qué pasos necesitan tus ojos (por ejemplo, comprobar el idioma de un escaneo). Esos pasos son los más difíciles de automatizar.
Peldaño 2: plugins CLI (locales, con scripts)
Lee antes el capítulo de la CLI. Hechos que verifica:
- Cada plugin hace una operación, necesita el runtime de .NET 10, un archivo de licencia
documentize.licjunto a la dll (sin él, modo de evaluación) y, en Linux, paquetes adicionales (libgdiplus, fontconfig, fuentes). - Los plugins no reciben rutas de archivo como parámetros. Leen una carpeta de entrada y escriben una carpeta de salida:
$PLUGIN_INPUT_DIR/<task-id>/y$PLUGIN_OUTPUT_DIR/<task-id>/. Pasa siempre tu propio--task-id. - Los comandos que documenta el capítulo, con sus parámetros:
dotnet Documentize.Merge.dll --task-id j1(los archivos se combinan por orden de nombre de archivo)dotnet Documentize.RemovePages.dll --task-id j4 --remove-range 1,3dotnet Documentize.OcrSearchable.dll --task-id j5 --language eng(necesita Tesseract en local)dotnet Documentize.Compress.dll --task-id j2 --compress-type 1dotnet Documentize.Rotate.dll --task-id j3 --angle 90
- Encadenar no usa tuberías: la carpeta de salida de un paso se copia a la carpeta de entrada del siguiente. La función
step()del capítulo hace esto.
Tu cadena del lunes, construida con esas piezas (montada a partir del ejemplo del capítulo; comprueba los nombres de los archivos de salida en tu máquina):
set -e
export PLUGIN_INPUT_DIR=$HOME/dmz/in PLUGIN_OUTPUT_DIR=$HOME/dmz/out
step() { prev=$1; next=$2; plugin=$3; shift 3
mkdir -p "$PLUGIN_INPUT_DIR/$next"
cp "$PLUGIN_OUTPUT_DIR/$prev"/*.pdf "$PLUGIN_INPUT_DIR/$next/"
dotnet "Documentize.$plugin.dll" --task-id "$next" "$@"; }
dotnet Documentize.Merge.dll --task-id w1 # escaneos ya en $PLUGIN_INPUT_DIR/w1
step w1 w2 RemovePages --remove-range 1
step w2 w3 OcrSearchable --language eng
step w3 w4 Compress --compress-type 1
El orden sigue las recetas: primero las páginas, después el texto, la compresión al final. Para ejecutarlo de forma programada, llama al script desde el planificador de tu sistema. Las herramientas para eso son las de tu sistema operativo, no las de Documentize; el libro no ha verificado ningún planificador integrado.
Salvedades honestas: los plugins se ejecutan en tu máquina, así que los archivos no salen de ella; pero hay un archivo de licencia y, según el capítulo, comprobaciones en la primera ejecución y una conexión a internet para la activación (compruébalo plugin por plugin). Las páginas del catálogo pueden mostrar un estilo de comandos distinto al de los archivos léame; manda el léame del zip. Los plugins que llaman a la IA necesitan conexión con el servicio de IA (el plugin Resume lo dice).
Peldaño 3: MCP (un asistente ejecuta la cadena)
Lee MCP. Punto de conexión https://api.documentize.app/mcp, clave dmk_ opcional como cabecera Bearer. Las herramientas que se nombran allí incluyen MergeDocuments, RemovePages, MakeSearchable, CompressDocument, ExtractFormData, AddToc, GenerateAbstract y más, además de ProcessBatch, WaitForTasks y GetTaskStatus.
- Lo dices con palabras: «Combina estas tres URL de archivos, quita la página 1, hazlo buscable, comprímelo». El asistente llama a las herramientas, espera cada tarea y pasa el enlace de cada resultado a la siguiente.
- Para 20 o más archivos, el capítulo dice que uses ProcessBatch (una operación, hasta 200 archivos por llamada) y luego WaitForTasks.
- No adivines los parámetros de las herramientas; pide al asistente que los liste. El servidor es la fuente de verdad.
- No todas las aplicaciones tienen una herramienta: por ejemplo, de Collage y Ask PDF se indica que no tienen herramienta MCP.
- Salvedades: los archivos van a la nube; las ejecuciones anónimas tienen una cuota diaria minúscula (documentada como 2 operaciones; compruébalo), las cuentas gratuitas 5 (compruébalo). Una cadena de cuatro pasos son cuatro operaciones.
Peldaño 4: API REST (tu programa la ejecuta)
Lee API REST. El patrón es enviar (POST multipart), consultar process_status/{id} (203 sigue trabajando, 200 terminado con enlaces, 204 en espera, 500 fallido), descargar y, opcionalmente, borrar.
- Úsala para integrar la cadena en una aplicación.
- Gran salvedad del capítulo: no hay una referencia pública independiente; los detalles de los puntos de conexión son «lo que el servicio hace hoy», los nombres de los campos JSON no son fijos y no está documentado si las claves
dmk_funcionan en todas las rutas. Verifica con una respuesta real y plantéate el autoalojamiento si construyes un producto. - Los trabajos largos del plan gratuito pueden detenerse con una continuación; gestiónala (el capítulo lista las rutas).
¿Qué peldaño?
- Una persona, la misma cadena cada semana, los archivos pueden quedarse en local: CLI.
- Quieres decirlo con palabras, lotes pequeños: MCP.
- Otro sistema lo dispara: API o autoalojamiento.
- Datos confidenciales: CLI o autoalojamiento, no MCP ni la API en la nube.
- Cualquier cosa que implique criterio (comprobar el idioma de un escaneo, resúmenes de IA): conserva un paso humano.
Comprueba que ha funcionado
Ejecuta la cadena automatizada sobre tu archivo de prueba y compárala con el resultado manual: número de páginas, texto seleccionable, tamaño. Repítelo después de cualquier actualización de un plugin.
Qué puede salir mal
- El plugin no encuentra mi archivo. Lee la carpeta de entrada de la tarea, no un parámetro de ruta.
- «Error de uso» (código de salida 2). Un parámetro es incorrecto; el código 1 significa que la tarea se ejecutó y falló (stderr da los detalles).
- Un paso posterior se ejecuta sobre el archivo equivocado. Tu comando de copia tomó una salida antigua; usa un task-id nuevo en cada ejecución.
- Rechazos de cuota por MCP (
quota_exceeded): te has quedado sin cuota por hoy. - La cadena difiere de la del navegador. Consulta la guía práctica de esa aplicación (biblioteca); si la guía y el libro difieren, fíate de la guía.
Por qué este orden
Primero lo manual demuestra la cadena y los valores de sus opciones. La CLI la repite en local con los mismos valores. MCP y la API añaden alcance, pero llevan tus archivos a la nube y traen cuotas, así que se eligen a conciencia, no por defecto.