# Wind MCP Skill

> 访问万得 Wind 金融数据。覆盖 A 股 / 港股 / 美股股票行情（最新价 / K 线 / 分钟）与财务基本面（财报 / 股本 / 事件 / 技术指标 / 风险）、ETF / 公募基金行情与全维数据（档案 / 财务 / 持仓 / 业绩 / 持有人 / 管理公司）、指数 / 板块行情与档案 / 基本面 / 技术、债券基本档案 / 发债主体 / 行情估值 / 主体财务、上市公司公告与财经新闻、宏观经济与行业指标。需要 WIND_API_KEY（登录 aifinmarket.wind.com.cn/#/user/overview 开发者中心获取）。**不包含**：欧股 / 日股、汇率 / 期货盘口、加密货币、非金融数据。

- Skill: `bobibobuyu/wind-mcp-skill-2` (Agent Skill, multi-file: 11 files)
- Install (CLI): `npx skillmds@latest add bobibobuyu/wind-mcp-skill-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bobibobuyu/wind-mcp-skill-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: bobibobuyu (https://skillmd.com/u/bobibobuyu)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/bobibobuyu/wind-mcp-skill-2

---


# Wind 万得金融数据

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

---

## 1. 数据范围

| server_type | 覆盖 | 路由要点 |
| --- | --- | --- |
| `stock_data` | **A 股** | 行情（快照 / K 线 / 分钟）+ 6 个 NL 专项（档案 / 财务 / 股东 / 事件 / 技术 / 风险） |
| `global_stock_data` | **港股 / 美股** | 与 `stock_data` 同结构，工具名加 `global_` 前缀 |
| `fund_data` | 基金 / ETF / LOF | 行情 + 6 个 NL 专项（档案 / 财务 / 持仓 / 业绩 / 持有人 / 管理公司） |
| `index_data` | 指数 / 板块 | 行情 + 3 个 NL 专项（档案 / 基本面 / 技术） |
| `bond_data` | 债券 | **无行情快照工具**，全走 NL（档案 / 主体 / 行情估值 / 主体财务） |
| `financial_docs` | 公告 + 新闻 | 2 个 RAG 工具（公告 / 新闻） |
| `economic_data` | 宏观 / 行业指标 | 1 个 EDB 工具 |
| `analytics_data` | 通用兜底 | 只在上述 7 个 server_type 都无法覆盖时使用 |

具体工具名见 `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>` 再运行示例命令。

```bash
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` 建议为：

```json
["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` 互相替换。

| 工具类别 | 入参字段 | 适用工具 |
| --- | --- | --- |
| **行情类** | `{windcode, ...}` | `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` |
| **专项 NL 类** | `{question, lang?}` | `stock_data` / `global_stock_data` / `fund_data` / `index_data` / `bond_data` 的 NL 工具 |
| **文档 RAG** | `{query, top_k?}` | `financial_docs.get_company_announcements` / `financial_docs.get_financial_news` |
| **宏观 EDB** | `{executionMode, question, ...}` | `economic_data.natural_language_get_edb_data` |
| **通用结构化取数** | `{question, lang?}` | `analytics_data.get_financial_data` |

---

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

每次接到用户问题时，必须先完成意图判定，再决定 `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`）

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

| 字段 | 必填 | 说明 |
| --- | --- | --- |
| `windcode` | ✅ | 标的（见行情类段头） |
| `indexes` | ✅ | **中文字段名**逗号分隔。调用前必须打开 `references/indicators.md` 并逐字段确认存在；该文件是 `indexes` 的唯一权威清单。常用候选（仍需去 reference 核对后再传）：`<br>`· 通用：`中文简称,最新成交价,前收盘价,今日开盘价,今日最高价,今日最低价,成交量,成交额,涨跌,涨跌幅<br>`· 股票额外：`换手率,量比,委比,涨停价,跌停价,52周最高,52周最低,总市值1,流通市值,市盈率(TTM),市净率,股息率<br>`· 基金额外：`IOPV,贴水率,基金最新份额,基金规模,最新净值,累计净值,七日年化收益率<br>`· 指数额外：`成分股贡献点数,上涨家数,下跌家数,平盘家数`。不在 `references/indicators.md` 的字段禁止猜测、翻译、改写或用英文名替代。 |

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

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

| 字段 | 必填 | 默认 | 说明 |
| --- | --- | --- | --- |
| `windcode` | ✅ | | 标的（见行情类段头） |
| `begin_date` | ✅ | | `yyyyMMdd`，例 `20260401` |
| `end_date` | ✅ | | `yyyyMMdd`，例 `20260430` |
| `count` | | | 数据条数：正数=从 `begin_date` 往后取 N 条；负数=从 `end_date` 往前取 N 条。不传则取 `begin_date ~ end_date` 范围内所有交易日 |
| `period` | | `"10"` | `1`=1分 / `3`=5分 / `4`=10分 / `5`=15分 / `6`=30分 / `7`=60分 / `8`=120分 / `9`=240分 / `10`=日K / `11`=周K / `12`=月K / `13`=年K / `14`=季K / `15`=半年K |
| `aftime` | | `"0"` | `0`=前复权 / `1`=后复权 |
| `issusp` | | `"1"` | `0`=不含停牌 / `1`=含 |
| `afdate` | | | 复权基准日期 `yyyyMMdd`，通常不需指定 |

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

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

| 字段 | 必填 | 默认 | 说明 |
| --- | --- | --- | --- |
| `windcode` | ✅ | | 标的（见行情类段头） |
| `begin` | | `LAST` | `yyyyMMdd` 或 `LAST` |
| `end` | | `LAST` | `yyyyMMdd` 或 `LAST` |

**示例：**

```bash
# 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" | "中文"`，默认 `"中文"`。

| 工具 | 说明 | question 示例 |
| --- | --- | --- |
| `get_stock_basicinfo` | 公司档案（信息 / 主营 / 行业 / IPO 上市板） | `"600519.SH公司基本档案"` |
| `get_stock_fundamentals` | 财务（盈利 / 资产负债 / 利润 / 现金流 / 增长率 / 银行业专项） | `"贵州茅台2024年ROE和净利润增速"` |
| `get_stock_equity_holders` | 股本 + 股东（总股本 / 流通 / 前十大 / 实控人 / 限售） | `"贵州茅台前十大股东"` |
| `get_stock_events` | 事件 + 资本运作（IPO / 增发 / 配股 / 并购 / ST / 分红） | `"宁德时代2024年增发和并购事件"` |
| `get_stock_technicals` | 技术指标时间序列（MACD / KDJ / RSI / BOLL / 融资融券 / 龙虎榜） | `"贵州茅台近60日MACD走势"` |
| `get_risk_metrics` | 风险指标（Beta / Jensen Alpha / 波动率 / Sharpe / VaR） | `"贵州茅台过去1年Beta和波动率"` |

#### `global_stock_data` NL（6 个，**港股 / 美股**）

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

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

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

| 工具 | 说明 | question 示例 |
| --- | --- | --- |
| `get_global_stock_basicinfo` | 公司档案（中英文名称 / 注册地 / 经营范围 / 上市交易所 / 行业 / 指数成份） | `"AAPL.O公司基本档案"` |
| `get_global_stock_fundamentals` | 财务（毛利率 / ROE / 资产 / 利润 / 现金流 / 增长率 / PE / PB / PS / 历史分位） | `"腾讯(00700.HK)2024年ROE和营收"` |
| `get_global_stock_equity_holders` | 股本 + 股东（总股本 / 流通 / 主要股东 / 机构持仓 / 限售解禁） | `"腾讯(00700.HK)前十大股东"` |
| `get_global_stock_events` | 事件 + 资本运作（IPO / 增发 / 配股 / 并购 / 合规监管 / 分红） | `"腾讯(00700.HK)分红历史"` |
| `get_global_stock_technicals` | 技术指标 + 多周期涨跌幅（相对大盘 / MACD / KDJ / RSI / BOLL / 融资融券） | `"AAPL.O的MACD和RSI"` |
| `get_global_stock_risk_metrics` | 风险指标（Beta / Alpha / 波动率 / Sharpe / 最大回撤 / VaR / 财务安全比率） | `"AAPL.O过去1年Beta和波动率"` |

#### `fund_data` NL（6 个）

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

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

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

| 工具 | 说明 | question 示例 |
| --- | --- | --- |
| `get_fund_info` | 档案（代码 / 简称 / 风格 / 业绩基准 / 费率 / 经理） | `"易方达蓝筹精选(005827.OF)基金档案"` |
| `get_fund_financials` | 财务（利润 / 净值 / 收入 / 费用 / 分红） | `"005827.OF2024年净利润和分红"` |
| `get_fund_holdings` | 持仓 + 资产配置（重仓股 / 申万 / Wind / 中信行业） | `"005827.OF最新一期重仓股"` |
| `get_fund_performance` | 业绩 + 排名 + ETF / 二级交易 | `"005827.OF近1年业绩排名"` |
| `get_fund_holders` | 持有人结构（个人 / 机构 / 申购赎回 / 规模变动） | `"005827.OF持有人结构"` |
| `get_fund_company_info` | 基金管理公司档案 + 经理团队 | `"易方达基金管理公司档案"` |

#### `index_data` NL（3 个）

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

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

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

| 工具 | 说明 | question 示例 |
| --- | --- | --- |
| `get_index_basicinfo` | 指数档案（发布机构 / 基日 / 基点 / 计算方法 / 成份股数量 / 分类） | `"沪深300指数档案"` |
| `get_index_fundamentals` | 指数基本面（成份股加权 PE / PB / PS / 营收 / 净利润 / 现金流 / 历史分位） | `"沪深300PE/PB历史分位"` |
| `get_index_technicals` | 指数技术指标（多周期涨跌幅 / 趋向 / 反趋向 / 能量 / 量价 / 波动） | `"中证500的MACD和RSI"` |

#### `bond_data` NL（4 个）

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

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

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

| 工具 | 说明 | question 示例 |
| --- | --- | --- |
| `get_bond_basicinfo` | 基本档案（交易所 / 分类 / 发行日期 / 规模 / 价格 / 票面利率 / 期限 / 兑付） | `"国债2601基本信息"` |
| `get_bond_issuer_info` | 发债主体公司信息（名称 / 注册地 / 行业 / 股权结构 / 企业背景） | `"国债2601发债主体"` |
| `get_bond_market_data` | 行情数据 + 估值分析（报价 / 估价 / 溢价 / 久期 / 凸性 / 利差） | `"国债2601久期和凸性"` |
| `get_bond_financial_data` | 发债主体财务（营收 / 利润 / 资产 / 负债 + 主体层面财务表现） | `"国债2601主体2024年营收"` |

#### `financial_docs` — 公告 / 新闻（2 个）

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

共用入参：

| 字段 | 必填 | 类型 | 说明 |
| --- | --- | --- | --- |
| `query` | ✅ | string | 自然语言，如 `"贵州茅台2024年报"` / `"美联储利率政策"` |
| `top_k` | | int | 返回文档数 |

```bash
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` 等精细化字段控制：

| 字段 | 必填 | 说明 |
| --- | --- | --- |
| `question` | ✅ | **自然语言问句**（不是指标 ID），如 `"中国GDP"` / `"美国CPI同比"` |
| `beginDate` / `endDate` | | `yyyyMMdd` |
| `freq` | | `日`=`1` / `工作日`=`2` / `周`=`3` / `月`=`4` / `季`=`5` / `半年`=`6` / `年`=`7` / `年度`=`8`（中文或代码均可） |
| `magnitude` | | `个`=`1` / `千` / `万` / `百万` / `千万` / `亿` / `十亿` / `百亿` / `千亿` / `万亿` |
| `currency` | | `USD` / `CNY` / `EUR` / `JPY` / `AUD` / `GBP` / `CHF` / `CAD` / `SGD` / `HKD` / `MYR` / `BYR` |
| `searchType` | | `深度`=`0` / `精确`=`1` |
| `ifUnion` | | `开启`=`1` / `不开启`=`2`（混合搜索） |

```bash
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 线、分钟线或指数行情，优先使用对应专项工具。

| 字段 | 必填 | 类型 | 说明 |
| --- | --- | --- | --- |
| `question` | ✅ | string | 简洁自然语言取数问题 |
| `lang` | | enum | `CNS`=中文（默认）/ `ENS`=英文 |

**字段名硬约束**：`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 综合。
- 需要先发现对象 / 展开范围 / 再对范围内对象二次取数的问题必须分步；如果无法得到明确范围或后端没有对应排名口径，停止并说明限制，不要强行猜。

```bash
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. 注意事项（违反必失败）

| 规则 | 后果 |
| --- | --- |
| 全流程禁止 Web Search 兜底 | 立即取消当前违规分支，回到 Wind 合规路径继续处理（修参数、换工具、换 server_type、拆分查询、升级 skill）；不结束整体任务 |
| 命令必须在**本文件所在目录**下执行 | cli.mjs 用相对路径，否则找不到资源 |
| K 线 `begin_date` / `end_date` **都必填** | schema 已强制，缺一报错 |
| `get_stock_quote` / `get_global_stock_quote` / `get_fund_quote` / `get_index_quote` 字段名是 `begin / end`，**不是** `begin_date / end_date` | 字段名错参数解析报错 |
| K 线 `begin_date / end_date` 和 EDB `beginDate / endDate`（注意 camelCase）都用 `yyyyMMdd` | 格式不对报错 |
| 行情类 `indexes` 字段**只接中文名**，从 `references/indicators.md` 复制粘贴 | 自创字段名 / 写英文报错 |
| `aftime` 只接受 `"0"` / `"1"`（无"不复权"） | 其他值报错 |
| A 股查 `stock_data`，港股 / 美股查 `global_stock_data`，**别混** | A 股财务工具会拒港股 / 美股 |
| `server_type + tool_name` 必须存在于 `references/tool-manifest.json` | CLI 本地拦截，按 `error.agent_action` 修正即可 |
| 单工具调用**只支持单标的** | 逗号分隔多代码后端只识别第 1 个，其余静默忽略 |
| Codex 中调用 Wind 后端联网必须使用 `require_escalated` | 否则沙箱内可能 `fetch failed` |
| 结果末尾**必须标注**「数据来源于万得 Wind 金融数据服务」 | 合规要求 |
| 涉及行业筛选 / 行业分类的问句，用户未明确指定行业体系时，**默认使用万得行业分类**（Wind 行业） | 申万、中信等口径与万得不一致，默认万得保证与后端一致；用户明确要求其他体系时才切换 |

---

## 6. 使用技巧

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

| 场景 | 怎么做 |
| --- | --- |
| 拿单时点最新值 / 已知具体字段名 | 用 `get_stock_price_indicators` / `get_global_stock_price_indicators` / `get_fund_price_indicators` / `get_index_price_indicators`，结构化入参，`indexes` 中文名 |
| 拿过去 N 日时间序列 | K 线 / 分钟级用 `get_stock_kline` / `get_global_stock_kline` / `get_fund_kline` / `get_index_kline` / `get_stock_quote` / `get_global_stock_quote` / `get_fund_quote` / `get_index_quote`；技术指标 / 财务时间序列用 `get_stock_technicals` / `get_global_stock_technicals` / `get_index_technicals` |
| 财务 / 档案 / 持仓 / 事件等深度业务问题 | NL 类工具，自然语言入参 |
| `indexes` 字段 | 每次都 Read `references/indicators.md` 并逐字段核对完全一致；常用快捷只是候选，不是权威清单；字段不在 reference 里就切 NL 或说明不可用 |
| 多标的对比（`贵州茅台 vs 五粮液`） | 单工具单标的限制 → 并行多次调用 |
| 多市场对比（`苹果 vs 腾讯`） | 美股走 `global_stock_data`，港股走 `global_stock_data`，分别调 |
| 指数行情 vs 指数基本面 | 行情走 `index_data` 行情类；PE / PB 历史分位走 `get_index_fundamentals`（NL） |
| 债券需要快照？ | `bond_data` 没有行情类 → 用 `get_bond_market_data`（NL）描述要哪些指标 |
| NL `question` / `query` 写法 | **禁止空格**，用标点或直接连接 |

---

## 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` 选分支策略**：

| code | 策略 |
| --- | --- |
| `KEY_MISSING` / `KEY_INVALID` / `KEY_FORBIDDEN_SERVER` | 修 Key 根因；**禁止**换工具/换 server 绕过。 |
| `RATE_LIMIT_DAILY` / `BALANCE_INSUFFICIENT` | 等额度刷新或换 Key；**禁止**换工具绕过。 |
| `RATE_LIMIT_QPS` / `NETWORK_ERROR` / `SERVER_5XX` | 等 3-5 秒后**原样重试同一请求**。 |
| `INVALID_PARAMS_JSON` | 只能修 JSON / shell 转义,重试**同一** server_type + tool_name；**禁止**换工具。 |
| `UNKNOWN_TOOL_NAME` / `UNKNOWN_SERVER_TYPE` | CLI 本地拦截（不会打到后端），按 `error.agent_action` 重选合法组合即可。 |
| `PARAM_VALIDATION_ERROR` | 按 `## 3. 工具表` + `references/indicators.md` 修字段;多次修正仍不通过且属于结构化取数,可改用 `analytics_data.get_financial_data`,question 须忠实反映用户原始意图。 |
| `NO_RESULTS` | 调关键词重试;专项无果且属结构化取数可改用 `analytics_data`。 |
| `RESPONSE_PARSE_ERROR` / `MCP_PROTOCOL_ERROR` / `TOOL_RUNTIME_ERROR` / `UNKNOWN` | 保留原文,能定位本地问题则修正后重试一次,否则告知用户并停止。 |

**禁止跨界 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` 告知用户需先安装，并给出当前项目的安装命令：

   ```bash
   # 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，简要返回已尝试路径、错误码和后端原文摘要，不再重复推荐。

| 错误 | 解法 |
| --- | --- |
| `indexes` 字段不识别 / 字段名不存在 | 按 `references/indicators.md` 复制表内字段名（不要自己拼）；仍不可用则改用对应 NL 工具或说明快照字段不可用 |
| 工具不存在 / 未知 server_type / 未知 tool_name / schema 对不上 | CLI 本地拦截，按 `error.agent_action` 修正 `server_type` / `tool_name` 后重试；仍不通过建议升级 skill |
| 美股 / 港股调用 `stock_data` 工具返空 / 报错 | 切到 `global_stock_data` 同名工具（参数签名一致） |
| 调用似乎啥都没报 | 检查命令是否在本 SKILL.md 所在目录下执行 |

---

## 8. 保持最新

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