t-invest-skill — CLI + скилл для доступа к Т-Инвестициям

Даёт ИИ-агенту доступ к вашему брокерскому счёту Т-Инвестиций: данные, аналитику и операции по вашей команде — через T-Invest API. Вы спрашиваете обычным языком — «как мой портфель?», «почём я брал Сбер?», «какая доходность у моих облигаций?» — а агент сам вызывает встроенный CLI и отвечает по реальным данным счёта, а не по памяти. Вручную запускать CLI не нужно.

Это инструмент доступа к данным и операциям, а не инвестиционный советник: он не оказывает инвестиционного консультирования и не даёт индивидуальных инвестиционных рекомендаций (см. Дисклеймер).

Что умеет

• Портфель: позиции и P/L, реальная доходность (XIRR с учётом пополнений и выводов), структура (классы активов, секторы, валюты, страны, концентрация), календарь пассивного дохода (купоны + дивиденды), свободные деньги, операции с комиссиями.
• Рынок и бумаги: котировки, история цены с бенчмарком (IMOEX), стакан, лента обезличенных сделок, техиндикаторы (RSI/SMA/MACD), расписание торгов, карточки любых активов, облигации с расчётом YTM и дюрации, дивиденды, фундаментал, прогнозы аналитиков.
• Скринеры: облигации (по YTM / сроку / риску) и акции (по фундаменталу) по всему справочнику с локальным кэшем.
• Информация: новости, сделки инсайдеров, календарь отчётностей, сигналы стратегий, вотчлист.
• Торговля: заявки и стоп-заявки — в песочнице свободно, на боевом счёте с обязательным подтверждением каждой сделки; в режиме «только чтение» мутации заблокированы кодом.

Доходность к погашению и дюрация облигаций, XIRR-доходность счёта считаются самим CLI — T-Invest API готовых значений не отдаёт. Для флоатеров, амортизации и бессрочных выпусков YTM честно возвращается пустым с указанием причины.

Установка

Нужно: Node.js ≥ 20 (единственная внешняя зависимость — весь код вшит в один файл, npm-пакеты и сборка не требуются) и агент, умеющий читать SKILL.md и запускать shell-команды.

Быстро — одной командой (Linux / macOS / WSL). Скачает скилл и распакует его в каталоги скиллов (~/.agents/skills/ — общий для агентов, ~/.claude/skills/ — Claude Code), а также создаст шаблон ~/.config/tinvest/.env (без токенов):

curl -fsSL https://raw.githubusercontent.com/nyxandro/t-invest-skill/main/install.sh | bash

Повторный запуск обновляет скилл и НЕ трогает уже вписанные токены. Скилл сам подскажет (в session status), когда в репозитории появится новая версия.

Вручную. Скилл — это папка с SKILL.md, scripts/, references/. Скачай .skill (кнопка в шапке или Releases) — это ZIP-архив — и распакуй в каталог скиллов своего агента (~/.agents/skills/ у большинства, ~/.claude/skills/ у Claude Code; сам файл-архив не подхватывается):

unzip t-invest.skill -d ~/.agents/skills/     # или -d ~/.claude/skills/ для Claude Code
# → <каталог>/t-invest/{SKILL.md, scripts/tinvest.cjs, references/}

После установки скилл подхватывается автоматически (перезапусти сессию агента).

Токены и режимы

CLI работает в трёх режимах, у каждого — собственный токен: