Wind MCP Skill

Wind 万得金融数据

通过 MCP 协议访问万得 Wind 金融数据：股票（A 股 / 港股 / 美股）/ 基金 / 指数 / 债券 / 公司公告 / 财经新闻 / 宏观指标。

1. 数据范围

具体工具名见 references/tool-manifest.json；CLI 在 call 前本地校验 server_type + tool_name 组合，非法直接拦截，不会打到后端。

❌ 不触发：欧股 / 日股 / 其它非中概非美股；汇率 / 期货盘口 / 加密货币；非金融数据。

📅 数据时效：行情快照 + 分钟级 = 当日准实时；K 线 = 收盘历史；财务 / 档案 = 最近一期定期报告。WIND_API_KEY 有日调用额度。

2. 使用方法

调用命令

路径说明：本文档中的相对路径（如 scripts/cli.mjs、references/indicators.md）均相对 本 skill 目录，也就是本 SKILL.md 所在目录解析；不要假设当前 shell 工作目录存在 scripts/cli.mjs。

Agent 执行命令时，应优先使用 <skill_dir>/scripts/cli.mjs 的完整路径，或先 cd <skill_dir> 再运行示例命令。

node scripts/cli.mjs call <server_type> <tool_name> '<params_json>'

CLI 输出契约

cli.mjs 用 exit code 区分成功/失败；不要从 stderr 解析任何东西（stderr 仅做内部日志和更新检查信号）。

• exit code 0：stdout 输出纯数据，无 envelope 包裹（call 透传 MCP result 对象；open-portal / setup-key 输出结构化 JSON）。
• exit code 非 0：stdout 输出 { ok: false, error: { code, agent_action } }。先按 error.code 选分支策略（见第 7 节），再执行 error.agent_action。错误码字典见 references/error-codes.json。

强制错误动作：

• code == "KEY_MISSING"：必须立即执行 node <skill_dir>/scripts/cli.mjs open-portal；不得只把命令或 URL 发给用户。open-portal 成功后从其 stdout JSON 读取 url / flow_note 转述给用户，等待用户提供 Key。
• open-portal 命令本身失败（code == "OPEN_PORTAL_FAILED"）：把 agent_action 中嵌入的 URL 发给用户手动打开。
• 用户给 Key 后，先用 AskUserQuestion 询问或沿用用户已明确的存放范围，执行 node <skill_dir>/scripts/cli.mjs setup-key <KEY> --scope <global|skill>，再重试原调用。

⚠️ Shell 转义是 INVALID_PARAMS_JSON 的首要原因。 首次调用前先确认当前 shell：node -e "const s=process.env.SHELL||'',c=process.env.COMSPEC||'';console.log(/bash/i.test(s)?'bash':/powershell/i.test(process.env.PSModulePath?s:c)?'powershell':/cmd/i.test(c)?'cmd':'bash')"，然后只按对应行写 JSON：

