O que Portfolio Manager faz?
Visão Geral
Analise e gerencie carteiras de investimentos integrando-se ao Alpaca MCP Server para obter dados em tempo real de posições e, em seguida, realizar uma análise abrangente que cobre alocação de ativos, diversificação, métricas de risco, avaliação de posições individuais e recomendações de rebalanceamento. Gere relatórios detalhados de portfólio com insights acionáveis.
Este skill aproveita a API de corretagem da Alpaca por meio do MCP (Model Context Protocol) para acessar dados de portfólio ao vivo, garantindo que a análise seja baseada em posições reais atuais, em vez de dados inseridos manualmente.
Quando Usar
Invoque este skill quando o usuário solicitar:
- "Analise meu portfólio"
- "Revise minhas posições atuais"
- "Qual é a minha alocação de ativos?"
- "Verifique o risco do meu portfólio"
- "Devo rebalancear meu portfólio?"
- "Avalie minhas posições"
- "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
Este skill requer que o Alpaca MCP Server esteja configurado e conectado. O servidor MCP fornece acesso a:
- Posições atuais da carteira
- Patrimônio da conta e poder de compra
- Posições e transações históricas
- Dados de mercado para títulos mantidos
Ferramentas do Servidor MCP Utilizadas:
get_account_info- Obter patrimônio da conta, 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 do arquivo references/alpaca_mcp_setup.md.
Fluxo de Trabalho
Etapa 1: Obter Dados do Portfólio via Alpaca MCP
Use as ferramentas do Alpaca MCP Server para reunir informações atuais do portfólio:
1.1 Obter Informações da Conta:
Use mcp__alpaca__get_account_info para obter:
- Patrimônio 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 obter todas as posições:
- 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
- Cálculo de retorno ponderado pelo tempo
- Análise de drawdown
Validação de Dados:
- Verificar se todas as posições têm tickers válidos
- Confirmar que os valores de mercado somam aproximadamente o patrimônio da conta
- Verificar posições obsoletas ou inativas
- Lidar com casos de borda (ações fracionárias, opções, cripto, se suportado)
Etapa 2: Enriqueça os Dados das Posições
Para cada posição na carteira, reúna dados de mercado adicionais e fundamentos:
2.1 Dados de Mercado Atuais:
- Cotações de preço em tempo real ou atrasadas
- 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 obter:
- Classificação de setor e indústria
- Principais métricas de valuation (P/L, P/VPA, rendimento de dividendos)
- Indicadores de saúde financeira e resultados recentes
- 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, 200 dias)
- Força relativa
- Níveis de suporte e resistência
- Indicadores de momento (RSI, MACD, se disponíveis)
Etapa 3: Análise em Nível de Portfólio
Realize uma análise abrangente do portfólio usando frameworks dos arquivos de referência:
3.1 Análise de Alocação de Ativos
Leia references/asset-allocation.md para frameworks de alocação
Analise a alocação atual em várias dimensões:
Por Classe de Ativo:
- Ações vs Renda Fixa vs Caixa vs Alternativos
- Comparar com a alocação alvo para o perfil de risco do usuário
- Avaliar se a alocação corresponde aos objetivos de investimento
Por Setor:
- Tecnologia, Saúde, Financeiro, Consumo, etc.
- Identificar riscos de concentração setorial
- Comparar com pesos setoriais de referência (ex.: S&P 500)
Por Capitalização de Mercado:
- Distribuição entre Large-cap, Mid-cap e Small-cap
- Concentração em megacaps
- 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% |
| ... |
### Distribuição Setorial
[Descrição de gráfico de pizza ou tabela com porcentagens setoriais]
### Top 10 Posições
| Ranking | 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ções:
- Identificar as principais posições e seu peso agregado
- Sinalizar se alguma posição individual exceder 10-15% do portfólio
- Calcular o Índice Herfindahl-Hirschman (HHI) para medir a concentração
Concentração Setorial:
- Identificar setores dominantes
- Sinalizar se algum setor exceder 30-40% do portfólio
- Comparar com a diversidade setorial de referência
Análise de Correlação:
- Estimar a correlação entre as principais posições
- Identificar posições altamente correlacionadas (potencial redundância)
- Avaliar o benefício real da diversificação
Número de Posições:
- Faixa ideal: 15-30 ações para portfólios individuais
- Sinalizar 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]
- As 5 principais posições representam XX% do portfólio
- Maior posição individual: [SÍMBOLO] com XX%
**Diversificação Setorial:** [Excelente / Boa / Razoável / Ruim]
- Setor dominante: [Nome do Setor] com 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:**
- [Listar pares de posições altamente correlacionadas]
- [Sugestões de melhoria da diversificação]
3.3 Análise de Risco
Leia references/portfolio-risk-metrics.md para frameworks de medição de risco
Calcular e interpretar 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 estiverem disponíveis)
Risco de Baixa:
- Drawdown máximo (a partir do histórico do portfólio)
- Drawdown atual em relação ao pico
- Posições com perdas não realizadas significativas
Concentração de Risco:
- Percentual em ações de alta volatilidade (beta > 1,5)
- Percentual em empresas especulativas/não lucrativas
- Uso de alavancagem (se aplicável)
Risco de Cauda:
- Exposição a potenciais eventos cisne negro
- Risco de concentração em uma única ação
- 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
**Drawdown Máximo:** -XX.X% (de $XXX,XXX para $XXX,XXX)
- Drawdown atual em relação ao 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 ([Risco Baixo/Médio/Alto])
3.4 Análise de Desempenho
Avalie o desempenho do portfólio usando os 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 (últimas 5 por % de perda)
Retornos Ponderados pelo Tempo (se histórico estiver disponível):
- Retorno no ano até a data (YTD)
- Retornos anualizados de 1 ano, 3 anos, 5 anos
- Comparar com referência (S&P 500, índice relevante)
Desempenho em Nível de Posição:
- Proporção de vencedores vs perdedores
- Ganho médio em posições vencedoras
- Perda média em posições perdedoras
- Posições próximas às 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ções Individuais
Para posições-chave (top 10-15 por peso no portfólio), realize uma análise detalhada:
Leia references/position-evaluation.md para framework de análise de posições
Para cada posição significativa:
4.1 Validação da Tese Atual:
- Por que esta posição foi iniciada? (se conhecida do contexto do usuário)
- A tese de investimento se concretizou ou quebrou?
- Desenvolvimentos e notícias recentes da empresa
4.2 Avaliação de Valuation:
- Métricas de valuation atuais (P/L, P/VPA, etc.)
- Comparar com faixa histórica de valuation
- Comparar 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 em relação à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?
- Sobrepeso ou subpeso em relação ao ideal
4.5 Recomendação de Ação:
- MANTER - A posição está bem dimensionada e a tese intacta
- ADICIONAR - Subponderado dada a oportunidade, tese se fortalecendo
- REDUZIR - Sobrepeso ou valuation esticado
- VENDER - Tese quebrada, melhores oportunidades em outros lugares
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 resultados 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 da Posição:** [Ideal / Sobrepeso / Subpeso]
**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
Gerar 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 com sobrepeso para reduzir (excederam o limite)
- Áreas com subpeso 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 com sobrepeso (> desvio limite do alvo)
- Ações que subiram significativamente (preocupações com valuation)
- Posições concentradas que excedem 15-20% do portfólio
- Posições com tese quebrada
Posições para ADICIONAR:
- Setores ou classes de ativos com subpeso
- Posições de alta convicção atualmente com subpeso
- Novas oportunidades para melhorar a diversificação
Alocação de Caixa:
- Se houver excesso de caixa (>10% do portfólio), sugerir alocação
- Priorizar com base na oportunidade e lacunas de alocação
5.3 Priorização: Classificar as ações de rebalanceamento por prioridade:
- Imediato - Redução de risco (reduzir posições concentradas)
- Prioridade Alta - Desvio de alocação importante (>10% do alvo)
- Prioridade Média - Desvio moderado (5-10% do alvo)
- Prioridade Baixa - Ajustes finos e ajustes 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 caixa / etc]
- **Negociações Estimadas:** X ordens de venda, Y ordens de compra
### Ações Recomendadas
#### PRIORIDADE ALTA: Redução de Risco
**REDUZIR [SÍMBOLO]** de XX% para YY% do portfólio
- **Ações a Vender:** XX ações (~$XX,XXX)
- **Justificativa:** [Sobrepeso / Valuation estendido / etc]
- **Impacto Fiscal:** $X,XXX ganho de capital (est.)
#### PRIORIDADE MÉDIA: Alocação de Ativos
**ADICIONAR** exposição a [Setor/Classe de Ativo]
- **Alvo:** Aumentar de XX% para YY%
- **Ações Sugeridas:** [SÍMBOLO1, SÍMBOLO2, SÍMBOLO3]
- **Valor a Investir:** ~$XX,XXX
#### ALOCAÇÃO DE CAIXA
**Caixa 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 - prioridade mais alta]
2. [Segunda ação]
3. [Terceira ação]
...
**Considerações de Timing:**
- [Planejamento de fim de ano fiscal / Temporada de resultados / Condições de mercado]
- [Fasagem sugerida, se aplicável]
Etapa 6: Gerar Relatório de Portfólio
Criar relatório abrangente em Markdown 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 conclusões]
- Avaliação geral da saúde do portfólio
- Principais pontos fortes
- Principais riscos ou preocupações
- Recomendações primárias
---
## Visão Geral das Posições
[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 da Etapa 3.4]
---
## Análise de Posições Individuais
[Seção da Etapa 4]
---
## Recomendações de Rebalanceamento
[Seção da Etapa 5]
---
## Avisos
**Aviso Legal:** Esta análise é gerada automaticamente e não constitui aconselhamento financeiro profissional. Consulte um consultor financeiro qualificado antes de tomar decisões de investimento. O desempenho passado não garante resultados futuros. Todos os investimentos envolvem riscos, incluindo a perda potencial do principal.
**Aviso de Dados:** A análise é baseada em dados fornecidos pelas APIs da Alpaca. Pode haver atrasos nos dados ou imprecisões. Sempre verifique as informações importantes de forma independente.