Communitygithub.com

Gestionnaire de Portefeuille

Analyse complète de portefeuille utilisant l'intégration d'Alpaca MCP Server pour récupérer les avoirs et positions, puis analyser l'allocation d'actifs, les métriques de risque, les positions individuelles en actions, la diversification et générer des recommandations de rééquilibrage. À utiliser lorsque l'utilisateur demande une revue de portefeuille, une analyse de position, une évaluation des risques, une évaluation de performance ou des suggestions de rééquilibrage pour son compte de courtage.

Qu'est-ce que Gestionnaire de Portefeuille ?

Cette compétence permet d'analyser et de gérer des portefeuilles d'investissement en s'intégrant à Alpaca MCP Server pour récupérer les données de portefeuille en temps réel, puis effectuer une analyse complète couvrant l'allocation d'actifs, la diversification, les métriques de risque, l'évaluation individuelle des positions et les recommandations de rééquilibrage. Elle génère des rapports de portefeuille détaillés avec des informations exploitables. La compétence exploite l'API de courtage d'Alpaca via MCP pour accéder aux données de portefeuille en direct, garantissant que l'analyse est basée sur les positions réelles plutôt que sur des données saisies manuellement. Elle prend en charge les plateformes utilisant le protocole MCP, comme Claude Code, et nécessite qu'Alpaca MCP Server soit configuré et connecté.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/leecyno1/boutique-skills/tree/HEAD/skills/default/portfolio-manager

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait Gestionnaire de Portefeuille ?

Vue d'Ensemble

Analyser et gérer des portefeuilles d'investissement en s'intégrant à Alpaca MCP Server pour récupérer des données de portefeuille en temps réel, puis effectuer une analyse complète couvrant l'allocation d'actifs, la diversification, les métriques de risque, l'évaluation individuelle des positions et les recommandations de rééquilibrage. Générer 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 les positions réelles plutôt que sur des données saisies manuellement.

Quand l'Utiliser

Invoquez cette compétence lorsque l'utilisateur demande :

  • "Analysez mon portefeuille"
  • "Passez en revue mes positions actuelles"
  • "Quelle est mon allocation d'actifs ?"
  • "Vérifiez le risque de mon portefeuille"
  • "Devrais-je rééquilibrer mon portefeuille ?"
  • "Évaluez mes avoirs"
  • "Revue de 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 d'Alpaca MCP Server

Cette compétence nécessite que Alpaca MCP Server soit configuré et connecté. Le serveur MCP fournit l'accès à :

  • Les positions actuelles du portefeuille
  • Les capitaux propres du compte et le pouvoir d'achat
  • Les positions et transactions historiques
  • Les données de marché pour les titres détenus

Outils du Serveur MCP Utilisés :

  • get_account_info - Récupérer les capitaux propres du compte, le pouvoir d'achat, le solde en espèces
  • get_positions - Récupérer toutes les positions actuelles avec les quantités, le coût de base, la valeur de marché
  • get_portfolio_history - Données de performance historique du portefeuille
  • Outils de données de marché pour les cotations et fondamentaux

Si Alpaca MCP Server n'est pas connecté, informez l'utilisateur et fournissez des 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 du ticker
- Quantité détenue
- Prix d'entrée moyen (coût de base)
- Prix de marché actuel
- Valeur de marché actuelle
- 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 de baisse

Validation des Données :

  • Vérifiez que toutes les positions ont des symboles de 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 fractionnées, options, crypto si pris en charge)

É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 en temps réel ou différées
  • Volume quotidien et métriques de liquidité
  • Fourchette 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 sectorielle et industrielle
  • Principales métriques de valorisation (P/E, P/B, rendement du dividende)
  • Résultats récents et indicateurs de santé financière
  • Évaluations des analystes et objectifs de prix
  • Actualités récentes et développements matériels

