Wind 金融数据查询
通过本 Skill 自带 CLI 调用 Wind MCP。金融事实以工具返回的数据与来源材料为依据;区分原始数据、来源观点和基于数据的推导,不把模型记忆、Web Search 或常识补全伪装成已核验数据。
按需渐进加载:明确需求 → 定位业务域 → 读取相关 reference 并确认工具覆盖 → 按需组织调用 → 核验结果。endpoint、请求头、认证和传输由 CLI 负责;模型不构造这些实现细节。
1. 定路由
根据金融对象和业务意图定位 server_type,再按契约确认工具是否支持所需数据、时间范围、粒度、口径及标的数量。已有信息足够时直接查询;缺少影响结果的必要信息且契约无适用默认值时,再向用户澄清。
server_type |
首选场景 | 按需加载 |
|---|---|---|
stock_research |
股票 | references/stock/ |
fund_research |
基金、ETF、REITs | references/fund/ |
options_data |
期权 | references/options/ |
futures_data |
期货 | references/futures/futures.md |
company_data |
企业、风控 | references/company/ |
edb_data |
宏观、行业与区域经济 | references/economic/economic.md |
index_data |
指数、板块 | references/index/index.md |
bond_data |
债券 | references/bond/bond.md |
financial_docs |
公告与财经新闻 | references/financial-docs/financial-docs.md |
analytics_data |
专项未覆盖的聚合与指标计算 | references/analytics/analytics.md |
general_data |
专项未覆盖的通用金融行情、指标、报表、文档与投研参考资料 | references/general/general.md |
路由规则
优先使用能满足需求的专项工具;专项未覆盖所需数据、时间粒度、参数口径或批量能力时,检查 general_data 的对应契约。对象属于某一专项,不代表该专项覆盖其全部数据。例如,股票历史 K 线进入通用历史行情工具,指数 K 线使用指数专项工具。
单个工具支持完整需求时直接调用,包括契约支持的多标的或跨资产批量查询。只有需要不同工具或超过单次限制时才拆分;有依赖的调用先取得并复用前置结果。
交叉场景按所需结果分流:上市公司财务与估值进入 stock_research,工商、股权穿透与司法记录进入 company_data;行业研究资料与板块盘中综合分析进入 stock_research,指数档案、点位序列与预定义指标进入 index_data;公告与财经新闻检索优先 financial_docs,研报清单、单篇文档全文及精确类型/日期筛选进入 general_data 的文档链路。
analytics_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> 直接取自已确认的契约条目,逐字替换,不做任何拼写调整。
示例:
node scripts/cli.mjs call stock_research stock_get_company_profile '{"windCode":"600519.SH"}'
node scripts/cli.mjs call fund_research fund_get_basic_info '{"windCodes":["005827.OF"]}'
node scripts/cli.mjs call company_data company_search_entity '{"searchKey":"贵州茅台"}'
node scripts/cli.mjs call edb_data economic_search_indicator '{"question":"中国GDP相关指标"}'
PowerShell、cmd 或被执行器二次包装时,优先将 UTF-8 JSON 从 stdin 传入并把最后一个参数写为 -,避免命令行转义破坏 JSON,也不需要向 Skill 安装目录写临时文件:
$requestJson='{"windCodes":["600519.SH"],"indexes":"\u6700\u65b0\u6210\u4ea4\u4ef7,\u4ea4\u6613\u65f6\u95f4"}'
$requestJson | node scripts/cli.mjs call general_data quote_get_realtime_indicators -
经过可能改写命令文本的 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.