Ein Scan aus dem Postraum ist ein Bild: Niemand kann ihn durchsuchen, und ein Textextraktor findet nichts darin. Der Barcode auf der Seite ist die Ausnahme. Der GroupDocs.Parser.Mcp‑Server läuft lokal in Docker, und ein KI‑Agent in einem Client wie Claude Desktop, Cursor oder GitHub Copilot kann ihn auffordern, Barcodes aus gescannten Dokumenten zu lesen und die dekodierten Werte zurückzugeben:

Lies die Barcodes in diesen gescannten Lieferscheinen und liste die Werte zusammen mit der Datei, aus der sie stammen.

Die schrittweise Version mit Konfiguration und Fehlersuche befindet sich in der Dokumentation: Wie man Barcodes und QR‑Codes aus gescannten Dokumenten liest.

Warum benötigt ein Scan einen Barcode‑Leser und keinen Textextraktor?

Eine gescannte Seite hat keine Textebene. extract_text liefert dafür wenig oder nichts, was eine wahre Aussage über die Datei ist. Die Modelle der Engine erkennen jedoch Codes im gerasterten Bild, sodass extract_barcodes weiterhin die auf einem gescannten Lieferschein gedruckte Sendungsnummer zurückgibt. Der Server hat kein OCR, sodass gedruckte Wörter Pixel bleiben; nur die Codes werden zu Daten.

Was gibt das Tool zurück?

extract_barcodes gibt eine Kopfzeile zurück, Found N barcode(s) in ..., gefolgt von einem JSON‑Array mit einem Objekt pro Code, jedes mit index, value, type, page, confidence und angle. Es erkennt Code128, QR‑Code, PDF417, DataMatrix, EAN‑13, EAN‑8, UPC, Aztec und viele weitere Symbologien in PDF, DOCX, XLSX, PPTX, PNG, JPG, TIFF und anderen Formaten. Wenn nichts gefunden wird, gibt es die Meldung „No barcodes found“ zurück.

Beispielsession (gekürzt):

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.

Wie verwandelt man einen Scan in einen Datensatz?

Der dekodierte Wert ist in der Regel der Join‑Schlüssel: die Sendungsnummer, die einen Scan mit einer Sendung verknüpft, die Auftragsreferenz, die ein unterschriebenes Formular mit einem Fall verbindet, das Asset‑Tag, das ein Foto mit einem Inventar‑Datensatz verknüpft. Sobald der Agent ihn hat, wird das Bild zu einer Zeile.

Lies für jeden Scan den Barcode und sag mir, zu welchem Auftrag er gehört.

Der Agent ruft extract_barcodes pro Datei auf und vergleicht jeden Wert mit den Aufträgen, die Sie ihm geben. Übergeben Sie page, um nur die Seite zu scannen, die das Etikett trägt, anstatt jede Seite eines langen Dokuments.

Wie sortiert man einen gemischten Stapel aus Scans und digital erzeugten Dateien?

Lassen Sie den Agenten je nach Vorhandensein von Text in einer Datei verzweigen.

Für jede Datei: Versuchen Sie die Textextraktion. Wenn das Ergebnis leer ist, lesen Sie stattdessen die Barcodes und sagen Sie mir, welche Dateien das benötigten.

Dateien, die zur Barcode‑Auslesung übergegangen sind, sind die Scans. Diese Liste ist ein nützliches Inventar für sich, wenn Sie ein Aufnahmeprojekt planen. Fügen Sie einen Routing‑Schritt hinzu, z. B. „Dateien nach dem Präfix ihres Barcode‑Werts gruppieren“, und der Ordner kommt bereits sortiert an.

Welcher Server liest den Code: Parser oder Signature?

Beide Server können einen Barcode oder QR‑Code aus einem Scan lesen: Parser mit extract_barcodes, Signature mit search_barcodes und search_qr_codes. Verwenden Sie GroupDocs.Parser.Mcp, wenn Sie Daten aus beliebigen Scans extrahieren und gleichzeitig Text, Tabellen oder Metadaten aus denselben Dateien benötigen. Verwenden Sie GroupDocs.Signature.Mcp, wenn der Code ein Signatur‑Element ist, das Sie ebenfalls hinzufügen, oder wenn Dokumente in beide Richtungen fließen und Sie das ausgehende Dokument mit einem neuen Code signieren. Der Signature‑Teil wird in From Barcode to Record: Document Intake Automation with AI Agents behandelt.

Was sind die Grenzen?

  • Ein dekodierter Wert ist unzuverlässige Daten. Wer das Dokument erstellt hat, hat ihn gewählt. Melden Sie ihn, recherchieren Sie ihn, prüfen Sie ihn ab und lassen Sie keinen Agenten ungeprüft darauf handeln.
  • Schlechte Scans können nicht dekodiert werden. Verzerrte, niedrigauflösende oder beschädigte Codes können nichts zurückgeben. Ein leeres Ergebnis bedeutet „nicht gefunden“, was bei einem schlechten Scan nicht dasselbe ist wie „nicht vorhanden“.
  • Der Evaluationsmodus ist eingeschränkt. Ohne Lizenz ist die Extraktion begrenzt; siehe die Bibliothek‑licensing page und bitten Sie den Agenten, zuerst get_license_status auszuführen.
  • Nur Docker. Die Modelle sind im Image gebündelt, weshalb es groß ist. Es gibt keinen dnx‑Befehl; der Container startet mit docker run --rm -i -v $(pwd)/documents:/data ghcr.io/groupdocs-parser/parser-net-mcp:latest, und Ein‑Klick‑Links für VS Code und Cursor finden Sie in Register in AI clients.

FAQ

Kann Claude einen Barcode aus einem gescannten PDF lesen?
Ja, über das extract_barcodes‑Tool, das in einem lokalen Container auf der gescannten Datei läuft. Claude erhält den dekodierten Wert, den Typ und die Seite.

Kann ich einen QR‑Code in einem gescannten Dokument ohne OCR lesen?
Ja. Die Code‑Erkennung hängt nicht von der Texterkennung ab, sodass QR‑Codes dekodiert werden, selbst wenn die gedruckten Wörter auf der Seite nicht vorhanden sind.

Wie sortiere ich gescannte Dokumente automatisch nach Barcode?
Bitten Sie den Agenten, den Code auf jedem Scan zu lesen und die Dateien nach dem Wert zu gruppieren oder umzubenennen. Überprüfen Sie die Gruppierung, bevor Sie Dateien verschieben, da die dekodierten Werte aus dem Dokument selbst stammen.

Weiterführende Informationen