功能描述

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

使用说明 (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"

安全使用建议

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.

功能分析

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.

能力标签

cryptocan-make-purchases

能力评估

✓ 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.

版本历史

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.

元数据

Slug accountant-priv-assistant

版本 1.0.0

许可证 MIT-0

累计安装 1

当前安装数 1

历史版本数 1

常见问题

Accountant Priv Assistant 是什么？

Personal finance assistant for AccountantPriv. Query SQLite databases (Hapoalim, Isracard, Max) to answer financial questions like "מאיזה כרטיס יורד הנטפליקס... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 84 次。

如何安装 Accountant Priv Assistant？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install accountant-priv-assistant」即可一键安装，无需额外配置。

Accountant Priv Assistant 是免费的吗？

是的，Accountant Priv Assistant 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

Accountant Priv Assistant 支持哪些平台？

Accountant Priv Assistant 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Accountant Priv Assistant？

由 sharon8811（@sharon8811）开发并维护，当前版本 v1.0.0。

Accountant Priv Assistant