yahoo-finance-mcp MCP — Сценарии использования, Установка & Живое демо

Зачем использовать

Ключевые функции

No API key — uses Yahoo's public endpoints
Full OHLCV history with configurable period and interval
Annual + quarterly income, balance, cash flow statements
Options chains with all expirations
Analyst recommendations + upgrade/downgrade history

Живое демо

Как выглядит на практике

yahoo-finance.replay ▶ готово

0/0

Установка

Выберите клиент

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

{
  "mcpServers": {
    "yahoo-finance": {
      "command": "uvx",
      "args": [
        "yahoo-finance-mcp"
      ],
      "_inferred": true
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "yahoo-finance": {
      "command": "uvx",
      "args": [
        "yahoo-finance-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "yahoo-finance": {
      "command": "uvx",
      "args": [
        "yahoo-finance-mcp"
      ],
      "_inferred": true
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "yahoo-finance": {
      "command": "uvx",
      "args": [
        "yahoo-finance-mcp"
      ],
      "_inferred": true
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "yahoo-finance",
      "command": "uvx",
      "args": [
        "yahoo-finance-mcp"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "yahoo-finance": {
      "command": {
        "path": "uvx",
        "args": [
          "yahoo-finance-mcp"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add yahoo-finance -- uvx yahoo-finance-mcp

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: yahoo-finance-mcp

Get a quick snapshot on a stock

👤 Curious investors, finance students ⏱ ~3 min beginner

Когда использовать: You want a 30-second summary before reading deeper.

Предварительные требования

yahoo-finance-mcp installed — uvx --from git+https://github.com/Alex2Yang97/yahoo-finance-mcp yahoo-finance-mcp

Поток

Basic info

Give me the current snapshot on NVDA — price, market cap, P/E, 52-week range.✓ Скопировано

→ Clean data card
Recent news

Latest 5 news items on NVDA with headlines and publication dates.✓ Скопировано

→ News feed
Analyst view

Show analyst recommendations trend and any rating changes in the last 60 days.✓ Скопировано

→ Rating counts and recent changes

Итог: A one-screen briefing for any ticker.

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

Yahoo data is delayed/best-effort — don't use for real-time trading — For live decisions, use a paid data feed; this is for research
International tickers need exchange suffix (7203.T for Toyota) — Include the suffix explicitly when asking

Сочетать с: notion

Compare fundamentals across several peers

👤 DIY investors doing homework ⏱ ~10 min intermediate

Когда использовать: You want a side-by-side before picking between similar names.

Поток

Pull statements

Compare MSFT, GOOGL, META on revenue growth, operating margin, and FCF for the last 4 annual filings.✓ Скопировано

→ Comparison table
Normalize

Express everything as year-over-year % to make the comparison fair.✓ Скопировано

→ Normalized view

Итог: A peer comparison you can save for later.

Explore an options chain

👤 Options learners ⏱ ~10 min intermediate

Когда использовать: You want to see what contracts exist before paper-trading.

Поток

List expirations

Available option expirations for AAPL.✓ Скопировано

→ Date list
Pull a chain

Get the AAPL options chain for the nearest monthly expiration. Calls only, strikes within 5% of spot.✓ Скопировано

→ Filtered calls table

Итог: A readable options view without an options-screener subscription.

Check dividend and split history

👤 Income-focused investors ⏱ ~5 min beginner

Когда использовать: Evaluating dividend consistency or adjusted-basis calculations.

Поток

Pull actions

Dividend and split history for KO for the last 20 years.✓ Скопировано

→ Two timelines
Assess consistency

Any missed or cut dividends? Call it out.✓ Скопировано

→ Narrative with specifics

Итог: Data-grounded view of long-term dividend discipline.

Комбинации

Сочетайте с другими MCP — эффект x10

yahoo-finance + notion

Build a watchlist dossier per ticker in Notion

For each ticker in my Notion Watchlist, pull the current snapshot + recent news + analyst ratings and append as a dated block.✓ Скопировано

yahoo-finance + maverick

Pair Yahoo data with technical analysis from maverick-mcp

Get NVDA fundamentals from Yahoo and RSI/MACD from maverick-mcp; synthesize a pro/con memo.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
get_historical_stock_prices	ticker: str, period?: str, interval?: str	Price history / backtests / charting	1 yahoo request
get_stock_info	ticker: str	Quick card on a stock	1 request
get_yahoo_finance_news	ticker: str	Headlines per ticker	1 request
get_stock_actions	ticker: str	Dividend/split timeline	1 request
get_financial_statement	ticker: str, type: income\|balance\|cashflow, annual\|quarterly	Fundamentals research	1 request
get_holder_info	ticker: str	Institutional/insider analysis	1 request
get_option_expiration_dates	ticker: str	Options workflow setup	1 request
get_option_chain	ticker: str, expiration: date	Examine contracts for an expiry	1 request
get_recommendations	ticker: str	Sentiment cross-check	1 request

Стоимость и лимиты

Во что обходится

Квота API: Yahoo's public endpoints are best-effort; no official published limit — don't hammer
Токенов на вызов: 200-2000 per response depending on depth
Деньги: Free
Совет: Cache statement queries — they update quarterly, not hourly. Avoid polling.

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: None

Исходящий трафик: Queries to finance.yahoo.com (via yfinance library)

Yahoo can and does change endpoints; when the MCP breaks, update yfinance upstream.
Not for real-time trading — 15-20 min delay on most feeds.

Устранение неполадок

Частые ошибки и исправления

Empty data for ticker

Ticker symbol wrong or delisted; try the exchange-suffixed form (e.g. TSLA vs 'TSLA.BA' for BA listing).

Проверить: Search yahoo finance web for the ticker

429 Too Many Requests

yfinance hit Yahoo's informal limits. Back off 5 min; avoid tight loops.

ImportError on yfinance

Reinstall with uvx --upgrade — yfinance version lag is common.

Проверить: uvx --from ... yahoo-finance-mcp --help

Альтернативы

yahoo-finance-mcp в сравнении

Альтернатива	Когда использовать	Компромисс
maverick-mcp	You want technical analysis, screens, backtesting on top of data	Larger surface; requires Tiingo key
Alpaca / IEX Cloud MCPs	You need real-time and a paid SLA	Not free; different data shape

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills