Communitygithub.com

Gestor de Cartera

Análisis integral de carteras de inversión mediante la integración con el Servidor MCP de Alpaca para obtener tenencias y posiciones, y luego analizar la asignación de activos, métricas de riesgo, posiciones individuales, diversificación y generar recomendaciones de reequilibrio.

¿Qué es Gestor de Cartera?

Esta habilidad permite a un agente de IA analizar y gestionar carteras de inversión conectándose al Servidor MCP de Alpaca para obtener datos en tiempo real de las tenencias y posiciones de una cuenta de corretaje. Realiza un análisis exhaustivo que incluye la asignación de activos, métricas de riesgo, diversificación, evaluación de posiciones individuales y recomendaciones de reequilibrio. Es útil para desarrolladores y usuarios que desean automatizar revisiones de cartera, evaluar el rendimiento, identificar riesgos de concentración y recibir sugerencias accionables sobre qué comprar o vender. La habilidad admite tanto el uso del Servidor MCP de Alpaca como una alternativa mediante su API REST para entornos programados, garantizando que el análisis se base siempre en datos reales de la cartera.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Gestor de Cartera?

Descripción General

Analice y gestione carteras de inversión integrándose con el Servidor MCP de Alpaca para obtener datos de tenencias en tiempo real, luego realice un análisis completo que cubra la asignación de activos, diversificación, métricas de riesgo, evaluación de posiciones individuales y recomendaciones de reequilibrio. Genere informes detallados de cartera con información procesable.

Esta habilidad aprovecha la API de corretaje de Alpaca a través de MCP (Protocolo de Contexto del Modelo) para acceder a datos de cartera en vivo, asegurando que el análisis se base en posiciones reales actuales en lugar de datos ingresados manualmente.

Cuándo Usar

Invoque esta habilidad cuando el usuario solicite:

  • "Analiza mi cartera"
  • "Revisa mis posiciones actuales"
  • "¿Cuál es mi asignación de activos?"
  • "Revisa el riesgo de mi cartera"
  • "¿Debería reequilibrar mi cartera?"
  • "Evalúa mis tenencias"
  • "Revisión del rendimiento de la cartera"
  • "¿Qué acciones debería comprar o vender?"
  • Cualquier solicitud que implique análisis o gestión a nivel de cartera

Requisitos Previos

Configuración del Servidor MCP de Alpaca

Esta habilidad requiere que el Servidor MCP de Alpaca esté configurado y conectado. El servidor MCP proporciona acceso a:

  • Posiciones actuales de la cartera
  • Patrimonio de la cuenta y poder de compra
  • Posiciones y transacciones históricas
  • Datos de mercado para valores mantenidos

Herramientas del Servidor MCP Utilizadas:

  • get_account_info - Obtener patrimonio de la cuenta, poder de compra, saldo de efectivo
  • get_positions - Recuperar todas las posiciones actuales con cantidades, base de costo, valor de mercado
  • get_portfolio_history - Datos históricos de rendimiento de la cartera
  • Herramientas de datos de mercado para cotizaciones de precios y fundamentos

Si el Servidor MCP de Alpaca no está conectado, informe al usuario y proporcione instrucciones de configuración desde references/alpaca_mcp_setup.md.

Flujo de Trabajo

Paso 1: Obtener Datos de la Cartera a través de Alpaca MCP o alternativa REST

Utilice las herramientas del Servidor MCP de Alpaca para recopilar información actual de la cartera cuando esté disponible. En trabajos programados de Hermes, las herramientas MCP pueden no estar expuestas incluso cuando las credenciales de Alpaca están presentes; en ese caso, use la API REST de Alpaca directamente con ALPACA_API_KEY, ALPACA_SECRET_KEY y ALPACA_PAPER.

1.1 Obtener Información de la Cuenta:

Preferido: use mcp__alpaca__get_account_info para obtener:
- Patrimonio de la cuenta (valor total de la cartera)
- Saldo de efectivo
- Poder de compra
- Estado de la cuenta

