Finance Guru — плагин
Личный «семейный офис» в терминале: типизированные калькуляторы портфеля, локальная база и агенты для Claude Code и Codex.
- 333 ★ репозитория
- Последний коммит
- AGPL-3.0
Расширенный доступ
Почему такой уровень
- Ключи SnapTrade и SimpleFIN открывают чтение брокерских и банковских данных, а настройки с ними лежат в каталоге экземпляра.
- Рыночные, брокерские и модельные интеграции отправляют запросы настроенным провайдерам, хотя хранение остается локальным.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/finance-guruОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Ключи SnapTrade и SimpleFIN открывают чтение брокерских и банковских данных, а настройки с ними лежат в каталоге экземпляра.
- Рыночные, брокерские и модельные интеграции отправляют запросы настроенным провайдерам, хотя хранение остается локальным.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Finance Guru — плагин и движок для самостоятельного «семейного офиса» в Claude Code и Codex. Расчеты вынесены из модели в 20 типизированных калькуляторов на Python с командной строкой: просадки и VaR, моментум, волатильность, корреляции, оптимизация, бэктесты, опционы, факторы, хеджирование, полная доходность и маржа. Агент запускает калькулятор с флагом `--output json` и цитирует результат, а арифметику сам не делает. Над калькуляторами работают скиллы и 11 специализированных агентов под руководством оркестратора. Личные данные лежат в отдельном каталоге вне репозитория: база SQLite, `.env` и выгрузки брокера в CSV. Синхронизация с SnapTrade и SimpleFIN идет с вашими ключами только на чтение. Перед сохранением черновика заявки на покупку защитные проверки смотрят лимит позиции в 30% капитала и покрытие маржи не ниже двух и блокируют заявку, если данных не хватает.
Для кого. Частным инвесторам с брокерским счетом, которые ведут учет и анализ на своем компьютере и готовы работать из терминала.
Подходит, если
- Хочется получить VaR, CVaR, коэффициент Шарпа и просадку по тикеру против бенчмарка одной командой.
- Выгрузки брокера в CSV лежат в папке, и агенту надо свести позиции, транзакции и расходы в одной базе.
- Позиция растет, и перед покупкой хочется проверить лимит концентрации и покрытие маржи.
- Раз в неделю маржинальную ставку из `.env` сверяют с опубликованной таблицей Fidelity.
- Сведения о финансах хранят без облачных дашбордов, и учет остается на вашей машине.
Не подходит, если
- Нужна инвестиционная рекомендация или прогноз доходности: проект заявляет, что советов не дает и доходность не обещает.
- Python 3.12 и uv не установлены, и ставить их не хочется: калькуляторы запускаются из оболочки через uv.
- Ваш брокер не подключается к SnapTrade, и выгрузки CSV для вас неудобны.
- Данные не должны уходить внешним провайдерам: рыночные, брокерские и модельные интеграции отправляют запросы выбранным сервисам.
Пример запроса к агенту
Проверь, не слишком ли велика позиция по TSLA: запусти калькулятор метрик за 252 дня против SPY и процитируй результат.Ограничения
Хранение локальное, но сеть не исключена: рыночные, брокерские и модельные интеграции отправляют данные настроенным провайдерам. Движку нужны Python 3.12 или новее, uv и Git, а Bun нужен для хуков сессий и приложения синхронизации SimpleFIN. Полностью поддерживается установка через клонирование репозитория, плагин упрощает ее. Лицензия AGPL-3.0. Планировщик swamp для еженедельной сверки маржинальной ставки помечен как экспериментальный, и провал проверки никого не уведомляет. Проект не дает финансовых советов.
Как отключить. Удалите плагин средствами Claude Code или клон репозитория. Личные данные лежат в каталоге экземпляра, например `~/finance-guru-data`, и удаляются вручную. Запущенный планировщик останавливает команда `swamp serve daemon disable`.
Частые вопросы
Как поставить Finance Guru как плагин Claude Code?
Выполните `claude plugin marketplace add AojdevStudio/Finance-Guru`, затем `claude plugin install finance-guru@finance-guru` и запустите скилл `instance-onboarding`: он создаст каталог экземпляра. Установка через клонирование поддерживается полностью.
Нужны ли данные портфеля, чтобы попробовать?
Нет. Анализ рынка работает из свежего клона: `uv run python -m src.analysis.risk_metrics_cli TSLA --days 252 --benchmark SPY` выводит VaR, CVaR, Шарпа, Сортино, просадку, волатильность, бету и альфу по дневным биржевым данным.
Куда попадают мои данные?
В каталог экземпляра вне репозитория: база `family_office.db`, `.env`, выгрузки брокера и результаты анализа. Перед пушем хук ищет секреты и персональные данные в истории и изменениях.
Что происходит, если проверке не хватает данных?
Защитная проверка блокирует заявку с типизированной причиной, например `equity_nav_unavailable`, и ничего не записывает. Недостающее значение она не угадывает.
Что за заявка на покупку?
Модель выдает идею покупки, система собирает проверенный контекст: капитал до займа, ставку по марже и балл ITC третьего слоя. Если проверки пройдены, черновик сохраняется под стабильным идентификатором, и приходит уведомление.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныМаркетплейс плагинов Anthropic для финансовых аналитиков: 10 агентов, скиллы и MCP-коннекторы для моделей DCF и LBO, отчетности, сверки и KYC
Плагин Claude для разбора отчетов инвесторов, расчета долей портфеля и подготовки заявок через брокерский коннектор
Плагины со скиллами для анализа акций, отчетностей, опционов и стартапов плюс чтение соцсетей и рыночных данных
Плагин Claude Code для аналитических отчетов по акциям: фундаментальный и технический разбор, сценарии и оценка рисков, только для обучения
MCP-сервер финансового анализа: более 500 методов из отчетностей компаний, коэффициенты, индикаторы, метрики риска и макро
Набор скиллов для частных инвесторов и трейдеров: обзор рынка, скрининг акций, теханализ, планирование сделок, журнал и разбор результатов
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Finance Guru (эта карточка) | нет | 333 | ||
| Claude Trading Skills | нет | 3 656 | набор скиллов для обзора рынка, скрининга и планирования сделок; Finance Guru добавляет калькуляторы с тестами, локальную базу и защитные проверки | |
| The Finance Toolkit | да | API-ключ | 5 502 | MCP-сервер финансового анализа по отчетностям компаний; Finance Guru работает с вашим портфелем и данными брокера в локальной базе |
Коротко о README
Описание построено на разделении ролей: агент выдвигает идею, типизированный код считает, защитные проверки отказывают при нехватке данных. Приведены схемы архитектуры и цикла проверки заявки, правило трех слоев для каждого инструмента и раздел с инструкциями для самого агента. В конце рассказано, как проект появился и что на том же движке построен коммерческий продукт Keepfolio.