Инструкция

Инструкция по установке AI Finam Trade Skill

~5 мин чтенияОбновлено 28 сентября 2026

Содержание

Представьте, что вместо изучения документации API, разбора REST-эндпоинтов и написания клиента с нуля вы просто открываете чат с AI-ассистентом и пишете: «Покажи мой портфель» или «Найди самые волатильные акции на Мосбирже за неделю». Именно это умеет Finam Trade Skill — плагин, который подключается к Claude Code, Qwen Code, Codex или Cursor и обучает их работать с Finam Trade API на естественном языке.

В этом гайде — все, что нужно, чтобы за пять минут поставить скилл и получить первый ответ от своего портфеля.

Что это такое

Скилл - не отдельный сервер и не облачный сервис, а набор инструкций для AI-ассистента плюс несколько самодостаточных скриптов, таких как поиск инструментов и сканирование рынка. Когда вы просите ассистента что-то сделать:

Читает инструкции скилла и понимает, какой запрос к Finam Trade API нужен.
По заданному вами токену находит нужный торговый счет и получает JWT токен для авторизации каждого запроса.
Сам обращается к REST или gRPC API напрямую.
При необходимости пишет и сразу запускает код — например, скрипт стратегии или бэктест на исторических данных.

Никакого фонового процесса, который нужно поднимать и поддерживать. Установили плагин, задали токен — и все готово: то, на что раньше уходили часы на чтение документации и написание клиента, теперь занимает один запрос ассистенту.

Что понадобится

Перед установкой проверьте три вещи:

AI-ассистент с поддержкой плагинов — Claude Code, Qwen Code, Codex или Cursor. Скилл написан один раз и работает во всех четырех.
python3 — нужен только скриптам поиска инструментов и сканера рынка. Он почти наверняка уже стоит в вашей системе; отдельно ставить обычно не приходится, но если что сам AI ассистент может подсказать как поставить.
Токен Finam Trade API — получить можно на api.finam.ru/docs/tokens.

Токен нужен не для всего. Изучать документацию, проектировать стратегии и генерировать скрипты можно и без него — он требуется только когда ассистент реально обращается к API за вашими данными.

Если хотите не просто сгенерировать скрипт стратегии, а сразу запустить его и получать данные из SDK, дополнительно понадобится установить библиотеку командой pip install finam-sdk.

Шаг 1. Установите плагин

Выберите свой инструмент и выполните пару команд.

Claude Code

Если вы пользуетесь консольным агентом Claude Code, напишите в консоли следующее

Bash

Qwen Code

Если вы пользуетесь консольным агентом Qwen Code, напишите в консоли следующее

Bash

Codex

Если вы пользуетесь консольным агентом Codex, напишите в консоли следующее

Bash

Cursor

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

Bash

После установки перезапустите ассистента или откройте новую сессию — так он точно подхватит обновленный список команд.

Шаг 2. Подключите токен (опционально)

Скиллу нужна ровно одна переменная окружения — TRADE_API_SECRET. Счет, с которым он будет работать, определяется автоматически по самому токену, так что руками ничего выбирать не придется.

Для Claude Code есть возможность добавить секрет локально в директории текущего проекта .claude/settings.local.json, написав там следующее:

JSON

В Qwen Code токен запрашивается прямо во время установки. Если пропустили этот шаг, задайте его вручную:

Bash

Cursor— токен задаётся в панели управления, в разделе Plugins → Configure, уже после установки плагина.

Если один токен дает доступ сразу к нескольким счетам, ассистент об этом сам спросит — либо заранее зафиксируйте нужный счет переменной ACCOUNT_ID.

Нет счета? Начните с демо

На той же странице токенов можно открыть бесплатный демо-счет. Он действует две недели и ведет себя точно так же, как настоящий — с реальными котировками и полноценным исполнением заявок, но без риска для ваших денег. Хороший способ протестировать скилл перед тем, как подключать боевой счет. ❗️Важно: демо-счет нельзя открыть, если у вас уже есть реальный брокерский счет в Финаме — в этом случае сразу подключайте токен от своего счета.

Шаг 3. Проверьте, что все работает

Откройте чат с ассистентом и просто спросите:

Без подсветки

Если видите баланс и позиции — установка прошла успешно. Дальше можно пробовать что угодно:

Анализ портфеля

Без подсветки

Сканер рынка

Без подсветки

Готовая стратегия

Без подсветки

Работа с заявками

Без подсветки

Безопасность: ассистент помогает торговать, а не торгует за вас

Инструкции скилла требуют, чтобы ассистент подтверждал у вас каждую разовую заявку — вслух озвучивал инструмент, сторону, объем, тип и цену — и ждал явного «да» перед тем, как разместить или отменить ордер. Но это подтверждение защищает только ручные, разовые команды. Если вы попросили ассистента запустить автоматическую стратегию (например, с регулярной ребалансировкой), она будет сама принимать решения о сделках по заданной логике — сначала прогоняйте такие стратегии в режиме dry-run или на демо-счете, и только убедившись, что логика работает как задумано, переключайтесь на реальный счет.

Информация, сгенерированная скиллом и подключенными AI-агентами, носит образовательный и информационный характер и не является индивидуальной инвестиционной рекомендацией. Перед принятием торговых решений проводите собственный анализ. Результаты в прошлом не гарантируют результатов в будущем.*

Решение проблем

Ошибка авторизации или «токен не задан»
Проверьте, что TRADE_API_SECRET действительно виден в текущей сессии ассистента. JWT запрашивается заново перед каждым вызовом и нигде не кэшируется, так что сам секрет должен быть доступен постоянно.
Ассистент не видит новую команду
Перезапустите его или начните новый чат, чтобы список плагинов обновился.
«Токен дает доступ к нескольким счетам»
Задайте ACCOUNT_ID вручную или дождитесь, пока ассистент сам уточнит, какой счет использовать.
Слишком много запросов подряд
Действует лимит 200 запросов в минуту на метод; просто подождите немного.
API временно недоступен
У Trade API есть ежедневное технологическое окно 05:00–06:15 МСК, в это время сервис может отвечать с перебоями.