cn-funds-mcp 使用ガイド
ツールクイックリファレンス
ファンド検索
| ツール | 用途 | 主要パラメータ |
|---|---|---|
search_fund | ファンドを検索(名称/コード/ピンイン) | keyword |
get_fund_estimate | リアルタイム評価額(取引時間中の推定純資産価格と騰落率) | fundCode |
get_fund_batch_info | 複数ファンドの純資産価格を一括取得 | fundCodes(カンマ区切り) |
get_fund_info | ファンド詳細(種類/会社/運用者/規模/ランキング) | fundCode |
get_fund_valuation_detail | 当日の評価額推移(日内時系列) | fundCode |
get_fund_net_value_history | 過去の純資産価格推移 | fundCode, range |
get_fund_accumulated_performance | 累積収益 vs CSI300 vs 同種ファンド | fundCode, range |
get_fund_position | 保有株式明細 | fundCode |
get_fund_manager_list | 歴代の運用者一覧 | fundCode |
get_fund_manager_detail | 現任の運用者概要 | fundCode |
株式/指数
| ツール | 用途 | 主要パラメータ |
|---|---|---|
get_stock_trend | 日内時系列推移 | secid(例:1.600519) |
get_stock_quote | リアルタイム相場価格 | secids(カンマ区切り) |
市場/資金
| ツール | 用途 | 主要パラメータ |
|---|---|---|
get_market_overview | A株市場概況(上海/深圳) | なし |
get_market_capital_flow | 市場資金流出入(主力/大口/小口) | なし |
get_sector_capital_flow | セクター資金ランキング | timeType, code |
get_northbound_capital | 香港通の資金流出入 | なし |
ポートフォリオ管理
| ツール | 用途 | 主要パラメータ |
|---|---|---|
save_portfolio | ポートフォリオ記録の保存/更新 | fundCode, shares, costPrice |
remove_portfolio | ポートフォリオ記録の削除 | fundCode |
get_portfolio | ポートフォリオ一覧の表示 | なし |
get_portfolio_profit | 本日の収益と総収益を一括計算 | なし |
定期リマインダー
| ツール | 用途 | 主要パラメータ |
|---|---|---|
set_reminder | 定期リマインダーを設定(各取引日にトリガー) | time(HH:MM), type, message |
get_reminders | すべてのリマインダー設定を表示 | なし |
remove_reminder | 特定のリマインダーを削除 | id |
check_reminders | 期限切れのリマインダーを確認 | なし |
リマインダータイプ type:
profit_report— ポートフォリオ収益レポート(トリガー後、get_portfolio_profitを取得し、追加購入/売却のアドバイスを提供)market_report— 市場レポート(トリガー後、市場概況+資金流出入を取得)custom— カスタムリマインダー(messageパラメータと併用)
よく使うパラメータ説明
ファンドコード fundCode: 6桁の数字(例 161725(招商白酒)、110011(易方達中小盤))
証券ID secid: フォーマットは 市場.コード
| 市場コード | 意味 | 例 |
|---|---|---|
1. | 上海証券取引所 | 1.000001(上海総合指数)、1.600519(貴州茅台) |
0. | 深圳証券取引所 | 0.399001(深圳成分指数)、0.000858(五粮液) |
116. | 香港株式市場 | 116.01810(小米集团) |
時間範囲 range: m=1ヶ月, q=3ヶ月, hy=6ヶ月, y=1年, 2y=2年, 3y=3年, 5y=5年
アクティブな動作(重要)
各対話の開始時に、最初に check_reminders を呼び出すこと
ユーザーが何を言ったとしても、ユーザーに返信する前に、最初に check_reminders を呼び出して 期限切れのリマインダーがないか確認します。期限切れのリマインダーがある場合、以下のルールに従って実行します。
-
profit_reportが期限切れの場合:get_portfolio_profitを呼び出して収益データを取得get_market_overviewを呼び出して市場の背景を取得- フレンドリーな口調で本日のポートフォリオ収益の概要をユーザーに報告
- 各ファンドについて、操作アドバイスを提供:
- 本日の下落率 > 2%: 「適宜買い増しして平均取得単価を下げることを検討してください」
- 本日の上昇率 > 3%: 「上昇が大きいので、一部利益確定を検討してください」
- ポートフォリオの総損失 > 10%: 「損失が大きいので、保有継続の評価を推奨します」
- ポートフォリオの総利益 > 20%: 「利益が大きいので、分割で利益確定し収益を確保することを推奨します」
- 最後にユーザーにポートフォリオの調整が必要かどうかを尋ねます
-
market_reportが期限切れの場合:get_market_overview+get_market_capital_flow+get_northbound_capitalを呼び出す- 市場指数、資金流出入、香港通の資金動向を報告
-
customが期限切れの場合:- ユーザーにカスタムリマインダーの内容を表示
期限切れのリマインダーがない場合は、通常通りユーザーのリクエストを処理します。
典型的なシナリオ
ユーザーがファンドコードを知らない場合
まず search_fund で検索し、返された code を使用して他のツールを呼び出します。
ユーザーが「今日の相場はどうですか」と尋ねた場合
get_market_overview + get_market_capital_flow を順次呼び出し、市場のポイント、騰落、出来高、資金流出入を総合的に報告します。
ユーザーが「今日いくら儲かった?」と尋ねた場合
直接 get_portfolio_profit を呼び出し、各ファンドの本日の収益と合計を返します。ポートフォリオ記録がない場合は、save_portfolio で追加するようユーザーを誘導します。
ユーザーが保有情報を伝えた場合
ファンドコード、保有口数、取得単価を解析し、各ファンドに対して save_portfolio を呼び出して保存します。名称パラメータは省略可能で、ツールが自動的にクエリして補完します。
ユーザーがポートフォリオを素早くインポートしたい場合(スクリーンショット認識)
現在のモデルが画像認識(OCR)に対応している場合、ユーザーに次のように積極的に提案します。ファンドアプリ(天天基金、支付宝、蚂蚁财富など)のポートフォリオのスクリーンショットを直接アップロードできます。AIが自動的に画像内のファンドコード、ファンド名、保有口数、取得単価などの情報を認識し、各ファンドに対して save_portfolio を呼び出して一括インポートするため、手動で一つずつ入力する必要はありません。
処理の流れ:
- スクリーンショット内の各ファンド情報(コード、口数、取得単価)を認識
- 不完全なフィールド(名称のみでコードがない場合など)については、
search_fundでファンドコードを補完 - 各ファンドに対して
save_portfolioを呼び出して保存 - 保存完了後、インポートされたポートフォリオ一覧をまとめて表示し、不足や誤りがないかユーザーに確認を促します
ユーザーが特定のファンドの総合分析を求めた場合
組み合わせて呼び出す: get_fund_info + get_fund_estimate + get_fund_position + get_fund_accumulated_performance、基本情報、評価額、保有銘柄、過去の収益を多次元で分析します。
ユーザーが「毎日午後に収益をリマインドして」と言った場合
set_reminder を呼び出し、パラメータ time="14:30", type="profit_report" を設定します。以降、各取引日の14:30以降の最初の対話で、自動的に収益レポートと操作アドバイスがトリガーされます。
リマインダートリガー後のレポート例
こんにちは!14:30になりました。本日のポートフォリオ収益をお知らせします:
ポートフォリオ概要:3ファンド、総コスト 15000.00 元、現在の時価総額 14520.00 元 本日の収益:-180.00 元 | ポートフォリオ総収益:-480.00 元(-3.20%)
各ファンドの明細:
- 招商白酒A (161725):本日 -1.22%、ポートフォリオ損失 -11.07%、保有継続の評価を推奨
- 易方達藍籌 (005827):本日 +0.35%、ポートフォリオ利益 +5.20%、継続保有
- 広発納斯達克 (270042):本日 +1.80%、ポートフォリオ利益 +15.30%、良好な推移
ポートフォリオの調整が必要ですか?
注意事項
- 評価額データはA株の取引時間帯(9:30-15:00)にのみ更新され、非取引時間帯は終値を返します
get_fund_estimateが返すのは推定値であり、最終的な純資産価格ではありません。ユーザーにその旨を伝えてください- ポートフォリオデータは
data/portfolio.jsonに永続化され、セッションをまたいで保持されます - 収益計算:本日の収益 = 口数 ×(評価額 - 前日の純資産価格)、ポートフォリオ収益 = 口数 ×(評価額 - 取得単価)