Guide d'utilisation de cn-funds-mcp
Référence rapide des outils
Recherche de fonds
| Outil | Utilisation | Paramètres clés |
|---|---|---|
search_fund | Rechercher un fonds (nom/code/pinyin) | keyword |
get_fund_estimate | Valorisation en temps réel (estimation intraday et variation) | fundCode |
get_fund_batch_info | Obtenir les valeurs liquidatives de plusieurs fonds en lot | fundCodes (séparés par des virgules) |
get_fund_info | Détails du fonds (type/société/gestionnaire/taille/classement) | fundCode |
get_fund_valuation_detail | Courbe de valorisation du jour (intraday) | fundCode |
get_fund_net_value_history | Historique des valeurs liquidatives | fundCode, range |
get_fund_accumulated_performance | Performance cumulée vs CSI 300 vs catégorie | fundCode, range |
get_fund_position | Détail des actions en portefeuille | fundCode |
get_fund_manager_list | Liste des gestionnaires successifs | fundCode |
get_fund_manager_detail | Présentation du gestionnaire actuel | fundCode |
Actions/Indices
| Outil | Utilisation | Paramètres clés |
|---|---|---|
get_stock_trend | Tendance intraday | secid (ex. 1.600519) |
get_stock_quote | Cours en temps réel | secids (séparés par des virgules) |
Marché/Capitaux
| Outil | Utilisation | Paramètres clés |
|---|---|---|
get_market_overview | Aperçu du marché A (Shanghai/Shenzhen) | Aucun |
get_market_capital_flow | Flux de capitaux du marché (ordres importants/petits) | Aucun |
get_sector_capital_flow | Classement sectoriel des flux de capitaux | timeType, code |
get_northbound_capital | Flux de capitaux nordiques (Hong Kong-Shanghai-Shenzhen) | Aucun |
Gestion de portefeuille
| Outil | Utilisation | Paramètres clés |
|---|---|---|
save_portfolio | Enregistrer/mettre à jour une ligne de portefeuille | fundCode, shares, costPrice |
remove_portfolio | Supprimer une ligne de portefeuille | fundCode |
get_portfolio | Voir la liste du portefeuille | Aucun |
get_portfolio_profit | Consulter en un clic le profit du jour et le total | Aucun |
Rappels programmés
| Outil | Utilisation | Paramètres clés |
|---|---|---|
set_reminder | Configurer un rappel (déclenché chaque jour de bourse) | time(HH:MM), type, message |
get_reminders | Voir tous les rappels configurés | Aucun |
remove_reminder | Supprimer un rappel | id |
check_reminders | Vérifier s'il y a des rappels à déclencher | Aucun |
Types de rappel type :
profit_report— Bulletin des profits du portefeuille (déclenche la consultation deget_portfolio_profit, suggestions d'achat/vente)market_report— Bulletin des marchés (déclenche la consultation de l'aperçu marché + flux de capitaux)custom— Rappel personnalisé (avec le paramètremessage)
Explication des paramètres courants
Code de fonds fundCode : 6 chiffres, ex. 161725 (Zhaoshang Baijiu), 110011 (Yifangda Small Cap)
ID de titre secid : Format marché.code
| Code marché | Signification | Exemple |
|---|---|---|
1. | Bourse de Shanghai | 1.000001 (indice Shanghai), 1.600519 (Kweichow Moutai) |
0. | Bourse de Shenzhen | 0.399001 (indice Shenzhen), 0.000858 (Wuliangye) |
116. | Bourse de Hong Kong | 116.01810 (Xiaomi Group) |
Période range : m=1 mois, q=3 mois, hy=6 mois, y=1 an, 2y=2 ans, 3y=3 ans, 5y=5 ans
Comportements actifs (important)
Au début de chaque conversation, check_reminders doit être appelé
Peu importe ce que dit l'utilisateur, avant de répondre, appelez d'abord check_reminders pour vérifier s'il y a des rappels à déclencher. Si un rappel est à déclencher, exécutez les règles suivantes :
-
À l'échéance de
profit_report:- Appelez
get_portfolio_profitpour obtenir les données de profit - Appelez
get_market_overviewpour le contexte du marché - Présentez à l'utilisateur un résumé convivial des profits du portefeuille du jour
- Proposez des suggestions pour chaque fonds :
- Baisse > 2 % : "Envisagez un achat supplémentaire pour réduire le coût moyen"
- Hausse > 3 % : "Fort gain, envisagez de prendre partiellement vos bénéfices"
- Perte totale > 10 % : "Perte importante, évaluez s'il faut conserver"
- Gain total > 20 % : "Gain appréciable, envisagez de prendre vos bénéfices par étapes"
- Demandez enfin à l'utilisateur s'il souhaite ajuster son portefeuille
- Appelez
-
À l'échéance de
market_report:- Appelez
get_market_overview+get_market_capital_flow+get_northbound_capital - Rapport sur les indices, flux de capitaux et dynamique des capitaux nordiques
- Appelez
-
À l'échéance de
custom:- Affichez le contenu du rappel personnalisé à l'utilisateur
S'il n'y a aucun rappel à déclencher, traitez normalement la demande de l'utilisateur.
Scénarios typiques
L'utilisateur ne connaît pas le code du fonds
Utilisez d'abord search_fund pour rechercher, puis utilisez le code retourné pour appeler d'autres outils.
L'utilisateur demande "Comment est le marché aujourd'hui ?"
Appelez successivement get_market_overview + get_market_capital_flow, et présentez un rapport complet : niveaux d'indices, variations, volume d'échanges, flux de capitaux.
L'utilisateur demande "Combien ai-je gagné aujourd'hui ?"
Appelez directement get_portfolio_profit, qui retourne le profit du jour pour chaque fonds et un résumé. S'il n'y a aucune ligne de portefeuille, guidez l'utilisateur pour en ajouter avec save_portfolio.
L'utilisateur fournit des informations de portefeuille
Extrayez le code du fonds, le nombre de parts et le coût unitaire, puis appelez save_portfolio pour chaque ligne. Le paramètre de nom peut être omis, l'outil le complétera automatiquement.
L'utilisateur souhaite importer son portefeuille rapidement (reconnaissance de capture d'écran)
Si le modèle actuel prend en charge la reconnaissance d'image (OCR), proposez activement à l'utilisateur : vous pouvez directement télécharger une capture d'écran de votre portefeuille depuis une application de fonds (ex. Tiantian Fund, Alipay, Ant Fortune, etc.). L'IA reconnaîtra automatiquement les codes, noms, parts et coûts des fonds dans l'image, puis appellera save_portfolio pour chaque ligne pour importer le portefeuille en lot, sans saisie manuelle.
Processus :
- Reconnaissez les informations de chaque fonds sur la capture (code, parts, coût)
- Pour les champs incomplets (ex. nom seul sans code), utilisez
search_fundpour compléter le code - Appelez
save_portfoliopour chaque ligne pour enregistrer - Une fois terminé, présentez la liste du portefeuille importé et demandez à l'utilisateur de vérifier s'il manque ou si des erreurs subsistent
L'utilisateur demande une analyse complète d'un fonds
Combinez les appels : get_fund_info + get_fund_estimate + get_fund_position + get_fund_accumulated_performance, pour une analyse multidimensionnelle (fondamentaux, valorisation, portefeuille, historique).
L'utilisateur dit "Configure-moi un rappel de profit tous les après-midi"
Appelez set_reminder avec les paramètres time="14:30", type="profit_report". Chaque jour de bourse, la première conversation après 14:30 déclenchera automatiquement le bulletin de profit et les suggestions.
Exemple de bulletin après déclenchement d'un rappel
Bonjour ! Il est 14:30, voici le bulletin de votre portefeuille aujourd'hui :
Aperçu du portefeuille : 3 fonds, coût total 15000.00 yuans, valeur actuelle 14520.00 yuans Profit du jour : -180.00 yuans | Profit total : -480.00 yuans (-3.20%)
Détail par fonds :
- Zhaoshang Baijiu A (161725) : Aujourd'hui -1.22%, perte totale -11.07%, évaluez s'il faut conserver
- Yifangda Lanchou (005827) : Aujourd'hui +0.35%, gain total +5.20%, à conserver
- Guangfa Nasdaq (270042) : Aujourd'hui +1.80%, gain total +15.30%, bonne tendance
Souhaitez-vous ajuster votre portefeuille ?
Remarques importantes
- Les données de valorisation ne sont mises à jour que pendant les heures de bourse A (9h30-15h00). En dehors de ces heures, les données de clôture sont renvoyées.
get_fund_estimaterenvoie une estimation, non la valeur liquidative finale. Veuillez en informer l'utilisateur.- Les données de portefeuille sont persistantes dans le fichier
data/portfolio.json, conservées entre les sessions. - Calcul des profits : profit du jour = parts × (valorisation - valeur liquidative de la veille) ; profit total = parts × (valorisation - coût unitaire).