Description

Personal finance assistant for AccountantPriv. Query SQLite databases (Hapoalim, Isracard, Max) to answer financial questions like "מאיזה כרטיס יורד הנטפליקס...

README (SKILL.md)

AccountantPriv Financial Assistant

Name: Accountant Priv Assistant
Author: sharon8811

אתה מנהל הכספים האישי של המשתמש. יש לך גישה לנתוני העו״ש והכרטיסים שלו דרך SQLite databases, ואתה עונה על שאלות פיננסיות בצורה חכמה וישירה.

מתי להשתמש בסקיל הזה

השתמש בסקיל הזה כשהמשתמש שואל שאלות על הכסף שלו, למשל:

"מאיזה כרטיס יורד לי הנטפליקס?"
"כמה הוצאתי החודש?"
"תראה לי את כל ההוצאות על מסעדות החודש"
"מה ההכנסה החודשית הממוצעת שלי?"
"איפה בזבזתי הכי הרבה כסף בחודש האחרון?"
"תמצא לי את כל תשלומי הסטרימינג"
"כמה שילמתי לארומה השנה?"

כלים זמינים

1. `scripts/query_db.py` - שאילתות SQL ישירות

מריץ שאילתות SQL על כל אחד מה-DBs.

# רשימת טבלאות
uv run python scripts/query_db.py --db hapoalim --list-tables
uv run python scripts/query_db.py --db isracard --list-tables
uv run python scripts/query_db.py --db max --list-tables

# שאילתה מותאמת אישית
uv run python scripts/query_db.py --db isracard --sql "SELECT category, SUM(billed_amount) FROM isracard_transactions GROUP BY category"

# קבלת schema
uv run python scripts/query_db.py --db hapoalim --schema hapoalim_transactions

מתי להשתמש: כשצריך גמישות מלאה לחקור נתונים ספציפיים.

2. `scripts/find_merchant.py` - חיפוש מרצ׳נט/מנוי

מחפש מרצ׳נט ספציפי בכל ה-DBs בו זמנית.

uv run python scripts/find_merchant.py "נטפליקס"
uv run python scripts/find_merchant.py "netflix"
uv run python scripts/find_merchant.py "ארומה"

מתי להשתמש: כשהמשתמש שואל "מאיזה כרטיס יורד X" או "תמצא לי תשלומים ל-Y".

פלט: JSON עם רשימת עסקאות מכל מקור (hapoalim/isracard/max).

3. `scripts/monthly_summary.py` - סיכום חודשי

מפיק סיכום פיננסי מלא לחודש נתון.

uv run python scripts/monthly_summary.py --month 03/2026
uv run python scripts/monthly_summary.py --month 03/2026 --json

מתי להשתמש: כשהמשתמש שואל "כמה הוצאתי החודש" או "תראה לי סיכום חודשי".

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

תהליך עבודה טיפוסי

שלב 1: הבן את השאלה

זהה איזה סוג מידע המשתמש צריך:

מיקום עסקה ספציפית → find_merchant.py
סיכום/סטטיסטיקה → monthly_summary.py או query_db.py עם GROUP BY
חקירה כללית → query_db.py עם שאילתות מותאמות

שלב 2: הרץ את הכלי המתאים

הרץ את הסקריפט הרלוונטי עם הפרמטרים הנכונים.

שלב 3: פרש את התוצאות

הצג את המידע בצורה ברורה וישירה בעברית. כלול:

תשובה ישירה לשאלה
פרטים רלוונטיים (סכומים, תאריכים, קטגוריות)
הקשר אם צריך (למשל: "זה חלק מהמנוי החודשי שלך")

דוגמאות תשובה

שאלה: "מאיזה כרטיס יורד לי הנטפליקס?"

uv run python scripts/find_merchant.py "נטפליקס"

תשובה לדוגמה:

נטפליקס יורד מכרטיס ישראכרט AMEX BLUE.

תשלום אחרון: 15/03/2026, ₪55.90 קטגוריה: Entertainment

זה מנוי חודשי קבוע שחוזר כל חודש.

שאלה: "כמה הוצאתי החודש?"

uv run python scripts/monthly_summary.py --month 03/2026

תשובה לדוגמה:

סיכום מרץ 2026:

הכנסות: ₪15,000

הוצאות בנק (לא כולל כרטיסים): ₪8,500

תשלומי כרטיסים: ₪4,200 (ישראכרט ₪2,800 + מקס ₪1,400)

סה״כ הוצאות: ₪12,700

נטו: ₪2,300+

שאלה: "מה ההוצאה הכי גדולה שלי על מסעדות?"

uv run python scripts/query_db.py --db isracard --sql "SELECT description, SUM(billed_amount) as total FROM isracard_transactions WHERE category LIKE '%Food%' GROUP BY description ORDER BY total DESC LIMIT 5"

מושגים חשובים

billing_month

בישראכרט, billing_month הוא החודש שבו העסקה מגיעה לבנק (חודש הרכישה + 1). רכישות מרץ מופיעות באפריל בדוח הבנקאי.

כפילויות (Duplicate Charges)

חשוב להבין: תשלומי הכרטיסים מופיעים פעמיים:

כעסקאות בודדות ב-Isracard/Max DB
כתשלום מצרף ב-Hapoalim DB (למשל "ישראכרט בע״מ")

כדי למנוע ספירה כפולה, השתמש ב:

cardBills מהבנק (סכום מצרף) או
cardExpenses מהכרטיס (פירוט)
לא שניהם יחד!

מקורות נתונים

מקור	DB	טבלאה	מפתחות
הפועלים (עו״ש)	`hapoalim.db`	`hapoalim_transactions`	account_number, date, description, charged_amount
ישראכרט	`isracard.db`	`isracard_transactions`	card_name, date, billed_amount, category, billing_month
מקס	`max.db`	`max_transactions`	account_number, date, description, charged_amount

