O que Gestor de Portfólio faz?
Visão Geral
Analise e gerencie portfólios de investimento integrando-se ao Servidor MCP Alpaca para buscar dados de participações em tempo real, realizando análises abrangentes de alocação de ativos, diversificação, métricas de risco, avaliação de posições individuais e recomendações de rebalanceamento. Gere relatórios de portfólio detalhados com insights acionáveis.
Esta habilidade 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 atuais reais, em vez de dados inseridos manualmente.
Quando Usar
Invoque esta habilidade 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 minhas participaçõ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 Servidor MCP Alpaca
Esta habilidade requer que o Servidor MCP Alpaca esteja configurado e conectado. O servidor MCP fornece acesso a:
- Posições atuais do portfólio
- Patrimônio e poder de compra da conta
- Posições e transações históricas
- Dados de mercado para títulos detidos
Ferramentas do Servidor MCP Usadas:
get_account_info- Buscar patrimônio da conta, poder de compra, saldo de caixaget_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 Servidor MCP Alpaca não estiver conectado, informe o usuário e forneça instruções de configuração do 'references/alpaca_mcp_setup.md'.
Fluxo de Trabalho
Passo 1: Buscar Dados do Portfólio via Alpaca MCP
Use as ferramentas do Servidor MCP Alpaca para reunir informações atuais do portfólio:
1.1 Obter Informações da Conta:
Use mcp__alpaca__get_account_info para buscar:
- Patrimônio da conta (valor total do portfólio)
- Saldo de caixa
- Poder de compra
- Status da conta
1.2 Obter Posições Atuais:
Use mcp__alpaca__get_positions para buscar todas as participaçõ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 patrimoniais históricos
- Cálculo de retorno ponderado pelo tempo
- Análise de drawdown
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 da conta
- Verificar se há posições desatualizadas ou inativas
- Lidar com casos extremos (frações de ações, opções, cripto, se suportado)
Passo 2: Enriquecer Dados de Posição
Para cada posição no portfólio, reúna dados adicionais de mercado e fundamentos:
2.1 Dados Atuais de Mercado:
- 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 buscar:
- Classificação setorial e industrial
- Principais métricas de avaliação (P/L, P/VPA, rendimento de dividendos)
- Indicadores recentes de lucros e saúde financeira
- Classificações de analistas e preços-alvo
- Notícias recentes e desenvolvimentos importantes
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íveis)
Passo 3: Análise em Nível de Portfólio
Realize análise abrangente do portfólio usando estruturas de 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 múltiplas 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 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% |
| ... |
### Distribuição Setorial
[Descrição de gráfico de pizza ou tabela com porcentagens setoriais]
### Top 10 Participações
| Classificação | 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 participações e seu peso agregado
- Sinalizar se alguma posição individual excede 10-15% do portfólio
- Calcular o Índice Herfindahl-Hirschman (HHI) para medição de concentração
Concentração Setorial:
- Identificar setores dominantes
- Sinalizar se algum setor excede 30-40% do portfólio
- Comparar com a diversidade setorial de referência
Análise de Correlação:
- Estimar correlação entre posições principais
- Identificar participações altamente correlacionadas (potencial redundância)
- Avaliar o verdadeiro benefício da diversificação
Número de Posições:
- Faixa ideal: 15-30 ações para portfólios individuais
- Sinalizar se sub-diversificado (<10 ações) ou super-diversificado (>50 ações)
Saída:
## Avaliação de Diversificação
**Risco de Concentração:** [Baixo / Médio / Alto]
- As 5 principais participaçõ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 / Sub-diversificado / Super-diversificado]
- Total de posições: XX ações
- [Recomendação]
**Preocupações com Correlação:**
- [Listar quaisquer pares de posições altamente correlacionadas]
- [Sugestões de melhoria na 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 de posições individuais
- Desvio padrão do portfólio (se dados históricos disponíveis)
Risco de Baixa:
- Drawdown máximo (do histórico do portfólio)
- Drawdown atual do 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 de cisne negro
- Risco de concentração em ações individuais
- Risco de eventos específicos 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 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 ganho %)
- Posições com pior desempenho (bottom 5 por perda %)
Retornos Ponderados pelo Tempo (se histórico disponível):
- Retorno acumulado no ano
- 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 Ganhos vs Perdas
- 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 de Caixa:** $XX.XXX (XX% do portfólio)
**Melhores Performers:**
| Símbolo | Ganho | Valor da Posição |
|---------|-------|------------------|
| [TICKER] | +XX.X% | $XX.XXX |
| ... |
**Piores Performers:**
| 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%
Passo 4: Análise de Posições Individuais
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 foi quebrada?
- 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 a 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 relativa às médias móveis
- Níveis de suporte e resistência
- Status do momento
4.4 Dimensionamento da Posição:
- Peso atual no portfólio
- O tamanho é adequado 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
- COMPRAR MAIS - 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]
- Cap. Mercado: $XX.XB
- P/L: XX.X | Rendimento de Dividendos: X.X%
- Desenvolvimentos recentes: [Principais notícias ou lucros]
**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 / COMPRAR MAIS / REDUZIR / VENDER]
**Justificativa:** [Explicação de 1-2 frases]
Passo 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 de setor/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 limite do alvo)
- Ações que subiram significativamente (preocupações de 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 Caixa:
- Se excesso de caixa (>10% do portfólio), sugerir alocação
- Priorizar com base em 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 significativo de alocação (>10% do alvo)
- Prioridade Média - Desvio moderado (5-10% do alvo)
- Baixa Prioridade - 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
#### ALTA PRIORIDADE: Redução de Risco
**REDUZIR [SÍMBOLO]** de XX% para YY% do portfólio
- **Ações a Vender:** XX ações (~$XX.XXX)
- **Justificativa:** [Sobreponderado / Valuation estendido / etc]
- **Impacto Fiscal:** $X.XXX de 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 - 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]
- [Sugestão de faseamento, se aplicável]
Passo 6: Gerar Relatório do Portfólio
Crie 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 do 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 principais
---
## Visão Geral das Participações
[Tabela resumo de todas as posições]
---
## Alocação de Ativos
[Seção do Passo 3.1]
---
## Análise de Diversificação
[Seção do Passo 3.2]
---
## Avaliação de Risco
[Seção do Passo 3.3]
---
## Revisão de Desempenho
[Seção do Passo 3.4]
---
## Análise de Posições
[Análise detalhada das posições-chave do Passo 4]
---
## Recomendações de Rebalanceamento
[Recomendações do Passo 5]
---
## Próximos Passos
[Resumo das principais ações a serem tomadas]
1. [Ação principal]
2. [Ação secundária]
3. [Ação opcional]
---
*Relatório gerado por Análise de Portfólio assistida por IA em YYYY-MM-DD HH:MM*
*Dados fornecidos pelo Servidor MCP Alpaca*
Passo 7: Apresentar e Discutir
Após gerar o relatório:
**1. Apresente o Resumo Executivo:``` Forneça os pontos-chave primeiro, depois pergunte se o usuário deseja se aprofundar em alguma área específica.
2. Discuta Recomendações:
- Explique a lógica por trás de cada recomendação
- Destaque trade-offs entre risco e retorno
- Considere as preferências e restrições do usuário
- Sugira ordens de limite em vez de ordens de mercado para negociações grandes
3. Ofereça Insights Adicionais:
- Compare o portfólio com benchmarks relevantes
- Destaque oportunidades ou riscos de mercado
- Sugira educação adicional se necessário
4. Salvando o Relatório:
- O relatório foi salvo como 'portfolio_analysis_YYYY-MM-DD.md'
- Informe ao usuário onde encontrar o arquivo
Considerações Importantes
Aviso
⚠️ **Aviso:** Esta análise é apenas para fins informativos e não
constitui aconselhamento financeiro personalizado. Consulte um
assessor financeiro qualificado antes de tomar decisões de investimento.
Limitações
- A análise é baseada em dados atuais do mercado e posições da conta
- Desempenho passado não garante resultados futuros
- Oscilações do mercado podem impactar recomendações rapidamente
- Considere implicações fiscais antes de executar negociações
- A diversificação não garante lucro nem protege contra perdas
Privacidade
- Dados financeiros são processados localmente via servidor MCP
- Nenhum dado de portfólio é enviado para servidores externos
- Informações da conta permanecem dentro da sua sessão do assistente
Tratamento de Erros
Recuperação de Dados
Se o Servidor MCP Alpaca não estiver disponível:
- Tentar reconexão 2 vezes com intervalo de 5 segundos
- Se persistir falha, instruir o usuário a verificar a instalação do servidor MCP
- Fornecer configuração manual alternativa, se possível
Se as posições retornarem vazias:
- Sugerir verificar se a conta da Alpaca tem posições abertas
- Perguntar se o usuário deseja analisar uma conta diferente
- Oferecer verificação do status da conta
Se dados parciais estiverem disponíveis:
- Analisar com os dados disponíveis e marcar seções incompletas
- Sugerir buscar dados ausentes manualmente
Se dados de mercado não estiverem disponíveis para alguns símbolos:
- Pular a análise fundamental para esses símbolos
- Notificar o usuário sobre dados ausentes
- Sugerir verificação manual para posições com dados indisponíveis
Validação de Entrada
Antes de prosseguir, validar:
- A Alpaca MCP está conectada e respondendo
- As posições contêm dados válidos (quantidades, preços, valores)
- Informações da conta estão disponíveis (patrimônio, caixa)
- O símbolo é negociável e tem dados de mercado disponíveis
Nota sobre Cripto: Se a conta Alpaca suportar criptomoedas, a análise será simplificada para avaliação de risco/alocação sem análise fundamental.
Arquivos de Referência
Esta habilidade referencia estruturas e princípios destes arquivos:
references/asset-allocation.md- Estruturas de alocação de ativosreferences/diversification-principles.md- Teoria e métricas de diversificaçãoreferences/portfolio-risk-metrics.md- Métricas de risco do portfólioreferences/position-evaluation.md- Estrutura de avaliação de posiçãoreferences/rebalancing-strategies.md- Estratégias de rebalanceamento
Nota: Se você acessar um arquivo de referência e ele não existir, use seu conhecimento interno para preencher o conteúdo e notifique que você está usando conhecimento interno em vez de uma fonte externa.