O que Gerenciador de Portfólio faz?
Visão Geral
Analise e gerencie portfólios de investimento integrando-se ao Alpaca MCP Server para buscar dados de posições em tempo real, realizando 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.
Esta skill aproveita 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 skill quando o usuário solicitar:
- "Analisar meu portfólio"
- "Revisar minhas posições atuais"
- "Qual é minha alocação de ativos?"
- "Verificar o risco do meu portfólio"
- "Devo rebalancear meu portfólio?"
- "Avaliar meus ativos"
- "Revisão de desempenho do portfólio"
- "Quais ações devo comprar ou vender?"
- Qualquer solicitação envolvendo análise ou gerenciamento em nível 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 e poder de compra da conta
- Posições e transações históricas
- Dados de mercado para títulos mantidos
Ferramentas do MCP Server Usadas:
get_account_info- Buscar patrimônio líquido, 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 Alpaca MCP Server não estiver conectado, informe o usuário e forneça instruções de configuração a partir de references/alpaca_mcp_setup.md.
Fluxo de Trabalho
Passo 1: Buscar Dados do Portfólio via Alpaca MCP ou Fallback REST
Use as ferramentas do Alpaca MCP Server para reunir informações atuais do portfólio quando disponíveis. Em jobs Hermes agendados, as ferramentas MCP podem não estar expostas mesmo quando as credenciais Alpaca estão presentes; nesse caso, use a API REST da Alpaca diretamente com ALPACA_API_KEY, ALPACA_SECRET_KEY e ALPACA_PAPER.
1.1 Obter Informações da Conta:
Preferido: usar mcp__alpaca__get_account_info para buscar:
- Patrimônio líquido da conta (valor total do portfólio)
- Saldo de caixa
- Poder de compra
- Status da conta
Endpoints REST de fallback:
- paper: https://paper-api.alpaca.markets/v2/account
- live: https://api.alpaca.markets/v2/account
Cabeçalhos:
- APCA-API-KEY-ID=$ALPACA_API_KEY
- APCA-API-SECRET-KEY=$ALPACA_SECRET_KEY
1.2 Obter Posições Atuais:
Preferido: usar 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
Endpoints REST de fallback:
- paper: https://paper-api.alpaca.markets/v2/positions
- live: https://api.alpaca.markets/v2/positions
1.3 Obter Histórico do Portfólio (Opcional):
Preferido: usar mcp__alpaca__get_portfolio_history para análise de desempenho:
- Valores históricos do patrimônio líquido
- Cálculo de retorno ponderado pelo tempo
- Análise de drawdown
Endpoint REST de fallback:
- /v2/account/portfolio/history
Disciplina de fallback para jobs agendados:
- Rotule claramente a fonte como
Alpaca REST fallbackem vez de MCP. - Use
ALPACA_PAPER=truepara escolher o endpoint de papel; caso contrário, use o endpoint real. - Ainda valide se o valor de mercado longo mais caixa se reconcilia aproximadamente com o patrimônio líquido, e destaque margem/alavancagem se
long_market_value > equity. - Para jobs cron de portfólio principal semanais, calcule a exposição usando o patrimônio líquido como denominador, bem como o valor de mercado bruto:
gross_long_exposure = long_market_value / equity,cash_pct = cash / equity, e sinalize explicitamente portfólios financiados por margem quando a exposição bruta estiver materialmente acima de 100% ou o caixa for negativo. Não deixe os pesos do setor parecerem benignos usando apenas o denominador bruto longo quando a conta estiver alavancada. - Quando a solicitação enfatizar participações de dividendos ou gatilhos de revisão forçada, construa uma entrada de monitor normalizada a partir das participações ativas e entregue-a a
kanchi-dividend-review-monitorem vez de tratar a revisão de dividendos como uma seção apenas narrativa. Também construa entrada de planejamento tributário parakanchi-dividend-us-tax-accountingquando forem solicitadas notas de localização da conta; rotule-a como degradada se o tipo de conta ou janelas de período de manutenção não estiverem disponíveis.
Validação de Dados:
- Verifique se todas as posições têm símbolos de ticker válidos
- Confirme se os valores de mercado somam aproximadamente o patrimônio líquido da conta
- Verifique se há posições desatualizadas ou inativas
- Lide com casos extremos (ações fracionárias, opções, cripto, se suportado)
Passo 2: Enriquecer Dados das Posições
Para cada posição no portfólio, 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 buscar:
- Classificação de setor e indústria
- Principais métricas de valuation (P/L, P/VP, rendimento de dividendos)
- Indicadores recentes de lucros e saúde financeira
- Classificações de analistas e preços-alvo
- Notícias recentes e desenvolvimentos materiais
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 momentum (RSI, MACD, se disponíveis)
Passo 3: Análise em Nível de Portfólio
Realize 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 múltiplas dimensões:
Por Classe de Ativo:
- Ações vs Renda Fixa vs Caixa 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 (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% |
| ... |
### Detalhamento Setorial
[Descrição do 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:
- Identifique as principais participações e seu peso agregado
- Sinalize se qualquer posição única exceder 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 qualquer setor exceder 30-40% do portfólio
- Compare com a diversidade setorial de referência
Análise de Correlação:
- Estime a correlação entre posições principais
- Identifique participações altamente correlacionadas (redundância potencial)
- Avalie o benefício real da diversificação
Número de Posições:
- Faixa ideal: 15-30 ações para portfólios individuais
- Sinalize se sub-diversificado (<10 ações) ou sobre-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 única: [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]
**Contagem de Posições:** [Ideal / Sub-diversificado / Sobre-diversificado]
- Total de posições: XX ações
- [Recomendação]
**Preocupações com Correlação:**
- [Liste quaisquer pares de posições altamente correlacionadas]
- [Sugestões de melhoria de 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:
- 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:
- 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ções individuais
- 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 ú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 (últimas 5 por % de perda)
Retornos Ponderados pelo Tempo (se histórico disponível):
- Retorno no ano
- 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 Ganhadores 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 de Caixa:** $XX.XXX (XX% do portfólio)
**Melhores Desempenhos:**
| Símbolo | Ganho | Valor da Posição |
|---------|-------|------------------|
| [TICKER] | +XX,X% | $XX.XXX |
| ... |
**Piores Desempenhos:**
| 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%
- Alpha: +/- 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 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 Sobrevalorizado / 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 do momentum
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 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]
- Cap. de Mercado: $XX,XB
- P/L: XX,X | Rend. 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 por XX%]
- Suporte: $XX,XX | Resistência: $XX,XX
**Avaliação da Posição:**
- **Status da Tese:** [Intacta / Enfraquecendo / Quebrada / Fortalecendo]
- **Valuation:** [Subvalorizado / Justo / Sobrevalorizado]
- **Dimensionamento:** [Ideal / Sobreponderado / Subponderado]
**Recomendação:** [MANTER / ADICIONAR / 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 setoriais/de classe de ativos que precisam de ajuste
- Posições sobreponderadas a reduzir (excederam o limite)
- Áreas subponderadas a adicionar (abaixo do limite)
- Considerações fiscais (implicações de ganhos de capital)
5.2 Desenvolver Plano de Rebalanceamento:
Posições a REDUZIR:
- Posições sobreponderadas (>desvio 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 a 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), 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 maior 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
[...
[truncado para tradução]