Communitygithub.com

smallke/cn-funds-mcp

中國基金與股票數據助手(免費 API,無需金鑰)。查詢基金估值、淨值、持股、經理資訊,股票/指數行情,大盤資金流向、產業排行、北向資金,並管理用戶的基金投資組合並計算收益。

cn-funds-mcp 是什麼?

cn-funds-mcp 是一個專為 AI 代理(如 Claude Code、Cursor、Codex 等)設計的中國金融市場資料工具,提供免費且無需 API 金鑰的資料來源。它支援查詢基金估值、淨值、持股明細、經理人資訊,以及股票和指數的即時報價。此外,還能獲取大盤資金流向、產業資金排行和北向資金動態,讓開發者輕鬆整合市場分析到代理的工作流程中。該工具還包含完整的投資組合管理功能,可儲存、更新和刪除用戶的基金持倉記錄,並自動計算每日收益與總收益。內建的定時提醒系統允許在每個交易日觸發收益報告或大盤行情播報,代理會根據用戶設定主動檢查提醒並提供操作建議(如加倉或止盈)。支援貨幣市場代碼(如 `1.` 代表上交所、`0.` 代表深交所)和時間範圍參數(如 `m` 代表一個月),並具有圖片辨識功能,可從截圖中提取持倉資訊。適用於需要自動化基金跟蹤、市場監控和個人化投資建議的場景。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add smallke/cn-funds-mcp

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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 滬深300 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),主動提示用戶:可以直接上傳基金APP(如天天基金、支付寶、螞蟻財富等)的持倉截圖,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]

相關技能