前言¶
做投研輔助、財報覈對或板塊篩選時，如果只靠模型記憶回答「茅臺最新價」「某指數 PE 分位」，結果往往不可追溯。常見做法是另開終端查 Wind，再把數字貼回對話，上下文容易斷。下面介紹 SkillHub 上的 萬得金融數據（@user_db7424f5/udb7-wind-financial-data，v1.0.0）：把萬得 Wind 金融庫通過本地 CLI 接到 Agent，按工具契約取數後再組織回答。
這是什麼¶
萬得金融數據 是面向 AI Agent 的金融數據 Skill，座標 @user_db7424f5/udb7-wind-financial-data，在 SkillHub 分類爲 professional，來源爲 community，SkillHub 頁面由發佈者 user_db7424f5 維護；包內元數據標明作者爲 Wind，主頁爲 Wind 金融 AI 市場。
一句話定位：通過 MCP 協議訪問萬得數據庫，覆蓋 A 股、港股、美股、基金 ETF、指數板塊、債券、公告新聞及宏觀經濟等指標查詢；官方簡介明確 不含歐股、日股與加密資產。
SkillHub 當前展示：評分 100000，下載 8162 次；標籤 requires_api_key=false 表示安裝 Skill 本身不需要 SkillHub API Key，但實際調用 Wind 後端仍需配置 WIND_API_KEY（見下文）。
核心功能¶
能力按 server_type 劃分，工具名以包內 references/tool-manifest.json 爲權威清單，主要包括：
| server_type | 典型能力 |
|---|---|
stock_data |
滬深及港美股篩選、最新價/行情/K 線、檔案、財務、股東、事件、技術、風險 |
fund_data |
基金/ETF 篩選、行情、檔案、財務、持倉、業績、持有人、基金公司 |
index_data |
指數/板塊行情、K 線、檔案、基本面、技術指標 |
bond_data |
債券檔案、發債主體、行情估值、主體財務 |
financial_docs |
上市公司公告、財經新聞檢索 |
economic_data |
宏觀經濟/行業 EDB 指標 |
analytics_data |
自然語言結構化取數兜底（README 建議僅在專項工具無法覆蓋時使用） |
SKILL 元數據中的示例問句（安裝後可直接用自然語言向 Agent 提問）包括：篩選滬深市值超 500 億且連續 5 日上漲的股票、港股科技股篩選、股票型基金收益篩選、貴州茅臺最新價、蘋果 AAPL 近 30 日 K 線、基金規模與經理、中證 500 PE/PB 分位、年報內容、新能源汽車產銷量等。
安裝與啓用¶
1. 安裝 SkillHub CLI（若尚未安裝）¶
按 SkillHub 安裝說明 檢查或安裝：
command -v skillhub && skillhub --version
未安裝時可執行：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 安裝本 Skill¶
官方頁面給出的安裝提示爲：請根據 https://skillhub.cn/install/skillhub.md，安裝 @user_db7424f5/udb7-wind-financial-data。
命令行安裝時需用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 可能不會被識別。常用路徑示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
示例：
skillhub install @user_db7424f5/udb7-wind-financial-data --dir ~/.cursor/skills/
安裝完成後，Skill 目錄內包含 SKILL.md、scripts/cli.mjs、references/tool-contracts.md 等文件。當前 v1.0.0 包內的 SKILL.md 以 YAML 元數據與示例問句爲主，詳細工具表與參數說明在 references/tool-contracts.md 與 README.md。
包內 README.md 另提供通過 npx skills add 從 Wind 官方倉庫安裝同名能力的路徑（GitHub / Gitee 鏡像）；若你已從 SkillHub 安裝 @user_db7424f5/udb7-wind-financial-data，一般無需重複執行，除非你要改用該文檔中的全局 -g 安裝方式。
3. 配置 Wind API Key¶
取數需要 WIND_API_KEY，可在 Wind 金融 AI 市場 獲取。
在 Skill 目錄下可打開配置引導：
cd <skills目錄>/@user_db7424f5/udb7-wind-financial-data
node scripts/cli.mjs open-portal
README 說明：若 CLI 返回 KEY_MISSING，按 stdout JSON 中 error.agent_action / error.hint 配置即可；讀取順序爲用戶全局配置、當前 Skill 本地配置、環境變量 WIND_API_KEY。
典型用法¶
自然語言（推薦給 Agent）¶
安裝並配置 Key 後，用 SKILL 元數據中的問句即可，例如：
- 「貴州茅臺今天最新價」
- 「蘋果公司(AAPL.O)最近30日K線」
- 「篩選股票型基金中近一年收益率超20%的產品」
Agent 應按 server_type 路由，在 Skill 根目錄執行 node scripts/cli.mjs call ...，並只依據 Wind 返回結果作答。
CLI 直接調用（可復現）¶
先 cd 到本 Skill 根目錄（不是業務項目根目錄），命令形態爲：
node scripts/cli.mjs call <server_type> <tool_name> '<params_json>'
references/tool-contracts.md 與 scripts/cli.mjs 內嵌的示例包括：
# 滬深選股
node scripts/cli.mjs call stock_data search_stocks '{"question":"篩選滬深市場市值超500億且連續5日上漲的股票"}'
# 單標的最新價指標（indexes 字段名見 references/indicators.md）
node scripts/cli.mjs call stock_data get_stock_price_indicators '{"windcode":"600519.SH","indexes":"中文簡稱,最新成交價,漲跌幅,成交量"}'
# K 線（日期格式 yyyyMMdd，須同時傳 begin_date / end_date）
node scripts/cli.mjs call stock_data get_stock_kline '{"windcode":"600519.SH","begin_date":"20260401","end_date":"20260430"}'
# 財經新聞
node scripts/cli.mjs call financial_docs get_financial_news '{"query":"美聯儲利率政策","top_k":5}'
注意：windcode 須爲單個標的字符串（如 600519.SH、AAPL.O、005827.OF）；多標的對比需拆成多次調用。K 線用 begin_date/end_date，分鐘行情工具字段爲 begin/end，不要混用。
適用場景與注意¶
適合誰：需要在 Cursor、Claude Code、Codex 等支持 Skills 的環境裏做可覈驗的金融問答——選股條件、單標的行情與基本面、基金/指數/債券檔案、公告新聞與宏觀序列，且標的範圍在 A/港/美股及相關品種之內。
限制與坑：
- 數據範圍以 SkillHub 簡介爲準：不含歐股、日股、加密；README 還寫明不含部分非中概非美股市場、匯率/期貨盤口等，超出範圍應明確說明而非臆測。
analytics_data是兜底入口，公告、新聞、宏觀、行情、財務等明確意圖應優先走對應server_type。- Windows PowerShell 5.x 傳 JSON 易觸發
INVALID_PARAMS_JSON，可參考包內文檔的 Shell 轉義說明，或使用@scripts/request-*.json傳參方式（若 SKILL 正文有寫明）。 - 在 Codex 等沙箱中調用 Wind 後端需聯網時，README 提到可能需要
require_escalated。 - Skill 會按 README 做每日後臺更新檢查，結果寫入
update-state.json，不影響當天後續取數邏輯的理解即可。
結尾¶
萬得金融數據 把 Wind 的 MCP 工具鏈封裝成 Agent Skill：安裝座標 @user_db7424f5/udb7-wind-financial-data，用 cli.mjs 按契約取數，適合把「查數」和「寫分析」留在同一會話裏完成。
- SkillHub 頁面：https://www.skillhub.cn/skills/user_db7424f5/udb7-wind-financial-data
- API 入口（SkillHub）：https://api.skillhub.cn/user_db7424f5/udb7-wind-financial-data
- 安裝說明：https://skillhub.cn/install/skillhub.md
