Добавить сервер
narumiruna/yfinance-mcp
  1. Каталог MCP
  2. narumiruna/yfinance-mcp

narumiruna/yfinance-mcp

от narumiruna
Тянет данные Yahoo Finance: котировки, отчёты, новости и свечные графики по любому тикеру. Ищет акции и ETF, ранжирует сектора.
GithubPyPiСайт сервера

Yahoo Finance MCP Server

PyPI version Python CI License: MIT

A Model Context Protocol (MCP) server that provides AI assistants with access to Yahoo Finance data via yfinance. Query stock information, financial news, sector rankings, and generate professional financial charts — all from your AI chat.

Features

  • Stock Data — Company info, financials, valuation metrics, dividends, and trading data
  • Analyst Data — Consensus targets, estimate/revision trends, recommendation history, and firm-level actions
  • Financial Statements — Income statement and balance sheet with historical data (EBIT, Invested Capital, etc.)
  • Financial News — Recent news articles and press releases for any ticker
  • Search — Find stocks, ETFs, and news across Yahoo Finance
  • Sector Rankings — Top ETFs, mutual funds, companies, growth leaders, and top performers by sector
  • Price History — Historical OHLCV data as markdown tables or professional charts
  • Chart Generation — Candlestick, VWAP, and volume profile charts returned as WebP images
  • Options Data — Option chains with calls, puts, strike prices, IV, and expiration dates
  • Ownership Data — Major holders, institutional investors, mutual fund holders, and insider transactions
  • Fund Look-Through — ETF and mutual-fund holdings, asset classes, sectors, ratings, and operating details
  • Screeners — Predefined, equity, mutual-fund, and ETF query trees

Часто задаваемые вопросы

Инструменты были проиндексированы:
yfinance_get_analyst_estimatesтолько чтениеидемпотентныйвнешний мир

Получает консенсус-прогнозы, тренды по EPS/выручке, пересмотры, рекомендации и историю прибыли.

Параметры
  • max_rowsinteger

    Максимум строк в разделе. Укажите 0, чтобы вернуть все строки.

  • sectionsstring[] | null

    Необязательные разделы аналитиков: рекомендации, оценка прибыли, оценка выручки, динамика прибыли на акцию, пересмотры прибыли, история прибыли и прогнозы роста. Если не указано, возвращаются все разделы.

  • symbolstringобязательный

    Биржевой тикер (например, 'AAPL', 'GOOGL', 'MSFT')

yfinance_get_analyst_price_targetsтолько чтениеидемпотентныйвнешний мир

Получает текущую цену и консенсус-прогнозы аналитиков для акции. Возвращает объект JSON с полями, предоставляемыми Yahoo Finance: - current: текущая рыночная цена - low: минимальный целевой уровень цены от аналитиков - high: максимальный целевой уровень цены от аналитиков - mean: средний целевой уровень цены от аналитиков - median: медианный целевой уровень цены от аналитиков Покрытие аналитиками и доступные поля различаются в зависимости от тикера.

Параметры
  • symbolstringобязательный

    Биржевой тикер (например, 'AAPL', 'GOOGL', 'MSFT')

yfinance_get_financialsтолько чтениеидемпотентныйвнешний мир

Получает финансовые отчёты (отчёт о прибылях и убытках, баланс и отчёт о движении денежных средств) с историческими данными. Возвращает JSON с данными отчёта о прибылях и убытках, баланса и отчёта о движении денежных средств за несколько отчётных периодов. Используйте эти данные, чтобы анализировать динамику, рассчитывать коэффициенты или сравнивать периоды.

Параметры
  • frequencystring

    Частота отчетности: 'annual' для годовой, 'quarterly' для квартальной или 'ttm' для последних двенадцати месяцев.

  • symbolstringобязательный

    Биржевой тикер (например, 'AAPL', 'GOOGL', 'MSFT')

yfinance_get_fund_dataтолько чтениеидемпотентныйвнешний мир

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

Параметры
  • max_rowsinteger

    Максимальное количество строк на табличный раздел. Укажите 0, чтобы вернуть все строки.

  • sectionsstring[] | null

    Необязательные разделы фонда: description, fund_overview, fund_operations, asset_classes, top_holdings, equity_holdings, bond_holdings, bond_ratings и sector_weightings. Если не указано, возвращаются все разделы.

  • symbolstringобязательный

    Тикер ETF или взаимного фонда (например, 'SPY', 'BND', 'VFIAX')

