Yahoo Finance CLI

Yahoo Finance CLI — это инструмент командной строки на Node.js, предназначенный для получения подробных финансовых данных с Yahoo Finance с использованием библиотеки yahoo-finance2.

Описание

Данный инструмент используется в случаях, когда необходимо получить цены акций, котировки, данные по прибыли, финансовые показатели или найти трендовые активы. Он обеспечивает быстрый доступ к рыночной информации прямо из терминала.

С помощью Yahoo Finance CLI можно работать с акциями, криптовалютами и другими финансовыми инструментами, представленными в Yahoo Finance. :

Требования

• Node.js
• Установленный пакет yahoo-finance2
• Утилита jq для обработки JSON

Установка

brew install jq
npm install yahoo-finance2
sudo ln -s /opt/homebrew/bin/yahoo-finance /usr/local/bin/yf

Использование

Инструмент доступен через команду yf. Все данные возвращаются в формате JSON и могут быть дополнительно обработаны с помощью jq.

yf   [queryOptions]

Основные модули

Quote (котировки в реальном времени)

Позволяет получить текущую цену, изменение и базовые данные по активу.

yf quote AAPL
yf quote AAPL | jq '.regularMarketPrice'

Quote Summary (расширенные данные)

Предоставляет детализированные данные: финансовые показатели, профиль компании, статистику и многое другое.

yf quoteSummary AAPL '{"modules":["assetProfile","financialData","defaultKeyStatistics"]}'

• assetProfile — информация о компании
• financialData — финансовые показатели
• defaultKeyStatistics — ключевые метрики
• calendarEvents — даты отчетности
• earnings — история прибыли
• recommendationTrend — рекомендации аналитиков

Insights (аналитика)

Показывает технические и фундаментальные инсайты: оценку, прогнозы и перспективы.

yf insights AAPL

Search (поиск)

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

yf search "Apple"
yf search "BTC-USD"

Historical / Chart (исторические данные)

Получение исторических данных OHLCV. Рекомендуется использовать модуль chart, так как historical считается устаревшим.

yf chart AAPL '{"period1":"2024-01-01","period2":"2024-12-31"}'

Trending (тренды)

Показывает популярные и активно обсуждаемые активы.

yf trendingSymbols US

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

Быстрая проверка цены

yf quote NVDA | jq '{symbol: .symbol, price: .regularMarketPrice, changePct: .regularMarketChangePercent}'

Дата следующего отчета

yf quoteSummary TSLA '{"modules":["calendarEvents"]}' | jq '.calendarEvents.earnings.earningsDate'

Рекомендации аналитиков

yf quoteSummary AAPL '{"modules":["recommendationTrend"]}'

Профиль компании

yf quoteSummary MSFT '{"modules":["assetProfile"]}'

Дополнительно

Инструмент автоматически управляет cookies, сохраняя их в файле ~/.yf2-cookies.json. При возникновении ошибок рекомендуется удалить этот файл и повторить запрос.

Результаты выводятся в чистом JSON-формате, что делает CLI удобным для интеграции в скрипты и автоматизацию процессов анализа данных.