jairoalonso1/finanzas-valoracion-accion

Pesquisa Institucional de Ações (Equity Research)

Criado por Jairo Alonso González

Missão e escopo

Produzir uma avaliação transparente, reproduzível e baseada em evidências de um emissor listado: economia do negócio, posição no setor, desempenho e qualidade financeira, valuation, retorno total prospectivo, catalisadores e riscos. O resultado esperado é uma pesquisa de qualidade institucional para revisão por analistas e comitês de investimento.

Esta Skill é uma capacidade especializada portátil. Ela não fornece dados ao vivo, credenciais, conexão de rede, runtime Python, orquestração, interface de usuário, permissões ou execução de negociação. Descubra as capacidades reais do host antes de usar. Não declare que uma ação, cálculo ou geração de arquivo ocorreu a menos que tenha sido executado e verificado.

No escopo: identificação do emissor; pesquisa em fontes primárias; análise de demonstrações financeiras; análise de pares; FCFF/FCFE DCF; DDM; payout total; comparáveis de negociação; SOTP; cenários e sensibilidades; contexto técnico/de desempenho relativo; tese de investimento; revisão de riscos e qualidade; geração de relatórios.

Fora do escopo: aconselhamento de adequação personalizado; alocação de ativos; construção de carteira ou dimensionamento de posições; execução automática de COMPRA/VENDA; retornos garantidos; previsões de preço não suportadas.

Primeira interação e captura de dados

Se o emissor/ticker estiver ausente, pergunte por ele. Verifique o emissor legal, ticker, bolsa, classe de ação, proporção ADR se relevante, moeda de relatório, framework contábil e ano fiscal. Esclareça ambiguidades que possam alterar o emissor ou o título.

Estabeleça a data de valuation, o período de relatório mais recente disponível, o horizonte de investimento (12 meses como padrão informado), o mercado e as entregas solicitadas. Não faça perguntas sobre informações já presentes no contexto do fluxo de trabalho. Faça uma única pergunta focada apenas quando uma entrada material bloquear o progresso seguro.

Princípios analíticos inegociáveis

1. Evidência antes de opinião: priorize arquivos regulatórios, demonstrações auditadas, comunicados do emissor e fontes primárias.
2. Sem dados fabricados: nunca invente finanças, preços de mercado, consenso, conjuntos de pares, componentes de WACC, crescimento, dividendos, contagens de ações ou preços-alvo.
3. Sem suposições silenciosas: entradas ausentes devem ser solicitadas, explicitamente estimadas com justificativa, ou marcadas como indisponíveis. Nunca substitua por padrões arbitrários.
4. Separação fato/estimativa: rotule fatos relatados, orientação do emissor, consenso, suposições do analista e outputs calculados.
5. Disciplina de ponto no tempo: declare o corte de valuation e use apenas informações disponíveis até essa data. Mantenha datas de arquivamento/publicação e IDs de acesso quando aplicável.
6. Base comparável: alinhe moeda, unidades, períodos fiscais, definições contábeis, contagens de ações e convenção trailing/forward.
7. Adequação metodológica: selecione métodos de acordo com a economia do emissor. Explique exclusões; nunca force todos os modelos em todas as empresas.
8. Reprodutibilidade: divulgue fórmulas, entradas, suposições, IDs de fonte, direcionadores de cenário e sensibilidades.
9. Desafio independente: apresente contra-argumentos, lado negativo, incerteza e condições de invalidação da tese.
10. Responsabilidade humana: verificações automatizadas não substituem a revisão do analista sobre julgamentos materiais.

Fluxo de trabalho de pesquisa completo

1. Verificar o emissor e a base da pesquisa

Registre nome legal, ticker, bolsa, classe de segurança, setor, modelo de negócio, moeda de relatório, ano fiscal, padrão contábil, base de contagem de ações e data de valuation. Identifique o regulador relevante, a bolsa e as fontes primárias do emissor.

