Imagine una bandeja de entrada de facturas escaneadas donde cada página lleva un código de barras que indica la orden de compra. Un agente de IA puede leer cada código en la carpeta localmente, sin subir nada, y proporcionarte una tabla que asocie cada archivo con su registro. El agente es Claude, Cursor o GitHub Copilot; la lectura la realiza el servidor GroupDocs.Signature.Mcp. Un solo prompt cubre esto:

Para cada PDF en la carpeta, lee el código de barras y dame una tabla con el nombre del archivo, el valor del código de barras y la página.

La versión paso a paso con configuración y solución de problemas está en la documentación: Cómo extraer datos de códigos QR y códigos de barras de documentos con IA.

Escenario: de un montón de archivos a una cola dirigida

Una sala de correo, un equipo de cuentas por pagar o un escritorio de gestión de casos recibe documentos en masa. Cada uno lleva un código legible por máquina colocado allí para este momento exacto. Sin automatización, alguien escribe el valor en el siguiente sistema. Con un agente, la secuencia es:

  1. Los documentos llegan a la carpeta que el servidor está configurado para usar (GROUPDOCS_MCP_STORAGE_PATH).
  2. El agente llama a search_barcodes en cada archivo y recopila los valores decodificados, páginas y posiciones.
  3. El agente devuelve la tabla. Esa tabla es la clave de unión entre los archivos y los registros en tu ERP, almacén o sistema de casos.
  4. Una persona, o un paso automatizado posterior que controles, realiza la búsqueda y el enrutamiento.

El paso 4 se mantiene fuera del agente a propósito. Ver “Qué no automatizar” a continuación.

¿Qué herramienta lee qué código?

search_qr_codes lee códigos QR. search_barcodes lee códigos de barras unidimensionales como Code39, Code128 y EAN. Cada uno devuelve el texto decodificado, la página y la posición de cada coincidencia. Si no estás seguro de qué tipo contiene un documento, solicita ambos:

Lee los códigos QR y los códigos de barras en invoice.pdf y dime qué contienen.

¿Cómo encuentras un código entre muchos?

Ambas herramientas aceptan un filtro text que devuelve solo los códigos que contienen una cadena dada:

Encuentra el código de barras que comienza con SHIP y dime en qué página está.

En un documento con una docena de códigos, eso es la diferencia entre una respuesta y una pared de valores.

Mantén las respuestas pequeñas

Ambas herramientas aceptan returnImage. Déjalo desactivado a menos que realmente necesites el gráfico. El texto decodificado es lo que el agente procesa, y las imágenes en base64 hacen que las respuestas sean grandes y lentas.

Sesión de ejemplo (abreviada)

You:    For every PDF in the folder, read the barcode, and give me a table
        of file name, barcode value, page.

Agent:  [search_barcodes] file=invoice-0007.pdf   found: 1
        [search_barcodes] file=invoice-0008.pdf   found: 1
        [search_barcodes] file=scan-0009.pdf      found: 0
        | file             | barcode value | page |
        | invoice-0007.pdf | PO-448210     | 1    |
        | invoice-0008.pdf | PO-448377     | 1    |
        scan-0009.pdf has no barcode in the pages that were processed.

​Salida ilustrativa: los nombres de archivo y los valores de los códigos de barras son inventados. La herramienta devuelve los campos descritos arriba.

Signature o Parser: ¿qué servidor lee el código?

Utiliza GroupDocs.Signature.Mcp cuando el código es un elemento de firma que también añades, o cuando los documentos fluyen en ambas direcciones: lee la referencia entrante, realiza el trabajo, luego llama a sign en el documento saliente con un código QR que lleva la nueva referencia. Utiliza GroupDocs.Parser.Mcp (disponible solo como imagen Docker; su herramienta extract_barcodes) cuando extraes datos de escaneos arbitrarios y también necesitas texto, tablas o metadatos de los mismos archivos. Este servidor lee firmas y códigos. No extrae diseño, campos ni tablas.

Qué no automatizar

  • No es OCR. Estas herramientas leen simbologías de códigos, no texto impreso. Una página escaneada sin código no devuelve nada, y eso es una respuesta correcta en lugar de un error.
  • Un valor decodificado es una entrada no confiable. Fue suministrado por quien creó el documento. Regístralo, búscalo y compáralo. No permitas que un agente actúe sobre él sin revisión.

Límites de evaluación

Sin una licencia solo se procesan las primeras 2 páginas de un documento, y se estampilla una insignia de prueba en cada página. Un código en la página 3 simplemente no se encuentra, y un resultado vacío parece “sin código”. Pide al agente que llame a get_license_status antes de confiar en un resultado vacío.

Preguntas frecuentes

¿Puede Claude leer el código QR en este PDF?
Sí. Con el servidor conectado, Claude llama a search_qr_codes y reporta el texto decodificado, la página y la posición, localmente.

¿Cómo extraigo el valor de un código de barras de una factura con IA?
Pide al agente que lea los códigos de barras en el archivo. Llama a search_barcodes y devuelve el valor decodificado; agrega un filtro text si deseas un código específico.

¿Puedo encontrar cada código QR en una carpeta de documentos?
Sí. Pide al agente que recorra la carpeta y liste el archivo, el texto decodificado y la página para cada código QR. Sin una licencia, solo se examinan las primeras 2 páginas de cada archivo.

Profundiza