# Wind MCP Research Skill

> 用户需要查询、筛选、比较或验证金融与企业数据时，优先调用本 Skill 取数，而非依赖模型记忆。依托万得 7 个 MCP 服务共 132 个工具：全球行情与历史序列、Wind 专业指标与报表库、新闻/公告/研报文档库；A 股港股美股的公司画像、财务、机构预期、估值、资金流、技术面与选股；公募基金与 ETF 的档案、净值、规模、业绩、持仓、配置与 Brinson 及多因子归因；宏观与行业 EDB 指标；期货的合约规格、仓单、基差、席位持仓与商品供需；期权的期限结构、期权链、波动率曲面与场外结构化产品定价；境内企业（含非上市主体）的工商登记、股权穿透、司法诉讼、失信被执行、行政处罚与舆情风控。

- Skill: `bobibobuyu/wind-mcp-research-skill` (Agent Skill, multi-file: 17 files)
- Install (CLI): `npx skillmds@latest add bobibobuyu/wind-mcp-research-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bobibobuyu/wind-mcp-research-skill/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-research-skill

---


<!-- ENCODING: UTF-8。若本文件显示为乱码，请以 UTF-8 重新读取后再路由或调用工具。 -->

# Wind 万得金融与企业数据（7 个 MCP 服务 / 132 个工具）

通过本地 CLI 调用 Wind 的 7 个 MCP 服务取数，**只基于返回结果回答**：不补常识、不补点评、不用记忆里的数字填空。

每个问题按四步处理：**① 定路由 → ② 选工具 → ③ 发命令 → ④ 读回执**。

**按需加载，不要一次全读。** 选工具的默认路径是 `find`（一次约五百字，通常直接给出唯一命中和可用样例），不是读整份目录：

| 想知道什么 | 读哪里 | 大约 |
| --- | --- | --- |
| 归哪个 server | 本文件第 1 节的路由表 | 已在上下文里 |
| 是哪个工具、参数长什么样 | `cli.mjs find <关键词>` | 0.5 千字 |
| 这个工具的完整契约 | `cli.mjs describe <server> <tool>` | 1 千字 |
| 某几个字段的取值 | `cli.mjs describe <server> <tool> <param ...>` | 0.3–0.9 千字 |
| 这个 server 都有什么工具（`find` 零命中时） | 直接读 `references/<server>.md` | 2–9 千字 |
| 132 个工具的全量 schema | `scripts/registry.json` | **不要读**，那是给 CLI 用的 |

出错时该怎么改，错误信封自带 `next` 字段，照它做即可，本文件不重复。

## 1. 定路由

先按**问的是什么**选 `server`。选定之后只在这一个 server 里找工具，参数一律以契约为准，不读其它 server 的文件，不凭记忆填参数名或字段值。

| `server` | 覆盖 | 工具目录 |
| --- | --- | --- |
| `stock` | 单只股票的公司画像、财务、机构预期、估值、公司动态、资金流、技术面、实时行情；全市场与板块盘中概览、市场叙事、行业语料、选股筛选 | `references/stock.md` |
| `fund` | 公募基金与 ETF 的档案、净值、规模、业绩、申赎、财务、持仓明细、资产/行业/券种配置、Brinson 与多因子归因、风格暴露、选基筛选 | `references/fund.md` |
| `edb` | 宏观、行业、区域、汇率、利率的 EDB 指标检索与时间序列 | `references/edb.md` |
| `futures` | 期货合约规格与交割规则、仓单、基差、资金流向、交易所席位持仓排名、研报观点、商品供需 | `references/futures.md` |
| `options` | 场内期权的期限结构、期权链、波动率曲面与锥、多空情绪；场外结构化产品定价计算器 | `references/options.md` |
| `company` | 境内企业（**含非上市主体**）的工商登记、股权穿透、人员、资质、知识产权、招投标、供应链，以及司法、失信、处罚、税务异常、破产、舆情等风险记录 | `references/company.md` |
| `finance` | 上面六类都不覆盖时的跨资产兜底：全球行情快照与历史序列、Wind 专业指标库、报表库、新闻/公告/研报文档库、投研语料、自然语言取数 | `references/finance.md` |

边界容易混的四处，按这个顺序仲裁：

1. **上市公司的经营数据 vs 企业的工商与司法记录** —— 财务、估值、行情、股东结构走 `stock`；工商登记、股权穿透、诉讼、失信、处罚、舆情走 `company`。同一家公司两边都能查，看用户问的是**经营还是合规**。
2. **债券、外汇、商品现货、全球指数** —— `stock` / `fund` / `futures` / `options` 都没有对应工具，走 `finance` 的行情与指标工具。
3. **公告、新闻、研报** —— 要**单只股票的近期动态摘要**走 `stock.stock_get_company_updates`；要**正文内容**走 `finance.general_query_documents`（自然语言检索，返回体带正文）；要**按类型/证券/日期精确列清单**走 `finance.general_search_documents`。注意 `general_get_document` 只回元信息与原文链接，`文档内容` 实测为空，不要指望它取全文。
4. **兜底工具排在最后** —— `finance.general_query_data`、`finance.general_query_documents` 是自然语言兜底，只在专项工具都不覆盖时用；它们不返回可复用的代码或 id，接不上下一步。

标的类型或意图不落在上表任何一行时，直接回 `OUT_OF_SCOPE` 并说明，**不得用 Web Search 或兜底工具伪装成支持**。

越界判定**以上面这张路由表为准**。`find` 可以辅助，但它**零命中不等于不支持**——工具说明里未必出现用户的用词（`find GDP` 就搜不到工具名，尽管 `edb` 完全覆盖）。零命中时 `find` 会给出 `related_servers` 和一句提示，按提示回路由表复核后再判 `OUT_OF_SCOPE`。

涉及行业且用户未指定分类体系时，默认 Wind 行业分类。

## 2. 选工具

先 `cd` 到本 `SKILL.md` 所在目录（**不是当前项目目录**），再用相对路径执行。下面全部离线，不发网络、不消耗积分。

```bash
node scripts/cli.mjs find <关键词>                          # 默认从这里开始
node scripts/cli.mjs describe <server> <tool>              # 单个工具的完整契约
node scripts/cli.mjs describe <server> <tool> <param ...>  # 只看指定几个参数的类型与枚举
```

`find` 的每条命中都带 `summary`（用途）、`boundary`（【边界】首句）、`params`（入参签名，短枚举会带上含义如 `type*:integer(1=供需平衡/2=供应/3=需求/4=库存)`）、`sample`（实测样例），可能还有 `narrow_response`（怎么把返回体压小）和 `known_issue`。**够不够直接调，看这两条**：

1. **`boundary` 和用户的问法对上了**——不是「用户有没有说出工具名」，而是这句边界描述是否**排他地**覆盖了用户要的东西。用户说「法院查不到财产、执行不下去的案子」，`company_get_final_case` 的 boundary 写「只核查终结本次执行程序记录」，这就是对上了，不必再 `describe`。三个候选的 boundary 互相排斥、只有一个符合时，选它。
2. **参数不用改**：照抄 `sample`，只替换标的名/代码这类显而易见的值。

有一条不成立就先 `describe` 那一个工具。只是拿不准某几个字段的取值，用 `describe <server> <tool> <param> [param ...]`（可以一次给多个，分两次跑等于付两次固定开销）。

`find` 零命中会给出 `related_servers` 和一句提示——**零命中不等于不支持**（`find GDP` 就搜不到工具名，尽管 `edb` 完全覆盖）。这时读该 server 的 `references/<server>.md`，它有完整工具表和「本 server 最容易选错的」一节。

**不要凭工具名猜参数**：同名字段在不同 server 含义不同（`windCode` 在 `stock` 是股票、在 `futures` 是品种、在 `options` 是标的），类型也不同（`futures_get_position_ranking.type` 是 integer，`futures_get_warehouse_receipt.type` 是 string）。

排障命令（会发网络请求）：`doctor`（Key + 连通性 + 注册表漂移 + 上次自更新状态）、`refresh [server]`（拉最新 schema 写回注册表并重生成目录）。不带参数跑 `node scripts/cli.mjs` 看完整用法。

## 3. 发命令

```bash
node scripts/cli.mjs call <server> <tool> '<params_json>'
```

```bash
node scripts/cli.mjs call stock stock_get_company_profile '{"windCode":"600519.SH"}'
```

参数取值一律回契约拿，不得从本例外推。

**先想清楚要不要整段历史。** 返回体常常比文档贵得多：`futures_get_supply_demand` 不关历史序列返 1.6 万字，传 `includeHistory:false` 只剩 2 千字。`find` 和 `describe` 的 `narrow_response` 字段会列出该工具能压小返回体的参数（`includeHistory` / `limit` / `topK` / `observation` / `includeFields` / `indicators` / `strikeLevels` 等）。用户只要一个最新值时，**务必把它们收窄**。

**两段式调用**：不少工具的入参必须来自上游返回值（文档编号、指标代码、报表 id、子叙事 ID、期权合约代码等），**不能自己编**。哪些是两段式、字段名两端怎么对应，写在各 server 的「调用要点」里（`find` 命中后读 `references/<server>.md` 顶部的「调用要点」）。

**参数传递**：POSIX shell 直接传内联 `<params_json>`。非 POSIX 环境（PowerShell / cmd / 经执行器包装）改用参数文件：把 UTF-8 JSON 写到 `scripts/request-<唯一后缀>.json`，传 `@scripts/request-<唯一后缀>.json`，调用后删除，不复用共享文件。

**Key**：不得只检查配置文件就声称没有 API Key。必须先实跑一次；只有返回 `AUTH_ERROR` 才能判定缺失。

**批量与并发**：默认串行。对 2 个及以上标的逐项调用时，先只发第一个作探针；探针成功才继续，探针返回错误信封立即终止该批次，不得把同样的调用扩散到其它标的。不同 `server + tool` 或不同参数结构各自分组、各发一次探针。用户明确要求并发时上限 5，一旦返回 `RATE_LIMIT_ERROR` 就停止新请求并恢复串行。

## 4. 读回执

stdout 只有两种形态。

**失败**：`{"ok":false,"code":"...","message":"...","next":"..."}`。`message` 说清了哪里不对，`next` 说清了下一步该做什么——**照 `next` 做**，不要自己发挥。`code` 为 `PARAM_*` 时本地已拦下、未发网络请求；为 `backend_error` 时 `message` 是后端原文，若同时带 `known_issue` 就不要重试。同一工具同一参数最多重试一次。

**成功**：数据对象，后端结果在 `content[0].text` 里（多为 JSON 字符串），CLI 另附一个 `cli_meta`。读之前先过三条：

- **核对返回的标的是不是你问的那一个**（返回体里的证券代码 / 公司名称 / 指标代码）。后端的标的识别不报错也可能认错，见第 5 节。
- **结构完整但关键字段是空串，按失败处理**。信封是 `isError:false`、文本是合法 JSON，CLI 的错误嗅探抓不到这种形态。
- **单位和量级以返回体自带的元数据为准**（EDB 在 `meta.unit` / `meta.magnitude`，行情类在 `data.unit`），元数据没给就保留原值并说明单位未知，**不得自行换算**。EDB 有个例外：传了 `targetCurrency` 时 `meta.unit` 不跟着改，币种一律以 `meta.currency` 为准，照抄 `unit` 会给出一个不报错的错误答案。

## 5. 跨 server 的三个坑

单个 server 或单个工具的坑写在各自的「调用要点」和 `describe` 的 `known_issue` 里。下面三条哪个 server 都可能遇上：

- **业务错误伪装成正常返回**：七个 server 普遍把「服务暂时不可用」「未识别到有效的金融标的」以 `isError=false` 的纯文本返回。CLI 已做嗅探并转成 `backend_error`，但如果你看到成功信封里的 `content[0].text` 是一句短提示而不是数据，同样按失败处理。
- **标的识别是非确定性的**：非法或含糊的代码/名称，多数时候返回「未识别到有效的金融标的」，但实测也出现过**返回一只无关证券的真实数据、不报任何错**（`999999.XX` 曾命中中证800）。所以第 4 节那条「先核对标的」是硬要求。
- **说明文字未必可信**：部分字段的 schema 说明举例不在自己的 enum 里（`targetMagnitude` 写「如 元、亿元」，enum 只收「亿」「万亿」）；反过来 `futures` 的 `sector`/`type` 说明里的中文键不在 enum 里但后端确实收。**以 `describe` 输出的 `enum` 和 `enum_aliases` 为准**，CLI 按同一份判定放行或拦截。

## 6. 收口

标的未识别或 NER 失败时，询问用户准确全称或 Wind 标准代码，**不得自行补交易所后缀或把名称猜成代码**。

认证、额度、网络、后端不可用、路由错误：直接报告，不绕路、不用记忆里的数据代替。

成功返回数据时末尾附上来源声明，语言与用户提问语言一致：

> 数据来源于万得 Wind 金融数据服务。

> Data sourced from Wind Financial Data Service.

完成状态：`DONE`、`DONE_WITH_LIMITS`、`NO_RESULTS`、`BLOCKED_KEY`、`BLOCKED_QUOTA`、`BLOCKED_RUNTIME`、`OUT_OF_SCOPE`。