Wind Mcp Skill

# wind-mcp-skill

> **访问万得 Wind 金融数据** · A 股 / 港股 / 美股 / 基金 / 指数 / 债券 / 公告 / 新闻 / 宏观经济

---

## 这是什么
 
通过 MCP 协议访问万得 Wind 金融数据库，给 AI Agent 提供：

- A 股股票筛选 + 行情（最新价 / K 线 / 分钟）+ 财务基本面（财报 / 股本 / 事件 / 技术指标 / 风险）
- 港股 / 美股股票筛选 + 行情 + 基本面（档案 / 财务 / 股本 / 事件 / 技术指标 / 风险）
- ETF / 公募基金筛选 + 行情 + 全维数据（档案 / 财务 / 持仓 / 业绩 / 持有人 / 管理公司）
- 指数 / 板块行情 + 档案 / 基本面（成份股加权 PE / PB / PS）/ 技术指标
- 债券基本档案 / 发债主体 / 行情估值（久期 / 凸性 / 利差）/ 主体财务
- 上市公司公告 + 财经新闻 RAG
- 宏观经济 / 行业经济指标（EDB）
- 自然语言通用查询入口（仅在专项能力无法覆盖时兜底，覆盖更广泛的 Wind 数据库）

**不包含**：欧股 / 日股 / 其它非中概非美股、汇率 / 期货盘口、加密货币、非金融数据。

---

## 安装

```bash
# 全局（推荐 — 跨项目 + 跨 AI agent 共享）

# GitHub
npx skills add Wind-Information-Co-Ltd/wind-skills --skill wind-mcp-skill -g -y

# Gitee 镜像（国内）
npx skills add https://gitee.com/wind_info/wind-skills.git --skill wind-mcp-skill -g -y
```

> 想限制在当前项目内用，把命令的 `-g` 去掉即可。`-g` 会按 skills 工具支持的客户端进行全局安装 / 链接（如 Claude Code / Cursor / OpenClaw / Hermes 等）。

---

## API Key

需要 `WIND_API_KEY`（登录 [Wind金融AI市场](https://aifinmarket.wind.com.cn/#/user/overview) 获取）。

装好后向 AI 提一个 wind 数据问题，AI 会按 stdout JSON envelope 里的 `error.agent_action` / `error.hint` 引导完成 Key 配置——无需手动管路径。也可以在本 skill 目录下运行：

```bash
node scripts/cli.mjs open-portal
```

如果 CLI 报 `KEY_MISSING`，按 stdout JSON 里的 `error.agent_action` / `error.hint` 配置即可；程序会自动查找环境变量 `WIND_API_KEY` 和常见本地配置文件。

---

## 使用注意

- `analytics_data` 只是兜底入口；公告 / 新闻、宏观、行情、财务基本面等明确意图应优先走对应 `server_type`。
- `references/tool-manifest.json` 是 CLI 校验 `server_type + tool_name` 的权威清单；错误组合会在真正调用后端前被本地拒绝。
- Windows PowerShell 5.x 中 JSON 转义容易导致 `INVALID_PARAMS_JSON`。如果遇到该错误，请优先看 [SKILL.md](./SKILL.md) 里的 Shell 转义说明。
- K 线工具必须同时传 `begin_date` / `end_date`；分钟级行情工具字段名是 `begin` / `end`。
- 行情类 `indexes` 建议从 [references/indicators.md](./references/indicators.md) 复制表内字段名。
- 单次工具调用只支持单标的；多标的对比需要拆成多次调用。
- Codex 沙箱中调用 Wind 后端联网时，需要使用 `require_escalated`。

---

## 升级

```bash
# 装到全局(默认推荐)
npx skills update wind-mcp-skill -g -y

# 装到当前项目(不带 -g)
npx skills update wind-mcp-skill -y
```

call 命令调用时会触发后台自动更新检查。每天首次使用时异步执行一次
`npx skills update wind-mcp-skill -y`；如果当前 skill 位于全局
`~/.agents/skills` 下，则自动追加 `-g`。执行结果写入当前 skill 根目录的
`update-state.json`；当天后续调用不会再次执行，且不会阻塞正常取数。

---

## 目录结构

```
wind-mcp-skill/
├── SKILL.md                     # AI 加载的核心守则（数据范围 / 使用方法 / 工具表 / 注意事项 / 使用技巧 / 出错怎么办）
├── references/
│   ├── indicators.md            # 行情字段 indexes 中文清单（按类别分组）
│   └── tool-manifest.json       # CLI 前置校验的 server_type / tool_name 权威清单
├── scripts/
│   ├── cli.mjs                  # MCP 调用主入口
│   └── update-check.mjs         # 每日一次后台自动更新
└── README.md
```

详细的工具列表 / 入参 schema / 字段说明见 [SKILL.md](./SKILL.md)。


{
  "schema_version": 4,
  "description": "wind-mcp-skill CLI 错误码字典。每条 code 对应一段 agent_action（诊断 + 行动一体）。CLI 运行时读取本文件;本文件也是开发者参考与监控/集成的唯一码表。",
  "envelope_contract": {
    "success": "成功路径不返回 envelope,直接 stdout 输出纯数据。call 命令透传 result.content[0].text(JSON 字符串则 parse 后输出)；其它命令直接输出结构化对象;help 输出 USAGE 纯文本。exit code 0。",
    "failure": "失败路径返回 envelope: { ok: false, error: { code, agent_action } }。exit code 1。agent 用 exit code 判断成功/失败；失败时直接执行 agent_action 即可。"
  },
  "codes": {
    "TEMPORARILY_UNAVAILABLE": "后端偶发不可用。原样重试一次即可，可能是临时波动。重试仍失败则告知用户稍后再试，不得修改参数、工具或路由。",
    "INVALID_PARAM_NAME": "后端参数名错误：请求中包含不存在的字段或缺少必填字段。1) 读取 references/tool-contracts.md 当前工具段落，逐项核对字段名是否与文档完全一致；2) 检查是否遗漏必填字段；3) 只修 detail 指出的字段名问题，保持同一 server_type+tool_name 和其他参数不变。禁止改 shell 引号、发明字段名或切换工具。",
    "INVALID_PARAM_VALUE": "后端参数值错误：字段名正确但值不合法。1) 读取 references/tool-contracts.md 当前工具段落，核对 detail 指出字段的值域要求（日期格式 yyyyMMdd、枚举值、windcode 格式等）；2) 含 indexes 时读取 references/indicators.md 相关类别，逐字核对；3) 只修 detail 指出的值问题，保持同一 server_type+tool_name 和其他参数不变。禁止改字段名、shell 引号或切换工具。",
    "USAGE_ERROR": "命令用法错误。确认命令格式为 cli.mjs call <server_type> <tool_name> '<params_json>'，修正后重试。只修 CLI 形态，保持 server/tool/params 语义不变。",
    "INVALID_PARAMS_JSON": "命令传递错误：第三参数 JSON 解析失败。1) 按 SKILL.md「params JSON 写法」表核对当前 shell / 执行器的引号写法；2) 用同一执行路径运行 argv 探针：node -e \"JSON.parse(process.argv[1]); console.log(process.argv[1])\" '<params_json>'；3