إعداد متتبع النفقات بالذكاء الاصطناعي مع Claude Code وCodex وOpenClaw

إذا كنت تريد استخدام وكيل ذكاء اصطناعي لتتبّع النفقات، فعادةً ما تكون خطوة الإعداد هي الجزء الأكثر إزعاجًا.

غالبًا ما يبدو المسار التقليدي هكذا:

1. تفتح التطبيق
2. تُنشئ مفتاح API
3. تنسخ المفتاح
4. تلصقه في وكيلك الطرفي
5. تشرح للوكيل نقطة النهاية التي يجب أن يستدعيها
6. وتأمل بعد ذلك أن يعمل ضمن مساحة العمل الصحيحة

هذا المسار ممكن، لكنه ليس مصممًا للوكلاء من الأساس.

يوفّر Expense Budget Tracker الآن نقطة اكتشاف عامة لوكلاء الطرفية مثل Claude Code وOpenAI Codex وOpenClaw:

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

يعطي المستخدم الوكيل هذا الرابط فقط، ثم يجيب عن سؤالين:

• ما عنوان البريد الإلكتروني الذي سيُستخدم لتسجيل الدخول؟
• ما الرمز المكوّن من 8 أرقام الذي وصل الآن إلى صندوق الوارد؟

بعد ذلك، ينشئ الوكيل مفتاح ApiKey خاصًا به، ويحفظه خارج ذاكرة الدردشة، ويحمّل بيانات الحساب، ويستعرض مساحات العمل، ويحفظ إحداها كمساحة العمل الافتراضية لذلك المفتاح، ثم يستطيع البدء في استيراد المعاملات أو الاستعلام عنها.

المشروع مفتوح المصدر على GitHub:

• github.com/kirill-markin/expense-budget-tracker
• تنفيذ واجهة Machine API الخاصة بالوكلاء
• مسار الوكيل لإرسال الرمز
• مسار الوكيل للتحقق من الرمز

الرابط الوحيد الذي تعطيه لوكيلك

هذا هو الرابط المطلوب كما هو:

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

تعيد نقطة النهاية هذه مستند اكتشاف مقروءًا آليًا. ويستطيع الوكيل من خلاله معرفة:

• مكان بدء التهيئة الأولية للمصادقة
• الإجراء الذي يجب استدعاؤه أولًا
• ترويسة المصادقة التي ينبغي استخدامها لاحقًا
• الخطوات التالية لإعداد مساحة العمل والوصول إلى SQL

الفكرة الأساسية هنا بسيطة: بدلًا من حشر تعليمات الإعداد داخل مطالبة ثابتة، يشرح المنتج نفسه للوكيل كيف يتصل به.

مثال على مطالبة لـ Claude Code

اتصل بـ Expense Budget Tracker باستخدام https://api.expense-budget-tracker.com/v1/.
اطلب مني البريد الإلكتروني للحساب، ثم انتظر الرمز المكوّن من 8 أرقام الذي يصل إلى صندوق الوارد،
وأكمِل الإعداد، واحفظ مفتاح `ApiKey` الذي يعود من الخدمة خارج ذاكرة الدردشة،
ثم استورد المعاملات من ~/Downloads/chase-march-2026.csv وتحقق من الرصيد النهائي.

مثال على مطالبة لـ Codex

استخدم https://api.expense-budget-tracker.com/v1/ للاتصال بحسابي في Expense Budget Tracker.
عندما تحتاج إلى معلومات تسجيل الدخول، اطلب مني البريد الإلكتروني ثم الرمز المكوّن من 8 أرقام.
بعد الإعداد، احفظ المفتاح، وافحص /schema، ثم اعرض لي آخر 20 معاملة وإجمالي إنفاق البقالة هذا الشهر.

مثال على مطالبة لـ OpenClaw

اتصل بحسابي في Expense Budget Tracker عبر https://api.expense-budget-tracker.com/v1/.
بعد تسجيل الدخول، احفظ مساحة عملي الشخصية كمساحة العمل الافتراضية لهذا المفتاح، ثم استورد ملف CSV الذي رفعته.
استخدم الفئات الحالية كلما أمكن، وأخبرني إذا كان أي رصيد لا يتطابق.