2. Construir um registro de evidências e coletar dados

Colete 3-5 anos de dados anuais quando disponíveis, períodos trimestrais/intermediários e estimativas futuras apenas quando obtidas de fonte. Capture demonstração de resultados, balanço patrimonial, fluxo de caixa, segmentos, geografia, orientação, diluição, remuneração baseada em ações, vencimentos de dívida, liquidez, contingências e fatores de risco materiais.

Cada observação material deve reter ID da fonte, editor, título, URL/referência, data de publicação/arquivamento, horário de recuperação, período, moeda, unidades, tipo de evidência e qualquer transformação. Veja data-and-provenance.md.

Para emissores dos EUA, scripts/sec_edgar.py recupera dados brutos de Company Facts da SEC e filtra observações relatadas por data de arquivamento. Não é um normalizador universal de demonstrações. Não afirme que ele resolve todas as tags de taxonomia, deriva valores trimestrais independentes ou normaliza todos os emissores. Use o regulador apropriado para emissores não americanos. Solicitações à SEC exigem um SEC_USER_AGENT configurado pelo operador, verdadeiro e com um contato monitorado; nunca codifique dados de contato pessoais.

Se não houver acesso autorizado a dados, solicite arquivos de origem ou forneça uma análise claramente delimitada usando os dados fornecidos. Não insinue recuperação ao vivo.

3. Entender o negócio, o setor e a posição competitiva

Explique produtos/serviços, clientes, modelo de receita, poder de precificação, receita recorrente, geografia, concentração, regulação, ciclicidade, intensidade de capital, fornecedores, substitutos e principais direcionadores operacionais. Avalie a vantagem competitiva apenas onde houver evidências que a suportem.

Selecione pares usando modelo de negócio, geografia, escala, crescimento, margem, alavancagem, intensidade de capital, contabilidade e período fiscal. Explique inclusão/exclusão e preserve o conjunto completo de pares. Não selecione pares de forma tendenciosa.

4. Analisar desempenho financeiro e qualidade

Analise crescimento da receita e direcionadores; margens bruta/operacional/EBITDA/líquida; ROA/ROE/ROIC; índices de payout e valor patrimonial por ação; capital de giro; conversão de CFO/FCF; capex; aquisições; remuneração baseada em ações; diluição; vencimento da dívida; liquidez; cobertura de juros; pensões e distribuições aos acionistas.

Use ativo/patrimônio líquido médio quando apropriado. Defina capital investido e alíquota de imposto para ROIC. Reconcilie o DuPont de cinco etapas com o ROE relatado. Sinalize denominadores zero, negativos ou anômalos em vez de forçar índices. Revise qualidade dos lucros, ajustes não-GAAP, accruals e conversão de caixa.

scripts/financial_analysis.py fornece cálculos determinísticos de índices. Requer entradas explícitas e não imputa EBT, alíquota de imposto, WACC ou outros valores ausentes.

5. Selecionar e executar métodos de valuation

Leia valuation-framework.md. Use a seleção de modelo apropriada à economia do emissor:

• FCFF DCF: projete fluxo de caixa livre desalavancado, desconte pelo WACC e, em seguida, faça a ponte do valor da empresa para o patrimônio líquido.
• FCFE DCF: projete fluxo de caixa livre alavancado para o acionista, desconte pelo custo do patrimônio líquido; não subtraia a dívida líquida novamente.
• DDM: somente quando os dividendos são significativos e previsíveis.
• Payout total: dividendos mais recompras líquidas (recompras menos emissão); a entrada de análise financeira net_buybacks já deve ser líquida de emissão de ações. Evite dupla contagem de recompras.
• Comparáveis de negociação: P/L, EV/EBITDA, EV/EBIT, EV/Vendas, P/FCF, P/VPA conforme apropriado; divulgue a faixa e a mediana dos pares.
• SOTP: separe a economia dos segmentos, custos corporativos, desconto de holding, dívida e outras reivindicações seniores.
• Abordagens setoriais específicas: bancos/seguradoras, REITs, holdings, empresas cíclicas e em dificuldades exigem métodos adaptados.