yfinance_get_holdersтолько чтениеидемпотентныйвнешний мир

Возвращает основных держателей, институциональных держателей, держателей взаимных фондов и данные инсайдеров. Возвращает JSON с: - major_holders: Агрегированная разбивка: процент инсайдеров, процент институционалов, процент институционалов от free float и количество институтов. - institutional_holders: Список институциональных инвесторов с количеством акций, датой отчёта, стоимостью и % изменения. - mutualfund_holders: Список держателей взаимных фондов с теми же полями. - insider_transactions: Последние инсайдерские сделки: количество акций, стоимость, тип сделки и дата. - insider_purchases: Сводка покупок/продаж инсайдеров за последние 6 месяцев. - insider_roster: Список известных инсайдеров по имени и должности. Используйте для анализа концентрации собственности, активности инсайдеров и интереса институционалов.

Параметры
  • max_rowsinteger

    Максимальное количество строк, возвращаемых на раздел держателя. Укажите 0, чтобы вернуть все строки.

  • symbolstringобязательный

    Биржевой тикер (например, 'AAPL', 'GOOGL', 'MSFT')

yfinance_get_option_chainтолько чтениеидемпотентныйвнешний мир

Получает данные опционной цепочки (коллов и путов) для акции с доступными ценами страйков. Возвращает JSON с данными по коллам и/или путам для каждой даты экспирации. Поля JSON включают: - contractSymbol: Идентификатор опционного контракта - strike: Цена страйка - lastPrice: Последняя цена сделки - bid/ask: Цены спроса и предложения - volume: Объём торгов - openInterest: Открытый интерес - impliedVolatility: Подразумеваемая волатильность (IV) - inTheMoney: Опцион в деньгах (ITM) - contractSize: Размер контракта (REGULAR) - currency: Валюта (USD) Используйте это для анализа цен опционов, поверхностей IV и уровней страйков.

Параметры
  • expiration_datestring | null

    Дата истечения в формате ГГГГ-ММ-ДД. Используйте инструмент 'yfinance_get_option_dates', чтобы получить доступные даты, или опустите его, чтобы загрузить все доступные даты истечения.

  • option_typeenum

    Какие опционы возвращать: 'calls', 'puts' или 'all' (и calls, и puts).

  • symbolstringобязательный

    Биржевой тикер (например, 'AAPL', 'GOOGL', 'MSFT')

yfinance_get_option_datesтолько чтениеидемпотентныйвнешний мир

Запрашивает доступные даты истечения опционов для акции. Возвращает массив JSON с датами истечения в формате ГГГГ-ММ-ДД. Используйте эти даты с инструментом 'yfinance_get_option_chain', чтобы получить цепочку опционов на конкретную дату.

Параметры
  • symbolstringобязательный

    Биржевой тикер (например, 'AAPL', 'GOOGL', 'MSFT')

yfinance_get_price_historyтолько чтениеидемпотентныйвнешний мир

Получает исторические данные о ценах и опционально генерирует графики технического анализа. Когда chart_type равен None, возвращает Markdown-таблицу со столбцами: - Дата: Торговая дата (индекс) - Цена открытия: Цена открытия - Максимум: Максимальная цена - Минимум: Минимальная цена - Цена закрытия: Цена закрытия - Объём: Объём торгов - Дивиденды: Выплаты дивидендов (если есть) - Сплиты акций: События дробления акций (если есть) Когда задан chart_type, возвращает изображение графика: - 'price_volume': Свечной график с гистограммой объёмов - 'vwap': Цена с наложением средневзвешенной по объёму цены - 'volume_profile': Распределение объёма по ценовым уровням Установите prepost=True, чтобы включить данные до начала и после окончания основной торговой сессии, если они доступны. Примечание: Не все комбинации периода и интервала допустимы. Минутные интервалы (1m, 5m и т.д.) работают только с короткими периодами (1d, 5d).