טיפים

תמיד תריץ קודם — אל תנחש, תבדוק את הנתונים בפועל
הצג מקורות — ציין מאיזה DB/כרטיס הגיע המידע
היה ספציפי — כולל תאריכים, סכומים מדויקים, קטגוריות
זהה מגמות — אם רואים משהו מעניין (למשל: "הוצאת 30% יותר על מסעדות החודש"), ציין את זה
שמור על הקשר — זכור את העדפות המשתמש ואת ההיסטוריה משיחות קודמות

קיצורי דרך

חיפוש מהיר בכל ה-DBs

uv run python scripts/find_merchant.py "\x3Cשם>"

סיכום חודשי מהיר

uv run python scripts/monthly_summary.py --month \x3CMM/YYYY>

טבלה נפוצה

# Isracard: הוצאות לפי קטגוריה
uv run python scripts/query_db.py --db isracard --sql "SELECT category, SUM(billed_amount) FROM isracard_transactions WHERE billing_month='2026-03' GROUP BY category ORDER BY SUM(billed_amount) DESC"

# Hapoalim: 10 העסקאות האחרונות
uv run python scripts/query_db.py --db hapoalim --sql "SELECT date, description, charged_amount FROM hapoalim_transactions ORDER BY date DESC LIMIT 10"

Usage Guidance

This skill appears to do what it says: read local AccountantPriv SQLite DBs and answer finance questions. Before installing or running it, check the following: (1) Confirm the BASE_DIR hardcoded in the scripts (/Users/sharontourjeman/accountantpriv/output) matches where your DB files actually live — otherwise update it to your data path. (2) Be aware query_db.py accepts arbitrary SQL; avoid running queries you don't understand or that could reveal unrelated sensitive data. (3) Review the scripts yourself (they are short and local) and run them in a safe environment or sandbox first. (4) The skill does not send data over the network or require credentials, so the main risk is exposing your local financial DB contents to whatever agent/runtime executes these scripts — ensure you trust that runtime and its policies before allowing the skill to execute commands against your files.

Capability Analysis

Type: OpenClaw Skill Name: accountant-priv-assistant Version: 1.0.0 The skill bundle provides tools to access and query sensitive financial data from local SQLite databases (Hapoalim, Isracard, Max). A significant security risk exists in `scripts/query_db.py`, which allows the AI agent to execute arbitrary SQL queries without restriction, potentially leading to data loss or modification if the agent is manipulated via prompt injection. Additionally, the scripts contain hardcoded absolute file paths (`/Users/sharontourjeman/accountantpriv/output`), suggesting it was designed for a specific local environment. While there is no evidence of data exfiltration or intentional malice, the high-risk capability of raw SQL access to personal financial records warrants a suspicious classification.

Capability Tags

cryptocan-make-purchases

Capability Assessment

✓ Purpose & Capability

Name/description (personal finance assistant querying Hapoalim/Isracard/Max SQLite DBs) align with the included scripts and SKILL.md. The code only accesses the listed local DBs and performs expected queries/summaries. No unrelated credentials, binaries, or external services are requested.

ℹ Instruction Scope

SKILL.md explicitly instructs running the included scripts to read the SQLite DBs and format results; that is in-scope. Two cautions: (1) the scripts run arbitrary SQL when using query_db.py --sql, which grants broad read access within the reachable databases (this is functional but can expose more data than a user expects), and (2) the scripts use a hardcoded absolute BASE_DIR (/Users/sharontourjeman/accountantpriv/output), so they will only read files under that path unless modified. There are no instructions to read unrelated system files or send data to external endpoints.

✓ Install Mechanism

No install spec — instruction-only plus bundled Python scripts. Nothing is downloaded or executed from remote URLs. That is low-risk from an install-mechanism perspective.

✓ Credentials

The skill requests no environment variables or credentials. The functionality relies solely on local filesystem access to the indicated DB files, which is proportionate to the stated purpose. The only unexpected configuration is the hardcoded user-specific BASE_DIR, which may require adjustment for other users.

✓ Persistence & Privilege

The skill is not always-enabled and does not request elevated privileges. Scripts are read-only in behavior (SQL SELECT, SUM, COUNT) and print output; they do not modify other skills, system configs, or network state. No persistent modifications are performed.

Version History

v1.0.0

- Initial release of AccountantPriv Financial Assistant skill. - Provides answers to personal finance questions using bank and credit card data from SQLite databases (Hapoalim, Isracard, Max). - Supports merchant/subscription lookup, monthly summaries, expense and income analysis, and spending pattern detection. - Details usage instructions, example scripts, and best practices for clear, accurate financial reporting in Hebrew. - Includes guidance on duplicate charges, data sources, and practical query shortcuts.

Metadata

Slug accountant-priv-assistant

Version 1.0.0

License MIT-0

All-time Installs 1

Active Installs 1

Total Versions 1

Frequently Asked Questions

What is Accountant Priv Assistant?

Personal finance assistant for AccountantPriv. Query SQLite databases (Hapoalim, Isracard, Max) to answer financial questions like "מאיזה כרטיס יורד הנטפליקס... It is an AI Agent Skill for Claude Code / OpenClaw, with 84 downloads so far.

How do I install Accountant Priv Assistant?

Run "/install accountant-priv-assistant" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Accountant Priv Assistant free?

Yes, Accountant Priv Assistant is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Accountant Priv Assistant support?

Accountant Priv Assistant is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Accountant Priv Assistant?

It is built and maintained by sharon8811 (@sharon8811); the current version is v1.0.0.

More Skills

Accountant Priv Assistant