Communitygithub.com

Portfolio Manager

Análise abrangente de portfólio usando integração com o Alpaca MCP Server para buscar posições e ativos, analisar alocação de ativos, métricas de risco, posições individuais, diversificação e gerar recomendações de rebalanceamento.

O que é Portfolio Manager?

Este skill realiza uma análise completa de portfólios de investimentos ao se integrar com o Alpaca MCP Server para obter dados reais de posições e saldos de corretagem. Ele é útil para investidores que desejam revisar seus portfólios, avaliar riscos, alocação de ativos, desempenho e obter recomendações práticas de rebalanceamento. O skill utiliza ferramentas do MCP, como `get_account_info` e `get_positions`, para coletar dados atuais e, em seguida, aplica frameworks detalhados de análise de alocação, diversificação e risco, gerando relatórios estruturados em Markdown. Suporta plataformas como Claude Code, Cursor e Codex, e o fluxo de trabalho inclui desde a validação de dados até a geração de um relatório final com recomendações priorizadas.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/leecyno1/boutique-skills/tree/HEAD/skills/default/portfolio-manager

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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 dinheiro
  • get_positions - Recuperar todas as posições atuais com quantidades, base de custo, valor de mercado
  • get_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:

  1. Imediato - Redução de risco (reduzir posições concentradas)
  2. Prioridade Alta - Desvio de alocação importante (>10% do alvo)
  3. Prioridade Média - Desvio moderado (5-10% do alvo)
  4. 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.

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

leecyno1/boutique-skills

Review fixed income portfolios by pricing multiple bonds, retrieving reference data, analyzing cashflows, and running scenario analysis. Use when reviewing bond portfolios, computing portfolio duration and DV01, analyzing cashflow waterfalls, stress testing rate scenarios, or assessing portfolio composition.

leecyno1/boutique-skills

Track and analyze portfolio company performance against plan. Ingests monthly/quarterly financial packages (Excel, PDF), extracts KPIs, flags variances to budget, and produces summary dashboards. Use when reviewing portfolio company financials, preparing board materials, or monitoring covenant compliance. Triggers on "review portfolio company", "monthly financials", "how is [company] performing", "covenant check", or "portfolio update".

leecyno1/boutique-skills

Analyze portfolio allocation drift and generate rebalancing trade recommendations across accounts. Considers tax implications, transaction costs, and wash sale rules. Triggers on "rebalance", "portfolio drift", "allocation check", "rebalancing trades", or "my portfolio is out of balance".

leecyno1/boutique-skills

Router skill for LLMQuant portfolio-lab workflows. Use when the user needs portfolio exposure maps, what-if simulations, scenario states, or virtual portfolio comparisons.

leecyno1/boutique-skills

Router skill for LLMQuant portfolio workflows. Use when the user needs company profiles, thesis tracking, theme research, watchlist monitoring, or alert management.

leecyno1/boutique-skills

Best practices for Remotion - Video creation in React

leecyno1/boutique-skills

Agent skill at skills/default/video-autopilot-kit/SKILL.md

Habilidades Relacionadas