Параметры
  • chart_typeenum | null

    Необязательная визуализация: 'price_volume' (свечной график со столбцами объема), 'vwap' (наложение средневзвешенной цены по объему), 'volume_profile' (распределение объема по уровням цены). Опустите для табличных данных.

  • intervalenum

    Гранулярность данных: '1m'/'5m'/'15m'/'30m' (минуты), '1h' (час), '1d'/'5d' (дни), '1wk' (неделя), '1mo'/'3mo' (месяцы). Короткие интервалы требуют коротких периодов (например, интервал '1m' работает только с периодом '1d'/'5d')

  • periodenum

    Временной диапазон: '1d'/'5d' (дни), '1mo'/'3mo'/'6mo' (месяцы), '1y'/'2y'/'5y'/'10y' (годы), 'ytd' (с начала года), 'max' (все доступные данные)

  • prepostboolean

    Включает данные до открытия и после закрытия рынка, когда они доступны.

  • symbolstringобязательный

    Биржевой тикер (например, 'AAPL', 'GOOGL', 'MSFT')

yfinance_get_ticker_infoтолько чтениеидемпотентныйвнешний мир

Получает полные данные по акциям, включая информацию о компании, финансовые показатели, торговые метрики и корпоративное управление. Возвращает JSON-объект со следующими полями: - Компания: symbol, longName, sector, industry, longBusinessSummary, website, city, country - Цена: currentPrice, previousClose, open, dayHigh, dayLow, fiftyTwoWeekHigh, fiftyTwoWeekLow - Оценка: marketCap, enterpriseValue, trailingPE, forwardPE, priceToBook, pegRatio - Торговля: volume, averageVolume, averageVolume10days, bid, ask, bidSize, askSize - Дивиденды: dividendRate, dividendYield, exDividendDate, payoutRatio - Финансы: totalRevenue, revenueGrowth, earningsGrowth, profitMargins, operatingMargins - Производительность: beta, fiftyDayAverage, twoHundredDayAverage, trailingEps, forwardEps Примечание: доступные поля различаются в зависимости от типа ценной бумаги. Временные метки преобразуются в читаемые даты.

Параметры
  • symbolstringобязательный

    Биржевой тикер (например, 'AAPL', 'GOOGL', 'MSFT')

yfinance_get_ticker_newsтолько чтениеидемпотентныйвнешний мир

Получает свежие новостные статьи и пресс-релизы для конкретной акции. Возвращает JSON-массив, где каждый элемент новости содержит: - id: Уникальный идентификатор статьи - content: Объект со следующими полями: - title: Заголовок статьи - summary: Краткое описание статьи - pubDate: Дата публикации (формат ISO 8601) - provider: Объект с полями displayName (например, "Yahoo Finance") и url - canonicalUrl: Объект с url статьи, site, region, lang - thumbnail: Объект с URL изображений и разрешениями - contentType: Тип контента (например, "STORY", "VIDEO") Используйте этот инструмент, чтобы отслеживать корпоративные объявления, рыночные настроения и актуальные новости.

Параметры
  • symbolstringобязательный

    Биржевой тикер (например, 'AAPL', 'GOOGL', 'MSFT')

yfinance_get_topтолько чтениеидемпотентныйвнешний мир

Получает топ финансовых сущностей в секторе. Этот универсальный инструмент объединяет несколько рейтингов: - ETF и взаимные фонды, ориентированные на сектор - Крупнейшие компании по рыночной капитализации - Быстрорастущие компании по выручке/прибыли - Лучшие акции по росту котировок Возвращает JSON-данные с метриками для каждого типа сущностей.

Параметры
  • sectorenumобязательный

    Сектор рынка (например, «Технологии», «Здравоохранение», «Финансовые услуги»)

  • top_ninteger

    Количество ведущих сущностей для получения по категории/отрасли

  • top_typeenumобязательный

    Тип сущностей для получения: 'top_etfs' (отраслевые ETF), 'top_mutual_funds' (отраслевые взаимные фонды), 'top_companies' (крупнейшие по рыночной капитализации), 'top_growth_companies' (самый быстрый рост выручки/прибыли), 'top_performing_companies' (лучшая динамика цены акций)

yfinance_get_upgrades_downgradesтолько чтениеидемпотентныйвнешний мир

Получает апгрейды, даунгрейды, инициации и изменения целевых цен от аналитиков. Возвращает действия аналитиков, начиная с самых новых. Поля, которые предоставляет Yahoo Finance, могут включать: - GradeDate: дата и время действия аналитика - Firm: название аналитической фирмы - ToGrade и FromGrade: новый и предыдущий рейтинги - Action: рейтинговое действие, например апгрейд, даунгрейд, инициация или подтверждение - priceTargetAction: действие с целевой ценой, например Повышение, Понижение или Сохранение - currentPriceTarget и priorPriceTarget: новая и предыдущая целевые цены Доступные поля различаются в зависимости от символа и действия аналитика.

