איך לאסוף חשבוניות מהמייל ולהתאים אותן לפירוט האשראי

• •מחפש חשבוניות וקבלות בכל חשבונות Gmail המחוברים, עם גישה לקריאה בלבד.
• •קורא קובצי XLSX ו-CSV נפוצים של Max, ישראכרט, כאל ולאומי.
• •משווה סכום, מטבע, ספק, תאריך וסיומת כרטיס.
• •מסיר כפילויות זהות ויוצר תיקייה מקומית עם דוח בעברית.

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

• •Codex או Claude Code.
• •Python 3. הסקריפט עצמו משתמש בספרייה הסטנדרטית בלבד.
• •חיבור Gmail קיים לסוכן, עם הרשאת קריאה.
• •קובצי פירוט אשראי אם רוצים לבדוק שלמות, ולא רק לאסוף מסמכים.

פותחים טרמינל בתיקייה שבה רוצים לשמור את הריפו ומורידים אותו מ-GitHub.

git clone https://github.com/dangogit/agent-skills.git

בוחרים את הסוכן שבו משתמשים. אפשר ליצור את שני הקישורים אם עובדים עם שניהם.

Codex

cd agent-skills
mkdir -p ~/.codex/skills
ln -s "$(pwd)/skills/invoice-pack" ~/.codex/skills/invoice-pack

Claude Code

cd agent-skills
mkdir -p ~/.claude/skills
ln -s "$(pwd)/skills/invoice-pack" ~/.claude/skills/invoice-pack

שתי הפקודות משתמשות ב-symlink, לכן עדכון הריפו מעדכן גם את ה-skill בלי העתקה נוספת.

אחרי שה-skill מותקן ו-Gmail מחובר, מדביקים את ה-prompt הבא ומחליפים את החודש במידת הצורך.

Use invoice-pack to collect my invoices from all connected Gmail accounts for July 2026.
Reconcile them against the XLSX or CSV card statements in Downloads.
Keep everything local, do not upload any invoice, and do not auto-match uncertain candidates.
Save the result to a new folder on my Desktop and open report.html when finished.

הסוכן אמור לחפש בכל החשבונות המחוברים, לשמור את המסמכים לתיקיית input מקומית, להריץ את ההתאמה ולפתוח את הדוח.

מורידים פירוט אשראי ושומרים אותו תחת invoice-pack-input/statements. את החשבוניות שנאספו שומרים תחת invoice-pack-input/documents.

python3 skills/invoice-pack/scripts/invoice_pack.py \
  --documents /absolute/path/invoice-pack-input/documents \
  --statements /absolute/path/invoice-pack-input/statements \
  --output /absolute/path/invoice-pack-2026-07

בלי --statements אפשר עדיין לאסוף ולסדר מסמכים. אי אפשר לטעון שהאיסוף מלא, כי אין רשימת חיובים להשוות אליה.

• •report.html: דוח מקומי בעברית עם הסיכום וכל המצבים.
• •matched: מסמכים שהותאמו לעסקה עם סכום ומטבע זהים וראיות תומכות.
• •needs-review: מועמדים שלא בטוח מספיק להתאים אוטומטית.
• •missing-invoices: עסקאות בפירוט שלא נמצא להן מסמך מתאים.
• •unmatched-documents: מסמכים שנאספו אבל לא נמצאה להם עסקה מתאימה.

• •החיפוש במייל הוא לקריאה בלבד. ה-skill לא משנה labels, סטטוס קריאה או תיקיות.
• •החשבוניות, הפירוטים והדוחות נשמרים על מערכת הקבצים המקומית.
• •אין צורך במסד נתונים, מערכת הנהלת חשבונות בענן או העלאה לשירות חיצוני.
• •הדוח לא מחזיר לצ׳אט טקסט מלא של חשבוניות, כתובות, מספרי מס או תוכן מייל.

קובצי PDF נקראים בעזרת pdftotext כשהוא מותקן. בלעדיו הקובץ עדיין נשמר, מקבל hash ומאורגן, אבל ייתכן שיעבור לבדיקה ידנית.

תמונות ללא שכבת טקסט אינן נשלחות אוטומטית ל-OCR. הן נכנסות ל-needs-review כדי שאפשר יהיה לבדוק אותן ידנית בלי להוציא את המסמך מהמחשב.

לעדכון, נכנסים לתיקיית הריפו ומושכים את הגרסה האחרונה:

cd /path/to/agent-skills
git pull --ff-only

להסרה, מוחקים רק את ה-symlink המתאים. הריפו וקובצי הפלט נשארים במקומם:

rm ~/.codex/skills/invoice-pack
# או
rm ~/.claude/skills/invoice-pack

הריפו כולל את ה-skill, הסקריפט הדטרמיניסטי, התיעוד, הבדיקות וה-fixture הסינתטי ששימש לצילומי המסך במדריך.