Controlando o TradingView Desktop a partir de um Agente de IA

Qualquer um que tenha tentado pesquisa de trading assistida por IA já se deparou com a mesma barreira.

O agente não tem acesso nativo aos seus gráficos. Você acaba copiando e colando símbolos, valores de indicadores, capturas de tela e Pine Script de um lado para o outro entre TradingView e Claude ou Cursor. As ferramentas que tentam resolver isso se dividem em dois grupos: roteiam dados de mercado através de uma API de terceiros (latência adicional, custo adicional, sua interpretação das suas barras), ou poluem seu gráfico do TradingView com indicadores auxiliares apenas para que um agente possa lê-los de volta.

Há um terceiro caminho que é mais óbvio em retrospecto: controlar seu local TradingView Desktop através do Chrome DevTools Protocol que o aplicativo já expõe na porta 9222 quando você o inicia com --remote-debugging-port=9222. O agente se comunica com o mesmo TradingView que você já usa, lê o que seu gráfico realmente mostra, executa Pine Script através do próprio runtime do TradingView. Os mesmos dados, os mesmos indicadores, as mesmas funcionalidades, apenas com um agente no meio.

Um projeto chamado tradesdontlie/tradingview-mcp começou por esse caminho. Então parou devido a incompatibilidades com o TV Desktop 3.1.0 e uma série de bugs, e o mantenedor ficou em silêncio sobre PRs. Eu fiz um fork, e agora, 71 commits depois, acabei de marcar 1.0.0 do fork. Este post cobre o que eu adicionei e o que a ferramenta não faz.

O que há no 1.0.0

A versão está em https://github.com/iliaal/tradingview-mcp/releases/tag/1.0.0 com o changelog por ferramenta. Os números em alto nível:

• 78 → 96 ferramentas (18 novas ferramentas MCP)
• Um tv CLI (30 comandos, 66 subcomandos) espelhando a superfície MCP
• Compatibilidade com TV Desktop 3.1.0 em toda a superfície
• 338 testes offline (detecção de padrões, múltiplos períodos, replay, roteamento CLI)
• Removido ui_evaluate da superfície upstream (ele aceitava JavaScript arbitrário na sessão autenticada do usuário no TV)

Ciclo de Vida do Pine Script

O projeto original permitia que um agente inspecionasse o Pine Script, mas apenas de forma rudimentar. Editar, salvar, alternar e histórico de versões exigiam que o usuário clicasse na interface do TradingView. O fork 1.0.0 fecha essa lacuna com oito novas ferramentas:

• pine_save_as e pine_rename para nomear e copiar scripts
• pine_version_history, pine_delete, pine_switch_script para gerenciar a biblioteca Pine
• pine_smart_compile (detecta automaticamente se deve adicionar ou atualizar um indicador no gráfico; retorna elapsed_ms)
• pine_analyze (análise estática offline; captura erros de digitação, variáveis não utilizadas, padrões obsoletos antes da compilação)
• pine_check (compilação do lado do servidor sem colocar o script em um gráfico; útil para validação estilo CI)

A combinação pine_check + pine_analyze é a chave para a depuração assistida por IA do Pine. O agente escreve um rascunho, executa pine_analyze para verificações estruturais baratas, depois pine_check para a compilação real, lê erros, corrige, repete. O usuário nunca precisa adicionar um script inacabado ao gráfico apenas para ver se compila.

Leitores de Desenho do Pine

Esta é a parte que continuo usando mais. Cinco novas ferramentas permitem que o agente leia o que um indicador Pine realmente desenhou, depois que está rodando no gráfico:

• data_get_pine_lines: níveis de preço horizontais (suporte, resistência, linhas de tendência)
• data_get_pine_labels: anotações de texto (rótulos de sinal, chamadas de divergência)
• data_get_pine_tables: células de tabela (painéis de estatísticas, scanners de múltiplos símbolos)
• data_get_pine_boxes: zonas de preço (oferta, demanda, blocos de ordens)
• data_get_pine_shapes: marcadores plotshape e plotchar