Параметры
  • max_rowsinteger

    Максимум действий аналитика для возврата, сначала новые. Используйте 0, чтобы вернуть все строки.

  • symbolstringобязательный

    Биржевой тикер (например, 'AAPL', 'GOOGL', 'MSFT')

yfinance_screenтолько чтениеидемпотентныйвнешний мир

Запустить поиск по фильтру Yahoo Finance. Поддерживает предопределённые ключи фильтра Yahoo и пользовательские деревья запросов по акциям или фондам.

Параметры
  • countinteger | null

    Строки для возврата в предопределённых запросах. Максимум для Yahoo - 250.

  • offsetinteger | null

    Смещение результата.

  • querystring | objectобязательный

    Запрос скринера. Для query_type='predefined': строковый ключ, например 'day_gainers'. Для query_type='equity', 'fund' или 'etf': объект дерева запроса с узлами {operator, operands}.

  • query_typeenum

    Режим запроса: 'predefined', 'equity', 'fund' или 'etf'.

  • sizeinteger | null

    Количество строк для возврата в пользовательских запросах. Максимум Yahoo — 250.

  • sort_ascboolean | null

    Сортирует по возрастанию, если true, и по убыванию, если false.

  • sort_fieldstring | null

    Поле сортировки, например 'percentchange'.

  • user_idstring | null

    Необязательный идентификатор пользователя Yahoo.

  • user_id_typestring | null

    Необязательный тип идентификатора пользователя Yahoo, обычно 'guid'.

yfinance_screen_gappersтолько чтениеидемпотентныйвнешний мир

Запускает пользовательский скринер акций, настроенный на акции, открывающиеся с гэпом.

Параметры
  • min_market_capinteger

    Минимальная внутридневная рыночная капитализация в USD.

  • min_percent_changenumber

    Минимальное процентное изменение от предыдущего закрытия, например 3.0 для +3%.

  • min_pricenumber

    Минимальная текущая внутридневная цена.

  • min_volumeinteger

    Минимальный внутридневной объём торгов.

  • offsetinteger

    Смещение результата для пагинации.

  • regionstring

    Код региона скринера Yahoo, например 'us'.

  • sizeinteger

    Количество строк для возврата. Максимум Yahoo — 250.

  • sort_ascboolean

    Сортирует по percentchange по возрастанию, если true, и по убыванию, если false.

yfinance_searchтолько чтениеидемпотентныйвнешний мир

Ищет акции, ETF и новости через Yahoo Finance. Возвращает JSON с результатами поиска в зависимости от search_type: - 'quotes': Массив ценных бумаг с полями: - symbol: Тикер - shortname/longname: Название компании - quoteType: Тип ценной бумаги (EQUITY, ETF, MUTUALFUND и т.д.) - exchange: Код биржи - sector: Сектор экономики - industry: Отрасль - score: Оценка релевантности поиска - 'news': Массив статей с полями: - uuid: Идентификатор статьи - title: Заголовок - publisher: Источник новости - link: Ссылка на статью - providerPublishTime: Время публикации в формате Unix timestamp - relatedTickers: Массив связанных тикеров - thumbnail: URL изображений - 'all': Объект с массивами 'quotes' и 'news' Используйте этот инструмент, чтобы найти тикеры, обнаружить связанные ценные бумаги или искать финансовые новости.

Параметры
  • querystringобязательный

    Поисковый запрос - название компании, тикер или ключевые слова

  • search_typeenumобязательный

    Фильтровать результаты: «все» (котировки + новости), «котировки» (только акции и ETF) или «новости» (только статьи).

0.14.0основная
0.13.0
0.12.4
0.12.3
0.12.2
0.12.1
0.12.0
0.11.3
0.11.2
0.11.1
0.11.0
0.10.0
0.9.3
0.9.2
0.9.1
0.9.0
0.8.3
0.8.2
0.8.1
0.8.0
0.7.0
0.6.1
0.6.0
0.5.1
0.5.0
0.4.8
0.4.7
0.4.4
0.4.3
0.4.2
0.4.1
0.4.0
0.3.1
0.3.0
0.2.0
0.1.11
0.1.10
0.1.9
0.1.8
0.1.7
0.1.6
0.1.5
0.1.3
0.1.2
0.1.1
0.1.0

