QUANT-COD-EX/analisador-acoes-indianas

Analisador de Ações Indianas (NSE/BSE)

Produz uma análise estruturada e baseada em dados de uma ou mais ações listadas na NSE/BSE usando apenas pesquisa web (não há conector de dados de mercado ao vivo disponível). A saída é um arquivo JSON que outros skills/sessões podem reutilizar, além de um resumo legível no chat.

Este é um skill independente — ele não depende nem chama os skills do plugin trader-* (que são voltados ao mercado dos EUA, orientados por conectores). É para ações indianas, orientado por pesquisa web.

Requisitos obrigatórios — sempre

1. Não é aconselhamento financeiro. Cada relatório — tanto inline quanto no campo disclaimer do JSON — deve declarar que se trata de uma análise informacional baseada em fontes públicas, não em aconselhamento de investimento, e que o usuário deve verificar com um consultor registrado na SEBI antes de agir. Nunca apresente uma recomendação como certa.
2. Pergunte o modo primeiro. Antes de pesquisar, sempre pergunte ao usuário se deseja Intraday ou Longo Prazo usando ask_user_input_v0, a menos que ele já tenha declarado de forma inequívoca em sua mensagem (ex.: "day trade", "swing hoje" → intraday; "investir por 2 anos" → longo prazo). Se ambíguo, pergunte.
3. Apenas pesquisa web para preços, notícias, esquemas, documentos. Nunca invente um preço, data ou documento. Se um número não puder ser encontrado via pesquisa, marque-o como null com uma nota, não chute.
4. Prioridade de fontes (cite o que você realmente usou em sources_used):
   • Primárias/oficiais: BSE (bseindia.com), NSE (nseindia.com), comunicados de imprensa do PIB/ministérios governamentais, SEBI, documentos do Orçamento da União
   • Pesquisas de corretoras: Groww, Zerodha Varsity/Pulse, Upstox, Angel One
   • Notícias financeiras mainstream (para "notícias atuais"): Economic Times, Moneycontrol, LiveMint, Business Standard
   • Evite conteúdo de agregadores/blogs de baixa qualidade, sem assinatura ou fonte primária.
5. Escreva o arquivo JSON em trader/stock-analysis.json no diretório de trabalho (crie a pasta trader/ se não existir) a cada execução e, em seguida, apresente um resumo legível no chat a partir dos mesmos dados. Se present_files estiver disponível, apresente também o arquivo JSON.

Fluxo de trabalho

Etapa 1 — Coletar entradas

Da mensagem do usuário, extraia:

• Ações: ticker ou nome(s) da empresa. Resolva para o símbolo NSE/BSE via pesquisa se apenas um nome de empresa for fornecido (ex.: "Reliance" → RELIANCE NSE / 500325 BSE).
• Orçamento (₹), se já declarado na mensagem. Caso contrário, será coletado na Etapa 2 — o orçamento é sempre solicitado, para uma única ação ou múltiplas, pois a acessibilidade é um dos quatro componentes da pontuação. Se o usuário se recusar a fornecer um, prossiga com o peso da acessibilidade redistribuído nos outros três componentes, como antes.

Etapa 2 — Perguntar modo e orçamento

Chame ask_user_input_v0 com até duas perguntas em uma única chamada:

• "Isso é para trading intraday (day trade) ou investimento de longo prazo?" — opções: Intraday, Longo Prazo
• "Qual é o seu orçamento?" — sempre pergunte isso, mesmo para uma única ação sem comparação, pois a acessibilidade faz parte da pontuação. Pule apenas se o usuário já tiver declarado um valor de orçamento em sua mensagem. Pule a pergunta sobre o modo apenas se as palavras do usuário já tornarem o modo inequívoco — declare o modo inferido em sua resposta se pular a pergunta. O orçamento ainda é perguntado (ou confirmado) separadamente, mesmo quando o modo é pulado.

Etapa 3 — Pesquisa (por ação, via web_search / web_fetch)

Execute pesquisas separadas por ação para cada um dos seguintes:

1. Preço atual e movimento recente — último preço negociado, variação % de hoje/recente, faixa de 52 semanas (sites de corretoras ou notícias).
2. Notícias atuais — últimas 1–4 semanas de notícias específicas da empresa.
3. Anúncios/documentos corporativos — anúncios BSE/NSE: resultados, reuniões do conselho, aprovações de capex, contratos, captações de recursos, ações de controladores. Pesquise "<empresa> anúncio BSE" / "<empresa> anúncio corporativo NSE" e busque a página BSE/NSE se acessível; recorra a sites de corretoras ou cobertura de notícias do mesmo documento se o site da bolsa bloquear a busca.
4. Esquemas governamentais futuros — elegibilidade ao esquema PLI, alocações orçamentárias, política setorial relevante para o setor da empresa (pesquise fontes do PIB/ministérios).
5. Projetos futuros da empresa — novas fábricas, expansão de capacidade, planos de capex, vitórias de pedidos, lançamentos de produtos — com prazos esperados, se declarados.
6. Visão de analistas/corretoras — preço-alvo ou perspectiva de pesquisa da Groww/Zerodha/Upstox/Angel One, se disponível.

