Если вы хотите вести учет расходов с помощью ИИ-агента, больше всего времени обычно уходит не на саму работу, а на первое подключение.

Обычно ручной сценарий выглядит так:

Открыть приложение
Создать API-ключ
Скопировать ключ
Вставить его в терминального агента
Объяснить, какой адрес API нужно вызывать
Надеяться, что агент выберет правильное рабочее пространство

Такой подход работает, но для агента он неудобен.

Expense Budget Tracker теперь публикует открытый URL обнаружения для терминальных агентов, таких как Claude Code, OpenAI Codex и OpenClaw:

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

Пользователь передает агенту эту ссылку и отвечает всего на два вопроса:

Какой адрес электронной почты использовать для входа?
Какой 8-значный код только что пришел в почту?

После этого агент сам выпускает ApiKey, сохраняет его вне памяти чата, загружает аккаунт, получает список рабочих пространств, выбирает одно из них по умолчанию для этого ключа и сразу может импортировать или запрашивать транзакции.

Проект открыт и доступен на GitHub:

Одна ссылка для агента

Вот точный URL:

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

Подключись к моему аккаунту Expense Budget Tracker через https://api.expense-budget-tracker.com/v1/.
Когда понадобятся данные для входа, сначала спроси адрес электронной почты, а затем 8-значный код.
После настройки сохрани ключ, проверь /schema и покажи последние 20 транзакций и общую сумму трат на продукты за этот месяц.

Пример инструкции для OpenClaw

Подключись к Expense Budget Tracker через https://api.expense-budget-tracker.com/v1/.
После входа сохрани мое личное рабочее пространство как пространство по умолчанию для этого ключа и импортируй загруженный мной CSV-файл.
По возможности используй уже существующие категории и сообщи, если какой-либо баланс не совпадет.

Как работает настройка ИИ-трекера расходов

Ниже показан полный HTTP-сценарий этого подключения.

1. Прочитать URL обнаружения

Агент начинает здесь:

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

Ответ сообщает, что сначала нужно вызвать send_code, содержит стартовый URL на auth-домене и указывает на опубликованные эндпоинты OpenAPI и schema.

2. Отправить адрес электронной почты пользователя

Агент отправляет адрес электронной почты в auth-сервис:

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.

Это и есть главное улучшение по сравнению со старым ручным сценарием: пользователю больше не нужно создавать ключ в настройках и вручную переносить его в терминал.

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 автоматически выбирает и сохраняет его для нового ключа.

Что агент может делать после настройки

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

Разбирать CSV, PDF и скриншоты банковских выписок
Добавлять транзакции в журнал
Сверять балансы с тем, что показывает банк
Анализировать траты по категориям, контрагентам и периодам
Обновлять бюджетные строки на следующий месяц

Вот практический пример инструкции для импорта выписки:

Импортируй ~/Downloads/revolut-february-2026.csv в мой счет в EUR.
Перед записью запроси мои текущие категории и транзакции за последние 30 дней, чтобы не создавать дубликаты.
После импорта сравни итоговый баланс счета с закрывающим балансом из CSV.

А вот пример инструкции для анализа:

Покажи 10 крупнейших категорий расходов за последние 90 дней и сравни их с предыдущим 90-дневным периодом.
Также перечисли самые крупные операции в категориях, где расходы выросли.

Почему это лучше, чем ручная настройка API-ключа

Новый поток проще и для пользователя, и для агента:

пользователю не нужно вручную копировать долгоживущий ключ
агент сам узнает протокол из продукта
аутентификация чисто отделена от доступа к данным
каждый SQL-запрос привязан к выбранному рабочему пространству
подключение можно потом отозвать из приложения

Если вы строите процесс учета расходов с ИИ, это важно: становится меньше служебных инструкций и типичных ошибок при подключении.

Открытый трекер расходов с поддержкой агентов

Expense Budget Tracker распространяется по лицензии MIT и полностью открыт:

Если вы хотите вариант с самостоятельным размещением, начните так:

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

Если вы хотите использовать уже развернутую версию сервиса, дайте агенту этот URL:

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

Этого достаточно, чтобы Claude Code, Codex или OpenClaw сами начали процесс входа.

Читайте дальше

2026-03-05

Как подключить Claude Code, Codex и OpenClaw к Expense Budget Tracker