Communitygithub.com

cn-funds-mcp

中国基金・株価データアシスタント(無料API、APIキー不要)。cn-funds-mcp ツールを使ってファンド評価額、純資産価格、保有銘柄、運用者情報、株式・指数の相場、市場資金流出入、セクターランキング、香港通の資金動向を取得し、ユーザーのポートフォリオを管理して収益計算を行います。

cn-funds-mcp とは?

cn-funds-mcp は、中国のファンド・株式データにアクセスするための強力なアシスタントです。無料のAPIを使用するため、APIキーは不要で、多様なデータ取得ツールを提供します。ユーザーはファンドの検索、評価額や純資産価格の確認、保有銘柄の詳細、運用者情報、株式・指数のリアルタイム相場、市場全体の資金流出入、セクター別の資金ランキング、香港通の資金動向などを簡単に取得できます。また、ユーザーのポートフォリオを管理し、毎日の収益や総収益を計算することも可能です。主なプラットフォームは、Claude Code、Cursor、Codex などのAIエージェントと連携して使用されることを想定しており、SKILL.mdに従って、毎日のリマインダー(収益報告や市場報告)を自動的にトリガーし、適切なアドバイスを提供します。このスキルは、投資家が中国市場のデータを効率的に追跡し、情報に基づいた意思決定を行うのに役立ちます。

対応~Claude Code~Codex CLI~Cursor
npx skills add smallke/cn-funds-mcp

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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_overviewA株市場概況(上海/深圳)なし
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 を呼び出して 期限切れのリマインダーがないか確認します。期限切れのリマインダーがある場合、以下のルールに従って実行します。

  1. profit_report が期限切れの場合:

    • get_portfolio_profit を呼び出して収益データを取得
    • get_market_overview を呼び出して市場の背景を取得
    • フレンドリーな口調で本日のポートフォリオ収益の概要をユーザーに報告
    • 各ファンドについて、操作アドバイスを提供:
      • 本日の下落率 > 2%: 「適宜買い増しして平均取得単価を下げることを検討してください」
      • 本日の上昇率 > 3%: 「上昇が大きいので、一部利益確定を検討してください」
      • ポートフォリオの総損失 > 10%: 「損失が大きいので、保有継続の評価を推奨します」
      • ポートフォリオの総利益 > 20%: 「利益が大きいので、分割で利益確定し収益を確保することを推奨します」
    • 最後にユーザーにポートフォリオの調整が必要かどうかを尋ねます
  2. market_report が期限切れの場合:

    • get_market_overview + get_market_capital_flow + get_northbound_capital を呼び出す
    • 市場指数、資金流出入、香港通の資金動向を報告
  3. custom が期限切れの場合:

    • ユーザーにカスタムリマインダーの内容を表示

期限切れのリマインダーがない場合は、通常通りユーザーのリクエストを処理します。

典型的なシナリオ

ユーザーがファンドコードを知らない場合

まず search_fund で検索し、返された code を使用して他のツールを呼び出します。

ユーザーが「今日の相場はどうですか」と尋ねた場合

get_market_overview + get_market_capital_flow を順次呼び出し、市場のポイント、騰落、出来高、資金流出入を総合的に報告します。

ユーザーが「今日いくら儲かった?」と尋ねた場合

直接 get_portfolio_profit を呼び出し、各ファンドの本日の収益と合計を返します。ポートフォリオ記録がない場合は、save_portfolio で追加するようユーザーを誘導します。

ユーザーが保有情報を伝えた場合

ファンドコード、保有口数、取得単価を解析し、各ファンドに対して save_portfolio を呼び出して保存します。名称パラメータは省略可能で、ツールが自動的にクエリして補完します。

ユーザーがポートフォリオを素早くインポートしたい場合(スクリーンショット認識)

現在のモデルが画像認識(OCR)に対応している場合、ユーザーに次のように積極的に提案します。ファンドアプリ(天天基金、支付宝、蚂蚁财富など)のポートフォリオのスクリーンショットを直接アップロードできます。AIが自動的に画像内のファンドコード、ファンド名、保有口数、取得単価などの情報を認識し、各ファンドに対して save_portfolio を呼び出して一括インポートするため、手動で一つずつ入力する必要はありません。

処理の流れ:

  1. スクリーンショット内の各ファンド情報(コード、口数、取得単価)を認識
  2. 不完全なフィールド(名称のみでコードがない場合など)については、search_fund でファンドコードを補完
  3. 各ファンドに対して save_portfolio を呼び出して保存
  4. 保存完了後、インポートされたポートフォリオ一覧をまとめて表示し、不足や誤りがないかユーザーに確認を促します

ユーザーが特定のファンドの総合分析を求めた場合

組み合わせて呼び出す: 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 に永続化され、セッションをまたいで保持されます
  • 収益計算:本日の収益 = 口数 ×(評価額 - 前日の純資産価格)、ポートフォリオ収益 = 口数 ×(評価額 - 取得単価)

作者

smallke | [email protected]

関連スキル