كيف تعمل عملية إعداد متتبع النفقات بالذكاء الاصطناعي

في ما يلي تدفّق HTTP الكامل الذي يقف وراء هذا الإعداد.

1. قراءة نقطة الاكتشاف

يبدأ الوكيل من هنا:

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

تخبره الاستجابة بأن البداية تكون مع send_code، وتضم عنوان التهيئة الأولية على نطاق المصادقة، وتشير أيضًا إلى نقطتَي النهاية المنشورتين لكل من OpenAPI وschema.

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 عبر واجهة 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"
  }'

يجب أن يتضمن الطلب هذين العنصرين معًا:

• Authorization: ApiKey <key>
• X-Workspace-Id: <workspaceId> فقط إذا كنت تريد تجاوز مساحة العمل المحفوظة أو قبل حفظ مساحة افتراضية

اختيار مساحة العمل هنا صريح، ويحفظ الخادم هذا الاختيار لكل مفتاح API بعد POST /v1/workspaces/{workspaceId}/select. وإذا كان لدى المستخدم مساحة عمل واحدة فقط، فستُحفظ تلقائيًا وتُستخدم مع المفتاح الجديد.

ما الذي يستطيع وكيلك فعله بعد الإعداد؟

بعد إتمام الاتصال، يمكن للوكيل أن يتولى الأعمال المالية المملة التي لا ينبغي أن تتطلب ساعات من النقر:

1. تحليل ملفات CSV أو PDF أو لقطات الشاشة التي يصدّرها البنك
2. إدخال المعاملات في دفتر الأستاذ
3. التحقق من الأرصدة مقارنة بما يعرضه البنك
4. الاستعلام عن الإنفاق حسب الفئة أو التاجر أو الفترة الزمنية
5. تحديث بنود الميزانية للشهر التالي

إليك مثالًا عمليًا على استيراد كشف حساب:

استورد ~/Downloads/revolut-february-2026.csv إلى حسابي باليورو.
قبل أن تكتب أي شيء، استعلم عن فئاتي الحالية وعن معاملات آخر 30 يومًا لتجنّب التكرار.
بعد الاستيراد، قارن رصيد الحساب الناتج مع الرصيد الختامي الموجود في ملف CSV.

وهذا مثال على التحليل:

اعرض لي أعلى 10 فئات إنفاق لدي خلال آخر 90 يومًا، ثم قارنها بفترة التسعين يومًا السابقة.
واعرض أيضًا أكبر المعاملات في الفئات التي ارتفع فيها الإنفاق.

لماذا هذا أفضل من إعداد مفتاح API يدويًا؟

المسار الجديد أبسط لكل من المستخدم والوكيل:

• لا يحتاج المستخدم إلى نسخ مفتاح طويل الأجل يدويًا
• يكتشف الوكيل البروتوكول من المنتج نفسه
• تنفصل المصادقة عن الوصول إلى البيانات بوضوح
• يكون كل طلب SQL مقيّدًا بمساحة العمل المختارة
• يمكن إلغاء هذا الاتصال لاحقًا من داخل التطبيق

إذا كنت تبني سير عمل لتتبّع النفقات بالذكاء الاصطناعي، فهذه نقطة مهمة. فهي تقلّل التعليمات التمهيدية المكررة داخل المطالبات وتخفف أخطاء الإعداد.

متتبع نفقات مفتوح المصدر مع إعداد مناسب للوكلاء

Expense Budget Tracker مرخّص تحت MIT ومفتوح المصدر بالكامل:

• موقع المشروع
• مستودع GitHub
• ملف README على GitHub
• توثيق إعداد وكلاء الذكاء الاصطناعي
• مرجع واجهة API

إذا أردت استضافته ذاتيًا، فابدأ بـ:

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

وإذا أردت استخدام النسخة المستضافة، فأعطِ وكيلك هذا الرابط:

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

وهذا يكفي لكي يبدأ Claude Code أو Codex أو OpenClaw مسار تسجيل الدخول من تلقاء نفسه.