Скан почтового отделения — это изображение: его нельзя искать, и извлекатель текста ничего в нём не находит. Штрихкод на странице — исключение. Сервер 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.

Каковы ограничения?

  • Декодированное значение — недоверенные данные. Тот, кто создал документ, выбрал его. Сообщите об этом, проверьте, сверните и не позволяйте агенту действовать на его основе без проверки.
  • Плохие сканы могут не декодироваться. Искажённые, низкокачественные или повреждённые коды могут вернуть ничего. Пустой результат означает «не найдено», что при плохом скане не то же самое, что «отсутствует».
  • Режим оценки ограничен. Без лицензии извлечение ограничено; см. страницу лицензирования библиотеки и попросите агента сначала выполнить 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.

FAQ

Может ли Claude прочитать штрихкод из отсканированного PDF?
Да, с помощью инструмента extract_barcodes, который запускается в локальном контейнере над отсканированным файлом. Claude получает декодированное значение, тип и страницу.

Могу ли я прочитать QR‑код в отсканированном документе без OCR?
Да. Обнаружение кода не зависит от распознавания текста, поэтому QR‑коды декодируются даже если печатные слова на странице отсутствуют.

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

Углубиться