¿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 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 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 Alpacaen lugar de MCP. - Use
ALPACA_PAPER=truepara 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-monitoren lugar de tratar la revisión de dividendos como una sección solo narrativa. También construya una entrada de planificación fiscal parakanchi-dividend-us-tax-accountingcuando 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:
- Inmediata - Reducción de riesgo (recortar 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 oportunistas
Salida:
## Recomendaciones de Reequilibrio
### Resumen
...