Сканування поштового відділення — це зображення: ніхто не може його шукати, і текстовий екстрактор нічого в ньому не знаходить. Штрих‑код на сторінці — виняток. Сервер GroupDocs.Parser.Mcp працює локально в Docker, а AI‑агент у клієнті, наприклад Claude Desktop, Cursor або GitHub Copilot, може попросити його зчитати штрих‑коди зі сканованих документів і повернути декодовані значення:

Прочитайте штрих‑коди у цих сканованих накладних і перелічіть значення разом з файлом, з якого вони походять.

Покрокова інструкція з налаштуванням та усуненням проблем знаходиться в документації: Як читати штрих‑коди та QR‑коди зі сканованих документів.

Чому скан потребує зчитувач штрих‑коду, а не текстовий екстрактор?

Сканована сторінка не має текстового шару. extract_text повертає мало або нічого, що є правдивим твердженням про файл. Однак моделі движка виявляють коди у растровому зображенні, тому extract_barcodes все ще повертає номер відстеження, надрукований у сканованій накладній. На сервері немає OCR, тому надруковані слова залишаються пікселями; лише коди стають даними.

Що повертає інструмент?

extract_barcodes повертає рядок заголовка, Found N barcode(s) in ..., після чого слідує JSON‑масив з одним об’єктом на кожен код, кожен з полями index, value, type, page, confidence та angle. Він розпізнає Code128, QR Code, PDF417, DataMatrix, EAN‑13, EAN‑8, UPC, Aztec та багато інших символьних систем у форматах PDF, DOCX, XLSX, PPTX, PNG, JPG, TIFF та інших. Якщо нічого не знайдено, повертає повідомлення «No barcodes found».

Приклад сеансу (скорочений):

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.

Як перетворити скан у запис?

Декодоване значення зазвичай є ключем з’єднання: номер відстеження, який зв’язує скан з відправленням, посилання на замовлення, яке зв’язує підписану форму з випадком, або мітка активу, яка зв’язує фотографію з записом інвентарю. Коли агент отримує його, зображення стає рядком.

Для кожного скану зчитайте штрих‑код і повідомте, до якого замовлення він належить.

Агент викликає extract_barcodes для кожного файлу і порівнює кожне значення з замовленнями, які ви йому надаєте. Передайте параметр page, щоб сканувати лише сторінку, на якій розташована мітка, а не кожну сторінку довгого документа.

Як сортувати змішану партію сканів та цифрових файлів?

Нехай агент розгалужується залежно від того, чи має файл текст.

Для кожного файлу: спробуйте витягнути текст. Якщо результат порожній, зчитайте штрих‑коди замість цього і повідомте, які файли потребували цього.

Файли, які перейшли до зчитування штрих‑коду, є сканами. Цей список сам по собі є корисною інвентаризацією, якщо ви плануєте проєкт інжестії. Додайте крок маршрутизації зверху, наприклад «групувати файли за префіксом їхнього значення штрих‑коду», і папка буде вже відсортована.

Який сервер зчитує код: Parser чи Signature?

Обидва сервери можуть зчитувати штрих‑код або QR‑код зі скану: Parser за допомогою extract_barcodes, Signature за допомогою search_barcodes та search_qr_codes. Використовуйте GroupDocs.Parser.Mcp, коли ви витягуєте дані з довільних сканів і також потребуєте текст, таблиці або метадані з тих самих файлів. Використовуйте GroupDocs.Signature.Mcp, коли код є елементом підпису, який ви також додаєте, або коли документи проходять в обох напрямках і ви підписуєте вихідний документ новим кодом. Сторона Signature розглядається у From Barcode to Record: Document Intake Automation with AI Agents.

Які обмеження?

  • Декодоване значення — недовірені дані. Той, хто створив документ, обрав його. Повідомте про це, перевірте, переконайтеся у достовірності, і не дозволяйте агенту діяти на його підставі без перевірки.
  • Погані скани можуть не декодуватися. Спотворені, низькороздільні або пошкоджені коди можуть нічого не повернути. Порожній результат означає «не знайдено», що на поганому скані не те саме, що «відсутній».
  • Режим оцінки обмежений. Без ліцензії витяг обмежений; дивіться [licensing page] бібліотеки і попросіть агента спочатку виконати get_license_status.
  • Лише Docker. Моделі включені в образ, тому він великий. Команди dnx немає; контейнер запускається командою docker run --rm -i -v $(pwd)/documents:/data ghcr.io/groupdocs-parser/parser-net-mcp:latest, а посилання в один клік для VS Code та Cursor знаходяться в Register in AI clients.

Питання та відповіді

Чи може Claude зчитати штрих‑код зі сканованого PDF?
Так, за допомогою інструмента extract_barcodes, який працює в локальному контейнері над сканованим файлом. Claude отримує декодоване значення, тип та сторінку.

Чи можу я зчитати QR‑код у сканованому документі без OCR?
Так. Виявлення коду не залежить від розпізнавання тексту, тому QR‑коди декодуються навіть коли надруковані слова на сторінці відсутні.

Як автоматично сортувати скановані документи за штрих‑кодом?
Попросіть агента зчитати код на кожному скані та групувати або перейменовувати файли за значенням. Перевірте групування перед переміщенням файлів, оскільки декодовані значення беруться безпосередньо з документа.

Детальніше