Hermes agent

Stocks

Котировки акций, история, поиск, сравнение, крипта через Yahoo.

Метаданные навыка

ИсточникОпциональный — установка командой hermes skills install official/finance/stocks
Путьoptional-skills/finance/stocks
Версия0.1.0
АвторMibay (Mibayy), Hermes Agent
ЛицензияMIT
Платформыlinux, macos, windows
ТегиStocks, Finance, Market, Crypto, Investing
Связанные навыкиdcf-model, comps-analysis, lbo-model

Справочник: полный SKILL.md

инфо

Ниже — полное определение навыка, которое Hermes загружает при его срабатывании. Именно это агент видит как инструкции, пока навык активен.

Навык Stocks

Рыночные данные только для чтения через Yahoo Finance. Пять команд: quote, search, history, compare, crypto. Только стандартная библиотека Python — без API-ключа, без установки pip-пакетов. Эндпоинт Yahoo неофициальный: может ограничивать частоту запросов или измениться без предупреждения.

Когда использовать

  • Пользователь спрашивает текущую цену акции (AAPL, TSLA, MSFT, …)
  • Нужно найти тикер по названию компании
  • Нужна история OHLCV или динамика за период
  • Требуется сравнить несколько тикеров рядом
  • Пользователь спрашивает цену крипты (BTC, ETH, SOL, …)

Требования

Только стандартная библиотека Python 3.8+. Опционально: задайте ALPHA_VANTAGE_KEY, чтобы дополнить market_cap, pe_ratio и уровни за 52 недели, когда защищённые crumb-полями данные Yahoo возвращаются как null. Бесплатный ключ: https://www.alphavantage.co/support/#api-key

Как запускать

Вызывайте через инструмент terminal. После установки:

SCRIPT=~/.hermes/skills/finance/stocks/scripts/stocks_client.py
python3 $SCRIPT quote AAPL

Весь вывод — JSON в stdout; прогоните через jq, если нужно выбрать отдельные поля.

Краткая справка

python3 $SCRIPT quote AAPL
python3 $SCRIPT quote AAPL MSFT GOOGL TSLA
python3 $SCRIPT search "Tesla"
python3 $SCRIPT history NVDA --range 6mo
python3 $SCRIPT compare AAPL MSFT GOOGL
python3 $SCRIPT crypto BTC ETH SOL

Команды

quote SYMBOL [SYMBOL2 ...]

Текущая цена, изменение, изменение в %, объём, максимум/минимум за 52 недели.

search QUERY

Поиск тикеров по названию компании. Возвращает топ-5: символ, название, биржа, тип.

history SYMBOL [--range RANGE]

Дневной OHLCV и статистика (min, max, среднее, суммарная доходность в %). Диапазоны: 1mo, 3mo, 6mo, 1y, 5y. По умолчанию: 1mo.

compare SYMBOL1 SYMBOL2 [...]

Сравнение рядом: цена, изменение в %, динамика за 52 недели.

crypto SYMBOL [SYMBOL2 ...]

Цены криптовалют. Передавайте BTC (скрипт сам добавит -USD).

Подводные камни

  • API Yahoo Finance неофициальный. Эндпоинты могут меняться или начать ограничивать частоту запросов без предупреждения — если запросы вдруг начали падать, вот почему.
  • market_cap и pe_ratio могут вернуться как null в quote, когда crumb-сессия Yahoo не установлена. Задайте ALPHA_VANTAGE_KEY, чтобы заполнить эти поля.
  • Между массовыми запросами добавьте небольшую задержку — иначе можно упереться в лимит частоты.
  • Навык только для чтения: никакого выставления ордеров, никакой интеграции со счётом.

Проверка

python3 ~/.hermes/skills/finance/stocks/scripts/stocks_client.py quote AAPL

Возвращает JSON-объект с symbol: "AAPL" и числовым полем price.

⌕ ESC