wind-mcp-skill

Wind 金融数据查询

通过本 Skill 自带 CLI 调用 Wind MCP。金融事实以工具返回的数据与来源材料为依据；区分原始数据、来源观点和基于数据的推导，不把模型记忆、Web Search 或常识补全伪装成已核验数据。

按需渐进加载：明确需求 → 定位业务域 → 读取相关 reference 并确认工具覆盖 → 按需组织调用 → 核验结果。endpoint、请求头、认证和传输由 CLI 负责；模型不构造这些实现细节。

1. 定路由

根据金融对象和业务意图定位 server_type，再按契约确认工具是否支持所需数据、时间范围、粒度、口径及标的数量。已有信息足够时直接查询；缺少影响结果的必要信息且契约无适用默认值时，再向用户澄清。

路由规则

优先根据研究对象选择对应专项工具：股票及上市公司用 stock_research，基金/ETF/REITs 用 fund_research，期权用 options_data，期货用 futures_data，指数/板块用 index_data，债券用 bond_data，宏观、行业与区域经济用 edb_data，工商注册企业用 company_data；当需要从公告、新闻、研报等金融文档中获取摘要、片段、证据或事件解释时，使用 financial_docs。

当任务需要获取实时行情、历史行情、K 线、分钟行情、跨资产行情时，使用 general_data 中的行情工具。

当任务需要精准获取某一篇金融文档或附件，例如根据文档ID、标题、发布日期、来源、文档类型、附件名称或附件链接，定位单篇研报、公告、新闻、原文全文或相关附件内容时，使用 general_data 中的文档工具。

当专项工具返回结果不满足任务需求，例如缺少所需字段、时间范围、粒度、口径、筛选条件或批量能力时，再使用 general_data 中的对应工具补足。

单个工具能满足完整需求时直接调用；只有需要不同数据来源、不同工具能力，或超过单次查询限制时才拆分调用。有依赖关系的任务，应先取得前置结果并复用。

文件导航

以下文件名相对于路由表中的对应目录，只读取与当前需求相关的文件：

• stock/：市场概览与热点读 market-overview.md；行业研究与板块盘中分析读 industry-sector-research.md；公司画像、财务、预期、估值与动态读 company-research.md；资金、技术与个股盘中分析读 trading-analysis.md；条件选股读 screener.md。
• fund/：档案与相似基金读 discovery-profile.md；业绩、风险、风格与归因读 performance-attribution.md；配置、持仓与 ETF 申赎清单读 allocation-holdings.md；净值、交易与申赎状态读 nav-trading.md；规模与财务读 size-financials.md；条件筛选读 screener.md。
• options/：期限、期权链、合约与品种行情统计读 contract-market.md；波动率曲面、锥与期限结构读 volatility.md；定价读 pricing.md；市场情绪读 sentiment.md。
• company/：主体搜索与工商读 discovery-registration.md；股权、人员与控制关系读 ownership-governance.md；客户、供应商与招投标读 business-relations.md；知识产权与资质读 intellectual-property-qualifications.md；司法记录读 judicial-enforcement.md；处罚、失信与税务读 compliance-tax.md；经营、融资与舆情风险读 operating-financing-risk.md；工具需要风险分类枚举时再读 risk-enums.md。
• 指数行情指定 indexes 字段时，再读 references/index/index-indicators.md；未指定时沿用工具默认字段。

2. 读契约

reference 用于选择工具和构造参数，MCP Server 负责最终校验。发现参数拒绝、工具缺失或契约疑似过期时，运行 node scripts/cli.mjs list-tools <server_type> 核对完整线上定义，定位相关工具，不必每次调用前重复获取。契约与实际返回仍冲突时，保留差异并说明限制，不猜参数或隐瞒兼容问题。

工具名与 server 名必须逐字使用：只能调用当前 reference 契约或 list-tools 返回中实际存在的 server_type 与 tool_name，不得凭记忆、推测或相似命名编造、改写工具名（包括大小写、单复数、前后缀变体）。目标工具在契约中找不到时，视为当前专项未覆盖，按路由规则改查 general_data 或运行 list-tools 核对，不尝试相似名称。

参数名、类型、枚举和必填项以当前工具契约为准；windcode、windCode、windCodes 不能互换，数组与逗号分隔字符串也须按字段类型填写。CLI 负责已实现的代码和参数兼容处理；Agent 不自行猜测交易所后缀。

