YFinance MCP — Установка & Живое демо

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

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

Без API-ключа, без регистрации
Котировки, исторические OHLC, фундаментальные данные, балансы
Цепочки опционов, даты отчётностей, дивиденды
Новостные заголовки по тикеру
Быстрая Python-реализация через uvx

Живое демо

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

yfinance-mcp.replay ▶ готово

0/0

Установка

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

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

{
  "mcpServers": {
    "yfinance-mcp": {
      "command": "uvx",
      "args": [
        "yfinance-mcp"
      ]
    }
  }
}

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

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

{
  "mcpServers": {
    "yfinance-mcp": {
      "command": "uvx",
      "args": [
        "yfinance-mcp"
      ]
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "yfinance-mcp": {
      "command": "uvx",
      "args": [
        "yfinance-mcp"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "yfinance-mcp": {
      "command": "uvx",
      "args": [
        "yfinance-mcp"
      ]
    }
  }
}

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

~/.continue/config.json

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

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

~/.config/zed/settings.json

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

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

claude mcp add yfinance-mcp -- uvx yfinance-mcp

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

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

Реальные сценарии: YFinance MCP

Быстрый снимок вашего вотч-листа — цены, P/E, новости

👤 Инвесторы, делающие ежедневные сводки ⏱ ~5 min beginner

Когда использовать: Вы хотите однопромптовый брифинг по 10 тикерам перед открытием рынка.

Поток

Цены

Use yfinance-mcp. For AAPL, MSFT, NVDA, TSLA, GOOGL, AMZN, META, BRK-B, JPM, V — current price, 1d %, 52w range.✓ Скопировано

→ Чистая таблица со всеми 10 строками
Фундаментальные данные

For the same list, P/E, forward P/E, EPS, and dividend yield.✓ Скопировано

→ Фундаментальные данные выровнены с предыдущей таблицей
Новости

For the 3 biggest movers today, pull the 3 most recent headlines each. Summarize the vibe.✓ Скопировано

→ Новости сгруппированы по тикеру, однострочная характеристика настроений

Итог: Утренний брифинг по вашему вотч-листу на 10 строк.

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

Ограничение запросов при пакетной обработке слишком многих тикеров — Разбивайте по 10 тикеров за вызов, делайте паузу 1 секунду между запросами

Сочетать с: memory

Бэктест простой стратегической идеи на исторических ценах

👤 Розничные трейдеры в режиме прототипирования ⏱ ~20 min intermediate

Когда использовать: У вас есть идея вроде «покупать SPY когда RSI < 30, продавать при > 70» и нужна быстрая историческая проверка.

Поток

Загрузить историю

Pull 5y daily OHLC for SPY.✓ Скопировано

→ Временной ряд возвращён в виде массива
Посчитать

Compute RSI(14). Run the "buy<30, sell>70" strategy. Report CAGR, max drawdown, trade count vs buy-and-hold.✓ Скопировано

→ Метрики стратегии с честным сравнением с базой
Проверка реальностью

Account for commissions ($1/trade) and slippage (5bps). Does the edge survive?✓ Скопировано

→ Показатели с учётом затрат

Итог: Решение: стоит ли тестировать идею дальше.

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

Предвзятость выжившего — в yfinance только ликвидные тикеры — Для серьёзного бэктестинга используйте специализированный датасет; yfinance — для набросков

Сочетать с: alpaca

Комбинации

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

yfinance-mcp + alpaca

yfinance для исследования, Alpaca для реальных ордеров

Pick 3 ideas via yfinance, place paper trades via Alpaca.✓ Скопировано

yfinance-mcp + memory

Отслеживать собственный тезис по тикерам во времени

Store the thesis on NVDA as of today, along with the price.✓ Скопировано

Инструменты

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

Инструмент	Входные данные	Когда вызывать	Стоимость
get_quote	ticker: str	Снимок текущей цены	free
get_history	ticker, period: str, interval: str	Исторические данные для графика или бэктеста	free
get_fundamentals	ticker	Анализ оценки / фундаментальных данных	free
get_options	ticker, expiry?: date	Поиск по цепочке опционов	free
get_news	ticker, limit?: int	Заголовки новостей по тикеру	free

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

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

Квота API: Недокументированные лимиты Yahoo — не перегружайте запросами
Токенов на вызов: OHLC за 5 лет ≈ 50k токенов, держите запросы сфокусированными
Деньги: Бесплатно
Совет: Пересемплируйте до недельных данных для длинных историй; используйте дневные только когда нужно

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

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

Хранение учётных данных: Отсутствует

Исходящий трафик: query1.finance.yahoo.com

Yahoo ранее ломал yfinance изменениями HTML — обновляйте пакет регулярно

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

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

Возвращает пустой результат / ошибку для тикера

Используйте формат символов Yahoo (например BRK-B, а не BRK.B); некоторые биржи требуют суффикса (.T для Токио)

JSONDecodeError

Yahoo ввёл ограничение запросов. Подождите несколько минут или уменьшите количество тикеров в пакете.

Пакет устарел

uvx --upgrade yfinance-mcp — Yahoo регулярно что-то ломает

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

YFinance MCP в сравнении

Альтернатива	Когда использовать	Компромисс
Alpaca MCP	Нужны реальные данные брокера + размещение ордеров	Требует аккаунт Alpaca
Polygon / Finnhub	Нужны production-grade данные с низкой задержкой	Платные; нет MCP (пока)

Ещё

Ресурсы

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

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

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