Gestor de Cartera
Resumen
Analiza y gestiona carteras de inversión integrándose con el servidor MCP de Alpaca para obtener datos de tenencias en tiempo real, realizando luego un análisis completo que cubre la asignación de activos, la diversificación, las métricas de riesgo, la evaluación de posiciones individuales y las recomendaciones de reequilibrio. Genera 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, lo que garantiza que el análisis se base en posiciones reales actuales en lugar de datos ingresados manualmente.
Cuándo Usarlo
Invoca 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 efectivoget_positions- Recuperar todas las posiciones actuales con cantidades, base de costo, valor de mercadoget_portfolio_history- Datos de rendimiento histórico de la cartera- Herramientas de datos de mercado para cotizaciones de precios y fundamentales
Si el servidor MCP de Alpaca no está conectado, informa al usuario y proporciona 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
Usa las herramientas del servidor MCP de Alpaca para recopilar información actual de la cartera:
1.1 Obtener Información de la Cuenta:
Usa 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:
Usa 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
- G/P no realizado ($ y %)
- Tamaño de la posición como % de la cartera
1.3 Obtener Historial de la Cartera (Opcional):
Usa mcp__alpaca__get_portfolio_history para análisis de rendimiento:
- Valores de patrimonio histórico
- Cálculo de rendimiento ponderado en el tiempo
- Análisis de drawdown
Validación de Datos:
- Verifica que todas las posiciones tengan símbolos de ticker válidos
- Confirma que los valores de mercado sumen aproximadamente el patrimonio de la cuenta
- Revisa si hay posiciones obsoletas o inactivas
- Maneja casos extremos (acciones fraccionarias, opciones, cripto si es compatible)
Paso 2: Enriquecer Datos de Posición
Para cada posición en la cartera, recopila datos de mercado adicionales y fundamentales:
2.1 Datos de Mercado Actuales:
- Cotizaciones de precios en tiempo real o diferidos
- Volumen diario y métricas de liquidez
- Rango de 52 semanas
- Capitalización de mercado
2.2 Datos Fundamentales: Usa WebSearch o las API de datos de mercado disponibles para obtener:
- Clasificación de sector e industria
- 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 relevantes
2.3 Análisis Técnico:
- Tendencia de precio (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
Realiza un análisis completo de la cartera utilizando los marcos de referencia de los archivos:
3.1 Análisis de Asignación de Activos
Lee references/asset-allocation.md para marcos de asignación
Analiza la asignación actual en múltiples dimensiones:
Por Clase de Activo:
- Acciones vs Renta Fija vs Efectivo vs Alternativos
- Compara con la asignación objetivo para el perfil de riesgo del usuario
- Evalúa si la asignación coincide con los objetivos de inversión
Por Sector:
- Tecnología, Salud, Financiero, Consumo, etc.
- Identifica riesgos de concentración sectorial
- Compara 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 nacional
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 de gráfico circular o tabla con porcentajes sectoriales]
### Las 10 Principales Tenencias
| Rango | Símbolo | % de la Cartera | Sector |
|-------|---------|-----------------|--------|
| 1 | AAPL | X.X% | Tecnología |
| ... |
3.2 Análisis de Diversificación
Lee references/diversification-principles.md para teoría de diversificación
Evalúa la calidad de la diversificación de la cartera:
Concentración de Posiciones:
- Identifica las principales tenencias y su peso agregado
- Señala si alguna posición individual supera el 10-15% de la cartera
- Calcula el Índice Herfindahl-Hirschman (HHI) para medir la concentración
Concentración Sectorial:
- Identifica sectores dominantes
- Señala si algún sector supera el 30-40% de la cartera
- Compara con la diversidad sectorial de referencia
Análisis de Correlación:
- Estima la correlación entre las posiciones principales
- Identifica tenencias altamente correlacionadas (posible redundancia)
- Evalúa el beneficio real de la diversificación
Número de Posiciones:
- Rango óptimo: 15-30 acciones para carteras individuales
- Señala si está sub-diversificada (<10 acciones) o sobre-diversificada (>50 acciones)
Salida:
## Evaluación de Diversificación
**Riesgo de Concentración:** [Bajo / Medio / Alto]
- Las 5 principales tenencias representan el 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:**
- [Enumera cualquier par de posiciones altamente correlacionadas]
- [Sugerencias de mejora de la diversificación]
3.3 Análisis de Riesgo
Lee references/portfolio-risk-metrics.md para marcos de medición de riesgo
Calcula e interpreta métricas de riesgo clave:
Medidas de Volatilidad:
- Beta estimada de la cartera (promedio ponderado de las betas de las posiciones)
- Volatilidades de posiciones individuales
- Desviación estándar de la cartera (si hay datos históricos disponibles)
Riesgo a la Baja:
- Drawdown máximo (del historial de la cartera)
- Drawdown 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 corresponde)
Riesgo de Cola:
- Exposición a posibles eventos de cisne negro
- Riesgo de concentración en una sola acción
- Riesgo de evento sectorial específico
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 máximo: -XX.X%
**Posiciones de Alto Riesgo:**
| Símbolo | % de la 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úa el rendimiento de la cartera utilizando los datos disponibles:
Rendimientos Absolutos:
- G/P no realizado general 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 acumulado en el año
- Rendimientos anualizados a 1, 3 y 5 años
- Compara 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
**G/P 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 Índice de Referencia (si está disponible):**
- Rendimiento de la cartera: +X.X%
- Rendimiento del S&P 500: +Y.Y%
- Alfa: +/- Z.Z%
Paso 4: Análisis de Posiciones Individuales
Para las posiciones clave (las 10-15 principales por peso en la cartera), realiza un análisis detallado:
Lee references/position-evaluation.md para el marco de análisis de posiciones
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)
- ¿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.)
- Compara con el rango de valoración histórico
- Compara con pares del sector
- Evaluación de Sobrevalorado / Justo / Infravalorado
4.3 Salud Técnica:
- Tendencia del precio (alcista, bajista, lateral)
- Posición relativa a las medias móviles
- Niveles de soporte y resistencia
- Estado del momento
4.4 Tamaño de la 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 un tamaño adecuado y la tesis está intacta
- AUMENTAR - 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
- G/P 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:** [Infravalorada / Justa / Sobrevalorada]
- **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
Lee references/rebalancing-strategies.md para enfoques de reequilibrio
Genera recomendaciones de reequilibrio específicas:
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 (superaron el umbral)
- Áreas infraponderadas para agregar (por debajo del umbral)
- Consideraciones fiscales (implicaciones de ganancias de capital)
5.2 Desarrollar un Plan de Reequilibrio:
Posiciones a REDUCIR:
- Posiciones sobreponderadas (>desviación del umbral del objetivo)
- Acciones que han subido significativamente (preocupaciones de valoración)
- Posiciones concentradas que superan el 15-20% de la cartera
- Posiciones con tesis rota
Posiciones a 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), sugiere su despliegue
- Prioriza según la oportunidad y las brechas de asignación
5.3 Priorización: Clasifica las acciones de reequilibrio por prioridad:
- Inmediata - Reducción de riesgo (recortar posiciones concentradas)
- Alta Prioridad - Desviación importante de la asignación (>10% del objetivo)
- Prioridad Media - Desviación moderada (5-10% del objetivo)
- Baja Prioridad - Ajustes finos y oportunistas
Salida:
## Recomendaciones de Reequilibrio
### Resumen
- **Reequilibrio 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
**AUMENTAR 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 corresponde]
Paso 6: Generar Informe de Cartera
Crea 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:** AAAA-MM-DD
**Valor de la Cartera:** $XXX,XXX
**G/P Total:** $XX,XXX (+XX.X%)
---
## Resumen Ejecutivo
[3-5 viñetas resumiendo hallazgos clave]
- Evaluación general de la salud de la cartera
- Principales fortalezas
- 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 del Paso 3.4]
---
## Análisis de Posiciones
[Análisis del Paso 4 para las principales 10-15 posiciones]
---
## Recomendaciones de Reequilibrio
[Sección del Paso 5]
---
## Apéndice
- Metodología
- Fuentes de datos
- Supuestos
- Limitaciones
Paso 7: Archivos de Referencia
Esta habilidad utiliza los siguientes archivos de referencia en el repositorio:
- references/asset-allocation.md - Marcos de asignación de activos objetivo para diferentes perfiles de riesgo
- references/diversification-principles.md - Teoría y principios de diversificación de cartera
- references/portfolio-risk-metrics.md - Métodos de medición de riesgo y benchmarks
- references/position-evaluation.md - Marco de análisis de posiciones individuales
- references/rebalancing-strategies.md - Enfoques y umbrales de reequilibrio
- references/alpaca_mcp_setup.md - Configuración del servidor MCP de Alpaca