bobibobuyu 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 |
边界容易混的四处，按这个顺序仲裁：
- 上市公司的经营数据 vs 企业的工商与司法记录 —— 财务、估值、行情、股东结构走
stock；工商登记、股权穿透、诉讼、失信、处罚、舆情走company。同一家公司两边都能查，看用户问的是经营还是合规。 - 债券、外汇、商品现货、全球指数 ——
stock/fund/futures/options都没有对应工具，走finance的行情与指标工具。 - 公告、新闻、研报 —— 要单只股票的近期动态摘要走
stock.stock_get_company_updates；要正文内容走finance.general_query_documents（自然语言检索，返回体带正文）；要按类型/证券/日期精确列清单走finance.general_search_documents。注意general_get_document只回元信息与原文链接，文档内容实测为空，不要指望它取全文。 - 兜底工具排在最后 ——
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 所在目录（不是当前项目目录），再用相对路径执行。下面全部离线，不发网络、不消耗积分。
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。够不够直接调，看这两条：
boundary和用户的问法对上了——不是「用户有没有说出工具名」，而是这句边界描述是否排他地覆盖了用户要的东西。用户说「法院查不到财产、执行不下去的案子」，company_get_final_case的 boundary 写「只核查终结本次执行程序记录」，这就是对上了，不必再describe。三个候选的 boundary 互相排斥、只有一个符合时，选它。- 参数不用改：照抄
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. 发命令
node scripts/cli.mjs call <server> <tool> '<params_json>'
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。