Всем привет! Меня зовут Александр Панов, я разработчик Trade API в Финаме. Сегодня покажу, как соединить биржевые данные с искусственным интеллектом.

Через Финам вы можете торговать не только российскими бумагами, но и инструментами США. Это тысячи акций технологических гигантов (Apple, NVIDIA, Tesla) и перспективных стартапов, разнообразные ETF по секторам и стратегиям, а также товарные фьючеры на нефть, газ, золото.

Если вы еще не пробовали ИИ для анализа рынка — это реальная экономия времени. ИИ автоматически соберет котировки десятков инструментов, посчитает доходность и волатильность, построит графики и сравнит метрики. Задача, на которую раньше уходил час работы с Excel, решается за минуту в обычном диалоге.

Но если просто спрашивать ChatGPT вы получите устаревшие или выдуманные данные, взятые где-то из внутренних данных самого ChatGPT или просторов интернета.

Поэтому мы сделали Finam MCP-сервер на базе Trade API. С его помощью популярные ИИ (ChatGPT, Claude, Gemini) могут во время разговора получать реальные данные по рынку ценных бумаг и использовать их для анализа, визуализации и выработки полезных инсайтов.

В этой статье-туториале мы пройдем путь от установки и настройки Finam MCP-сервера до применения на реальных задачах инвестора. Поехали!

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

Finam MCP работает через протокол Model Context Protocol (MCP), который пока поддерживают не все ИИ-приложения. Вот приводим таблицу совместимых с MCP ИИ-инструментов, а также их доступность пользователям РФ, тарифы и платформы работы.

ИИ-приложения, совместимые с MCP**

* Для LM Studio нужна видеокарта с минимум 16 ГБ памяти — ИИ-модели запускаются локально на вашем компьютере
** Российские ИИ-решения (GigaChat, YandexGPT) и китайские (Qwen, Deepseek) пока не поддерживают MCP

В этом гайде мы будем использовать Claude Desktop — он бесплатный для базового использования, а модель Claude хорошо справляется с финансовым анализом и умеет красочно его представлять. Создайте аккаунт на сайте Anthropic, если его еще нет.

Также понадобится брокерский счет Финам и токен Finam Trade API. Брокерский счет можете открыть по ссылке, но если вы еще не клиент Финама тестировать можно и на демо-счете. После открытия счета токен на зарегистрированный аккаунт можно получить в разделе токены Trade API.

Когда всё готово, переходим к установке.

Установка

Шаг 1. Установка Claude Desktop

Скачайте приложение Claude Desktop для вашей ОС с официального сайта и войдите под аккаунтом Anthropic.

Шаг 2. Установка пакетного менеджера uv

Finam MCP-сервер написан на Python и устанавливается через менеджер пакетов uv.

Windows: Открыть PowerShell, вставить команду, нажать кнопку enter

powershell -ExecutionPolicy ByPass -c "irm <https://astral.sh/uv/install.ps1> | iex"

MacOS: Запустить терминал, установить brew через команду

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Далее вставить команду установки uv, нажать кнопку enter

brew install uv

Шаг 3. Подключение MCP-сервера к Claude Desktop

Откройте Claude Desktop. Нажмите на ваш аккаунт → Settings → Developer → Edit Config.

Откроется папка с файлом claude_desktop_config.json. Откройте его в блокноте и вставьте эту конфигурацию:

{
  "mcpServers": {
    "Finam": {
      "command": "uvx",
      "args": ["finam-mcp-server@latest"],
      "env": {
        "FINAM_API_KEY": "ваш_api_ключ",
        "FINAM_ACCOUNT_ID": "ваш_номер_счета",
        "INCLUDE_SERVERS": "market_data"
      }
    }
  }
}

Важно: Замените ваш_api_ключ и ваш_номер_счета на ваш полученный токен и номер счета из личного кабинета Finam. Содержимое файла должно быть таким

Сохраните файл (Ctrl + S) и полностью закройте Claude Desktop — не просто окно, а завершите процесс в системном трее.

