סריקת חדר דואר היא תמונה: אף אחד לא יכול לחפש בה, ומחלץ טקסט לא מוצא בה שום דבר. הברקוד על העמוד הוא היוצא מן הכלל. השרת 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 מכוסה ב‑מברקוד לרשומה: אוטומציה של קבלת מסמכים עם סוכני AI.

מה המגבלות?

  • ערך מפוענח הוא נתון בלתי מהימן. מי שיצר את המסמך בחר בו. דווח עליו, חפש אותו, בדוק אותו, ואל תאפשר לסוכן לפעול על בסיסו ללא בדיקה.
  • סריקות גרועות עשויות שלא להתפענח. קודים משופעים, ברזולוציה נמוכה או פגומים יכולים להחזיר כלום. תוצאה ריקה משמעותה “לא נמצא”, ובסריקה גרועה זה אינו זהה ל‑“לא קיים”.
  • מצב הערכה מוגבל. ללא רישיון, החילוץ מוגבל; ראה את דף הרישוי של הספרייה ובקש מהסוכן להריץ get_license_status תחילה.
  • Docker בלבד. המודלים משולבים בתמונה, ולכן היא גדולה. אין פקודת dnx; המכולה מתחילה עם docker run --rm -i -v $(pwd)/documents:/data ghcr.io/groupdocs-parser/parser-net-mcp:latest, וקישורים בלחיצה אחת ל‑VS Code ול‑Cursor נמצאים ב‑הירשם בלקוחות AI.

שאלות נפוצות

האם Claude יכול לקרוא ברקוד מקובץ PDF סרוק?
כן, דרך כלי extract_barcodes, הפועל במכולה מקומית על הקובץ הסרוק. Claude מקבל את הערך המפוענח, הסוג והעמוד.

האם אפשר לקרוא קוד QR במסמך סרוק ללא OCR?
כן. זיהוי קוד אינו תלוי בזיהוי טקסט, ולכן קודי QR מתפענחים גם כאשר המילים המודפסות על העמוד אינן ניתנות לזיהוי.

איך למיין מסמכים סרוקים לפי ברקוד באופן אוטומטי?
בקש מהסוכן לקרוא את הקוד בכל סריקה ולקבץ או לשנות שם קבצים לפי הערך. בדוק את הקיבוץ לפני העברת הקבצים, מכיוון שהערכים המפוענחים מגיעים מהמסמך עצמו.

עומק נוסף