Puntos finales REST alternativos:
- papel: https://paper-api.alpaca.markets/v2/account
- real:  https://api.alpaca.markets/v2/account
Encabezados:
- APCA-API-KEY-ID=$ALPACA_API_KEY
- APCA-API-SECRET-KEY=$ALPACA_SECRET_KEY

1.2 Obtener Posiciones Actuales:

Preferido: use mcp__alpaca__get_positions para obtener todas las tenencias:
- Símbolo del ticker
- Cantidad mantenida
- Precio de entrada promedio (base de costo)
- Precio de mercado actual
- Valor de mercado actual
- P&L no realizado ($ y %)
- Tamaño de la posición como % de la cartera

Puntos finales REST alternativos:
- papel: https://paper-api.alpaca.markets/v2/positions
- real:  https://api.alpaca.markets/v2/positions

1.3 Obtener Historial de la Cartera (Opcional):

Preferido: use mcp__alpaca__get_portfolio_history para análisis de rendimiento:
- Valores de patrimonio histórico
- Cálculo de rentabilidad ponderada en el tiempo
- Análisis de drawdown

Punto final REST alternativo:
- /v2/account/portfolio/history

Disciplina de alternativa para trabajos programados:

  • Etiquete claramente la fuente como Alternativa REST de Alpaca en lugar de MCP.
  • Use ALPACA_PAPER=true para elegir el punto final de papel; de lo contrario, use el punto final real.
  • Aún valide que el valor de mercado a largo más el efectivo se reconcilie aproximadamente con el patrimonio, y resalte el margen/apalancamiento si long_market_value > equity.
  • Para trabajos cron de cartera central semanal, calcule la exposición utilizando el patrimonio como denominador así como el valor de mercado bruto: gross_long_exposure = long_market_value / equity, cash_pct = cash / equity, y marque explícitamente las carteras financiadas con margen cuando la exposición bruta sea materialmente superior al 100% o el efectivo sea negativo. No permita que los pesos sectoriales parezcan benignos utilizando solo el denominador bruto a largo cuando la cuenta está apalancada.
  • Cuando la solicitud enfatice tenencias de dividendos o desencadenantes de revisión forzada, construya una entrada de monitor normalizada a partir de las tenencias en vivo y entréguela a kanchi-dividend-review-monitor en lugar de tratar la revisión de dividendos como una sección solo narrativa. También construya una entrada de planificación fiscal para kanchi-dividend-us-tax-accounting cuando se soliciten notas de ubicación de cuenta; etiquétela como degradada si el tipo de cuenta o las ventanas de período de tenencia no están disponibles.

Validación de Datos:

  • Verifique que todas las posiciones tengan símbolos de ticker válidos
  • Confirme que los valores de mercado sumen aproximadamente el patrimonio de la cuenta
  • Verifique si hay posiciones obsoletas o inactivas
  • Maneje casos extremos (acciones fraccionarias, opciones, cripto si es compatible)

Paso 2: Enriquecer Datos de Posición

Para cada posición en la cartera, recopile datos de mercado adicionales y fundamentos:

2.1 Datos de Mercado Actuales:

  • Cotizaciones de precios en tiempo real o retrasadas
  • Volumen diario y métricas de liquidez
  • Rango de 52 semanas
  • Capitalización de mercado

2.2 Datos Fundamentales: Use WebSearch o APIs de datos de mercado disponibles para obtener:

  • Clasificación sectorial e industrial
  • Métricas de valoración clave (P/E, P/B, rendimiento de dividendos)
  • Ganancias recientes e indicadores de salud financiera
  • Calificaciones de analistas y precios objetivo
  • Noticias recientes y desarrollos materiales

2.3 Análisis Técnico:

  • Tendencia de precio (medias móviles de 20, 50, 200 días)
  • Fortaleza relativa
  • Niveles de soporte y resistencia
  • Indicadores de momentum (RSI, MACD si están disponibles)