工具支持自然名称且目标明确时，可直接查询，无需固定先调用筛选工具。需要识别、搜索或条件筛选时，按契约选择具备相应能力的工具；仅在实体、指标、报表或文档标识尚未明确且工具要求时执行前置发现。返回候选存在歧义或无法识别时，请用户确认准确全称或 Wind 标准代码，不静默选择。

用户未指定行业分类等口径时，保留工具契约的适用默认值，不统一强制填入 Wind 行业分类；多结果比较时核对分类、日期与统计口径是否一致。

3. 发命令

先切换到本 SKILL.md 所在目录，再执行：

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

<server_type> 与 <tool_name> 直接取自已确认的契约条目，逐字替换，不做任何拼写调整。

示例：

PowerShell、cmd 或被执行器二次包装时，优先将 UTF-8 JSON 从 stdin 传入并把最后一个参数写为 -，避免命令行转义破坏 JSON，也不需要向 Skill 安装目录写临时文件：

经过可能改写命令文本的 Windows 执行器时，命令中的非 ASCII JSON 值使用 \uXXXX 转义。已有 UTF-8 JSON 文件时也可用 @<文件路径> 传入；临时文件必须位于客户端允许写入的临时目录或工作区，不得写入 Skill 安装目录，也不得复用共享请求文件。

认证由 CLI 处理。仅在实际调用明确返回认证失败或凭证缺失时报告认证问题，不预先猜测；不得在输出、日志或交付文件中写入 Key。

批量与并发

优先使用工具支持的批量参数，并遵守单次上限。确需逐项调用时默认串行，先验证首项的结果与口径再继续。出现认证、限流或服务故障时停止受影响批次；参数问题按下方规则修正后再继续。用户明确要求并发时上限 10，有前置依赖的步骤仍按顺序执行。

4. 验回执

正常返回时 stdout 为 MCP 结果对象，正文通常位于 content[0].text，CLI 另附 cli_meta。检查相关 content 项：可解析为 JSON 时按结构读取，否则按原始文本或表格读取；同时检查 cli_meta.warnings。退出码为 0 或 isError: false 不代表业务成功，正文中的参数拒绝、认证或执行失败信息仍须处理。

核验代码、名称及实体类型与用户目标一致，例如基金管理公司不能作为基金产品作答。检查实际日期、频率、单位、量级、币种及统计口径；元数据缺失、互相矛盾或不适用于某个资产时，保留原值并说明限制，不猜测或强行换算。需要计算或单位转换时，必须有明确输入口径和可说明的计算依据。

按请求的标的、字段和区间核对覆盖范围，不能仅信返回的总数或成功摘要。仅当整个目标无有效数据且无执行错误时报告 NO_RESULTS；部分有效时返回有效部分并说明缺失、失败或不适用项，标为 DONE_WITH_LIMITS。缺失值不得当作 0，也不得将局部空表视为整个请求无结果。

错误与恢复

CLI 失败通常返回 { "ok": false, "code": "...", "message": "..." }，也可能在 MCP 正文中出现失败说明。backend_error 可能包含可修正的参数错误，不能仅凭该代码判定服务故障。依据错误内容处理：

• 缺字段、类型、枚举或参数组合错误：按明确错误及当前契约修正，保持用户的筛选条件、日期和口径；必要值无法确定时澄清，不擅自补值。
• 身份歧义或实体类型错配：不使用错配结果作答，确认目标后再查询。
• 认证、额度或限流：停止受影响调用，按实际原因说明；限流不等同额度耗尽。
• 明确后端执行故障：保留原始错误，标为 BLOCKED_BACKEND，无需通过其他服务复现；本地执行或网络传输阻断标为 BLOCKED_RUNTIME，说明具体阶段。

同一请求的有效结果在时点仍适用时复用。参数错误须有修正依据才重试；明确可重试的暂时性故障仅在满足返回的恢复条件后原样重试一次，仍失败则停止，不用换工具掩盖失败。只有契约表明原工具不支持需求时才调整业务路由。合法空结果不盲目重试或放宽条件。

成功返回数据时，在答复末尾附与用户语言一致的来源声明：

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

Data sourced from Wind Alice Financial Data Service.