Шаг 4. Проверка установки

Запустите Claude Desktop заново. Если всё прошло успешно, при нажатии кнопки Tools появятся инструменты Finam.

Если появилась ошибка — проверьте правильность API-ключа и номера счета в конфигурационном файле claude_desktop_config.json, пересохраните и повторно откройте приложение, полностью завершив его в трее.

Готово! Далее при запросах разрешите Claude использовать инструменты Finam.

Примеры практического использования

Теперь протестируем возможности Finam MCP на реальных задачах. Используем методы Market Data API для анализа американских инструментов:

• Bars — исторические данные (свечи) для построения графиков и расчета метрик

• OrderBook — текущий стакан заявок на покупку и продажу

• LastQuote — последняя котировка по инструменту

• LatestTrades — список последних сделок

? Совет: Сlaude автоматически видит доступные инструменты в каждом диалоге. Можете просить его самого составить запрос под вашу задачу — например: "Подскажи промпт для сравнения волатильности Tesla и AMD за квартал".

⚠️ Важно: Указывайте символы в формате ТИКЕР@MIC (например, AAPL@XNGS). Полный список доступных инструментов и бирж смотрите через метод Assets в Trade API.

Разберем три сценария на примере американского рынка - задача, промпт, результат:

Сценарий 1: Анализ портфеля акций — графики и статистика

Задача: Сравнить доходность и риски популярных техно-акций и ETF за год.

Проанализируй следующие инструменты за последний год:

Акции: NVDA@XNGS, AAPL@XNGS, AMD@XNGS, ASTS@XNGS, TSLA@XNGS
ETF: SPY@ARCX, QQQ@XNMS

Для каждого инструмента:
1. Получи дневные бары (close цены) за последний год
2. Построй график цен закрытия
3. Рассчитай торговую статистику:
   - Return (среднегодовая доходность)
   - Volatility (годовая волатильность = стандартное отклонение доходностей)
   - Sharpe ratio (return/volatility)

Создай сводный столбчатый график с Sharpe ratio по всем инструментам для сравнения.

Представь результаты в виде таблицы и графиков.

Сценарий 2: Стакан заявок на товарные фьючерсы

Задача: Посмотреть текущий спрос и предложение на ключевые товарные активы.

Получи текущие данные OrderBook (стакан) для следующих 4 фьючерсов:
- Нефть: BZH26@XNYM
- Газ: NGF26@XNYM
- Золото: GCG26@XCEC
- Евродоллар: M6EH26@XCME

Для каждого инструмента:
1. Запроси данные стакана через Finam:market_data_get_order_book
2. Построй график визуализации стакана (bid/ask)

Создай единый файл с визуализацией всех 4 стаканов.

LastQuote

Задача: Проанализировать внутридневное движение NASDAQ и S&P 500.

Задача:
1. Запроси LastQuote для фьючерсов:
   - NQH26@XCME (E-MINI NASDAQ 100 Mar26)
   - ESH26@XCME (E-MINI S&P 500 Mar26)
2. Из полученных данных извлеки OHLC (open, high, low, close) для текущего дня
3. Построй визуализацию в виде свечей (candlestick chart) для каждого инструмента:
   - Зеленая свеча если close > open
   - Красная свеча если close < open
   - Покажи bid/ask спред
   - Добавь объемы торгов
4. Выведи краткое текстовое резюме с ключевыми метриками

Итоги

Итак, мы настроили Finam MCP-сервер и протестировали его на реальных кейсах. Теперь Claude работает как ваш личный аналитик фондового рынка.

Помимо Market Data, Trade API предоставляет еще много возможностей: анализ портфеля, данные об инструментах, управление ордерами — которые тоже можно подключить к ИИ. Следите за обновлениями.

Экспериментируйте с промптами, тестируйте свои гипотезы и делитесь своими результатами!

Исходный код сервера: Github

Telegram сообщество: @finam_trade_api

Всем новых инсайтов и профитных стратегий! ?