mcp-trading-view

# TradingView MCP Server MCP (Model Context Protocol) server para acessar dados públicos do TradingView, permitindo que LLMs realizem análise técnica de ativos. ## Features - 📊 **Análise Técnica Completa**: Indicadores RSI, MACD, Stochastic, ADX, ATR e mais - 📈 **Médias Móveis**: SMA e EMA em múltiplos períodos (10, 20, 50, 100, 200) - 🎯 **Recomendações**: Buy/Sell/Neutral baseado em múltiplos indicadores - 🌍 **Multi-Exchange**: Suporte a NASDAQ, NYSE, Binance, B3, LSE e dezenas de outras - ⏱️ **Multi-Timeframe**: De 1 minuto a 1 mês - 📋 **Pivot Points**: Níveis de suporte e resistência (Classic e Fibonacci) - 🔄 **Análise em Lote**: Compare múltiplos ativos de uma vez ## Instalação ### Via pip ```bash pip install -e . ``` ### Ou instale as dependências diretamente ```bash pip install mcp tradingview-ta httpx pydantic ``` ## Configuração no Claude Desktop Adicione ao seu `claude_desktop_config.json`: ```json { "mcpServers": { "tradingview": { "command": "python", "args": ["/caminho/para/tradingview_mcp.py"] } } } ``` Ou se instalou como pacote: ```json { "mcpServers": { "tradingview": { "command": "tradingview-mcp" } } } ``` ## Tools Disponíveis ### `tradingview_get_analysis` Análise técnica completa de um ativo. ``` symbol: AAPL exchange: NASDAQ screener: america interval: 1d ``` **Retorna**: Resumo de recomendação, osciladores, médias móveis, indicadores-chave. ### `tradingview_get_indicators` Obter valores específicos de indicadores. ``` symbol: BTCUSDT exchange: BINANCE screener: crypto indicators: ["RSI", "MACD.macd", "EMA20", "close"] ``` **Indicadores disponíveis**: - **Preço**: open, high, low, close, volume, change - **Médias Móveis**: SMA10, SMA20, SMA50, SMA100, SMA200, EMA10, EMA20, EMA50, EMA100, EMA200 - **Osciladores**: RSI, Stoch.K, Stoch.D, CCI20, ADX, AO, Mom, MACD.macd, MACD.signal - **Volatilidade**: ATR, Volatility.D, Volatility.W - **Bollinger**: BB.upper, BB.lower ### `tradingview_multi_analysis` Analisar múltiplos ativos de uma vez. ``` symbols: ["AAPL", "GOOGL", "MSFT", "AMZN", "META"] exchange: NASDAQ screener: america interval: 1d ``` ### `tradingview_get_recommendation` Recomendação rápida (buy/sell/neutral). ``` symbol: PETR4 exchange: BMFBOVESPA screener: brazil ``` ### `tradingview_pivot_points` Níveis de suporte e resistência. ``` symbol: EURUSD exchange: FX_IDC screener: forex ``` ### `tradingview_list_exchanges` Lista todas as exchanges e screeners suportados com exemplos de uso. ## Exchanges Suportados | Região | Exchanges | |--------|-----------| | US | NASDAQ, NYSE, AMEX | | Crypto | BINANCE, COINBASE, KRAKEN, BYBIT | | Brasil | BMFBOVESPA, B3 | | Europa | LSE, XETR, EURONEXT, SIX | | Ásia | TSE, HKEX, NSE, BSE | | Forex | FX_IDC, FOREX, OANDA | ## Screeners (Regiões de Mercado) - `america` - EUA e Canadá - `brazil` - Brasil - `crypto` - Criptomoedas - `forex` - Forex - `germany`, `uk`, `india`, `japan`, etc. ## Timeframes (Intervalos) | Código | Intervalo | |--------|-----------| | 1m | 1 minuto | | 5m | 5 minutos | | 15m | 15 minutos | | 30m | 30 minutos | | 1h | 1 hora | | 4h | 4 horas | | 1d | 1 dia | | 1w | 1 semana | | 1M | 1 mês | ## Exemplos de Uso ### Ações Americanas ``` tradingview_get_analysis( symbol="AAPL", exchange="NASDAQ", screener="america", interval="1d" ) ``` ### Criptomoedas ``` tradingview_get_analysis( symbol="BTCUSDT", exchange="BINANCE", screener="crypto", interval="4h" ) ``` ### Ações Brasileiras ``` tradingview_get_analysis( symbol="PETR4", exchange="BMFBOVESPA", screener="brazil", interval="1d" ) ``` ### Forex ``` tradingview_get_analysis( symbol="EURUSD", exchange="FX_IDC", screener="forex", interval="1h" ) ``` ## Formato de Resposta Todas as tools suportam dois formatos de resposta: - `markdown` (padrão): Formatado para leitura humana - `json`: Dados estruturados para processamento ## Limitações - Dados são públicos e podem ter delay (não são real-time) - Rate limiting pode ocorrer com muitas requisições - Alguns símbolos podem não estar disponíveis em todas as exchanges - Dependente da disponibilidade do TradingView ## Licença MIT