Communitygithub.com

Gerenciador de Portfólio

Análise abrangente de portfólio usando integração com o MCP Server da Alpaca para obter posições e ativos, analisar alocação de ativos, métricas de risco, posições individuais, diversificação e gerar recomendações de rebalanceamento. Use quando o usuário solicitar revisão de portfólio, análise de posições, avaliação de risco, avaliação de desempenho ou sugestões de rebalanceamento para sua conta de corretagem.

O que é Gerenciador de Portfólio?

Esta skill capacita agentes de IA a realizar análises profundas e gerenciamento de portfólios de investimento conectando-se ao Alpaca MCP Server para obter dados de posições em tempo real. Ela executa uma análise abrangente que cobre alocação de ativos, diversificação, métricas de risco, avaliação de posições individuais e gera recomendações práticas de rebalanceamento. Útil para usuários que gerenciam contas de corretagem ativas, a skill pode ser invocada para revisar portfólios, verificar alocações, avaliar riscos ou solicitar sugestões de rebalanceamento. O fluxo de trabalho envolve buscar dados da conta e posições via Alpaca MCP (ou API REST como fallback), enriquecer os dados com informações de mercado e fundamentos, realizar análises em nível de portfólio (incluindo alocação de ativos, diversificação, risco e desempenho), analisar posições individuais-chave e gerar um plano de rebalanceamento priorizado com base em limites de desvio do peso-alvo. A skill também inclui validação de dados para garantir precisão e lida com cenários de fallback para jobs agendados onde ferramentas MCP podem não estar disponíveis.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/majiayu000/claude-skill-registry/tree/HEAD/skills/analysis/portfolio-manager

Perguntar na sua IA favorita

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

Documentação

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 caixa
  • 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 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 fallback em vez de MCP.
  • Use ALPACA_PAPER=true para 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-monitor em vez de tratar a revisão de dividendos como uma seção apenas narrativa. Também construa entrada de planejamento tributário para kanchi-dividend-us-tax-accounting quando 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:

  1. Imediata - Redução de risco (reduzir posições concentradas)
  2. Alta Prioridade - Desvio maior de alocação (>10% do alvo)
  3. Prioridade Média - Desvio moderado (5-10% do alvo)
  4. Baixa Prioridade - Ajustes finos e ajustes oportunistas

Saída:

## Recomendações de Rebalanceamento

### Resumo

[...

[truncado para tradução]

Individual skills in this repo

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

majiayu000/claude-skill-registry

Builds, edit or validate Agent Skill through conversational discovery. Use when the user requests to "Create an Agent", "Optimize an Agent" or "Edit an Agent".

majiayu000/claude-skill-registry

Edit existing BMAD agents while maintaining compliance

majiayu000/claude-skill-registry

Edit existing BMAD agents while maintaining compliance

majiayu000/claude-skill-registry

Edit existing BMAD modules while maintaining coherence

majiayu000/claude-skill-registry

Edit existing BMAD modules while maintaining coherence

majiayu000/claude-skill-registry

Analyzes current state and user query to answer BMad questions or recommend the next workflow or agent. Use when user says what should I do next, what do I do now, or asks a question about BMad

majiayu000/claude-skill-registry

Build AI agents with Google ADK Python (Agent Development Kit). Use for multi-agent systems, workflow agents (sequential/parallel/loop), Vertex AI deployment, tool integration, human-in-the-loop.

majiayu000/claude-skill-registry

Build AI agents with Google ADK Python (Agent Development Kit). Use for multi-agent systems, workflow agents (sequential/parallel/loop), Vertex AI deployment, tool integration, human-in-the-loop.

majiayu000/claude-skill-registry

Portfolio allocation and rebalancing optimizer. Manages asset allocation across stocks/cash/bonds, performs periodic rebalancing, and ensures diversification according to market regime and risk tolerance.

majiayu000/claude-skill-registry

Create a hilarious and ultra-realistic video of an anthropomorphic animal acting like a human vlogger in a real-world setting.

majiayu000/claude-skill-registry

Speech-to-text transcription and translation via OpenAI Audio API -- models, response formats, timestamps, prompting, streaming, chunking, and diarization

majiayu000/claude-skill-registry

BlockRun works with Claude Code and Google Antigravity.

majiayu000/claude-skill-registry

This skill should be used when the user asks about libraries, frameworks, API references, or needs code examples. Activates for setup questions, code generation involving libraries, or mentions of specific frameworks like React, Vue, Next.js, Prisma, Supabase, etc.

majiayu000/claude-skill-registry

小省导购员数字人带货版即梦视频提示词生成系统,基于四大智能体协同(提示词生成师、质量管控师、知识库运维师、跨环节适配师),按照"主体+运动+场景+(镜头语言+光影+氛围)"公式输出中英文双版提示词,适配5s短视频。确保人物一致性、视觉连贯性、情绪连贯性,支持知识库智能复用和跨工具适配(Suno音乐、AI绘画),为数字人带货视频提供高质量提示词生成服务。

majiayu000/claude-skill-registry

Upload and manage files using Google Gemini File API via scripts/. Use for uploading images, audio, video, PDFs, and other files for use with Gemini models. Supports file upload, status checking, and file management. Triggers on "upload file", "file API", "upload image", "upload PDF", "upload video", "file management".

majiayu000/claude-skill-registry

CRITICAL: Use for MolyKit AI chat toolkit. Triggers on: BotClient, OpenAI, SSE streaming, AI chat, molykit, PlatformSend, spawn(), ThreadToken, cross-platform async, Chat widget, Messages, PromptInput, Avatar, LLM

majiayu000/claude-skill-registry

AI and machine learning workflow covering LLM application development, RAG implementation, agent architecture, ML pipelines, and AI-powered features.

majiayu000/claude-skill-registry

Analyze images/audio/video with Gemini API (better vision than Claude). Generate images (Imagen 4), videos (Veo 3). Use for vision analysis, transcription, OCR, design extraction, multimodal AI.

majiayu000/claude-skill-registry

Analyze images/audio/video with Gemini API (better vision than Claude). Generate images (Imagen 4), videos (Veo 3). Use for vision analysis, transcription, OCR, design extraction, multimodal AI.

majiayu000/claude-skill-registry

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Habilidades Relacionadas