Gestionnaire de Portefeuille
Aperçu
Analysez et gérez des portefeuilles d'investissement en vous intégrant au serveur Alpaca MCP pour récupérer les données en temps réel des avoirs, puis en effectuant une analyse complète couvrant la répartition d'actifs, la diversification, les indicateurs de risque, l'évaluation individuelle des positions et les recommandations de rééquilibrage. Générez des rapports de portefeuille détaillés avec des informations exploitables.
Cette compétence exploite l'API de courtage d'Alpaca via MCP (Model Context Protocol) pour accéder aux données de portefeuille en direct, garantissant que l'analyse est basée sur des positions réelles et actuelles plutôt que sur des données saisies manuellement.
Quand l'utiliser
Invoquez cette compétence lorsque l'utilisateur demande :
- "Analysez mon portefeuille"
- "Révisez mes positions actuelles"
- "Quelle est ma répartition d'actifs ?"
- "Vérifiez le risque de mon portefeuille"
- "Devrais-je rééquilibrer mon portefeuille ?"
- "Évaluez mes avoirs"
- "Examen de la performance du portefeuille"
- "Quelles actions devrais-je acheter ou vendre ?"
- Toute demande impliquant une analyse ou une gestion au niveau du portefeuille
Prérequis
Configuration du serveur Alpaca MCP
Cette compétence nécessite que le serveur Alpaca MCP soit configuré et connecté. Le serveur MCP donne accès à :
- Positions actuelles du portefeuille
- Capitaux propres et pouvoir d'achat du compte
- Positions et transactions historiques
- Données de marché pour les titres détenus
Outils du serveur MCP utilisés :
get_account_info- Récupère les capitaux propres, le pouvoir d'achat, le solde en espèces du compteget_positions- Récupère toutes les positions actuelles avec les quantités, le coût de base, la valeur de marchéget_portfolio_history- Données historiques de performance du portefeuille- Outils de données de marché pour les cotations de prix et les fondamentaux
Si le serveur Alpaca MCP n'est pas connecté, informez l'utilisateur et fournissez les instructions de configuration à partir de references/alpaca_mcp_setup.md.
Flux de travail
Étape 1 : Récupérer les données du portefeuille via Alpaca MCP
Utilisez les outils du serveur Alpaca MCP pour rassembler les informations actuelles du portefeuille :
1.1 Obtenir les informations du compte :
Utilisez mcp__alpaca__get_account_info pour récupérer :
- Capitaux propres du compte (valeur totale du portefeuille)
- Solde en espèces
- Pouvoir d'achat
- Statut du compte
1.2 Obtenir les positions actuelles :
Utilisez mcp__alpaca__get_positions pour récupérer tous les avoirs :
- Symbole ticker
- Quantité détenue
- Prix d'entrée moyen (coût de base)
- Prix actuel du marché
- Valeur actuelle du marché
- P&L non réalisé ($ et %)
- Taille de la position en % du portefeuille
1.3 Obtenir l'historique du portefeuille (optionnel) :
Utilisez mcp__alpaca__get_portfolio_history pour l'analyse de performance :
- Valeurs historiques des capitaux propres
- Calcul du rendement pondéré dans le temps
- Analyse des pertes maximales
Validation des données :
- Vérifiez que toutes les positions ont des symboles ticker valides
- Confirmez que les valeurs de marché totalisent approximativement les capitaux propres du compte
- Vérifiez la présence de positions obsolètes ou inactives
- Gérez les cas particuliers (actions fractionnaires, options, crypto si supporté)
Étape 2 : Enrichir les données des positions
Pour chaque position du portefeuille, rassemblez des données de marché et fondamentales supplémentaires :
2.1 Données de marché actuelles :
- Cotations de prix en temps réel ou différé
- Volume quotidien et indicateurs de liquidité
- Plage sur 52 semaines
- Capitalisation boursière
2.2 Données fondamentales : Utilisez WebSearch ou les API de données de marché disponibles pour récupérer :
- Classification par secteur et industrie
- Indicateurs de valorisation clés (P/E, P/B, rendement du dividende)
- Résultats récents et indicateurs de santé financière
- Notes des analystes et objectifs de prix
- Nouvelles récentes et développements importants
2.3 Analyse technique :
- Tendance des prix (moyennes mobiles sur 20, 50, 200 jours)
- Force relative
- Niveaux de support et de résistance
- Indicateurs de momentum (RSI, MACD si disponibles)
Étape 3 : Analyse au niveau du portefeuille
Effectuez une analyse complète du portefeuille en utilisant les cadres des fichiers de référence :
3.1 Analyse de la répartition d'actifs
Lisez references/asset-allocation.md pour les cadres de répartition
Analysez la répartition actuelle selon plusieurs dimensions :
Par classe d'actifs :
- Actions vs Revenu fixe vs Espèces vs Alternatives
- Comparez à la répartition cible pour le profil de risque de l'utilisateur
- Évaluez si la répartition correspond aux objectifs d'investissement
Par secteur :
- Technologie, Santé, Finance, Consommation, etc.
- Identifiez les risques de concentration sectorielle
- Comparez aux pondérations sectorielles de référence (par exemple, S&P 500)
Par capitalisation boursière :
- Grande capitalisation vs Moyenne capitalisation vs Petite capitalisation
- Concentration dans les méga-capitalisations
- Score de diversification de la capitalisation boursière
Par géographie :
- États-Unis vs International vs Marchés émergents
- Évaluation du risque de concentration nationale
Format de sortie :
## Répartition d'actifs
### Répartition actuelle vs cible
| Classe d'actifs | Actuelle | Cible | Écart |
|-----------------|----------|-------|-------|
| Actions US | XX.X% | YY.Y% | +/- Z.Z% |
| ... |
### Répartition sectorielle
[Description du graphique en camembert ou tableau avec les pourcentages sectoriels]
### Top 10 des avoirs
| Rang | Symbole | % du portefeuille | Secteur |
|------|---------|-------------------|---------|
| 1 | AAPL | X.X% | Technologie |
| ... |
3.2 Analyse de la diversification
Lisez references/diversification-principles.md pour la théorie de la diversification
Évaluez la qualité de la diversification du portefeuille :
Concentration des positions :
- Identifiez les principaux avoirs et leur pondération agrégée
- Signalez si une seule position dépasse 10-15 % du portefeuille
- Calculez l'indice Herfindahl-Hirschman (HHI) pour mesurer la concentration
Concentration sectorielle :
- Identifiez les secteurs dominants
- Signalez si un secteur dépasse 30-40 % du portefeuille
- Comparez à la diversité sectorielle de référence
Analyse de corrélation :
- Estimez la corrélation entre les positions principales
- Identifiez les avoirs fortement corrélés (redondance potentielle)
- Évaluez le véritable avantage de la diversification
Nombre de positions :
- Plage optimale : 15-30 actions pour les portefeuilles individuels
- Signalez si sous-diversifié (moins de 10 actions) ou sur-diversifié (plus de 50 actions)
Sortie :
## Évaluation de la diversification
**Risque de concentration :** [Faible / Moyen / Élevé]
- Les 5 principaux avoirs représentent XX % du portefeuille
- Plus grande position unique : [SYMBOLE] à XX %
**Diversification sectorielle :** [Excellente / Bonne / Correcte / Faible]
- Secteur dominant : [Nom du secteur] à XX %
- [Évaluation de l'équilibre entre les secteurs]
**Nombre de positions :** [Optimal / Sous-diversifié / Sur-diversifié]
- Nombre total de positions : XX actions
- [Recommandation]
**Problèmes de corrélation :**
- [Listez les paires de positions fortement corrélées]
- [Suggestions d'amélioration de la diversification]
3.3 Analyse des risques
Lisez references/portfolio-risk-metrics.md pour les cadres de mesure des risques
Calculez et interprétez les indicateurs de risque clés :
Mesures de volatilité :
- Bêta estimé du portefeuille (moyenne pondérée des bêtas des positions)
- Volatilités individuelles des positions
- Écart-type du portefeuille (si données historiques disponibles)
Risque de baisse :
- Perte maximale (à partir de l'historique du portefeuille)
- Perte actuelle par rapport au sommet
- Positions avec des pertes non réalisées significatives
Concentration du risque :
- Pourcentage dans les actions à haute volatilité (bêta > 1,5)
- Pourcentage dans les entreprises spéculatives/non rentables
- Utilisation de l'effet de levier (le cas échéant)
Risque extrême :
- Exposition à des événements potentiels de type "cygne noir"
- Risque de concentration sur une seule action
- Risque d'événement spécifique à un secteur
Sortie :
## Évaluation des risques
**Profil de risque global :** [Conservateur / Modéré / Agressif]
**Bêta du portefeuille :** X.XX (vs marché à 1,00)
- Interprétation : Le portefeuille est [plus/moins] volatil que le marché
**Perte maximale :** -XX, X% (de XXX XXX $ à XXX XXX $)
- Perte actuelle par rapport au sommet : -XX, X%
**Positions à haut risque :**
| Symbole | % du portefeuille | Bêta | Facteur de risque |
|---------|-------------------|------|-------------------|
| [TICKER] | XX% | X.XX | [Haute volatilité / Perte récente / etc] |
**Concentrations de risque :**
- XX% dans un seul secteur ([Secteur])
- XX% dans des actions avec un bêta > 1,5
- [Autres risques de concentration]
**Score de risque :** XX/100 ([Faible/Moyen/Élevé] risque)
3.4 Analyse de la performance
Évaluez la performance du portefeuille à l'aide des données disponibles :
Rendements absolus :
- P&L non réalisé global du portefeuille ($ et %)
- Meilleures positions (top 5 par % de gain)
- Pires positions (bottom 5 par % de perte)
Rendements pondérés dans le temps (si historique disponible) :
- Rendement depuis le début de l'année
- Rendements annualisés sur 1 an, 3 ans, 5 ans
- Comparez à un indice de référence (S&P 500, indice pertinent)
Performance au niveau des positions :
- Ratio gagnants vs perdants
- Gain moyen sur les positions gagnantes
- Perte moyenne sur les positions perdantes
- Positions proches des plus hauts/plus bas sur 52 semaines
Sortie :
## Examen de la performance
**Valeur totale du portefeuille :** XXX XXX $
**P&L non réalisé total :** XX XXX $ (+XX.X%)
**Solde en espèces :** XX XXX $ (XX% du portefeuille)
**Meilleurs performers :**
| Symbole | Gain | Valeur de la position |
|---------|------|-----------------------|
| [TICKER] | +XX.X% | XX XXX $ |
| ... |
**Pires performers :**
| Symbole | Perte | Valeur de la position |
|---------|-------|-----------------------|
| [TICKER] | -XX.X% | XX XXX $ |
| ... |
**Performance vs indice de référence (si disponible) :**
- Rendement du portefeuille : +X.X%
- Rendement du S&P 500 : +Y.Y%
- Alpha : +/- Z.Z%
Étape 4 : Analyse individuelle des positions
Pour les positions clés (top 10-15 par pondération du portefeuille), effectuez une analyse détaillée :
Lisez references/position-evaluation.md pour le cadre d'analyse des positions
Pour chaque position significative :
4.1 Validation de la thèse actuelle :
- Pourquoi cette position a-t-elle été initiée ? (si connu du contexte utilisateur)
- La thèse d'investissement s'est-elle réalisée ou est-elle rompue ?
- Développements récents de l'entreprise et actualités
4.2 Évaluation de la valorisation :
- Indicateurs de valorisation actuels (P/E, P/B, etc.)
- Comparez à la plage de valorisation historique
- Comparez aux pairs du secteur
- Évaluation Surévaluée / Juste / Sous-évaluée
4.3 Santé technique :
- Tendance du prix (haussière, baissière, latérale)
- Position par rapport aux moyennes mobiles
- Niveaux de support et de résistance
- Statut du momentum
4.4 Taille de la position :
- Pondération actuelle dans le portefeuille
- La taille est-elle appropriée compte tenu de la conviction et du risque ?
- Surpondérée ou sous-pondérée par rapport à l'optimal
4.5 Recommandation d'action :
- CONSERVER - Position bien dimensionnée et thèse intacte
- AJOUTER - Sous-pondérée compte tenu de l'opportunité, thèse se renforçant
- RÉDUIRE - Surpondérée ou valorisation tendue
- VENDRE - Thèse rompue, meilleures opportunités ailleurs
Sortie par position :
### [SYMBOLE] - [Nom de l'entreprise] (XX.X% du portefeuille)
**Détails de la position :**
- Actions : XXX
- Coût moyen : XX,XX $
- Prix actuel : XX,XX $
- Valeur de marché : XX XXX $
- P/L non réalisé : X XXX $ (+XX.X%)
**Aperçu fondamental :**
- Secteur : [Secteur]
- Capitalisation boursière : XX,X Mds $
- P/E : XX.X | Rendement du dividende : X.X%
- Développements récents : [Actualités ou résultats clés]
**Statut technique :**
- Tendance : [Haussière / Baissière / Latérale]
- Prix vs MM50 : [Au-dessus/Au-dessous de XX%]
- Support : XX,XX $ | Résistance : XX,XX $
**Évaluation de la position :**
- **Statut de la thèse :** [Intact / Affaibli / Rompu / Renforcé]
- **Valorisation :** [Sous-évaluée / Juste / Surévaluée]
- **Taille de la position :** [Optimale / Surpondérée / Sous-pondérée]
**Recommandation :** [CONSERVER / AJOUTER / RÉDUIRE / VENDRE]
**Justification :** [Explication en 1-2 phrases]
Étape 5 : Recommandations de rééquilibrage
Lisez references/rebalancing-strategies.md pour les approches de rééquilibrage
Générez des recommandations de rééquilibrage spécifiques :
5.1 Identifier les déclencheurs de rééquilibrage :
- Positions qui ont considérablement dévié des pondérations cibles
- Répartitions sectorielles/classes d'actifs nécessitant un ajustement
- Positions surpondérées à réduire (seuil dépassé)
- Zones sous-pondérées à ajouter (en dessous du seuil)
- Considérations fiscales (implications des gains en capital)
5.2 Élaborer un plan de rééquilibrage :
Positions à RÉDUIRE :
- Positions surpondérées (>écart seuil par rapport à la cible)
- Actions qui ont fortement monté (préoccupations de valorisation)
- Positions concentrées dépassant 15-20% du portefeuille
- Positions avec une thèse rompue
Positions à AJOUTER :
- Secteurs ou classes d'actifs sous-pondérés
- Positions à forte conviction actuellement sous-pondérées
- Nouvelles opportunités pour améliorer la diversification
Déploiement des liquidités :
- Si excès de liquidités (>10% du portefeuille), suggérez un déploiement
- Priorisez en fonction de l'opportunité et des écarts de répartition
5.3 Priorisation : Classez les actions de rééquilibrage par priorité :
- Immédiate - Réduction des risques (réduire les positions concentrées)
- Haute priorité - Déviation majeure de la répartition (>10% par rapport à la cible)
- Priorité moyenne - Déviation modérée (5-10% par rapport à la cible)
- Faible priorité - Ajustements fins et opportunistes
Sortie :
## Recommandations de rééquilibrage
### Résumé
- **Rééquilibrage nécessaire :** [Oui / Non / Optionnel]
- **Raison principale :** [Risque de concentration / Dérive sectorielle / Déploiement de liquidités / etc]
- **Transactions estimées :** X ordres de vente, Y ordres d'achat
### Actions recommandées
#### HAUTE PRIORITÉ : Réduction des risques
**RÉDUIRE [SYMBOLE]** de XX% à YY% du portefeuille
- **Actions à vendre :** XX actions (~XX XXX $)
- **Justification :** [Surpondération / Valorisation étendue / etc]
- **Impact fiscal :** X XXX $ de gain en capital (estimation)
#### PRIORITÉ MOYENNE : Répartition d'actifs
**AJOUTER l'exposition au [Secteur/Classe d'actifs]**
- **Objectif :** Augmenter de XX% à YY%
- **Actions suggérées :** [SYMBOLE1, SYMBOLE2, SYMBOLE3]
- **Montant à investir :** ~XX XXX $
#### DÉPLOIEMENT DE LIQUIDITÉS
**Liquidités actuelles :** XX XXX $ (XX% du portefeuille)
- **Recommandation :** [Déployer / Conserver pour opportunités / Réduire à X%]
- **Répartition suggérée :** [Distribution entre secteurs/actions]
### Plan de mise en œuvre
1. [Première action - priorité la plus élevée]
2. [Deuxième action]
3. [Troisième action]
...
**Considérations temporelles :**
- [Planification de fin d'année fiscale / Saison des résultats / Conditions de marché]
- [Phasage suggéré si applicable]
Étape 6 : Générer un rapport de portefeuille
Créez un rapport complet en markdown enregistré à la racine du référentiel :
Nom de fichier : portfolio_analysis_YYYY-MM-DD.md
Structure du rapport :
# Rapport d'analyse du portefeuille
**Compte :** [Type de compte si disponible]
**Date du rapport :** AAAA-MM-JJ
**Valeur du portefeuille :** XXX XXX $
**P&L total :** XX XXX $ (+XX.X%)
---
## Résumé exécutif
[3-5 points clés résumant les principales conclusions]
- Évaluation globale de la santé du portefeuille
- Principales forces
- Risques ou préoccupations clés
- Recommandations principales
---
## Aperçu des avoirs
[Tableau récapitulatif de toutes les positions]
---
## Répartition d'actifs
[Section de l'étape 3.1]
---
## Analyse de la diversification
[Section de l'étape 3.2]
---
## Évaluation des risques
[Section de l'étape 3.3]
---
## Examen de la performance
[Section de l'étape 3.4]
---
## Analyse des positions principales
[Section de l'étape 4]
---
## Recommandations de rééquilibrage
[Section de l'étape 5]
---
## Avertissement
*Ce rapport est généré à des fins d'information uniquement et ne constitue pas un conseil financier. Consultez un conseiller financier professionnel avant de prendre des décisions d'investissement.*
Fichiers de référence
Cette compétence utilise les fichiers de référence suivants dans le répertoire references/ pour des cadres d'analyse détaillés :
references/asset-allocation.md- Cadres de répartition d'actifs et allocations cibles par profil de risquereferences/diversification-principles.md- Principes et indicateurs de diversificationreferences/portfolio-risk-metrics.md- Mesures et interprétations des risquesreferences/rebalancing-strategies.md- Stratégies et seuils de rééquilibragereferences/position-evaluation.md- Cadre d'évaluation détaillée des positionsreferences/alpaca_mcp_setup.md- Instructions de configuration du serveur Alpaca MCP
Lisez ces fichiers de référence pendant l'analyse pour garantir l'application des meilleures pratiques de l'industrie.
Considérations sur l'intégrité des données
- Utilisez toujours les données d'API en direct du serveur MCP plutôt que des données saisies manuellement
- Les prix du marché peuvent être différés si vous utilisez un compte gratuit Alpaca
- La performance passée ne garantit pas les résultats futurs
- Les recommandations sont basées uniquement sur l'analyse quantitative et non sur des conseils financiers personnalisés
- Vérifiez les positions en attente de règlement ou non réglées qui pourraient affecter la répartition réelle du portefeuille
Gestion des erreurs
- Erreur de connexion MCP : Informez l'utilisateur d'activer le serveur Alpaca MCP et de suivre les instructions de configuration
- Aucune position : Si aucune position n'est trouvée, suggérez que le portefeuille peut être entièrement en espèces ou que les données doivent être vérifiées
- Données partielles : Si certaines données fondamentales ne sont pas disponibles, notez-le et procédez avec les données disponibles
- Données historiques insuffisantes : Utilisez les approximations disponibles et notez les limites
- Positions Actions non supportées : Option, crypto et autres instruments non standards peuvent avoir une analyse limitée ; notez ces limites