Gerenciador de Portfólio
Visão Geral
Analise e gerencie portfólios de investimentos integrando-se ao Alpaca MCP Server para buscar dados de posições em tempo real e, em seguida, realizando análises abrangentes que cobrem alocação de ativos, diversificação, métricas de risco, avaliação de posição individual e recomendações de rebalanceamento. Gere relatórios de portfólio detalhados com insights acionáveis.
Esta skill utiliza a API de corretagem da Alpaca através do MCP (Model Context Protocol) para acessar dados de portfólio ao vivo, garantindo que a análise seja baseada em posições reais e atuais, em vez de dados inseridos manualmente.
Quando Usar
Invoque esta skill quando o usuário solicitar:
- "Analise meu portfólio"
- "Revise minhas posições atuais"
- "Qual é minha alocação de ativos?"
- "Verifique o risco do meu portfólio"
- "Devo rebalancear meu portfólio?"
- "Avalie meus ativos"
- "Revisão de desempenho do portfólio"
- "Quais ações devo comprar ou vender?"
- Qualquer solicitação envolvendo análise ou gerenciamento de portfólio
Pré-requisitos
Configuração do Alpaca MCP Server
Esta skill requer que o Alpaca MCP Server esteja configurado e conectado. O servidor MCP fornece acesso a:
- Posições atuais do portfólio
- Patrimônio líquido da conta e poder de compra
- Posições e transações históricas
- Dados de mercado para títulos mantidos
Ferramentas do Servidor MCP Usadas:
get_account_info- Buscar patrimônio líquido, poder de compra, saldo em dinheiroget_positions- Recuperar todas as posições atuais com quantidades, base de custo, valor de mercadoget_portfolio_history- Dados históricos de desempenho do portfólio- Ferramentas de dados de mercado para cotações de preços e fundamentos
Se o Alpaca MCP Server não estiver conectado, informe o usuário e forneça instruções de configuração de references/alpaca_mcp_setup.md.
Fluxo de Trabalho
Etapa 1: Buscar Dados do Portfólio via Alpaca MCP
Use as ferramentas do Alpaca MCP Server para coletar informações atuais do portfólio:
1.1 Obter Informações da Conta:
Use mcp__alpaca__get_account_info para buscar:
- Patrimônio líquido da conta (valor total do portfólio)
- Saldo em dinheiro
- Poder de compra
- Status da conta
1.2 Obter Posições Atuais:
Use mcp__alpaca__get_positions para buscar todos os ativos:
- Ticker do símbolo
- Quantidade mantida
- Preço médio de entrada (base de custo)
- Preço de mercado atual
- Valor de mercado atual
- P&L não realizado ($ e %)
- Tamanho da posição como % do portfólio
1.3 Obter Histórico do Portfólio (Opcional):
Use mcp__alpaca__get_portfolio_history para análise de desempenho:
- Valores históricos de patrimônio líquido
- Cálculo de retorno ponderado pelo tempo
- Análise de redução
Validação de Dados:
- Verificar se todas as posições têm símbolos de ticker válidos
- Confirmar que os valores de mercado somam aproximadamente o patrimônio líquido da conta
- Verificar se há posições obsoletas ou inativas
- Lidar com casos extremos (ações fracionárias, opções, criptomoedas, se suportado)
Etapa 2: Enriquecer Dados de Posição
Para cada posição no portfólio, colete dados adicionais de mercado e fundamentos:
2.1 Dados de Mercado Atuais:
- Cotações de preço em tempo real ou com atraso
- Volume diário e métricas de liquidez
- Faixa de 52 semanas
- Capitalização de mercado
2.2 Dados Fundamentais: Use WebSearch ou APIs de dados de mercado disponíveis para buscar:
- Classificação de setor e indústria
- Principais métricas de valuation (P/L, P/VP, rendimento de dividendos)
- Lucros recentes e indicadores de saúde financeira
- Classificações de analistas e preços-alvo
- Notícias recentes e desenvolvimentos relevantes
2.3 Análise Técnica:
- Tendência de preço (médias móveis de 20, 50 e 200 dias)
- Força relativa
- Níveis de suporte e resistência
- Indicadores de momento (RSI, MACD, se disponível)
Etapa 3: Análise do Portfólio como um Todo
Realize uma análise abrangente do portfólio usando estruturas dos arquivos de referência:
3.1 Análise de Alocação de Ativos
Leia references/asset-allocation.md para estruturas de alocação
Analise a alocação atual em várias dimensões:
Por Classe de Ativo:
- Ações vs Renda Fixa vs Dinheiro vs Alternativos
- Compare com a alocação alvo para o perfil de risco do usuário
- Avalie se a alocação corresponde aos objetivos de investimento
Por Setor:
- Tecnologia, Saúde, Financeiro, Consumo, etc.
- Identifique riscos de concentração setorial
- Compare com os pesos setoriais de referência (por exemplo, S&P 500)
Por Capitalização de Mercado:
- Distribuição Large-cap vs Mid-cap vs Small-cap
- Concentração em mega-caps
- Pontuação de diversificação por capitalização de mercado
Por Geografia:
- EUA vs Internacional vs Mercados Emergentes
- Avaliação de risco de concentração doméstica
Formato de Saída:
## Alocação de Ativos
### Alocação Atual vs Alvo
| Classe de Ativo | Atual | Alvo | Variação |
|-----------------|-------|------|----------|
| Ações EUA | XX.X% | YY.Y% | +/- Z.Z% |
| ... |
### Detalhamento Setorial
[Descrição de gráfico de pizza ou tabela com percentuais setoriais]
### Top 10 Ativos
| Class. | Símbolo | % do Portfólio | Setor |
|--------|---------|----------------|-------|
| 1 | AAPL | X.X% | Tecnologia |
| ... |
3.2 Análise de Diversificação
Leia references/diversification-principles.md para teoria de diversificação
Avalie a qualidade da diversificação do portfólio:
Concentração de Posição:
- Identifique os principais ativos e seu peso agregado
- Sinalize se alguma posição única excede 10-15% do portfólio
- Calcule o Índice Herfindahl-Hirschman (HHI) para medição de concentração
Concentração Setorial:
- Identifique setores dominantes
- Sinalize se algum setor excede 30-40% do portfólio
- Compare com a diversidade setorial de referência
Análise de Correlação:
- Estime a correlação entre as principais posições
- Identifique ativos altamente correlacionados (redundância potencial)
- Avalie o verdadeiro benefício da diversificação
Número de Posições:
- Faixa ideal: 15-30 ações para portfólios individuais
- Sinalize se subdiversificado (<10 ações) ou superdiversificado (>50 ações)
Saída:
## Avaliação de Diversificação
**Risco de Concentração:** [Baixo / Médio / Alto]
- Os 5 principais ativos representam XX% do portfólio
- Maior posição única: [SÍMBOLO] em XX%
**Diversificação Setorial:** [Excelente / Boa / Razoável / Ruim]
- Setor dominante: [Nome do Setor] em XX%
- [Avaliação do equilíbrio entre setores]
**Número de Posições:** [Ideal / Subdiversificado / Superdiversificado]
- Total de posições: XX ações
- [Recomendação]
**Preocupações com Correlação:**
- [Liste quaisquer pares de posições altamente correlacionados]
- [Sugestões de melhoria da diversificação]
3.3 Análise de Risco
Leia references/portfolio-risk-metrics.md para estruturas de medição de risco
Calcule e interprete as principais métricas de risco:
Medidas de Volatilidade:
- Beta estimado do portfólio (média ponderada dos betas das posições)
- Volatilidades individuais das posições
- Desvio padrão do portfólio (se dados históricos disponíveis)
Risco de Queda:
- Redução máxima (do histórico do portfólio)
- Redução atual do pico
- Posições com perdas não realizadas significativas
Concentração de Risco:
- Porcentagem em ações de alta volatilidade (beta > 1,5)
- Porcentagem em empresas especulativas/não lucrativas
- Uso de alavancagem (se aplicável)
Risco de Cauda:
- Exposição a potenciais eventos de cisne negro
- Risco de concentração em ação única
- Risco de evento específico do setor
Saída:
## Avaliação de Risco
**Perfil de Risco Geral:** [Conservador / Moderado / Agressivo]
**Beta do Portfólio:** X.XX (vs mercado em 1,00)
- Interpretação: O portfólio é [mais/menos] volátil que o mercado
**Redução Máxima:** -XX.X% (de $XXX.XXX para $XXX.XXX)
- Redução atual do pico: -XX.X%
**Posições de Alto Risco:**
| Símbolo | % do Portfólio | Beta | Fator de Risco |
|---------|----------------|------|----------------|
| [TICKER] | XX% | X.XX | [Alta volatilidade / Perda recente / etc] |
**Concentrações de Risco:**
- XX% em um único setor ([Setor])
- XX% em ações com beta > 1,5
- [Outros riscos de concentração]
**Pontuação de Risco:** XX/100 ([Baixo/Médio/Alto] risco)
3.4 Análise de Desempenho
Avalie o desempenho do portfólio usando dados disponíveis:
Retornos Absolutos:
- P&L não realizado geral do portfólio ($ e %)
- Posições com melhor desempenho (top 5 por % de ganho)
- Posições com pior desempenho (bottom 5 por % de perda)
Retornos Ponderados pelo Tempo (se histórico disponível):
- Retorno YTD
- Retornos anualizados de 1 ano, 3 anos, 5 anos
- Compare com referência (S&P 500, índice relevante)
Desempenho em Nível de Posição:
- Razão de Vencedores vs Perdedores
- Ganho médio em posições vencedoras
- Perda média em posições perdedoras
- Posições próximas das máximas/mínimas de 52 semanas
Saída:
## Revisão de Desempenho
**Valor Total do Portfólio:** $XXX.XXX
**P&L Não Realizado Total:** $XX.XXX (+XX.X%)
**Saldo em Dinheiro:** $XX.XXX (XX% do portfólio)
**Melhores Performances:**
| Símbolo | Ganho | Valor da Posição |
|---------|-------|------------------|
| [TICKER] | +XX.X% | $XX.XXX |
| ... |
**Piores Performances:**
| Símbolo | Perda | Valor da Posição |
|---------|-------|------------------|
| [TICKER] | -XX.X% | $XX.XXX |
| ... |
**Desempenho vs Referência (se disponível):**
- Retorno do portfólio: +X.X%
- Retorno do S&P 500: +Y.Y%
- Alfa: +/- Z.Z%
Etapa 4: Análise de Posição Individual
Para posições-chave (top 10-15 por peso no portfólio), realize análise detalhada:
Leia references/position-evaluation.md para estrutura de análise de posição
Para cada posição significativa:
4.1 Validação da Tese Atual:
- Por que esta posição foi iniciada? (se conhecido do contexto do usuário)
- A tese de investimento se concretizou ou se quebrou?
- Desenvolvimentos recentes da empresa e notícias
4.2 Avaliação de Valuation:
- Métricas de valuation atuais (P/L, P/VP, etc.)
- Compare com a faixa histórica de valuation
- Compare com pares do setor
- Avaliação de Supervalorizado / Justo / Subvalorizado
4.3 Saúde Técnica:
- Tendência de preço (alta, baixa, lateral)
- Posição relativa às médias móveis
- Níveis de suporte e resistência
- Status de momento
4.4 Dimensionamento da Posição:
- Peso atual no portfólio
- O tamanho é apropriado dada a convicção e o risco?
- Sobreponderado ou subponderado vs ideal
4.5 Recomendação de Ação:
- MANTER - Posição bem dimensionada e tese intacta
- ADICIONAR - Subponderado dada a oportunidade, tese se fortalecendo
- REDUZIR - Sobreponderado ou valuation esticado
- VENDER - Tese quebrada, melhores oportunidades em outro lugar
Saída por posição:
### [SÍMBOLO] - [Nome da Empresa] (XX.X% do portfólio)
**Detalhes da Posição:**
- Ações: XXX
- Custo Médio: $XX.XX
- Preço Atual: $XX.XX
- Valor de Mercado: $XX.XXX
- P/L Não Realizado: $X.XXX (+XX.X%)
**Resumo Fundamental:**
- Setor: [Setor]
- Capitalização de Mercado: $XX.XB
- P/L: XX.X | Rendimento de Dividendos: X.X%
- Desenvolvimentos recentes: [Notícias ou lucros importantes]
**Status Técnico:**
- Tendência: [Alta / Baixa / Lateral]
- Preço vs MM 50 dias: [Acima/Abaixo em XX%]
- Suporte: $XX.XX | Resistência: $XX.XX
**Avaliação da Posição:**
- **Status da Tese:** [Intacta / Enfraquecendo / Quebrada / Fortalecendo]
- **Valuation:** [Subvalorizado / Justo / Supervalorizado]
- **Dimensionamento:** [Ideal / Sobreponderado / Subponderado]
**Recomendação:** [MANTER / ADICIONAR / REDUZIR / VENDER]
**Justificativa:** [Explicação de 1-2 frases]
Etapa 5: Recomendações de Rebalanceamento
Leia references/rebalancing-strategies.md para abordagens de rebalanceamento
Gere recomendações específicas de rebalanceamento:
5.1 Identificar Gatilhos de Rebalanceamento:
- Posições que se desviaram significativamente dos pesos-alvo
- Alocações setoriais/classe de ativos que precisam de ajuste
- Posições sobreponderadas para reduzir (excederam o limite)
- Áreas subponderadas para adicionar (abaixo do limite)
- Considerações fiscais (implicações de ganhos de capital)
5.2 Desenvolver Plano de Rebalanceamento:
Posições para REDUZIR:
- Posições sobreponderadas (>desvio do limite do alvo)
- Ações que subiram significativamente (preocupações com valuation)
- Posições concentradas excedendo 15-20% do portfólio
- Posições com tese quebrada
Posições para ADICIONAR:
- Setores ou classes de ativos subponderados
- Posições de alta convicção atualmente subponderadas
- Novas oportunidades para melhorar a diversificação
Alocação de Dinheiro:
- Se excesso de dinheiro (>10% do portfólio), sugira alocação
- Priorize com base na oportunidade e lacunas de alocação
5.3 Priorização: Classifique as ações de rebalanceamento por prioridade:
- Imediata - Redução de risco (reduzir posições concentradas)
- Alta Prioridade - Desvio de alocação significativo (>10% do alvo)
- Prioridade Média - Desvio moderado (5-10% do alvo)
- Baixa Prioridade - Ajustes finos e oportunidades oportunistas
Saída:
## Recomendações de Rebalanceamento
### Resumo
- **Rebalanceamento Necessário:** [Sim / Não / Opcional]
- **Motivo Principal:** [Risco de concentração / Desvio setorial / Alocação de dinheiro / etc]
- **Negociações Estimadas:** X ordens de venda, Y ordens de compra
### Ações Recomendadas
#### ALTA PRIORIDADE: Redução de Risco
**REDUZIR [SÍMBOLO]** de XX% para YY% do portfólio
- **Ações para Vender:** XX ações (~$XX.XXX)
- **Justificativa:** [Sobreponderado / Valuation estendido / etc]
- **Impacto Fiscal:** $X.XXX ganho de capital (estimado)
#### PRIORIDADE MÉDIA: Alocação de Ativos
**ADICIONAR** exposição a [Setor/Classe de Ativos]
- **Alvo:** Aumentar de XX% para YY%
- **Ações Sugeridas:** [SÍMBOLO1, SÍMBOLO2, SÍMBOLO3]
- **Valor para Investir:** ~$XX.XXX
#### ALOCAÇÃO DE DINHEIRO
**Dinheiro Atual:** $XX.XXX (XX% do portfólio)
- **Recomendação:** [Alocar / Manter para oportunidades / Reduzir para X%]
- **Alocação Sugerida:** [Distribuição entre setores/ações]
### Plano de Implementação
1. [Primeira ação - maior prioridade]
2. [Segunda ação]
3. [Terceira ação]
...
**Considerações de Timing:**
- [Planejamento de final de ano fiscal / Temporada de lucros / Condições de mercado]
- [Fasagem sugerida, se aplicável]
Etapa 6: Gerar Relatório de Portfólio
Crie relatório markdown abrangente salvo na raiz do repositório:
Nome do Arquivo: portfolio_analysis_YYYY-MM-DD.md
Estrutura do Relatório:
# Relatório de Análise de Portfólio
**Conta:** [Tipo de conta se disponível]
**Data do Relatório:** YYYY-MM-DD
**Valor do Portfólio:** $XXX.XXX
**P&L Total:** $XX.XXX (+XX.X%)
---
## Resumo Executivo
[3-5 marcadores resumindo as principais descobertas]
- Avaliação geral da saúde do portfólio
- Principais pontos fortes
- Principais riscos ou preocupações
- Recomendações primárias
---
## Visão Geral dos Ativos
[Tabela resumo de todas as posições]
---
## Alocação de Ativos
[Seção da Etapa 3.1]
---
## Análise de Diversificação
[Seção da Etapa 3.2]
---
## Avaliação de Risco
[Seção da Etapa 3.3]
---
## Revisão de Desempenho
[Seção truncada]