Як підключити ШІ-агента до Expense Budget Tracker: Claude Code, Codex і OpenClaw

Якщо ви хочете вести облік витрат через ШІ-агента, найнеприємніша частина зазвичай не сама робота, а початкове підключення.

Зазвичай усе виглядає так:

1. Відкрити застосунок
2. Створити API-ключ
3. Скопіювати цей ключ
4. Вставити його в термінального агента
5. Пояснити, до якої адреси API потрібно звертатися
6. Сподіватися, що агент працюватиме з правильним робочим простором

Працювати так можна, але це не найзручніший сценарій для агента.

Expense Budget Tracker тепер публікує окрему URL-адресу підключення для термінальних агентів на кшталт Claude Code, OpenAI Codex або OpenClaw:

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

Користувач передає агенту лише це посилання, а далі відповідає всього на два запитання:

• Яку адресу електронної пошти використати для входу?
• Який 8-значний код щойно надійшов у пошту?

Після цього агент сам отримує ApiKey, зберігає його поза пам'яттю чату, завантажує дані облікового запису, показує список робочих просторів, зберігає один із них як робочий простір за замовчуванням для цього ключа й одразу може імпортувати транзакції або виконувати запити.

Проєкт має відкритий код на GitHub:

• github.com/kirill-markin/expense-budget-tracker
• Реалізація 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, містить початкову URL-адресу авторизації на домені авторизації та посилання на опубліковані адреси 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 на MacBook"
  }'

У відповіді буде новий ApiKey. Цей ключ показується лише один раз, тому агент має зберегти його для подальших запитів, бажано як EXPENSE_BUDGET_TRACKER_API_KEY.

Це головне покращення порівняно зі старим ручним сценарієм: користувачу не потрібно створювати ключ у налаштуваннях і вручну переносити його в термінал.

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> лише якщо ви хочете перевизначити вже збережений робочий простір або поки його ще не збережено

Вибір робочого простору тут явний: після POST /v1/workspaces/{workspaceId}/select сервер зберігає його окремо для кожного API-ключа. Якщо у користувача рівно один робочий простір, API автоматично зберігає й використовує його для нового ключа.

Що агент може робити після налаштування

Після підключення агент може взяти на себе рутинну фінансову роботу, яка не повинна забирати години ручних кліків:

1. Розбирати CSV, PDF або скриншоти з банку
2. Додавати транзакції в обліковий журнал
3. Звіряти баланси з тим, що показує банк
4. Аналізувати витрати за категоріями, продавцями або періодами
5. Оновлювати рядки бюджету на наступний місяць

Ось практичний приклад запиту для імпорту виписки:

Імпортуй ~/Downloads/revolut-february-2026.csv у мій рахунок у EUR.
Перш ніж щось записувати, перевір мої наявні категорії та транзакції за останні 30 днів, щоб уникнути дублікатів.
Після імпорту порівняй підсумковий баланс рахунку з кінцевим балансом у CSV.

А ось приклад запиту для аналітики:

Покажи мої 10 найбільших категорій витрат за останні 90 днів, а потім порівняй їх із попереднім 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 самостійно пройшли вхід і далі виконували практичну роботу з вашими витратами.