Fundamental CopilotBR
Fundamental Copilot BR · Plataforma

Sobre o Fundamental Copilot BR

Uma plataforma experimental para análise fundamentalista automatizada de empresas brasileiras listadas na B3.

O projeto combina dados de mercado e demonstrações financeiras da CVM em uma interface de research que automatiza a coleta, normalização e apresentação de indicadores fundamentalistas. O objetivo é oferecer uma experiência próxima a uma ferramenta profissional de equity research — mais acessível, transparente e focada em dados verificáveis.

Seção 1
O que o produto faz

A plataforma reúne dados de diferentes fontes e os apresenta em uma interface unificada voltada para análise fundamentalista:

🔍
Busca de ativos da B3
Universo de ~170 ativos pesquisável por ticker, nome ou setor. Cada ativo exibe seu status de cobertura diretamente no dropdown.
📈
Cotações reais via brapi
Preço atual, variação diária e market cap quando disponíveis. Dados fornecidos por brapi.dev via rota interna do servidor.
🏛️
Dados financeiros CVM / DFP anual
Receita, EBIT, lucro líquido, CFO, capex, FCL, caixa, dívida total e dívida líquida — normalizados para BRL bilhões por ano fiscal.
📊
Indicadores fundamentalistas
CAGR de receita, margens operacionais, margem FCL, conversão CFO/lucro, dívida líquida/EBIT e múltiplos de mercado calculados automaticamente.
🔬
Diagnóstico baseado em regras
Observações objetivas sobre crescimento, margens, caixa e endividamento. Sem recomendações de compra ou venda.
🔢
Múltiplos comparáveis
P/L, EV/EBITDA e EV/Receita de empresas do mesmo setor como referência relativa de precificação.
📋
Documentos e Eventos CVM
Documentos oficiais publicados na CVM — DFP, ITR, FRE e fatos relevantes. Exibidos diretamente do sistema ENET da CVM com links para o visualizador oficial.
🔎
Transparência de fontes de dados
DataSourceNotice indica claramente quais campos vêm de CVM, quais são calculados e quais são dados ilustrativos — antes de qualquer uso em análise.
Seção 2
Fontes de dados

O app integra três origens de dados com comportamentos diferentes. Nenhuma delas é considerada completamente validada nesta versão.

brapi
Cotação e dados de mercado
Preço atual, variação percentual diária e market cap (quando disponível). Acessado via rota interna do servidor usando BRAPI_TOKEN. Sem token, o app opera normalmente com dados ilustrativos.
Variável de ambiente: BRAPI_TOKEN. Nunca exposta no cliente.
CVM Dados Abertos
DFP anual consolidada — demonstrações financeiras oficiais
Dados baixados diretamente de dados.cvm.gov.br. Inclui DRE, DFC (método indireto ou direto) e Balanço Patrimonial dos anos 2020–2024. Valores normalizados para BRL bilhões. Disponível para empresas com mapeamento verificado.
Acesso em: /api/cvm/financials/[ticker]. Capex e FCL são calculados a partir de linhas da DFC — podem divergir de relatórios de analistas.
Mock
Dados ilustrativos para demonstração e fallback
Usados nas empresas com análise completa (WEGE3, ABEV3, EGIE3, CPFE3, VIVT3). Valores plausíveis mas não auditados. Servem para demonstrar o layout e os indicadores sem depender de APIs externas.
O dashboard principal utiliza dados CVM quando disponíveis e elegíveis; caso contrário, exibe dados ilustrativos com fallback explícito.
Transparência: o DataSourceNotice exibido no dashboard detalha a origem de cada campo — Receita, EBIT, FCL, Dívida líquida e Cotação — incluindo o que é calculado versus o que vem diretamente de uma fonte primária.
Seção 3
Status de cobertura

Cada ativo no universo de busca carrega um coverageStatus que indica o que a plataforma suporta atualmente para aquele ticker. O status aparece como badge colorido no dropdown de busca e define a experiência de empty state quando um ativo sem análise completa é selecionado.

