הנתונים שלכם בטרמינל, ואצל סוכן ה-AI שלכם

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

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

מתחילים בפקודה אחת

הדרישה היחידה היא Node 20 ומעלה. אין מה להתקין מראש:

npx financy status

להתקנה קבועה:

npm install -g financy

השימוש בנתונים דרך ה-API הוא חלק מהתוכניות בתשלום, Starter ו-Pro. בתוכנית Free הפקודות שמושכות נתונים יחזירו שגיאה מסודרת שמסבירה שצריך לשדרג.

הגדרה חד-פעמית

הפקודה financy setup מבקשת שלושה ערכים שנמצאים באפליקציה תחת הגדרות → API: clientId, clientSecret ו-userId.

financy setup

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

מה אפשר לעשות

פקודה	מה היא מחזירה
financy status	האם הנתונים עדכניים, שורה לכל בנק או כרטיס
financy connections list	החיבורים, מצב השליפה ותוקף ההסכמה
financy accounts list	החשבונות והיתרות
financy transactions list	תנועות, עם סינון לפי תאריך, חשבון וסוג
financy categories	עץ הקטגוריות
financy providers list	בנקים וסניפים
financy refresh	רענון יזום של כל החיבורים

financy status היא בדרך כלל הפקודה הראשונה שתריצו: היא מסמנת לכל חיבור אם הנתונים טריים, מתיישנים או שיש בעיה שדורשת חיבור מחדש באפליקציה.

financy refresh מפעילה את אותו רענון יזום שקיים במסך החיבורים, עם אותה עלות של 20 קרדיטים לכל הפעלה, והיא חלה על כל החיבורים יחד. הרחבנו על שני מסלולי הרענון בפוסט על רענון נתונים בזמן שלכם.

פלט לסקריפטים, לא רק לקריאה

כל פקודה מקבלת --json ומחזירה מבנה קבוע, כך שאפשר להעביר אותה ל-jq או לסקריפט בלי לנתח טקסט:

financy transactions list \
  --from 2026-07-01 --to 2026-07-31 \
  --all --json

--all שולף את כל העמודים בפקודה אחת. לצד זה, קודי היציאה מבדילים בין סוגי כשל: בעיית הרשאה, תוכנית שלא כוללת את ה-API, או חוסר בקרדיטים. סקריפט יכול להגיב לכל מקרה אחרת, בלי לנחש מתוך הודעת השגיאה.

חיבור לסוכן AI

באותה חבילה מגיע שרת MCP — התקן פתוח שסוכני AI משתמשים בו כדי להתחבר לכלים חיצוניים. חיבור ל-Claude Code נעשה בשורה אחת:

claude mcp add financy -- npx financy mcp

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

Skills: ידע מוכן לסוכן

סוכן שמקבל גישה לכלי עדיין לא יודע איך להשתמש בו נכון. בשביל זה החבילה כוללת skills — קובצי הנחיות שמלמדים את הסוכן את העבודה עצמה:

financy skills install --all

בגרסה הראשונה יש שני skills. financy-setup מלמד את הסוכן להעביר אותכם תהליך הגדרה מלא, כולל מה לעשות כשהתוכנית לא כוללת את ה-API. freshness-check מלמד אותו לקרוא את מצב העדכניות, להחליט אם הנתונים מספיק טריים לשאלה שנשאלה, ולבקש את אישורכם לפני רענון שעולה קרדיטים.

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

מה הכלי לא עושה

הכלי עובד באותן הרשאות של החיבור עצמו: קריאת מידע. הוא לא מעביר כסף, לא מבצע תשלומים ולא משנה הגדרות בחשבון — כפי שהסברנו בפוסט רואים את הכסף, לא נוגעים בו. הפעולה היחידה שאינה קריאה היא הרענון היזום, שרק מבקש נתונים עדכניים יותר.

ה-clientSecret נשמר רק במחשב שלכם. ה-skills מנחים את הסוכן במפורש לא לבקש אותו, לא להעביר אותו בפקודה ולא להציג אותו — ההקלדה נעשית על ידכם, ישירות לכלי.

הקוד פתוח ב-GitHub תחת רישיון Apache-2.0, וכל גרסה מפורסמת מ-CI עם חתימת provenance שמקשרת את החבילה ב-npm לקוד ולתהליך הבנייה שיצרו אותה. אפשר לקרוא בדיוק מה הכלי עושה לפני שמתקינים אותו.

מתחילים

npx financy setup
npx financy status

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