Escale a profundidade da pesquisa de acordo com o número de ações: 1 ação → completa (6–10 pesquisas); 3+ ações → 3–5 pesquisas focadas cada, priorizando atualidade.

Horizonte de tempo da pesquisa — vinculado ao modo escolhido na Etapa 2. Sites indianos de corretoras/gráficos geralmente expõem o histórico de preços como abas: 1D, 5D, 1M, 6M, YTD, 1Y, 5Y, Max. Espelhe essa convenção ao escolher as janelas de pesquisa:

• Intraday → use apenas as janelas 1D, 5D, 1M (ex.: "<empresa> preço da ação hoje", "<empresa> preço da ação 5 dias", "<empresa> ação outubro 2026" usando o mês/ano atual real). Descarte ou pondere menos qualquer coisa com mais de ~1 mês; não é relevante para um day trade. Se os resultados de preço entrarem em conflito ou tiverem datas diferentes, prefira o mais recentemente datado e sinalize explicitamente o preço como potencialmente desatualizado, em vez de apresentá-lo como atual (a pesquisa não tem feed ao vivo).
• Longo Prazo → use as janelas restantes: 6M, YTD, 1Y, 5Y, Max (ex.: "<empresa> desempenho da ação 1 ano", "<empresa> retorno de 5 anos", "<empresa> máxima histórica", "<empresa> desempenho YTD"). Isso revela catalisadores de vários anos, volatilidade histórica e se as notícias atuais são um ponto fora da curva ou parte de uma tendência mais longa — não confie apenas em notícias da última semana para uma decisão de longo prazo.

Etapa 4 — Pontuar cada ação (0–100)

Calcule quatro sub-pontuações, cada uma de 0 a 100, e depois um total ponderado. Mostre suas pontuações componentes, não apenas o número final.

Componente	Peso	O que mede
Sentimento de notícias e momentum	30%	Tom líquido de notícias/anúncios recentes (catalisadores positivos vs. itens negativos/de risco encontrados)
Catalisadores futuros	30%	Esquemas/projetos/contratos concretos, com data ou de curto prazo, que podem mover a ação — mais forte se datados e específicos, mais fraco se especulativos
Acessibilidade (adequação ao orçamento)	20%	Apenas se o orçamento for dado: quão bem o orçamento permite uma posição significativa (ações inteiras compradas, capacidade de diversificar na lista fornecida) — se nenhum orçamento for dado, redistribua esse peso proporcionalmente nos outros três
Nível de risco	20% (invertido: menor risco → maior pontuação)	Volatilidade implícita nas oscilações recentes de preço, risco setorial/regulatório, alavancagem/sinais de dívida se visíveis nas notícias

Documente o raciocínio de cada componente brevemente (1–2 linhas) para que a pontuação não seja uma caixa preta.

Etapa 5 — Recomendação de timing

• Modo Intraday: Com base no preço/níveis mais recentes disponíveis encontrados via pesquisa (páginas de gráficos de corretoras, notícias), sugira uma zona de entrada plausível (ex.: "próximo ao suporte de hoje em torno de ₹X, confirmado em um rompimento acima de ₹Y") e uma zona de saída/stop. Advertência explícita de que os níveis intraday são sensíveis ao tempo e os dados da pesquisa podem estar desatualizados na abertura do mercado — recomende que o usuário confirme os níveis ao vivo em seu terminal de corretora antes de agir. NÃO afirme precisão em tempo real.
• Modo Longo Prazo: Dê uma estimativa de período de holding ideal por ação (ex.: "12–24 meses, vinculado ao cronograma de pagamento do esquema PLI" ou "3–5 anos para que a duplicação da capacidade orientada por capex se reflita nos lucros"), vinculada explicitamente ao cronograma do catalisador encontrado na Etapa 3 (datas de conclusão de esquemas/projetos), em vez de um padrão genérico.

Etapa 6 — Classificar e recomendar (múltiplas ações + orçamento)

Se várias ações forem fornecidas com um orçamento: classifique pela pontuação total e, em seguida, indique qual(is) ação(ões) o orçamento melhor suporta — levando em consideração o preço da ação vs. orçamento (acessibilidade de ações inteiras) e se dividir o orçamento entre as ações mais bem classificadas para diversificação supera concentrá-lo na única de maior pontuação. Explique a troca; não escolha apenas uma em silêncio.

Etapa 7 — Saída

JSON (escreva em trader/stock-analysis.json, esquema completo em references/schema.md):

• mode (intraday | long_term), budget, generated_at, disclaimer
• stocks[]: cada um com symbol, exchange, last_price, price_as_of, scores (news, catalysts, affordability, risk, total), score_notes, news_summary, catalysts (array com descrição + data esperada, se conhecida), filings (array), timing (entry/exit para intraday, ou holding_period para longo prazo), sources_used
• recommendation: lista classificada + raciocínio de alocação do orçamento (se aplicável)

Resumo no chat: Uma versão concisa e legível do mesmo — pontuação por ação + raciocínio de 1 linha, a decisão de timing/holding, a recomendação de orçamento e o aviso legal. Não despeje o JSON bruto no chat; resuma-o e mencione que o arquivo foi salvo se present_files for usado.

Consulte references/schema.md para os nomes exatos dos campos JSON e um exemplo.