Análise completaDashboard completo com dados financeiros, indicadores, diagnóstico e métricas de mercado.
Análise CVMAnálise fundamentalista gerada automaticamente com dados CVM suficientes.
Dados CVMDados financeiros da CVM disponíveis, mas com histórico insuficiente para análise completa.
CotaçãoCotação de mercado disponível. Demonstrações financeiras da CVM ainda não integradas para este ativo.
Modelo específicoEste ativo exige metodologia específica. Bancos, seguradoras, FIIs, ETFs e BDRs utilizam métricas distintas das empresas industriais padrão.
Em breveAtivo reconhecido no universo B3, mas ainda sem cobertura de dados financeiros.
Cobertura atual aproximada: 5 ativos com Análise completa · 27 com Análise CVM · 3 com Dados CVM · ~29 com Modelo específico (bancos, FIIs, ETFs) · 98 com Cotação.
Seção 4
O que já está implementado
  • Dashboard em Next.js 15 com App Router — componentizado, tipado com TypeScript
  • Universo de busca com ~170 ativos da B3 pesquisável por ticker, nome e setor
  • Indicadores fundamentalistas calculados automaticamente (crescimento, margens, endividamento, múltiplos)
  • Diagnóstico baseado em regras — sinais objetivos sobre tendências nos dados
  • Tabela de múltiplos comparáveis setoriais
  • Integração com brapi.dev para cotações em tempo real (server-side, token protegido)
  • Endpoint CVM DFP — download, parsing e normalização de DFP anual (2020–2024)
  • Modo Dados CVM — análise fundamentalista com dados reais quando disponíveis
  • DataSourceNotice — identifica a origem de cada campo antes do uso em análise
  • Página de metodologia — explica fonte de dados, cálculos de indicadores, diagnóstico e limitações
  • Página Sobre (esta página)
  • Página de cobertura — lista todos os ativos com status e filtros
  • Documentos e Eventos CVM — integração com o sistema ENET da CVM para exibir DFP, ITR, FRE e fatos relevantes com links para o visualizador oficial
Seção 5
Limitações atuais
  • —Os dados financeiros das empresas com análise completa (WEGE3, ABEV3, EGIE3, CPFE3, VIVT3) são ilustrativos — plausíveis, mas não auditados contra demonstrações reais.
  • —Os dados CVM ainda estão em validação empresa por empresa. Capex e FCL são calculados a partir de linhas da DFC e podem divergir de relatórios de analistas externos.
  • —EBITDA usa EBIT como proxy quando D&A não está disponível como linha separada na DFP.
  • —Dívida total é capturada como 2.01.04 (curto prazo) + 2.02.01 (longo prazo). Debêntures em contas não padronizadas podem não ser capturadas.
  • —Bancos, seguradoras, FIIs, ETFs, BDRs e holdings requerem modelos setoriais específicos — DDM, NAV, Excess Return Model — que não estão implementados nesta versão.
  • —O app suporta apenas demonstrações consolidadas (não individuais) e apenas dados anuais (sem ITR trimestral).
  • —Cold start: a primeira requisição por ano fiscal baixa um zip de ~13 MB da CVM (1–3 segundos). Requisições subsequentes são servidas do cache em memória.
  • —O universo de busca tem ~170 ativos; cobertura ampla da B3 ainda está em expansão.
  • —A plataforma não fornece recomendações de investimento e não é registrada como serviço de consultoria de valores mobiliários.
Seção 6
Próximos passos

Funcionalidades planejadas, em ordem aproximada de prioridade:

  • Ampliar cobertura CVM — mapear mais tickers ao registro da CVM Dados Abertos
  • Validar normalização por setor — confirmar receita, EBIT e capex para utilities, varejo, telecom e mineração
  • Integrar ITR trimestral — dados de DRE e DFC com periodicidade trimestral
  • Melhorar modelos setoriais — implementar DDM para bancos e utilidades, NAV para FIIs
  • Adicionar histórico de preço — séries de cotação para gráficos de desempenho
  • Relatório exportável — snapshot fundamentalista em PDF com layout estruturado
  • Ampliar testes automatizados — cobertura do normalizer CVM, indicadores e diagnóstico
  • Ampliar cobertura de documentos CVM — mapear mais tickers ao ENET para exibir DFP, ITR, FRE e fatos relevantes em tempo real
Aviso Legal

Este projeto tem finalidade educacional e demonstrativa. As informações apresentadas não constituem recomendação de investimento, oferta de compra ou venda de valores mobiliários, nem substituem análise profissional independente. Investimentos em renda variável envolvem riscos e podem resultar em perdas. Consulte um profissional certificado antes de tomar decisões de investimento.