Перейти к основному содержимому

Акции

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

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

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

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

к сведению

Ниже приведено полное описание навыка, которое VibeOS загружает при его активации. Агент видит эти инструкции, когда навык активен.

Навык «Акции»

Рыночные данные только для чтения через 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=~/.vibeos/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 плюс статистика (мин, макс, среднее, общая доходность %). Диапазоны: 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 ~/.vibeos/skills/finance/stocks/scripts/stocks_client.py quote AAPL

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