Un escaneo de la sala de correo es una imagen: nadie puede buscar en ella, y un extractor de texto no encuentra nada. El código de barras en la página es la excepción. El servidor GroupDocs.Parser.Mcp se ejecuta localmente en Docker, y un agente de IA en un cliente como Claude Desktop, Cursor o GitHub Copilot puede pedirle que lea códigos de barras de documentos escaneados y devuelva los valores decodificados:

Lee los códigos de barras en estas notas de entrega escaneadas y enumera los valores con el archivo del que provienen.

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

¿Por qué un escaneo necesita un lector de códigos de barras y no un extractor de texto?

Una página escaneada no tiene capa de texto. extract_text devuelve poco o nada para ella, lo cual es una afirmación verdadera sobre el archivo. Sin embargo, los modelos del motor detectan códigos en la imagen rasterizada, por lo que extract_barcodes sigue devolviendo el número de seguimiento impreso en una nota de entrega escaneada. El servidor no tiene OCR, por lo que las palabras impresas permanecen como píxeles; solo los códigos se convierten en datos.

¿Qué devuelve la herramienta?

extract_barcodes devuelve una línea de encabezado, Found N barcode(s) in ..., seguida de una matriz JSON con un objeto por código, cada uno con index, value, type, page, confidence y angle. Detecta Code128, QR Code, PDF417, DataMatrix, EAN-13, EAN-8, UPC, Aztec y muchas más simbologías, en PDF, DOCX, XLSX, PPTX, PNG, JPG, TIFF y otros formatos. Cuando no se encuentra nada, devuelve un mensaje de “No barcodes found”.

Sesión de ejemplo (abreviada):

You:    Read the barcodes on page 1 of dn-2291.pdf and tell me which order it belongs to.
Agent:  [calls extract_barcodes with page 1]
        Found 1 barcode(s) in dn-2291.pdf
        [{"index": 1, "value": "SHP-884120377", "type": "Code128", "page": 1, "confidence": 0.98, "angle": 0}]
        The delivery note carries tracking number SHP-884120377.

¿Cómo conviertes un escaneo en un registro?

El valor decodificado suele ser la clave de unión: el número de seguimiento que vincula un escaneo a un envío, la referencia de pedido que vincula un formulario firmado a un caso, la etiqueta de activo que vincula una fotografía a un registro de inventario. Una vez que el agente lo tiene, la imagen se convierte en una fila.

Para cada escaneo, lee el código de barras y dime a qué pedido pertenece.

El agente llama a extract_barcodes por archivo y compara cada valor con los pedidos que le proporcionas. Pasa page para escanear solo la página que lleva la etiqueta, en lugar de todas las páginas de un documento extenso.

¿Cómo ordenas un lote mixto de escaneos y archivos digitales nativos?

Deja que el agente ramifique según si un archivo tiene texto.

Para cada archivo: intenta la extracción de texto. Si devuelve vacío, lee los códigos de barras en su lugar y dime qué archivos lo necesitaban.

Los archivos que pasaron a la lectura de códigos de barras son los escaneos. Esa lista es un inventario útil por sí misma si estás planificando un proyecto de ingestión. Añade un paso de enrutamiento encima, como “agrupa los archivos por el prefijo de su valor de código de barras”, y la carpeta llega ya ordenada.

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

Ambos servidores pueden leer un código de barras o código QR de un escaneo: Parser con extract_barcodes, Signature con search_barcodes y search_qr_codes. Usa GroupDocs.Parser.Mcp cuando estés extrayendo datos de escaneos arbitrarios y también necesites texto, tablas o metadatos de los mismos archivos. Usa GroupDocs.Signature.Mcp cuando el código sea un elemento de firma que también añades, o cuando los documentos fluyan en ambos sentidos y firmes el documento saliente con un nuevo código. La parte de Signature se cubre en De código de barras a registro: automatización de ingreso de documentos con agentes de IA.

¿Cuáles son los límites?

  • Un valor decodificado es datos no confiables. Quien produjo el documento lo eligió. Regístralo, búscalo, compáralo y no permitas que un agente actúe sobre él sin revisión.
  • Los escaneos de mala calidad pueden no decodificarse. Los códigos sesgados, de baja resolución o dañados pueden no devolver nada. Un resultado vacío significa “no encontrado”, lo que en un escaneo malo no es lo mismo que “no presente”.
  • El modo de evaluación es limitado. Sin una licencia, la extracción está limitada; consulta la página de licencias de la biblioteca y pide al agente que ejecute get_license_status primero.
  • Solo Docker. Los modelos están empaquetados en la imagen, por lo que es grande. No existe el comando dnx; el contenedor se inicia con docker run --rm -i -v $(pwd)/documents:/data ghcr.io/groupdocs-parser/parser-net-mcp:latest, y los enlaces de un clic para VS Code y Cursor están en Registrarse en clientes de IA.

Preguntas frecuentes

¿Puede Claude leer un código de barras de un PDF escaneado?
Sí, a través de la herramienta extract_barcodes, que se ejecuta en un contenedor local sobre el archivo escaneado. Claude recibe el valor decodificado, el tipo y la página.

¿Puedo leer un código QR en un documento escaneado sin OCR?
Sí. La detección de códigos no depende del reconocimiento de texto, por lo que los códigos QR se decodifican incluso cuando las palabras impresas en la página no lo hacen.

¿Cómo ordeno automáticamente los documentos escaneados por código de barras?
Pide al agente que lea el código en cada escaneo y agrupe o renombre los archivos por su valor. Revisa la agrupación antes de mover los archivos, porque los valores decodificados provienen del propio documento.

Profundiza