Paso 3: Análisis a Nivel de Cartera

Realice un análisis integral de la cartera utilizando marcos de referencia de archivos de referencia:

3.1 Análisis de Asignación de Activos

Lea references/asset-allocation.md para marcos de asignación

Analice la asignación actual en múltiples dimensiones:

Por Clase de Activo:

  • Acciones vs Renta Fija vs Efectivo vs Alternativos
  • Compare con la asignación objetivo para el perfil de riesgo del usuario
  • Evalúe si la asignación coincide con los objetivos de inversión

Por Sector:

  • Tecnología, Salud, Financiero, Consumo, etc.
  • Identifique riesgos de concentración sectorial
  • Compare con los pesos sectoriales de referencia (por ejemplo, S&P 500)

Por Capitalización de Mercado:

  • Distribución de gran capitalización vs mediana capitalización vs pequeña capitalización
  • Concentración en mega capitalizaciones
  • Puntuación de diversificación por capitalización de mercado

Por Geografía:

  • EE. UU. vs Internacional vs Mercados Emergentes
  • Evaluación del riesgo de concentración doméstica

Formato de Salida:

## Asignación de Activos

### Asignación Actual vs Objetivo
| Clase de Activo | Actual | Objetivo | Variación |
|-----------------|--------|----------|-----------|
| Acciones EE. UU. | XX.X% | YY.Y% | +/- Z.Z% |
| ... |

### Desglose Sectorial
[Descripción del gráfico circular o tabla con porcentajes sectoriales]

### Principales 10 Tenencias
| Rango | Símbolo | % de Cartera | Sector |
|-------|---------|--------------|--------|
| 1 | AAPL | X.X% | Tecnología |
| ... |

3.2 Análisis de Diversificación

Lea references/diversification-principles.md para teoría de diversificación

Evalúe la calidad de la diversificación de la cartera:

Concentración de Posiciones:

  • Identifique las principales tenencias y su peso agregado
  • Marque si alguna posición individual supera el 10-15% de la cartera
  • Calcule el Índice Herfindahl-Hirschman (HHI) para medir la concentración

Concentración Sectorial:

  • Identifique sectores dominantes
  • Marque si algún sector supera el 30-40% de la cartera
  • Compare con la diversidad sectorial de referencia

Análisis de Correlación:

  • Estime la correlación entre posiciones principales
  • Identifique tenencias altamente correlacionadas (posible redundancia)
  • Evalúe el verdadero beneficio de diversificación

Número de Posiciones:

  • Rango óptimo: 15-30 acciones para carteras individuales
  • Marque si está sub-diversificado (<10 acciones) o sobre-diversificado (>50 acciones)

Salida:

## Evaluación de Diversificación

**Riesgo de Concentración:** [Bajo / Medio / Alto]
- Las 5 principales tenencias representan XX% de la cartera
- Posición individual más grande: [SÍMBOLO] en XX%

**Diversificación Sectorial:** [Excelente / Buena / Aceptable / Pobre]
- Sector dominante: [Nombre del Sector] en XX%
- [Evaluación del equilibrio entre sectores]

**Número de Posiciones:** [Óptimo / Sub-diversificado / Sobre-diversificado]
- Total de posiciones: XX acciones
- [Recomendación]

**Preocupaciones de Correlación:**
- [Lista de pares de posiciones altamente correlacionadas]
- [Sugerencias de mejora de diversificación]

3.3 Análisis de Riesgo

Lea references/portfolio-risk-metrics.md para marcos de medición de riesgo

Calcule e interprete métricas clave de riesgo:

Medidas de Volatilidad:

  • Beta estimada de la cartera (promedio ponderado de betas de posiciones)
  • Volatilidades de posiciones individuales
  • Desviación estándar de la cartera (si hay datos históricos disponibles)

Riesgo de Pérdida:

  • Drawdown máximo (del historial de la cartera)
  • Drawdown actual desde el pico
  • Posiciones con pérdidas no realizadas significativas

Concentración de Riesgo:

  • Porcentaje en acciones de alta volatilidad (beta > 1.5)
  • Porcentaje en empresas especulativas/no rentables
  • Uso de apalancamiento (si aplica)

Riesgo de Cola:

  • Exposición a posibles eventos de cisne negro
  • Riesgo de concentración en una sola acción
  • Riesgo de evento específico del sector

Salida:

## Evaluación de Riesgo

**Perfil de Riesgo General:** [Conservador / Moderado / Agresivo]

**Beta de la Cartera:** X.XX (frente al mercado en 1.00)
- Interpretación: La cartera es [más/menos] volátil que el mercado

**Drawdown Máximo:** -XX.X% (de $XXX,XXX a $XXX,XXX)
- Drawdown actual desde el pico: -XX.X%

**Posiciones de Alto Riesgo:**
| Símbolo | % de Cartera | Beta | Factor de Riesgo |
|---------|--------------|------|------------------|
| [TICKER] | XX% | X.XX | [Alta volatilidad / Pérdida reciente / etc] |

**Concentraciones de Riesgo:**
- XX% en un solo sector ([Sector])
- XX% en acciones con beta > 1.5
- [Otros riesgos de concentración]

**Puntuación de Riesgo:** XX/100 ([Riesgo Bajo/Medio/Alto])

3.4 Análisis de Rendimiento

Evalúe el rendimiento de la cartera utilizando datos disponibles:

Rentabilidades Absolutas:

  • P&L no realizado general de la cartera ($ y %)
  • Posiciones con mejor rendimiento (top 5 por % de ganancia)
  • Posiciones con peor rendimiento (inferior 5 por % de pérdida)

Rentabilidades Ponderadas en el Tiempo (si hay historial disponible):

  • Rentabilidad YTD
  • Rentabilidades anualizadas a 1 año, 3 años, 5 años
  • Compare con el punto de referencia (S&P 500, índice relevante)

Rendimiento a Nivel de Posición:

  • Ratio de Ganadores vs Perdedores
  • Ganancia promedio en posiciones ganadoras
  • Pérdida promedio en posiciones perdedoras
  • Posiciones cerca de máximos/mínimos de 52 semanas

Salida:

## Revisión de Rendimiento

**Valor Total de la Cartera:** $XXX,XXX
**P&L No Realizado Total:** $XX,XXX (+XX.X%)
**Saldo de Efectivo:** $XX,XXX (XX% de la cartera)

**Mejores Rendimientos:**
| Símbolo | Ganancia | Valor de la Posición |
|---------|----------|----------------------|
| [TICKER] | +XX.X% | $XX,XXX |
| ... |

**Peores Rendimientos:**
| Símbolo | Pérdida | Valor de la Posición |
|---------|---------|----------------------|
| [TICKER] | -XX.X% | $XX,XXX |
| ... |

**Rendimiento vs Punto de Referencia (si está disponible):**
- Rentabilidad de la cartera: +X.X%
- Rentabilidad del S&P 500: +Y.Y%
- Alfa: +/- Z.Z%

Paso 4: Análisis de Posiciones Individuales

Para posiciones clave (top 10-15 por peso en la cartera), realice un análisis detallado:

Lea references/position-evaluation.md para el marco de análisis de posición

Para cada posición significativa:

4.1 Validación de la Tesis Actual:

  • ¿Por qué se inició esta posición? (si se conoce del contexto del usuario)
  • ¿Se ha cumplido o roto la tesis de inversión?
  • Desarrollos recientes de la empresa y noticias

4.2 Evaluación de Valoración:

  • Métricas de valoración actuales (P/E, P/B, etc.)
  • Compare con el rango de valoración histórico
  • Compare con pares del sector
  • Evaluación de Sobrevalorado / Justo / Infravalorado

4.3 Salud Técnica:

  • Tendencia de precio (alcista, bajista, lateral)
  • Posición relativa a medias móviles
  • Niveles de soporte y resistencia
  • Estado del momentum

4.4 Tamaño de la Posición:

  • Peso actual en la cartera
  • ¿Es el tamaño apropiado dado la convicción y el riesgo?
  • Sobreponderado o infraponderado vs óptimo

4.5 Recomendación de Acción:

  • MANTENER - La posición está bien dimensionada y la tesis intacta
  • AUMENTAR - Infraponderado dada la oportunidad, tesis fortaleciéndose
  • REDUCIR - Sobreponderado o valoración estirada
  • VENDER - Tesis rota, mejores oportunidades en otro lugar

Salida por posición:

### [SÍMBOLO] - [Nombre de la Empresa] (XX.X% de la cartera)

**Detalles de la Posición:**
- Acciones: XXX
- Costo Promedio: $XX.XX
- Precio Actual: $XX.XX
- Valor de Mercado: $XX,XXX
- P/L No Realizado: $X,XXX (+XX.X%)

**Resumen Fundamental:**
- Sector: [Sector]
- Capitalización de Mercado: $XX.XB
- P/E: XX.X | Rendimiento de Dividendos: X.X%
- Desarrollos recientes: [Noticias clave o ganancias]

**Estado Técnico:**
- Tendencia: [Alcista / Bajista / Lateral]
- Precio vs MA de 50 días: [Por encima/Por debajo en XX%]
- Soporte: $XX.XX | Resistencia: $XX.XX

**Evaluación de la Posición:**
- **Estado de la Tesis:** [Intacta / Debilitándose / Rota / Fortaleciéndose]
- **Valoración:** [Infravalorado / Justa / Sobrevalorado]
- **Tamaño de la Posición:** [Óptimo / Sobreponderado / Infraponderado]

**Recomendación:** [MANTENER / AUMENTAR / REDUCIR / VENDER]
**Fundamento:** [Explicación de 1-2 oraciones]

Paso 5: Recomendaciones de Reequilibrio

Lea references/rebalancing-strategies.md para enfoques de reequilibrio

Genere recomendaciones específicas de reequilibrio:

5.1 Identificar Desencadenantes de Reequilibrio:

  • Posiciones que se han desviado significativamente de los pesos objetivo
  • Asignaciones sectoriales/clases de activos que requieren ajuste
  • Posiciones sobreponderadas para reducir (excedieron el umbral)
  • Áreas infraponderadas para aumentar (por debajo del umbral)
  • Consideraciones fiscales (implicaciones de ganancias de capital)

5.2 Desarrollar un Plan de Reequilibrio:

Posiciones para REDUCIR:

  • Posiciones sobreponderadas (>desviación del umbral del objetivo)
  • Acciones que han subido significativamente (preocupaciones de valoración)
  • Posiciones concentradas que exceden el 15-20% de la cartera
  • Posiciones con tesis rota

Posiciones para AUMENTAR:

  • Sectores o clases de activos infraponderados
  • Posiciones de alta convicción actualmente infraponderadas
  • Nuevas oportunidades para mejorar la diversificación

Despliegue de Efectivo:

  • Si hay exceso de efectivo (>10% de la cartera), sugiera despliegue
  • Priorice según la oportunidad y las brechas de asignación

5.3 Priorización: Clasifique las acciones de reequilibrio por prioridad:

  1. Inmediata - Reducción de riesgo (recortar posiciones concentradas)
  2. Alta Prioridad - Desviación importante de asignación (>10% del objetivo)
  3. Prioridad Media - Desviación moderada (5-10% del objetivo)
  4. Baja Prioridad - Ajustes finos y oportunistas

Salida:

## Recomendaciones de Reequilibrio

### Resumen

...

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.

Skills relacionados