Une numérisation de la salle du courrier est une image : personne ne peut la rechercher, et un extracteur de texte n’y trouve rien. Le code‑barres sur la page est l’exception. Le serveur GroupDocs.Parser.Mcp s’exécute localement dans Docker, et un agent IA dans un client tel que Claude Desktop, Cursor ou GitHub Copilot peut lui demander de lire les codes‑barres des documents numérisés et de renvoyer les valeurs décodées :

Lire les codes‑barres dans ces bons de livraison numérisés et lister les valeurs avec le fichier d’où ils proviennent.

La version étape par étape avec configuration et dépannage se trouve dans la documentation : Comment lire les codes‑barres et les QR codes à partir de documents numérisés.

Pourquoi une numérisation a-t-elle besoin d’un lecteur de code‑barres et non d’un extracteur de texte ?

Une page numérisée n’a pas de couche de texte. extract_text renvoie peu ou rien pour celle‑ci, ce qui est une affirmation exacte concernant le fichier. Les modèles du moteur, cependant, détectent les codes dans l’image rasterisée, de sorte que extract_barcodes renvoie toujours le numéro de suivi imprimé sur un bon de livraison numérisé. Le serveur ne possède pas d’OCR, ainsi les mots imprimés restent des pixels ; seuls les codes deviennent des données.

Que renvoie l’outil ?

extract_barcodes renvoie une ligne d’en‑tête, Found N barcode(s) in ..., suivie d’un tableau JSON contenant un objet par code, chacun avec index, value, type, page, confidence et angle. Il détecte Code128, QR Code, PDF417, DataMatrix, EAN‑13, EAN‑8, UPC, Aztec et bien d’autres symbologies, dans les formats PDF, DOCX, XLSX, PPTX, PNG, JPG, TIFF et autres. Lorsqu’aucun code n’est trouvé, il renvoie le message « No barcodes found ».

Exemple de session (abrégé) :

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.

Comment transformer une numérisation en enregistrement ?

La valeur décodée est généralement la clé de jointure : le numéro de suivi qui relie une numérisation à un envoi, la référence de commande qui relie un formulaire signé à un dossier, l’étiquette d’actif qui relie une photographie à un enregistrement d’inventaire. Une fois que l’agent l’a, l’image devient une ligne.

Pour chaque numérisation, lire le code‑barres et me dire à quelle commande il appartient.

L’agent appelle extract_barcodes par fichier et fait correspondre chaque valeur aux commandes que vous lui fournissez. Passez page pour analyser uniquement la page qui porte l’étiquette, au lieu de chaque page d’un document long.

Comment trier un lot mixte de numérisations et de fichiers nés numériques ?

Laissez l’agent bifurquer selon qu’un fichier possède du texte ou non.

Pour chaque fichier : essayer l’extraction de texte. Si le résultat est vide, lire les codes‑barres à la place et me dire quels fichiers en avaient besoin.

Les fichiers qui ont été dirigés vers la lecture de codes‑barres sont les numérisations. Cette liste constitue un inventaire utile en soi si vous planifiez un projet d’ingestion. Ajoutez une étape de routage supplémentaire, comme « grouper les fichiers par le préfixe de leur valeur de code‑barres », et le dossier arrive déjà trié.

Quel serveur lit le code : Parser ou Signature ?

Les deux serveurs peuvent lire un code‑barres ou un QR code à partir d’une numérisation : Parser avec extract_barcodes, Signature avec search_barcodes et search_qr_codes. Utilisez GroupDocs.Parser.Mcp lorsque vous extrayez des données de numérisations arbitraires et avez également besoin de texte, de tableaux ou de métadonnées provenant des mêmes fichiers. Utilisez GroupDocs.Signature.Mcp lorsque le code est un élément de signature que vous ajoutez également, ou lorsque les documents circulent dans les deux sens et que vous signez le document sortant avec un nouveau code. La partie Signature est couverte dans Du code‑barres à l’enregistrement : automatisation de l’ingestion de documents avec des agents IA.

Quelles sont les limites ?

  • Une valeur décodée est une donnée non fiable. Celui qui a produit le document l’a choisie. Signalez‑la, recherchez‑la, vérifiez‑la, et ne laissez pas un agent agir dessus sans révision.
  • Les numérisations de mauvaise qualité peuvent ne pas décoder. Les codes inclinés, à basse résolution ou endommagés peuvent ne rien renvoyer. Un résultat vide signifie « not found », ce qui, sur une mauvaise numérisation, n’est pas identique à « not present ».
  • Le mode d’évaluation est limité. Sans licence, l’extraction est restreinte ; consultez la page de licence de la bibliothèque et demandez à l’agent d’exécuter get_license_status en premier.
  • Docker uniquement. Les modèles sont inclus dans l’image, ce qui explique sa taille. Il n’y a pas de commande dnx ; le conteneur démarre avec docker run --rm -i -v $(pwd)/documents:/data ghcr.io/groupdocs-parser/parser-net-mcp:latest, et les liens en un clic pour VS Code et Cursor se trouvent dans Enregistrement dans les clients IA.

FAQ

Claude peut‑il lire un code‑barres à partir d’un PDF numérisé ?
Oui, via l’outil extract_barcodes, qui s’exécute dans un conteneur local sur le fichier numérisé. Claude reçoit la valeur décodée, le type et la page.

Puis‑je lire un QR code dans un document numérisé sans OCR ?
Oui. La détection de code ne dépend pas de la reconnaissance de texte, ainsi les QR codes se décodent même lorsque les mots imprimés sur la page ne le font pas.

Comment trier automatiquement les documents numérisés par code‑barres ?
Demandez à l’agent de lire le code sur chaque numérisation et de regrouper ou renommer les fichiers par valeur. Vérifiez le regroupement avant de déplacer les fichiers, car les valeurs décodées proviennent du document lui‑même.

Approfondir