Выберите клиент, чтобы установить narumiruna/yfinance-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "narumiruna-yfinance-mcp-opp5g8rst4": {
      "command": "uvx",
      "args": [
        "yfmcp@latest"
      ]
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "narumiruna-yfinance-mcp-opp5g8rst4": {
      "command": "uvx",
      "args": [
        "yfmcp@latest"
      ]
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "narumiruna-yfinance-mcp-opp5g8rst4": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "yfmcp@latest"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"narumiruna-yfinance-mcp-opp5g8rst4\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"yfmcp@latest\"]}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "narumiruna-yfinance-mcp-opp5g8rst4": {
      "command": "uvx",
      "args": [
        "yfmcp@latest"
      ]
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add narumiruna-yfinance-mcp-opp5g8rst4 -- uvx yfmcp@latest

Либо через JSON-конфиг:

claude mcp add-json narumiruna-yfinance-mcp-opp5g8rst4 "{\"command\":\"uvx\",\"args\":[\"yfmcp@latest\"]}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add narumiruna-yfinance-mcp-opp5g8rst4 -- uvx yfmcp@latest

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.narumiruna-yfinance-mcp-opp5g8rst4]
command = "uvx"
args = ["yfmcp@latest"]
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите narumiruna/yfinance-mcp, а в поле команды запуска — строку ниже:
uvx yfmcp@latest

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "narumiruna-yfinance-mcp-opp5g8rst4": {
      "command": "uvx",
      "args": [
        "yfmcp@latest"
      ]
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "narumiruna-yfinance-mcp-opp5g8rst4": {
      "command": "uvx",
      "args": [
        "yfmcp@latest"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например narumiruna-yfinance-mcp-opp5g8rst4.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: narumiruna-yfinance-mcp-opp5g8rst4
    command: uvx
    args:
      - "yfmcp@latest"
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "narumiruna-yfinance-mcp-opp5g8rst4": {
      "command": "uvx",
      "args": [
        "yfmcp@latest"
      ]
    }
  }
}

Похожие MCP-сервера

berlinbra/alpha-vantage-mcp

berlinbra/alpha-vantage-mcp

от berlinbra

MCP сервер предоставляет доступ к реальным котировкам акций, опционам и ETF через Alpha Vantage. Идеально для технического анализа и торговых стратегий. Подходит для трейдеров и разработчиков, использующих единый MCP-интерфейс.

Python⭐ 104
etbars/vibetrader-mcp

etbars/vibetrader-mcp

от etbars

VibeTrader MCP сервер подключает AI-помощников к платформе торговли акциями. Через естественный язык создавайте ботов, управляйте портфелем, получайте котировки и бэктест стратегии. Полезно трейдер...

Python⭐ 4
ferdousbhai/wsb-analyst-mcp

ferdousbhai/wsb-analyst-mcp

от ferdousbhai

Анализирует WallStreetBets в реальном времени: находит топовые посты, собирает комментарии и внешние ссылки, отслеживает трендовые тикеры.

Python⭐ 31
laukikk/alpaca-mcp

laukikk/alpaca-mcp

от laukikk

MCP сервер для управления портфелем акций и криптовалют через API Alpaca. Размещай рыночные, лимитные и стоп-ордера, отслеживай позиции, получай котировки и исторические данные. Полезен трейдерам д...

Python⭐ 35
vdalhambra/financekit-mcp

vdalhambra/financekit-mcp

от vdalhambra

FinanceKit MCP — сервер для AI-агентов (Claude Code, Cursor, Windsurf), дающий доступ к котировкам акций и криптовалют в реальном времени, техническому анализу (RSI, MACD, Боллинджер) и портфельным...

Python⭐ 8
financial-datasets/mcp-server

financial-datasets/mcp-server

от financial-datasets

MCP сервер для доступа к финансовым данным из Financial Datasets. Предоставляет отчёты о прибылях, балансы, цены акций и криптовалют через интерфейс ИИ-ассистентов. Полезен для инвесторов и аналитиков.

Python⭐ 2309
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин