Yahoo Finance

Fornece dados financeiros abrangentes do Yahoo Finance, incluindo preços históricos, informações da empresa, demonstrações financeiras e notícias do mercado.

GitHubExperimente este MCPPatrocinado

Documentação

Yahoo Finance MCP Server

English | 中文

Este é um servidor Model Context Protocol (MCP) que fornece dados financeiros abrangentes do Yahoo Finance. Ele permite recuperar informações detalhadas sobre ações, incluindo preços históricos, informações da empresa, demonstrações financeiras, dados de opções e notícias de mercado.

Demonstração

MCP Demo

Ferramentas MCP

O servidor expõe as seguintes ferramentas por meio do Model Context Protocol:

Informações de Ações

Ferramenta	Descrição
`get_historical_stock_prices`	Obtenha dados históricos OHLCV para uma ação com período e intervalo personalizáveis
`get_stock_info`	Obtenha dados abrangentes da ação, incluindo preço, métricas e detalhes da empresa
`get_yahoo_finance_news`	Obtenha os artigos de notícias mais recentes para uma ação
`get_stock_actions`	Obtenha o histórico de dividendos e desdobramentos de ações

Demonstrações Financeiras

Ferramenta	Descrição
`get_financial_statement`	Obtenha demonstração de resultados, balanço patrimonial ou demonstração de fluxo de caixa (anual/trimestral)
`get_holder_info`	Obtenha principais acionistas, acionistas institucionais, fundos mútuos ou transações de insiders

Dados de Opções

Ferramenta	Descrição
`get_option_expiration_dates`	Obtenha as datas de vencimento de opções disponíveis
`get_option_chain`	Obtenha a cadeia de opções para uma data de vencimento e tipo específicos (calls/puts)

Informações de Analistas

Ferramenta	Descrição
`get_recommendations`	Obtenha recomendações de analistas ou histórico de atualizações/rebaixamentos

Casos de Uso Reais

Com este servidor MCP, você pode usar o Claude para:

Análise de Ações

Análise de Preço: "Mostre-me os preços históricos das ações da AAPL nos últimos 6 meses com intervalos diários."
Saúde Financeira: "Obtenha o balanço patrimonial trimestral da Microsoft."
Métricas de Desempenho: "Quais são as principais métricas financeiras da Tesla a partir das informações da ação?"
Análise de Tendências: "Compare as demonstrações de resultados trimestrais da Amazon e do Google."
Análise de Fluxo de Caixa: "Mostre-me a demonstração anual de fluxo de caixa da NVIDIA."

Pesquisa de Mercado

Análise de Notícias: "Obtenha os artigos de notícias mais recentes sobre a Meta Platforms."
Atividade Institucional: "Mostre-me os acionistas institucionais da Apple."
Negociações de Insiders: "Quais são as transações recentes de insiders da Tesla?"
Análise de Opções: "Obtenha a cadeia de opções para SPY com data de vencimento 2024-06-21 para calls."
Cobertura de Analistas: "Quais são as recomendações dos analistas para a Amazon nos últimos 3 meses?"

Pesquisa de Investimentos

"Crie uma análise abrangente da saúde financeira da Microsoft usando suas demonstrações financeiras trimestrais mais recentes."
"Compare o histórico de dividendos e desdobramentos de ações da Coca-Cola e da PepsiCo."
"Analise as mudanças na propriedade institucional da Tesla no último ano."
"Gere um relatório sobre a atividade do mercado de opções para a ação da Apple com vencimento em 30 dias."
"Resuma as atualizações e rebaixamentos mais recentes dos analistas no setor de tecnologia nos últimos 6 meses."

Requisitos

Python 3.11 ou superior
Dependências conforme listado em pyproject.toml, incluindo:
- mcp
- yfinance
- pandas
- pydantic
- e outros pacotes para processamento de dados

Configuração

Clone este repositório:

git clone https://github.com/Alex2Yang97/yahoo-finance-mcp.git
cd yahoo-finance-mcp

Crie e ative um ambiente virtual e instale as dependências:

uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -e .

Uso

Modo de Desenvolvimento

Você pode testar o servidor com o MCP Inspector executando:

uv run server.py

Isso iniciará o servidor e permitirá que você teste as ferramentas disponíveis.

Integração com Claude for Desktop

Para integrar este servidor com o Claude for Desktop:

Instale o Claude for Desktop na sua máquina local.
Instale o VS Code na sua máquina local. Em seguida, execute o seguinte comando para abrir o arquivo claude_desktop_config.json:
- MacOS: code ~/Library/Application\ Support/Claude/claude_desktop_config.json
- Windows: code $env:AppData\Claude\claude_desktop_config.json

Edite o arquivo de configuração do Claude for Desktop, localizado em:

macOS:

{
  "mcpServers": {
    "yfinance": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/yahoo-finance-mcp",
        "run",
        "server.py"
      ]
    }
  }
}

Windows:

{
  "mcpServers": {
    "yfinance": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\yahoo-finance-mcp",
        "run",
        "server.py"
      ]
    }
  }
}

Nota: Talvez seja necessário colocar o caminho completo para o executável uv no campo de comando. Você pode obtê-lo executando which uv no MacOS/Linux ou where uv no Windows.

Reinicie o Claude for Desktop

Licença

MIT