2026-03-10מאת Kirill Markin

הגדרת מעקב הוצאות עם AI עבור Claude Code, Codex ו-OpenClaw

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

התהליך הרגיל נראה כך:

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

זה עובד, אבל זה לא באמת מותאם לסוכנים.

Expense Budget Tracker חושף עכשיו נקודת קצה ציבורית של discovery עבור סוכני טרמינל כמו Claude Code, OpenAI Codex או OpenClaw:

https://api.expense-budget-tracker.com/v1/

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

באיזו כתובת אימייל צריך להשתמש להתחברות?
מהו הקוד בן 8 הספרות שהגיע עכשיו לתיבה?

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

הפרויקט הוא קוד פתוח ב-GitHub:

הקישור היחיד שצריך לתת לסוכן שלכם

זאת הכתובת המדויקת:

https://api.expense-budget-tracker.com/v1/

נקודת הקצה הזאת מחזירה מסמך discovery קריא למכונה. הסוכן יכול להבין ממנו:

איפה מתחיל תהליך האימות הראשוני
לאיזו פעולה צריך לפנות קודם
באיזו כותרת אימות להשתמש אחר כך
מהם השלבים הבאים להגדרת סביבת עבודה ולגישה ל-SQL

זה הרעיון המרכזי: במקום לקודד ידנית הוראות התחלה בתוך prompt, המוצר עצמו מסביר לסוכן איך להתחבר.

דוגמת prompt עבור Claude Code

Connect to Expense Budget Tracker using https://api.expense-budget-tracker.com/v1/.
Ask me for the account email, wait for the 8-digit code from my inbox, finish the setup,
save the returned ApiKey outside chat memory, then import transactions from ~/Downloads/chase-march-2026.csv and verify the final balance.

דוגמת prompt עבור Codex

Use https://api.expense-budget-tracker.com/v1/ to connect to my Expense Budget Tracker account.
When you need login information, ask me for the email and then the 8-digit code.
After setup, save the key, inspect /schema, and show me my latest 20 transactions and total grocery spend this month.

דוגמת prompt עבור OpenClaw

Connect yourself to Expense Budget Tracker through https://api.expense-budget-tracker.com/v1/.
After login, save my personal workspace as the default for this key and import the CSV file I uploaded.
Use existing categories when possible, and tell me if any balance does not match.

איך עובדת הגדרת מעקב ההוצאות עם AI

הנה תהליך ה-HTTP המלא שמאחורי ההגדרה הזו.

1. קוראים את נקודת הקצה של discovery

הסוכן מתחיל כאן:

curl https://api.expense-budget-tracker.com/v1/

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

2. שולחים את אימייל המשתמש

הסוכן שולח את כתובת האימייל לשירות האימות:

curl -X POST https://auth.expense-budget-tracker.com/api/agent/send-code \
  -H "Content-Type: application/json" \
  -d '{"email":"user@example.com"}'

אם הבקשה מצליחה, התשובה מכילה otpSessionToken והוראות לפנות אחר כך ל-verify_code.

3. מבקשים מהמשתמש את קוד האימייל בן 8 הספרות

המשתמש בודק את תיבת הדואר ומחזיר את הקוד לסוכן.

4. מאמתים את הקוד ומקבלים ApiKey

אחר כך הסוכן קורא לנקודת הקצה הבאה:

curl -X POST https://auth.expense-budget-tracker.com/api/agent/verify-code \
  -H "Content-Type: application/json" \
  -d '{
    "code":"12345678",
    "otpSessionToken":"opaque-token-from-send-code",
    "label":"Claude Code on macbook"
  }'

התשובה כוללת ApiKey חדש. המפתח הזה מוצג פעם אחת בלבד, ולכן הסוכן צריך לשמור אותו לבקשות עתידיות, רצוי כ-EXPENSE_BUDGET_TRACKER_API_KEY.

זה השיפור המרכזי לעומת התהליך הידני הישן: המשתמש לא צריך ליצור מפתח ב-Settings ולהעתיק אותו לטרמינל.

5. טוענים את החשבון ואת ההקשר של סביבת העבודה

אחרי האימות, הסוכן משתמש ב-Authorization: ApiKey <key> וטוען את החשבון:

curl https://api.expense-budget-tracker.com/v1/me \
  -H "Authorization: ApiKey ebta_ABCDEFGH_0123456789ABCDEFGHJKMNPQ"

אחר כך הוא מציג את רשימת סביבות העבודה:

curl https://api.expense-budget-tracker.com/v1/workspaces \
  -H "Authorization: ApiKey ebta_ABCDEFGH_0123456789ABCDEFGHJKMNPQ"

אם צריך, הוא יכול ליצור סביבת עבודה חדשה או לשמור במפורש סביבת עבודה קיימת עם POST /v1/workspaces/{workspaceId}/select.

curl -X POST https://api.expense-budget-tracker.com/v1/workspaces/workspace_123/select \
  -H "Authorization: ApiKey ebta_ABCDEFGH_0123456789ABCDEFGHJKMNPQ"

6. מריצים SQL דרך Agent API

אחרי זה, העבודה הרגילה על הנתונים נעשית דרך דומיין האפליקציה:

curl -X POST https://api.expense-budget-tracker.com/v1/sql \
  -H "Authorization: ApiKey ebta_ABCDEFGH_0123456789ABCDEFGHJKMNPQ" \
  -H "X-Workspace-Id: workspace_123" \
  -H "Content-Type: application/json" \
  -d '{
    "sql":"SELECT ts, category, counterparty, amount, currency FROM ledger_entries ORDER BY ts DESC LIMIT 20"
  }'

הבקשה חייבת לכלול את שני ה-headers הבאים:

Authorization: ApiKey <key>
X-Workspace-Id: <workspaceId> רק אם רוצים לעקוף את סביבת העבודה השמורה או לפני שנשמרת אחת כזאת

בחירת סביבת העבודה היא מפורשת, והשרת שומר אותה לכל API key אחרי POST /v1/workspaces/{workspaceId}/select. אם למשתמש יש סביבת עבודה אחת בלבד, ה-API שומר אותה אוטומטית ומשתמש בה עבור מפתח חדש.

מה הסוכן יכול לעשות אחרי ההגדרה

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

לנתח ייצוא CSV, PDF או צילומי מסך מהבנק
להכניס טרנזקציות ל-ledger
לבדוק יתרות מול מה שהבנק מציג
לשאול על הוצאות לפי קטגוריה, בית עסק או תקופה
לעדכן שורות תקציב לחודש הבא

הנה דוגמה מעשית לייבוא דוח:

Import ~/Downloads/revolut-february-2026.csv into my EUR account.
Before writing anything, query my existing categories and the last 30 days of transactions to avoid duplicates.
After import, compare the resulting account balance with the closing balance in the CSV.

והנה דוגמה לניתוח:

Show me my top 10 spending categories in the last 90 days, then compare them with the previous 90-day period.
Also list the largest transactions in categories where spending increased.

למה זה עדיף על הגדרה ידנית של API key

התהליך החדש פשוט יותר גם למשתמש וגם לסוכן:

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

אם אתם בונים תהליך עבודה של מעקב הוצאות עם AI, זה משנה. זה מוריד הרבה boilerplate מיותר ב-prompt והרבה טעויות הגדרה.

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

Expense Budget Tracker הוא פרויקט MIT ובקוד פתוח מלא:

אם אתם רוצים לארח אותו בעצמכם, התחילו כאן:

git clone https://github.com/kirill-markin/expense-budget-tracker.git
cd expense-budget-tracker
make up

אם אתם רוצים להשתמש בגרסה המתארחת, תנו לסוכן שלכם את ה-URL הזה:

https://api.expense-budget-tracker.com/v1/

זה מספיק כדי ש-Claude Code, Codex או OpenClaw יתחילו בעצמם את תהליך ההתחברות.

להמשך קריאה

2026-03-05