O comportamento padrão deduplica e limita a saída (50 rótulos por padrão). Substitua com verbose=true ou max_labels=N para casos em que o agente precisa do conjunto bruto.

Por que isso importa: agentes escrevendo Pine Script poderiam anteriormente verificar se o script compilava, mas não podiam verificar se a lógica estava correta. Agora o agente pode escrever um indicador, compilá-lo e ler os rótulos de volta para confirmar que as barras corretas foram marcadas. Sem isso, o trabalho assistido por IA no Pine para.

Isso também substitui o fluxo de trabalho que um agente de outra forma teria que recorrer: capturar a tela do gráfico, executar OCR sobre a imagem, esperar que o agente monte o que o indicador desenhou. Esse caminho é lento (uma captura de tela com tempo de espera mais latência de OCR em cada leitura), não confiável (rótulos sobrepostos e linhas finas confundem o OCR), e caro (imagens de gráficos no contexto do agente queimam milhares de tokens antes que qualquer raciocínio aconteça). Os leitores estruturados pulam todos os três problemas.

Navegação Multi-Painéis e Abas

Indicadores Pine raramente vivem sozinhos. Um layout de gráfico real pode ter três painéis (preço + RSI + volume) e quatro abas, uma para cada ticker. O projeto original assumiu um único contexto de gráfico. O fork adiciona onze ferramentas que tornam o layout endereçável:

• pane_list, pane_focus, pane_set_layout, pane_set_symbol, pane_set_timeframe
• pane_read_batch (chamada única que lê em todos os painéis visíveis)
• tab_list, tab_new, tab_close, tab_switch, tab_switch_by_name

pane_read_batch foi o motivador prático: agentes que precisam comparar valores de indicadores entre painéis costumavam precisar de mais de 5 chamadas. O leitor em lote reduz isso a uma chamada CDP, o que importa quando o agente está iterando rapidamente.

Um detalhe não óbvio: o foco do painel precisa de uma espera de 300ms após pane.focus() para _activeChartWidgetWV atualizar, necessário desde o TV 3.1.0. O fork incorpora isso para que os usuários não precisem descobrir.

Multi-Período e Detecção de Padrões

data_get_multi_timeframe lê valores de indicadores em uma lista de períodos (W → D → 4H → 1H → 15m) em uma única chamada. Ele salva e restaura o período original, para que o agente obtenha contexto de múltiplos períodos sem interromper a visualização do usuário.

data_detect_candlestick_patterns executa 17 padrões clássicos sobre barras OHLC brutas: doji, martelo, homem pendurado, martelo invertido, estrela cadente, marubozu, topo giratório, engolfamento de alta, engolfamento de baixa, harami de alta, harami de baixa, linha de perfuração, cobertura de nuvem escura, estrela da manhã, estrela da noite, três soldados brancos, três corvos negros. Cada correspondência retorna o nome do padrão, uma direção (altista/baixista/neutro) e uma pontuação de força.

O objetivo de fazer a detecção de padrões nativamente, em vez de via uma sobreposição de indicador Pine, é a higiene do gráfico. A detecção de padrões informa o agente; o usuário nunca quer vê-lo plotado no gráfico. Executá-lo sobre barras OHLC diretamente significa que nenhum indicador Pine é adicionado ao gráfico, nenhum script é enviado para o diálogo de Salvar do TV, e o gráfico do usuário permanece limpo.

O tv CLI

A superfície MCP é destinada a agentes de IA. Mas as mesmas operações são úteis a partir de um shell, e enviar ambas as interfaces do mesmo caminho de código (em vez de construir um programa CLI separado) mantém-nas em sincronia.

tv oferece 30 comandos com 66 subcomandos. Alguns exemplos:

tv quote get AAPL                          # cotação atual
tv data ohlcv AAPL --tf 1H --bars 20