YFinance MCP — Installer & Démo en direct

Pourquoi l'utiliser

Fonctionnalités clés

Pas de clé API, pas d'inscription
Cours, historique OHLC, fondamentaux, bilans
Chaînes d'options, dates de résultats, dividendes
Titres d'actualités par ticker
Implémentation Python rapide via uvx

Démo en direct

Aperçu en pratique

yfinance-mcp.replay ▶ prêt

0/0

Installer

Choisissez votre client

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

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

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

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

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

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit

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

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

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

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json

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

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

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

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : YFinance MCP

Snapshot rapide de votre watchlist — cours, P/E, actualités

👤 Investisseurs faisant leurs vérifications quotidiennes ⏱ ~5 min beginner

Quand l'utiliser : Vous voulez un briefing en un seul prompt sur 10 tickers avant l'ouverture du marché.

Déroulement

Cours

Utilise yfinance-mcp. Pour AAPL, MSFT, NVDA, TSLA, GOOGL, AMZN, META, BRK-B, JPM, V — cours actuel, variation 1j %, plage 52 semaines.✓ Copié

→ Tableau propre avec les 10 lignes
Fondamentaux

Pour la même liste, P/E, P/E forward, BPA et rendement du dividende.✓ Copié

→ Fondamentaux alignés avec le tableau précédent
Actualités

Pour les 3 plus grandes variations d'aujourd'hui, récupère les 3 derniers titres d'actualité chacun. Résume l'ambiance.✓ Copié

→ Actualités groupées par ticker avec ambiance en une ligne

Résultat : Un briefing matinal en 10 lignes adapté à votre watchlist.

Pièges

Limitation de débit si vous envoyez trop de tickers à la fois — Découpez en lots de 10 par appel, attendez 1s entre

Combiner avec : memory

Backtester une idée de stratégie simple sur des prix historiques

👤 Traders particuliers en prototypage ⏱ ~20 min intermediate

Quand l'utiliser : Vous avez une idée du type « acheter SPY quand le RSI < 30, vendre à > 70 » et voulez une vérification historique rapide.

Déroulement

Récupérer l'historique

Récupère 5 ans de données OHLC journalières pour SPY.✓ Copié

→ Série temporelle retournée sous forme de tableau
Calculer

Calcule le RSI(14). Lance la stratégie « achat<30, vente>70 ». Rapporte le CAGR, le drawdown maximum, le nombre de trades vs buy-and-hold.✓ Copié

→ Métriques de stratégie avec comparaison honnête à la référence
Test de réalité

Tiens compte des commissions (1$/trade) et du slippage (5 pb). Le edge survit-il ?✓ Copié

→ Chiffres nets de coûts

Résultat : Une décision go/no-go sur l'approfondissement du test de l'idée.

Pièges

Biais de survivance — seuls les tickers liquides sont dans yfinance — Pour un backtesting sérieux, utilisez un dataset dédié ; yfinance est pour l'esquisse

Combiner avec : alpaca

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

yfinance-mcp + alpaca

yfinance pour la recherche, Alpaca pour les vrais ordres

Sélectionne 3 idées via yfinance, place des paper trades via Alpaca.✓ Copié

yfinance-mcp + memory

Suivre votre thèse sur des tickers dans le temps

Stocke la thèse sur NVDA à la date d'aujourd'hui, avec le cours.✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler	Coût
get_quote	ticker: str	Snapshot du cours actuel	free
get_history	ticker, period: str, interval: str	Données historiques pour graphique ou backtest	free
get_fundamentals	ticker	Analyse de valorisation et fondamentaux	free
get_options	ticker, expiry?: date	Consultation de la chaîne d'options	free
get_news	ticker, limit?: int	Titres d'actualités par ticker	free

Coût et limites

Coût d'exécution

Quota d'API: Limites non documentées de Yahoo — évitez de les solliciter excessivement
Tokens par appel: OHLC sur 5 ans ≈ 50k tokens, gardez les requêtes ciblées
Monétaire: Gratuit
Astuce: Rééchantillonnez en hebdomadaire pour les longues périodes ; tirez le journalier uniquement quand nécessaire

Sécurité

Permissions, secrets, portée

Stockage des identifiants : Aucun

Sortie de données : query1.finance.yahoo.com

Yahoo a déjà cassé yfinance avec des changements HTML — maintenez le paquet à jour

Dépannage

Erreurs courantes et correctifs

Retourne vide ou erreur pour un ticker

Utilisez le format de symbole Yahoo (ex. BRK-B et non BRK.B) ; certaines bourses nécessitent un suffixe (.T pour Tokyo)

JSONDecodeError

Yahoo vous a limité en débit. Attendez quelques minutes, ou traitez moins de tickers par lot.

Paquet obsolète

uvx --upgrade yfinance-mcp — Yahoo casse les choses régulièrement

Alternatives

YFinance MCP vs autres

Alternative	Quand l'utiliser	Compromis
Alpaca MCP	Vous voulez des données de courtier réelles + passage d'ordres	Nécessite un compte Alpaca
Polygon / Finnhub	Vous avez besoin de données de qualité production, faible latence	Payant ; pas de MCP (encore)

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills