¿Qué hace Gestor de Portafolio?
Descripción General
Analice y gestione carteras de inversión integrándose con Alpaca MCP Server para obtener datos de tenencias en tiempo real, y luego realice un análisis completo que cubra asignación de activos, diversificación, métricas de riesgo, evaluación de posiciones individuales y recomendaciones de rebalanceo. 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 de Modelo) para acceder a datos de cartera en vivo, asegurando que el análisis se base en posiciones reales y 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?"
- "Verifica el riesgo de mi cartera"
- "¿Debería rebalancear mi cartera?"
- "Evalúa mis tenencias"
- "Revisión del rendimiento de la cartera"
- "¿Qué acciones debería comprar o vender?"
- Cualquier solicitud que involucre análisis o gestión a nivel de cartera
Prerrequisitos
Configuración de Alpaca MCP Server
Esta habilidad requiere que Alpaca MCP Server 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 efectivoget_positions- Recuperar todas las posiciones actuales con cantidades, base de costo, valor de mercadoget_portfolio_history- Datos históricos de rendimiento de la cartera- Herramientas de datos de mercado para cotizaciones de precios y fundamentales
Si Alpaca MCP Server 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 Cartera a través de Alpaca MCP
Use las herramientas de Alpaca MCP Server para recopilar información actual de la cartera:
1.1 Obtener Información de la Cuenta:
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
1.2 Obtener Posiciones Actuales:
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
- Ganancias/Pérdidas no realizadas ($ y %)
- Tamaño de la posición como % de la cartera
1.3 Obtener Historial de Cartera (Opcional):
Use mcp__alpaca__get_portfolio_history para análisis de rendimiento:
- Valores históricos del patrimonio
- Cálculo de rendimiento ponderado en el tiempo
- Análisis de reducción máxima
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 Posiciones
Para cada posición en la cartera, recopile datos de mercado adicionales y fundamentales:
2.1 Datos de Mercado Actuales:
- Cotizaciones de precios en tiempo real o con retraso
- Volumen diario y métricas de liquidez
- Rango de 52 semanas
- Capitalización de mercado
2.2 Datos Fundamentales: Use WebSearch o API de datos de mercado disponibles para obtener:
- Clasificación de sector e industria
- Métricas clave de valoración (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 precios (medias móviles de 20, 50 y 200 días)
- Fuerza relativa
- Niveles de soporte y resistencia
- Indicadores de momento (RSI, MACD si están disponibles)
Paso 3: Análisis a Nivel de Cartera
Realice un análisis integral de la cartera utilizando los marcos de los 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:
- Renta Variable vs Renta Fija vs Efectivo vs Alternativos
- Compare con la asignación objetivo según 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 del índice de referencia (ej. S&P 500)
Por Capitalización de Mercado:
- Distribución de Gran Capitalización vs Mediana vs Pequeña
- Concentración en mega-capitalizaciones
- Puntuación de diversificación por capitalización de mercado
Por Geografía:
- Distribución de 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 |
|------------------|--------|----------|-----------|
| Renta Variable EE. UU. | XX.X% | YY.Y% | +/- Z.Z% |
| ... |
### Desglose Sectorial
[Descripción de gráfico circular o tabla con porcentajes sectoriales]
### Las 10 Principales 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 tenencias principales y su peso agregado
- Señale 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
- Señale si algún sector supera el 30-40% de la cartera
- Compare con la diversidad sectorial del índice de referencia
Análisis de Correlación:
- Estime la correlación entre las posiciones principales
- Identifique tenencias altamente correlacionadas (posible redundancia)
- Evalúe el verdadero beneficio de la diversificación
Número de Posiciones:
- Rango óptimo: 15-30 acciones para carteras individuales
- Señale si está poco diversificado (<10 acciones) o sobrediversificado (>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 / Deficiente]
- Sector dominante: [Nombre del Sector] en XX%
- [Evaluación del equilibrio entre sectores]
**Recuento de Posiciones:** [Óptimo / Poco diversificado / Sobrediversificado]
- Total de posiciones: XX acciones
- [Recomendación]
**Preocupaciones de Correlación:**
- [Enumere 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 estimado de la cartera (promedio ponderado de betas de posiciones)
- Volatilidades individuales de posiciones
- Desviación estándar de la cartera (si hay datos históricos disponibles)
Riesgo a la Baja:
- Reducción máxima (del historial de la cartera)
- Reducción actual desde el máximo
- 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 eventos específicos del sector
Salida:
## Evaluación de Riesgo
**Perfil de Riesgo General:** [Conservador / Moderado / Agresivo]
**Beta de Cartera:** X.XX (vs mercado en 1.00)
- Interpretación: La cartera es [más/menos] volátil que el mercado
**Reducción Máxima:** -XX.X% (de $XXX,XXX a $XXX,XXX)
- Reducción actual desde el máximo: -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 ([Bajo/Medio/Alto] riesgo)
3.4 Análisis de Rendimiento
Evalúe el rendimiento de la cartera utilizando los datos disponibles:
Rendimientos Absolutos:
- Ganancias/Pérdidas no realizadas de la cartera ($ y %)
- Posiciones con mejor rendimiento (top 5 por % de ganancia)
- Posiciones con peor rendimiento (bottom 5 por % de pérdida)
Rendimientos Ponderados en el Tiempo (si hay historial disponible):
- Rendimiento YTD
- Rendimientos anualizados a 1, 3 y 5 años
- Compare con el índice 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
**Ganancias/Pérdidas No Realizadas Totales:** $XX,XXX (+XX.X%)
**Saldo de Efectivo:** $XX,XXX (XX% de la cartera)
**Mejores Rendimientos:**
| Símbolo | Ganancia | Valor de Posición |
|---------|----------|-------------------|
| [TICKER] | +XX.X% | $XX,XXX |
| ... |
**Peores Rendimientos:**
| Símbolo | Pérdida | Valor de Posición |
|---------|---------|-------------------|
| [TICKER] | -XX.X% | $XX,XXX |
| ... |
**Rendimiento vs Índice de Referencia (si está disponible):**
- Rendimiento de cartera: +X.X%
- Rendimiento S&P 500: +Y.Y%
- Alfa: +/- Z.Z%
Paso 4: Análisis de Posiciones Individuales
Para posiciones clave (top 10-15 por peso en cartera), realice un análisis detallado:
Lea references/position-evaluation.md para el marco de análisis de posiciones
Para cada posición significativa:
4.1 Validación de Tesis Actual:
- ¿Por qué se inició esta posición? (si se conoce del contexto del usuario)
- ¿La tesis de inversión se ha cumplido o se ha roto?
- 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órica
- Compare con pares del sector
- Evaluación de Sobrevalorado / Justo / Infravalorado
4.3 Salud Técnica:
- Tendencia de precios (alcista, bajista, lateral)
- Posición relativa a medias móviles
- Niveles de soporte y resistencia
- Estado del momento
4.4 Tamaño de Posición:
- Peso actual en la cartera
- ¿El tamaño es apropiado dado el nivel de convicción y riesgo?
- Sobreponderado o infraponderado vs óptimo
4.5 Recomendación de Acción:
- MANTENER - La posición tiene buen tamaño y la tesis intacta
- AGREGAR - Infraponderado dada la oportunidad, la tesis se fortalece
- 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
- Ganancias/Pérdidas No Realizadas: $X,XXX (+XX.X%)
**Resumen Fundamental:**
- Sector: [Sector]
- Capitalización de Mercado: $XX.XB
- P/E: XX.X | Rendimiento de Dividendo: X.X%
- Desarrollos recientes: [Noticias clave o ganancias]
**Estado Técnico:**
- Tendencia: [Alcista / Bajista / Lateral]
- Precio vs MA de 50 días: [Arriba/Abajo por 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:** [Infravalorada / Justa / Sobrevalorada]
- **Tamaño de Posición:** [Óptimo / Sobreponderado / Infraponderado]
**Recomendación:** [MANTENER / AGREGAR / REDUCIR / VENDER]
**Fundamento:** [Explicación de 1-2 oraciones]
Paso 5: Recomendaciones de Rebalanceo
Lea references/rebalancing-strategies.md para enfoques de rebalanceo
Genere recomendaciones específicas de rebalanceo:
5.1 Identificar Disparadores de Rebalanceo:
- Posiciones que se han desviado significativamente de los pesos objetivo
- Asignaciones de sector/clase de activo que requieren ajuste
- Posiciones sobreponderadas para reducir (superaron el umbral)
- Áreas infraponderadas para agregar (por debajo del umbral)
- Consideraciones fiscales (implicaciones de ganancias de capital)
5.2 Desarrollar un Plan de Rebalanceo:
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 AGREGAR:
- Sectores o clases de activo 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 su despliegue
- Priorice según oportunidad y brechas de asignación
5.3 Priorización: Clasifique las acciones de rebalanceo por prioridad:
- Inmediata - Reducción de riesgo (reducir posiciones concentradas)
- Alta Prioridad - Desviación importante de asignación (>10% del objetivo)
- Prioridad Media - Desviación moderada (5-10% del objetivo)
- Baja Prioridad - Ajustes finos y ajustes oportunistas
Salida:
## Recomendaciones de Rebalanceo
### Resumen
- **Rebalanceo Necesario:** [Sí / No / Opcional]
- **Razón Principal:** [Riesgo de concentración / Desviación sectorial / Despliegue de efectivo / etc]
- **Operaciones Estimadas:** X órdenes de venta, Y órdenes de compra
### Acciones Recomendadas
#### ALTA PRIORIDAD: Reducción de Riesgo
**REDUCIR [SÍMBOLO]** de XX% a YY% de la cartera
- **Acciones a Vender:** XX acciones (~$XX,XXX)
- **Fundamento:** [Sobreponderado / Valoración extendida / etc]
- **Impacto Fiscal:** $X,XXX de ganancia de capital (est)
#### PRIORIDAD MEDIA: Asignación de Activos
**AGREGAR exposición a [Sector/Clase de Activo]**
- **Objetivo:** Aumentar de XX% a YY%
- **Acciones Sugeridas:** [SÍMBOLO1, SÍMBOLO2, SÍMBOLO3]
- **Cantidad a Invertir:** ~$XX,XXX
#### DESPLIEGUE DE EFECTIVO
**Efectivo Actual:** $XX,XXX (XX% de la cartera)
- **Recomendación:** [Desplegar / Mantener para oportunidades / Reducir a X%]
- **Asignación Sugerida:** [Distribución entre sectores/acciones]
### Plan de Implementación
1. [Primera acción - prioridad más alta]
2. [Segunda acción]
3. [Tercera acción]
...
**Consideraciones de Momento:**
- [Planificación de fin de año fiscal / Temporada de ganancias / Condiciones del mercado]
- [Fase sugerida si aplica]
Paso 6: Generar Informe de Cartera
Cree un informe completo en markdown guardado en la raíz del repositorio:
Nombre de Archivo: portfolio_analysis_YYYY-MM-DD.md
Estructura del Informe:
# Informe de Análisis de Cartera
**Cuenta:** [Tipo de cuenta si está disponible]
**Fecha del Informe:** YYYY-MM-DD
**Valor de la Cartera:** $XXX,XXX
**Ganancias/Pérdidas Totales:** $XX,XXX (+XX.X%)
---
## Resumen Ejecutivo
[3-5 viñetas resumiendo hallazgos clave]
- Evaluación general de salud de la cartera
- Fortalezas principales
- Riesgos o preocupaciones clave
- Recomendaciones principales
---
## Resumen de Tenencias
[Tabla resumen de todas las posiciones]
---
## Asignación de Activos
[Sección del Paso 3.1]
---
## Análisis de Diversificación
[Sección del Paso 3.2]
---
## Evaluación de Riesgo
[Sección del Paso 3.3]
---
## Revisión de Rendimiento
[Sección...