Puedes aplicar una marca de agua a una carpeta de documentos con un solo mensaje: un agente de IA enumera los archivos, llama a la herramienta de marcas de agua una vez por archivo y reporta lo que ha producido, todo localmente sin cargas. En Claude Desktop, Claude Code, Cursor o Windsurf la solicitud se escribe:

Añade una marca de agua diagonal DRAFT a cada PDF en mi carpeta de documentos, luego enumera los archivos que has producido.

La versión paso a paso con configuración y solución de problemas está en la documentación: Cómo aplicar marcas de agua por lotes a una carpeta de documentos con un agente de IA.

¿Por qué estampar por etapa del ciclo de vida en lugar de hacerlo una sola vez?

Un paquete de propuesta rara vez se marca una sola vez. Comienza como Borrador (DRAFT), pasa a EN REVISIÓN cuando lo envía a un colega, y pierde su marca cuando se aprueba. Hacer eso manualmente en treinta archivos es el tipo de trabajo que se omite bajo una fecha límite. Con GroupDocs.Watermark.Mcp cada etapa es una frase, y el agente suministra el bucle que de otro modo tendrías que escribir como un script. El motor maneja el formato, de modo que la misma solicitud cubre PDF, Word, Excel, PowerPoint y archivos de imagen en una sola carpeta.

Etapa 1: ¿Cómo añades una marca de agua de borrador a todos los archivos?

Apunta GROUPDOCS_MCP_STORAGE_PATH a la carpeta. Los archivos se resuelven por nombre, por lo que el agente pasa proposal-01.pdf, no una ruta de tu máquina. Luego:

Añade una marca de agua diagonal DRAFT a cada PDF en mi carpeta de documentos, luego enumera los archivos que has producido.

El agente llama a add_watermark por archivo. Cada llamada guarda una nueva copia con marca de agua y deja el original en su lugar, de modo que la carpeta de origen sigue siendo tu registro de las versiones sin marcar.

Etapa 2: ¿Cómo cambias a una marca de revisión?

Después de la Etapa 1 cada archivo lleva DRAFT, así que intercambia la marca: elimina la anterior por texto y luego estampa el resultado.

Elimina la marca de agua DRAFT de cada archivo en esta carpeta, luego añade una marca de agua FOR REVIEW a cada resultado.

El agente llama a remove_watermarks con textFilter configurado a DRAFT, y después a add_watermark en cada copia limpiada. Para una carpeta en estado mixto, donde algunos archivos están marcados y otros no, indica al agente que revise primero:

Marca cada archivo FOR REVIEW excepto los que ya tengan una marca de agua.

Ejecuta search_watermarks en cada archivo y omite los que devuelvan una marca. Para una marca diferente por formato, indícalo así:

Pon el logotipo en las presentaciones y una marca de texto en los PDFs.

Etapa 3: ¿Cómo eliminas las marcas cuando el trabajo está aprobado?

La aprobación invierte el requisito. En la misma carpeta, con tus propios documentos:

Elimina la marca de agua DRAFT de cada archivo en esta carpeta y conserva el resto de las marcas.

Eso es remove_watermarks con un textFilter de “DRAFT”. El filtro es una coincidencia de subcadena sin distinción de mayúsculas; sin él, se elimina cualquier marca de agua que el motor pueda identificar. Los resultados se guardan como <name>_unwatermarked.<ext>. Los detalles están en la publicación complementaria sobre buscar antes de eliminar, enlazada a continuación.

Sesión de ejemplo (abreviada)

Tú:    Añade una marca de agua diagonal DRAFT a cada PDF en mi carpeta de documentos,
       luego enumera los archivos que has producido.
Agente: [add_watermark x 3: text "DRAFT", rotation -45]
        Marca de agua de texto "DRAFT" añadida a "proposal-01.pdf"
        Marca de agua de texto "DRAFT" añadida a "proposal-02.pdf"
        Marca de agua de texto "DRAFT" añadida a "proposal-03.pdf"
        Se produjeron 3 copias con marca de agua. 0 fallos.
        Los originales permanecen sin cambios.

¿Qué pasa con los originales y la carpeta de salida?

Por defecto, la entrada y la salida comparten una carpeta, de modo que las copias con marca de agua se sitúan junto a sus fuentes. Si prefieres una separación limpia, establece GROUPDOCS_MCP_OUTPUT_PATH a una carpeta distinta y envía desde allí. En cualquier caso, los originales nunca se sobrescriben, por lo que puedes volver a ejecutar una etapa después de que cambie un archivo fuente; simplemente indica los archivos que deseas procesar nuevamente.

¿Cómo mantienes una ejecución por lotes honesta?

  • Solicita la lista de archivos producidos. Una ejecución que solo informe “listo” te deja adivinando qué copias enviar.
  • Solicita los fallos explícitamente. Una carpeta mixta puede incluir un formato que el motor no pueda marcar. La llamada falla con un mensaje en lugar de omitir silenciosamente, así que pide una lista de fallos.
  • Ten en cuenta el uso medido. Con licenciamiento medido cada archivo se factura como procesamiento.
  • Verifica la licencia primero. Un lote en modo de evaluación es una ejecución desperdiciada.

¿Cuáles son los límites?

El modo de evaluación es el principal: la página de licencias del servidor indica que la salida sin licencia lleva limitaciones de evaluación; los límites exactos están en la página de licencias de la biblioteca. Una carpeta de copias en modo de evaluación es una carpeta de borradores que no puedes distribuir. Pide al agente que llame a get_license_status antes de la ejecución; reportará mode como evaluation, licensed o metered. Además, no hay un programador incorporado: el servidor actúa cuando tu agente lo solicita, por lo que un trabajo recurrente necesita un cliente o un ejecutor de tareas que envíe la solicitud.

Preguntas frecuentes

¿Puede la IA aplicar marcas de agua a varios PDFs a la vez?
Sí. El agente recorre la carpeta y llama a add_watermark una vez por archivo, luego enumera las copias que ha producido. Cada archivo se procesa por separado.

¿Puedo añadir CONFIDENTIAL a cada documento en una carpeta?
Sí. Sustituye DRAFT por CONFIDENTIAL en la solicitud. Especifica si los archivos que ya llevan una marca deben omitirse.

¿Es posible aplicar marcas de agua en lote localmente, sin subir archivos?
Sí. El servidor es un proceso local iniciado por tu cliente, y lee y escribe en la carpeta que configuraste.

Profundiza más