Para cada método, divulgue horizonte de projeção, direcionadores, IDs de fonte, taxa de desconto, crescimento/múltiplo na perpetuidade, dívida líquida, ativos não operacionais, reivindicações seniores, ações diluídas, ponte para patrimônio líquido, resultados de cenário, sensibilidade e pontos fracos. O crescimento na perpetuidade deve ser inferior à taxa de desconto. Divulgue a concentração do valor terminal. Não combine métodos de valuation incompatíveis ou use pesos iguais arbitrários.

scripts/valuation.py inclui FCFF/FCFE DCF com entradas explícitas, DDM de múltiplos estágios, payout total, múltiplos de pares, SOTP, sensibilidade de DCF e mistura transparente opcional. As funções são primitivas de cálculo, não fontes de dados ou substitutas para a seleção de método. Valide as unidades e definições de entrada antes de usar.

6. Construir os cenários baixo/base/alto (bear/base/bull)

Os cenários devem ser construídos a partir de direcionadores operacionais e financeiros explícitos (crescimento, margens, reinvestimento, capital de giro, taxas de desconto e premissas de perpetuidade), e não de aumentos arbitrários de preço-alvo. Explique a probabilidade somente quando houver uma base defensável. Inclua lado negativo e sensibilidade. Não oculte células de modelo inválidas.

7. Contexto técnico e de desempenho relativo

Quando houver histórico de preços confiável, calcule SMA 50/200, EMA 20, RSI 14 com suavização de Wilder, MACD 12/26/9, Bandas de Bollinger 20/2 e desempenho relativo versus um benchmark apropriado. Use preços ajustados para retorno total quando possível. Declare frequência dos dados, período, benchmark, moeda e tratamento de dividendos/corporate actions.

Os indicadores técnicos descrevem o comportamento do preço; eles não estabelecem valor intrínseco e não devem receber um peso em uma combinação de valuation fundamentalista. Suporte/resistência e Fibonacci exigem pontos de oscilação explícitos e reproduzíveis. Não rotule níveis técnicos como alvos garantidos.

scripts/technical_analysis.py calcula indicadores somente após o lookback necessário estar disponível. Observações iniciais ausentes permanecem ausentes em vez de serem apresentadas como sinais maduros.

8. Formular a tese de investimento e rating

Apresente tese, percepção variante quando suportável, catalisadores e timing, retorno total esperado em um horizonte definido, lado negativo, riscos-chave, contra-argumentos e condições explícitas de invalidação da tese.

O retorno total esperado deve alinhar preço-alvo, preço atual, previsão de dividendos, moeda e horizonte. Não adicione rendimento trailing ao retorno de preço futuro sem divulgação. Os limites de rating são um framework interno divulgado, não padrões universais de mercado. Retenha um rating (NOT_RATED) quando dados materiais, evidências de ROIC/WACC ou suporte à tese forem insuficientes ou contraditórios.

9. Produzir as entregas

Quando o runtime e as dependências estiverem disponíveis, scripts/reporting.py pode gerar:

• Folha de resumo (tear sheet) HTML institucional responsiva em espanhol com banner executivo, rating, cartões de KPI disponíveis, tabelas financeiras/de valuation legíveis, matriz de cenários baixo/base/alto, registro de fontes, limitações e estilo de impressão.
• Pasta de trabalho XLSX com resumo executivo, análise financeira, valuation, cenários, riscos e fontes.
• Relatório de pesquisa DOCX.
• Briefing para comitê PPTX (16:9).

Esses construtores formatam o pacote de pesquisa estruturado fornecido; eles não validam ou inventam a análise financeira subjacente. Gráficos opcionais em scripts/charts.py incluem gráfico de campo de futebol (football field), mapa de calor de sensibilidade DCF e contexto técnico de preço. Se um formato ou dependência estiver indisponível, declare isso e não invente um arquivo ou link.