Shell	JSON 外层	内部双引号	示例
Bash / Git Bash / WSL	单引号	不转义	'{"windcode":"600519.SH"}'
PowerShell（5.x / 7）	单引号	\" 转义	'{\"windcode\":\"600519.SH\"}'
cmd.exe	双引号	\" 转义	"{\"windcode\":\"600519.SH\"}"

不要混用。NL 参数中禁止空格，用标点或直接连接（如 '{\"question\":\"海光信息688041公司基本资料、所属行业\"}'）。

Codex 沙箱联网要求

调用 <skill_dir>/scripts/cli.mjs call ... 访问 Wind 后端时，在 Codex 环境中必须使用 sandbox_permissions: "require_escalated" 运行命令，并建议申请稳定的 prefix_rule。require_escalated 是 Codex 工具调用参数，不是 shell 命令参数，不能写进脚本或命令行。

对应 Codex prefix_rule 建议为：

["node", "<skill_dir>/scripts/cli.mjs", "call"]

API Key

报 KEY_MISSING 时读取 stdout JSON 中的 error.agent_action / error.hint，并强制先执行 node scripts/cli.mjs open-portal 自动打开开发者中心；不得只提示用户自行打开。拿到 Key 后执行 node scripts/cli.mjs setup-key <KEY> --scope <global|skill> 配置（程序自动按多种方式查找 Key），然后重试原调用。

入参签名按工具确定

不同自然语言工具的字段名不同，必须以 ## 3. 工具表 中具体工具的参数表为准；禁止把 query、question 互相替换。

意图判定与路由顺序（强制）

每次接到用户问题时，必须先完成意图判定，再决定 server_type + tool_name。按以下固定顺序执行，禁止跳步、禁止并行抢路由：

1. 文档类优先（financial_docs）

   • 命中新闻/媒体/快讯/报道/评论/消息等语义：financial_docs.get_financial_news
   • 命中公告/年报/半年报/季报/招股书/监管披露等语义：financial_docs.get_company_announcements

2. 宏观指标（economic_data）

   • 命中 GDP / CPI / PPI / PMI / 社融 / 利率 / 失业率 / 进出口等经济指标语义： economic_data.get_economic_data

3. 行情时序（stock_data / global_stock_data / fund_data / index_data）

   • 命中最新价 / 涨跌幅 / 成交量 / K 线 / 分钟线 / 日内走势等行情语义时： 先判标的类型与市场，再选对应 server 的行情类工具（*_price_indicators / *_kline / *_quote）。

4. 深度业务 NL（对应专项 server）

   • 命中财务 / 股本 / 股东 / 事件 / 技术指标 / 风险 / 持仓 / 业绩 / 主体财务等深度业务语义时： 走对应 server 的 NL 工具（如 *_fundamentals / *_events / *_technicals / *_risk_metrics 等）。

5. 通用兜底（analytics_data）

   • 仅当前 1~4 步都无法命中时，才可使用： analytics_data.get_financial_data

硬约束：

• analytics_data 不得抢占已明确意图（只允许兜底）。
• 同一问句只允许一次主路由；本节不定义追问流程。
• 路由判定必须先于参数构造与调用执行。

3. 工具表

行情类（stock_data / global_stock_data / fund_data / index_data 共用 3 个工具签名）

4 个 server_type 共用同一组 get_stock_price_indicators / get_stock_kline / get_stock_quote / get_global_stock_price_indicators / get_global_stock_kline / get_global_stock_quote / get_fund_price_indicators / get_fund_kline / get_fund_quote / get_index_price_indicators / get_index_kline / get_index_quote 工具签名。windcode 字段直接传用户原话里的标的名（中文名 / 简称 / 代码均可），后端自动解析（贵州茅台 → 600519.SH、小米集团 → 01810.HK、苹果公司 → AAPL.O、易方达蓝筹精选 → 005827.OF、沪深300 → 000300.SH），AI 无需自己查代码。用户给短名 / 别名（如 茅台 可匹配贵州茅台 / 茅台股份 / 茅台啤酒等多只）时主动预防性反问「你问的是哪只？」——后端不会报歧义，会直接选一个，可能选错。代码格式参考：A 股 600519.SH / 8XXXXX.BJ、港股 00700.HK、美股 AAPL.O / MSFT.O、场外基金 005827.OF、ETF/LOF 588200.SH / 159915.SZ、指数 000300.SH / 000905.SH / HSI.HI。

行情快照工具（4 个 server_type 各 1 个，共 4 个：get_stock_price_indicators / get_global_stock_price_indicators / get_fund_price_indicators / get_index_price_indicators）

获取对应标的指定价格指标的最新值（默认返回当前最新值，非时间序列）。需要提供标的代码/名称和指标名称。当用户询问某只股票、基金或指数的当前/最新价格或任何单一时点指标值时，使用此工具。

K 线工具（4 个 server_type 各 1 个，共 4 个：get_stock_kline / get_global_stock_kline / get_fund_kline / get_index_kline）

获取对应标的在指定日期范围内的 K 线行情时间序列，默认日 K（period=10）。每条记录代表一个交易周期，通常包含开盘价、收盘价、最高价、最低价、成交量、换手率、涨跌幅、均价。当用户需要多日价格历史时，使用此工具。

分钟级行情工具（4 个 server_type 各 1 个，共 4 个：get_stock_quote / get_global_stock_quote / get_fund_quote / get_index_quote）

获取对应标的在一段时间内的分钟级行情数据（默认为当日）。返回指定日期范围内逐分钟的成交价格、均价、成交量、换手率等。当用户需要日内价格走势、逐分钟交易数据或一段时间内的分钟级行情时，使用此工具。

示例：

# A 股
node scripts/cli.mjs call stock_data get_stock_price_indicators '{"windcode":"600519.SH","indexes":"中文简称,最新成交价,涨跌幅,成交量"}'
node scripts/cli.mjs call stock_data get_stock_kline '{"windcode":"600519.SH","begin_date":"20260401","end_date":"20260430"}'
node scripts/cli.mjs call stock_data get_stock_quote '{"windcode":"600519.SH"}'

# 港股 / 美股
node scripts/cli.mjs call global_stock_data get_global_stock_price_indicators '{"windcode":"AAPL.O","indexes":"中文简称,最新成交价,涨跌幅,52周最高"}'
node scripts/cli.mjs call global_stock_data get_global_stock_kline '{"windcode":"00700.HK","begin_date":"20260401","end_date":"20260430"}'

# ETF
node scripts/cli.mjs call fund_data get_fund_price_indicators '{"windcode":"588200.SH","indexes":"中文简称,最新成交价,IOPV,贴水率"}'

# 指数
node scripts/cli.mjs call index_data get_index_price_indicators '{"windcode":"000300.SH","indexes":"最新成交价,涨跌幅,成交量,成交额"}'
node scripts/cli.mjs call index_data get_index_kline '{"windcode":"000300.SH","begin_date":"20260401","end_date":"20260430"}'

NL 类（按 server_type 分）

stock_data NL（6 个，仅 A 股）

入参签名：{question: string, lang?}。

入参 question: string，自然语言问句，A 股标的（代码 / 中文名 / 简称）+ 业务关键词。

入参 lang?: "English" | "中文"，默认 "中文"。

global_stock_data NL（6 个，港股 / 美股）

入参签名：{question: string, lang?}。

入参 question: string，自然语言问句，港股 / 美股标的（00700.HK / AAPL.O / 中英文名）+ 业务关键词。

入参 lang?: "English" | "中文"，默认 "中文"。

fund_data NL（6 个）

入参签名：{question: string, lang?}。

入参 question: string，自然语言问句，基金代码（*.OF / ETF / LOF）或简称 + 业务关键词（get_fund_company_info 传管理公司名）。

入参 lang?: "English" | "中文"，默认 "中文"。

index_data NL（3 个）

入参签名：{question: string, lang?}。

入参 question: string，自然语言问句，指数标的（代码 / 中文名）+ 业务关键词。

入参 lang?: "English" | "中文"，默认 "中文"。

bond_data NL（4 个）

入参签名：{question: string, lang?}。注意：bond_data 没有行情类工具，债券快照 / 估值通过 NL 拿。

入参 question: string，自然语言问句，债券代码或简称（如 国债2601）+ 业务关键词。

入参 lang?: "English" | "中文"，默认 "中文"。

financial_docs — 公告 / 新闻（2 个）

get_company_announcements 获取上市公司、债券发行人及其他金融工具发行人向交易所及监管机构发布的官方公告与监管文件。返回发行人披露的文件，包括定期报告（年报、半年报、季报）、临时公告（董事会决议、股权变动、分红通知、风险提示）、以及招股说明书等。不包含第三方新闻报道或分析师评论 get_financial_news 获取来自第三方媒体的财经新闻报道，涵盖公司、行业、最新市场/政策/政经动态相关内容。不包含公司官方发布的公告或监管披露文件

共用入参：

node scripts/cli.mjs call financial_docs get_financial_news '{"query":"美联储利率政策","top_k":5}'

economic_data — EDB 宏观（1 个）

get_economic_data — EDB 宏观 / 行业经济指标，提供 freq / magnitude / currency 等精细化字段控制：

node scripts/cli.mjs call economic_data natural_language_get_edb_data '{"executionMode":"searchFetch","question":"中国CPI同比","beginDate":"20240101","endDate":"20261231"}'

analytics_data — NL 通用入口（1 个）

get_financial_data — 自然语言入参的结构化数据获取工具，后端会先将 question 解析成具体查询口径再取数。优先用于其它 server_type 覆盖不到的跨域综合、衍生品、商品等结构化取数问题。若已知标的代码、字段、K 线、分钟线或指数行情，优先使用对应专项工具。

字段名硬约束：analytics_data.get_financial_data 和 economic_data.natural_language_get_edb_data 只接受 question 作为自然语言入参；禁止使用 query。query 仅用于 financial_docs.get_company_announcements / financial_docs.get_financial_news。

使用要求：

• 首次调用必须将用户原始问句去除所有空格后作为 question 透传，用标点符号或直接连接替代空格，保持语义不变。禁止任何改写、概括、意译或添加用户未提及的条件。即使问句看起来不完整或不规范，也必须先透传一次（去除空格后）。
• 仅当透传首次调用失败（后端报错 / 返回空 / 返回不匹配）时，才可改写或拆分 question，此时改写后的问句仍须忠实反映用户原始意图，不得擅自添加口径、频率、筛选条件等。
• question 入参不要太复杂，应尽量是单一取数动作。复杂分析、归因、预测、多条件筛选后再分析等任务，先拆成多个简单取数问题，再由 AI 综合。
• 需要先发现对象 / 展开范围 / 再对范围内对象二次取数的问题必须分步；如果无法得到明确范围或后端没有对应排名口径，停止并说明限制，不要强行猜。

node scripts/cli.mjs call analytics_data get_financial_data '{"question":"查询螺纹钢主力合约最近一周的日收盘价和涨跌幅"}'

4. 调用前参数校验（强制）

每次调用前，必须逐字段对照 ## 3. 工具表 中对应工具的请求参数定义完成参数有效性验证。字段名、必填项、类型、日期格式、枚举值必须与参数表一致。任一项不一致时，必须先修正参数或先向用户澄清，再调用；禁止明知不符合参数表仍试错调用。参数有效性最终判定以工具参数表为准，示例写法或经验写法不得覆盖参数表。

对 get_stock_price_indicators / get_global_stock_price_indicators / get_fund_price_indicators / get_index_price_indicators，还必须执行 indexes 专项校验：调用前必须先打开 references/indicators.md，把 indexes 按英文逗号拆成单个字段，逐个到 reference 表格中查找完全一致的中文字段名（含括号、全角字符、数字位），确认后再调用。任一字段不在 reference 中时，不得调用快照工具，不得凭经验改写字段名；应改用对应 NL 工具，或向用户说明该快照字段不可用。

对自然语言文本字段（question / query）的值，禁止包含空格。必须使用标点符号（顿号、逗号、括号等）分隔或直接连接。即使用户原句含空格，也必须在调用前去除所有空格；但字段名必须按具体工具表填写，不得混用。

5. 注意事项（违反必失败）

6. 使用技巧

所有技巧仅在通过第 4 节强校验且不触发第 5 节红线时使用，不能替代参数表校验。

7. 出错怎么办

cli.mjs 失败时（exit code != 0）输出 envelope：{ ok:false, error:{code, agent_action} }。所有错误信息只解析 stdout，不从 stderr 取。

CLI 错误处理硬约束

默认行为：按 error.agent_action 文本中的指令执行。agent_action 已经把"原始诊断 + 标准处方"合并成一段 NL 文本，agent 读完即可决定下一步，不需要其它字段。

按 error.code 选分支策略：

禁止跨界 fallback：Key / 权限 / 限流 / 余额 / 网络 / 5xx 类错误绝对不能通过切换 server_type、改用 analytics_data、切到 wind-alice 或 Web Search 来绕过——这些根因不会因换工具而消失。

analytics_data fallback 前提：仅在 PARAM_VALIDATION_ERROR / NO_RESULTS 等"参数/数据覆盖"类错误且已尝试修正后才允许；先把复杂问题拆成简单结构化取数,不要机械照搬复杂原话。analytics_data 自身失败（非 Key / 权限 / 网络 / 5xx）可调整 question 措辞重试一次,不得改变用户原始意图;再失败则停止 fallback,转入终极兜底（见下）。

错误码完整字典见 references/error-codes.json。

终极兜底：wind-alice

当以上所有工具（含 analytics_data 兜底）均因数据覆盖、字段不可用、口径不匹配、无结果等原因失败后，可用 AskUserQuestion 向用户推荐 wind-alice skill 作为最后选项。wind-alice 是当前 wind-skills 仓库内的另一个 skill，接受自然语言问题，能处理 wind-mcp-skill 专项工具覆盖不到的复杂场景。

若失败原因是 KEY_MISSING / KEY_INVALID / 权限 / 限流 / 余额 / 网络 / 后端 5xx / INVALID_PARAMS_JSON / 未知 server_type / 未知 tool_name，不得推荐 wind-alice；应先修复 Key、权限、网络、shell 转义或工具参数。wind-alice 同样依赖 WIND_API_KEY 和网络，切换不能解决这些根因。

引导规则（强制）：

1. 仅在所有 wind-mcp-skill 路径均失败后触发——不得跳过前面的工具直接推荐 wind-alice。

2. 必须先判断客户环境是否已安装 wind-alice：如果当前可用 skill 列表中有 wind-alice，或客户端能加载 skills/wind-alice/SKILL.md，视为已安装；否则视为未安装。当前仓库包含 skills/wind-alice 源码，不等于客户环境已经安装。

3. 已安装 wind-alice 时：必须用 AskUserQuestion 让用户选择，不得自动切换。话术参考：

   wind-mcp-skill 已尝试专项工具和 analytics_data，但仍未取到可用结果。当前环境已安装 wind-alice，可以用 Alice Agent 的自然语言链路继续尝试。是否改用 wind-alice？ 用户确认后，将用户原始问题原封不动作为 wind-alice 的 --prompt 传入；默认不传 --skill，让 Alice auto route。只有用户明确点名 Alice 子 Skill（如「公司一页纸」「事实核验」「上市公司调研问题清单」）时，才传 --skill。

4. 未安装 wind-alice 时：不要假装可以直接切换。用 AskUserQuestion 告知用户需先安装，并给出当前项目的安装命令：

   # GitHub
   npx skills add Wind-Information-Co-Ltd/wind-skills --skill wind-alice -g -y
   
   # Gitee 镜像（国内）
   npx skills add https://gitee.com/wind_info/wind-skills.git --skill wind-alice -g -y
   

   说明安装完成后可继续用原问题重试；如果用户只想装到当前项目，把命令中的 -g 去掉。

5. 用户拒绝：尊重选择，停止继续 fallback，简要返回已尝试路径、错误码和后端原文摘要，不再重复推荐。

8. 保持最新

CLI 在 stderr 输出更新检查信号（检测到新版 / 检测失败），每个会话每种信号最多出现一次，与 stdout 主调用结果完全独立。看到时简短转告用户即可（升级命令照搬 stderr 原文，不要自己改），不影响主调用判断。