2.3 Analyse Technique :

  • Tendance des prix (moyennes mobiles sur 20 jours, 50 jours, 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 l'Allocation d'Actifs

Lisez references/asset-allocation.md pour les cadres d'allocation

Analysez l'allocation actuelle selon plusieurs dimensions :

Par Classe d'Actifs :

  • Actions vs Revenu Fixe vs Trésorerie vs Alternatives
  • Comparez à l'allocation cible pour le profil de risque de l'utilisateur
  • Évaluez si l'allocation 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 :

  • Distribution Grandes vs Moyennes vs Petites capitalisations
  • Concentration dans les méga-capitalisations
  • Score de diversification par capitalisation boursière

Par Géographie :

  • États-Unis vs International vs Marchés Émergents
  • Évaluation du risque de concentration nationale

Format de Sortie :

## Allocation d'Actifs

### Allocation Actuelle vs Cible
| Classe d'Actifs | Actuelle | Cible | Écart |
|-----------------|----------|-------|-------|
| Actions US | XX.X% | YY.Y% | +/- Z.Z% |
| ... |

### Répartition Sectorielle
[Description de diagramme circulaire ou tableau avec 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 poids agrégé
  • 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 principales positions
  • 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é (<10 actions) ou sur-diversifié (>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 / Acceptable / Mauvaise]
- Secteur dominant : [Nom du Secteur] à XX %
- [Évaluation de l'équilibre entre les secteurs]

**Nombre de Positions :** [Optimal / Sous-diversifié / Sur-diversifié]
- Total des positions : XX actions
- [Recommandation]

**Préoccupations 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 principales métriques de risque :

Mesures de Volatilité :

  • Bêta estimé du portefeuille (moyenne pondérée des bêtas des positions)
  • Volatilité individuelle des positions
  • Écart type du portefeuille (si des données historiques sont disponibles)

Risque de Baisse :

  • Baisse maximale (à partir de l'historique du portefeuille)
  • Baisse actuelle par rapport au pic
  • Positions avec des pertes non réalisées significatives

Concentration du Risque :

  • Pourcentage dans les actions à forte volatilité (bêta > 1,5)
  • Pourcentage dans les entreprises spéculatives/non rentables
  • Utilisation de l'effet de levier (le cas échéant)

Risque de Queue :

  • Exposition à d'éventuels événements 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é

**Baisse Maximale :** -XX.X% (de $XXX,XXX à $XXX,XXX)
- Baisse actuelle par rapport au pic : -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 bêta > 1,5
- [Autres risques de concentration]

**Score de Risque :** XX/100 ([Faible/Moyen/Élevé] risque)

3.4 Analyse de Performance

Évaluez la performance du portefeuille en utilisant les données disponibles :

Rendements Absolus :

  • P&L non réalisé global du portefeuille ($ et %)
  • Positions les plus performantes (top 5 en % de gain)
  • Positions les moins performantes (bottom 5 en % 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 à la 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 :

## Revue de 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 Performeurs :**
| Symbole | Gain | Valeur de la Position |
|---------|------|-----------------------|
| [TICKER] | +XX.X% | $XX,XXX |
| ... |

**Moins Performants :**
| Symbole | Perte | Valeur de la Position |
|---------|-------|-----------------------|
| [TICKER] | -XX.X% | $XX,XXX |
| ... |

**Performance vs Référence (si disponible) :**
- Rendement du portefeuille : +X.X%
- Rendement S&P 500 : +Y.Y%
- Alpha : +/- Z.Z%

Étape 4 : Analyse Individuelle des Positions

Pour les positions clés (top 10-15 par poids dans le portefeuille), effectuez une analyse détaillée :

Lisez references/position-evaluation.md pour le cadre d'analyse de position

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 brisée ?
  • Développements récents de l'entreprise et actualités

4.2 Évaluation de la Valorisation :

  • Métriques de valorisation actuelles (P/E, P/B, etc.)
  • Comparez à la fourchette de valorisation historique
  • Comparez aux pairs du secteur
  • Évaluation Surévalué / Juste / Sous-évalué

4.3 Santé Technique :

  • Tendance des prix (haussière, baissière, latérale)
  • Position relative aux moyennes mobiles
  • Niveaux de support et de résistance
  • Statut du momentum

4.4 Taille de la Position :

  • Poids actuel dans le portefeuille
  • La taille est-elle appropriée compte tenu de la conviction et du risque ?
  • Surpondéré ou sous-pondéré par rapport à l'optimal

4.5 Recommandation d'Action :

  • CONSERVER - Position bien dimensionnée et thèse intacte
  • AJOUTER - Sous-pondéré compte tenu de l'opportunité, thèse se renforce
  • RÉDUIRE - Surpondéré ou valorisation étirée
  • VENDRE - Thèse brisée, de 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.XB
- P/E : XX.X | Rendement du Dividende : X.X%
- Développements récents : [Actualités clés ou résultats]

**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 :** [Intacte / Faiblissante / Brisée / Renforcée]
- **Valorisation :** [Sous-évaluée / Juste / Surévaluée]
- **Dimensionnement de la Position :** [Optimal / Surpondéré / Sous-pondéré]

**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 dérivé de manière significative par rapport aux poids cibles
  • Allocations sectorielles/classe 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 Développer un Plan de Rééquilibrage :

Positions à RÉDUIRE :

  • Positions surpondérées (>écart seuil par rapport à la cible)
  • Actions qui ont fortement augmenté (préoccupations de valorisation)
  • Positions concentrées dépassant 15-20 % du portefeuille
  • Positions avec une thèse brisée

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 de Trésorerie :

  • Si l'excédent de trésorerie (>10 % du portefeuille), suggérez un déploiement
  • Priorisez en fonction de l'opportunité et des lacunes d'allocation

5.3 Priorisation : Classez les actions de rééquilibrage par priorité :

  1. Immédiat - Réduction des risques (réduire les positions concentrées)
  2. Haute Priorité - Dérive d'allocation majeure (>10 % de la cible)
  3. Priorité Moyenne - Dérive modérée (5-10 % de la cible)
  4. 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 trésorerie / 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éré / Valorisation étirée / etc]
- **Impact Fiscal :** $X,XXX de gain en capital (estimation)

#### PRIORITÉ MOYENNE : Allocation d'Actifs
**AJOUTER** exposition au [Secteur/Classe d'Actifs]
- **Cible :** Augmenter de XX% à YY%
- **Actions Suggérées :** [SYMBOLE1, SYMBOLE2, SYMBOLE3]
- **Montant à Investir :** ~$XX,XXX

#### DÉPLOIEMENT DE TRÉSORERIE
**Trésorerie Actuelle :** $XX,XXX (XX% du portefeuille)
- **Recommandation :** [Déployer / Garder pour opportunités / Réduire à X%]
- **Allocation 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é le cas échéant]

Étape 6 : Générer le Rapport de Portefeuille

Créez un rapport détaillé en markdown enregistré à la racine du référentiel :

Nom du fichier : portfolio_analysis_YYYY-MM-DD.md

Structure du Rapport :

# Rapport d'Analyse de Portefeuille

**Compte :** [Type de compte si disponible]
**Date du Rapport :** YYYY-MM-DD
**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
- Principaux points forts
- Risques ou préoccupations clés
- Recommandations principales

---

## Aperçu des Avoirs

[Tableau récapitulatif de toutes les positions]

---

## Allocation 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]

---

## Revue de Performance
[Section de l'Étape 3.4]

---

## Analyse Individuelle des Positions
[Section de l'Étape 4 pour chaque position significative]

---

## Recommandations de Rééquilibrage
[Section de l'Étape 5]

---

## Prochaines Étapes

1. [Action prioritaire la plus élevée]
2. [Action suivante]
3. [Action finale]

---
*Rapport généré par le Gestionnaire de Portefeuille. Ce n'est pas un conseil financier.*

Références

Les fichiers suivants dans le répertoire /references fournissent des cadres d'analyse détaillés :

  • references/asset-allocation.md - Cadres d'allocation d'actifs et allocations cibles par profil de risque
  • references/diversification-principles.md - Théorie de la diversification et meilleures pratiques
  • references/portfolio-risk-metrics.md - Mesures de risque de portefeuille et interprétations
  • references/position-evaluation.md - Cadre d'évaluation de positions individuelles
  • references/rebalancing-strategies.md - Stratégies et approches de rééquilibrage
  • references/alpaca_mcp_setup.md - Guide de configuration d'Alpaca MCP Server

Exemple d'Interaction

Utilisateur : "Analysez mon portefeuille"

Assistant : Je vais analyser votre portefeuille en utilisant Alpaca MCP Server. Commençons par récupérer vos données.

Étape 1 : Récupération des données du compte et des positions

  • Récupération des informations du compte... Terminé
  • Récupération des positions actuelles... Terminé (15 positions trouvées)
  • Récupération de l'historique du portefeuille... Terminé

Étape 2 : Enrichissement des positions avec des données de marché et fondamentales

  • Récupération des données de marché pour 15 positions... Terminé
  • Récupération des fondamentaux... Terminé

Étape 3-6 : Analyse complète et génération du rapport

Rapport généré : portfolio_analysis_2024-01-15.md


Résumé Exécutif

  • Santé du Portefeuille : Bonne, mais avec un certain risque de concentration
  • Points Forts : Bien diversifié entre les secteurs, faible exposition aux devises
  • Préoccupations : AAPL et MSFT représentent ensemble 22,5 % du portefeuille
  • Recommandation : Envisagez de réduire les positions concentrées et d'augmenter l'allocation aux actions internationales

Voulez-vous que je détaille l'un de ces points ou que je passe aux recommandations de rééquilibrage ?

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

leecyno1/boutique-skills

Review fixed income portfolios by pricing multiple bonds, retrieving reference data, analyzing cashflows, and running scenario analysis. Use when reviewing bond portfolios, computing portfolio duration and DV01, analyzing cashflow waterfalls, stress testing rate scenarios, or assessing portfolio composition.

leecyno1/boutique-skills

Track and analyze portfolio company performance against plan. Ingests monthly/quarterly financial packages (Excel, PDF), extracts KPIs, flags variances to budget, and produces summary dashboards. Use when reviewing portfolio company financials, preparing board materials, or monitoring covenant compliance. Triggers on "review portfolio company", "monthly financials", "how is [company] performing", "covenant check", or "portfolio update".

leecyno1/boutique-skills

Analyze portfolio allocation drift and generate rebalancing trade recommendations across accounts. Considers tax implications, transaction costs, and wash sale rules. Triggers on "rebalance", "portfolio drift", "allocation check", "rebalancing trades", or "my portfolio is out of balance".

leecyno1/boutique-skills

Router skill for LLMQuant portfolio-lab workflows. Use when the user needs portfolio exposure maps, what-if simulations, scenario states, or virtual portfolio comparisons.

leecyno1/boutique-skills

Router skill for LLMQuant portfolio workflows. Use when the user needs company profiles, thesis tracking, theme research, watchlist monitoring, or alert management.

leecyno1/boutique-skills

Best practices for Remotion - Video creation in React

leecyno1/boutique-skills

Agent skill at skills/default/video-autopilot-kit/SKILL.md

Skills associés