כן, אפשר לעבוד עם הנתונים של Financy מהטרמינל. financy הוא כלי שורת פקודה בקוד פתוח שמביא את החיבורים, החשבונות והתנועות שלכם לטרמינל, לסקריפטים ולסוכן ה-AI שאתם עובדים איתו, בלי לכתוב חיבור ל-API לבד.
הכלי קורא בלבד. הוא לא מעביר כסף, לא מבצע תשלומים ולא משנה הגדרות בחשבון. הפעולה היחידה שאינה קריאה היא רענון יזום, שרק מבקש נתונים עדכניים יותר.
מה צריך
Node 20 ומעלה במחשב.
תוכנית Starter או Pro. השימוש בנתונים דרך ה-API הוא חלק מהתוכניות בתשלום. בתוכנית Free הפקודות שמושכות נתונים יחזירו שגיאה שמסבירה שצריך לשדרג.
שלושה ערכים מ-Financy, תחת הגדרות ← גישה ל-API:
clientId,clientSecretו-userId.
איך מתחילים
הריצו בלי התקנה מראש:
npx financy status. להתקנה קבועה:npm install -g financy.הריצו
financy setup. הפקודה מבקשת אתclientId,clientSecretו-userId. ה-clientSecretמוסתר בזמן ההקלדה.הפקודה מאמתת את הפרטים מול ה-API לפני השמירה, כך שטעות הקלדה מתגלה מיד. הערכים נשמרים מקומית במחשב שלכם, בקובץ שרק המשתמש שלכם יכול לקרוא.
הריצו
financy statusכדי לראות שורה לכל בנק או כרטיס: האם הנתונים טריים, מתיישנים, או שיש בעיה שדורשת חיבור מחדש באפליקציה.
הפקודות
financy status: האם הנתונים עדכניים, שורה לכל בנק או כרטיס.financy connections list: החיבורים, מצב השליפה ותוקף ההסכמה.financy accounts list: החשבונות והיתרות.financy transactions list: תנועות, עם סינון לפי תאריך, חשבון וסוג.financy categories: עץ הקטגוריות.financy providers list: בנקים וסניפים.financy refresh: רענון יזום של כל החיבורים יחד. אותו רענון כמו "רענן עכשיו" במסך החיבורים, באותה עלות: 20 קרדיטים לכל הפעלה.
פלט לסקריפטים
כל פקודה מקבלת --json ומחזירה מבנה קבוע. --all שולף את כל העמודים בפקודה אחת, למשל: financy transactions list --from 2026-07-01 --to 2026-07-31 --all --json.
קודי היציאה מבדילים בין סוגי כשל: בעיית הרשאה, תוכנית שלא כוללת את ה-API, או חוסר בקרדיטים.
חיבור לסוכן AI (Claude Code)
החבילה כוללת שרת MCP. חיבור ל-Claude Code בשורה אחת:
claude mcp add financy -- npx financy mcp
הסוכן מקבל את אותן פעולות כמו שורת הפקודה. כדי ללמד אותו להשתמש בהן נכון, התקינו את ה-skills:
financy skills install --all
financy-setup: מלמד את הסוכן להעביר אתכם תהליך הגדרה מלא, כולל מה לעשות כשהתוכנית לא כוללת את ה-API.freshness-check: מלמד אותו לבדוק אם הנתונים טריים מספיק לשאלה, ולבקש את אישורכם לפני רענון שעולה קרדיטים.
ה-skills מנחים את הסוכן לא לבקש את ה-clientSecret, לא להעביר אותו בפקודה ולא להציג אותו. את ההקלדה עושים אתם, ישירות לכלי.
פתרון תקלות
הפקודה מחזירה שגיאה שצריך לשדרג
השימוש בנתונים דרך ה-API זמין ב-Starter וב-Pro. בתוכנית Free פקודות שמושכות נתונים מחזירות את השגיאה הזאת.
financy setup נכשל באימות
העתיקו שוב את שלושת הערכים מהגדרות ← גישה ל-API ב-Financy, ובדקו שכל ערך הוזן בשדה הנכון.
financy status מסמן חיבור עם בעיה
פתחו את Financy וחברו מחדש את הבנק או הכרטיס המסומן. חיבור מחדש נעשה באפליקציה, לא מהטרמינל.
financy refresh נכשל
בדקו שיש לכם לפחות 20 קרדיטים. קוד היציאה של הפקודה מציין אם הכשל נובע מחוסר בקרדיטים.
שאלות נפוצות
מאיפה אני לוקח את ה-clientId וה-clientSecret?
ב-Financy, תחת הגדרות ← גישה ל-API. שם מופיע גם ה-userId.
הכלי יכול להעביר כסף או לשלם?
לא. הוא עובד בהרשאות קריאה בלבד. הפעולה היחידה שאינה קריאה היא רענון יזום של הנתונים.
כמה עולה financy refresh?
20 קרדיטים לכל הפעלה, והיא חלה על כל החיבורים יחד. זה אותו רענון כמו "רענן עכשיו" באפליקציה.
איפה נשמר ה-clientSecret?
רק במחשב שלכם, בקובץ שרק המשתמש שלכם יכול לקרוא.
איך מחברים את Financy ל-Claude Code דרך הכלי?
הריצו claude mcp add financy -- npx financy mcp, ואז financy skills install --all.
הקוד פתוח?
כן, ב-GitHub תחת רישיון Apache-2.0.
למדריך המלא בבלוג: הנתונים שלכם בטרמינל, ואצל סוכן ה-AI שלכם.