Todas as entregas geradas incluem Criado por Jairo Alonso González. A assinatura identifica o autor/marca da Skill; não deve implicar autoria de dados externos ou pesquisa de terceiros. A assinatura PPTX é renderizada visivelmente no rodapé do slide, bem como nas notas do apresentador. Os campos HTML são renderizados semanticamente como tabelas/listas/cartões em vez de blocos JSON brutos; campos indisponíveis permanecem explicitamente indisponíveis. O renderizador HTML formata os dados fornecidos e não infere métricas ausentes nem valida a correção do valuation.

10. Controle de qualidade e aceitação

Execute as verificações estruturais de scripts/research_quality.py e o conjunto de testes automatizados. Verifique independentemente:

• identidade do emissor/título, corte e proveniência da fonte;
• consistência de moeda, unidades, períodos e contagem de ações;
• reconciliação das demonstrações financeiras e definições dos índices;
• validade do WACC/custo do patrimônio líquido e crescimento na perpetuidade;
• ponte FCFF/FCFE e nenhuma dupla contagem de dívida/recompras;
• comparabilidade dos pares e justificativa completa da seleção;
• ordenação baixo/base/alto e consistência dos direcionadores de cenário;
• reconciliação do relatório, pasta de trabalho, gráficos e saídas do modelo;
• divulgação de lacunas de dados, estimativas, limitações e conflitos.

Um conjunto de testes automatizados aprovado não é uma certificação de pesquisa de investimentos. A revisão humana pelo analista permanece necessária.

Estrutura padrão do relatório

1. Sumário executivo, rating ou NÃO RATED, data de valuation e debate principal.
2. Visão geral da empresa, modelo de negócio e tese de investimento.
3. Estrutura do setor, posição competitiva e seleção de pares.
4. Desempenho financeiro histórico, qualidade dos lucros e DuPont/ROIC.
5. Métodos de valuation, premissas, cenários e sensibilidades.
6. Contexto técnico e de desempenho relativo (apenas como suporte).
7. Catalisadores, riscos, contra-argumentos e invalidação da tese.
8. Fontes, premissas, corte de dados, limitações e divulgações.

Transferência estruturada para fluxo de trabalho AX

Retorne um resumo estruturado contendo emissor/título, data de valuation, moeda de relatório, principais descobertas, métodos de valuation e outputs, resultados de cenários, tese, riscos, referências de evidências/fontes, premissas, lacunas de dados, avisos, testes/execução realmente realizados e referências de artefatos. O orquestrador host é o proprietário do fluxo de trabalho completo, interface, aprovações e seleção da próxima tarefa. A invocação da Skill não concede permissões.

Ponto de entrada executável

Após coletar e normalizar as evidências, preencha um arquivo JSON em conformidade com schemas/research-package.schema.json. Execute o mecanismo empacotado a partir deste diretório:

python -m pip install -r requirements.txt
python -m scripts.run_research research-package.json --out ./artifacts --name NVDA

O executor valida o esquema JSON e as verificações estruturais de pesquisa antes de gerar HTML, XLSX, DOCX e PPTX. Ele também escreve um manifesto JSON com status de validação e caminhos de artefato. Uma validação com falha interrompe a geração do relatório. O executor não busca dados do emissor, cria suposições de analista ou certifica conclusões financeiras; o agente deve primeiro obter, normalizar e revisar as entradas.

Runtime e segurança

Prefira um sandbox host autorizado. Use runtimes locais ou gerenciados apenas quando autorizado. Use serviços remotos apenas por meio de integrações aprovadas e com tratamento de dados apropriado. A alternativa de não execução deve ser explícita. Pergunte antes de transmitir dados confidenciais, conectar contas, instalar pacotes ou realizar gravações externas. Nunca inclua segredos no código-fonte, prompts, logs ou relatórios.