FIU-data-query

通过 FIU Finance MCP 查询可核验的金融事实数据。识别用户需要的市场、标的、时间范围、频率和字段，调用正确的数据模块，并说明数据时间、币种、覆盖范围和缺失项。

响应要求

快速：已知代码直达最窄 endpoint；独立查询并行；不为“完整性”调用无关模块，也不重复搜索或 describe_tool。
准确：先完成必要的标识和参数校验；原样保留状态、时间、币种、单位、null 和缺失项，不用猜测或默认值补齐。
简洁：先返回核心数据，再补最少必要的来源、时间口径和警告；没有请求的字段、原始 JSON 和冗余解释不输出。

能力边界

只处理数据检索、字段整理和必要的客观计算，不形成投资观点。
不执行股票深度分析、市场原因判断、事件影响解读、选股、投资简报或策略回测。
不提供个性化建议、确定性买卖结论、预测、评级或下单能力。
港股、美股和 A 股上市公司公告使用 company_announcements.get_company_announcements；新闻不能替代公告，研报全文仍不在本 Skill 能力内。
当前未确认支持宏观经济日历、CPI、政策利率、通用外汇、通用商品、分析师一致预期及盈利修正；遇到这些需求应明确说明未支持或需验证。

工作流程

提取查询意图、市场、资产类型、证券、时间范围、频率、字段和排序条件。
解析标识：按速查文档选择证券 search 或基金 search_funds，复用返回的稳定标识；候选有歧义时先澄清。
先读取 references/fast-call-paths.md；需要数据域路由或市场边界时再读取 references/data-domains.md。
仅在速查未覆盖、分支不明或最小调用失败时调用 describe_tool，不要猜下游参数。
业务模块统一传入 { endpoint, params }；顶层 search 直接传 { key }。
检查状态、时间、币种、市场、请求/返回字段和空数据原因，并按 references/output-contract.md 输出。

查询规则

市场代码为 HK、US、CN、JP；GLOBAL 主要用于债券。
已知完整证券代码直接调用业务工具；未知代码按 references/fast-call-paths.md 先解析。全球基金始终使用 fund_etf 的稳定 ID 路由，不使用证券 search。
查询已上市公司公告时，已知代码直接调用 company_announcements.get_company_announcements，最小入参为 market + symbols；不要绕行新闻、公司行动或 IPO 公告接口。
业务参数、字段、枚举和分页以速查文档或 describe_tool schema 为准，不自行猜测或补造。
保留返回的时间、币种、单位、市场、字段和 emptyReason；缺失值写“未返回”或 null，禁止填零或推断。
单指标问题只调用必要模块；FIU 已覆盖的数据不使用网页搜索补齐。
非交易时段、停牌或退市状态需要结合时间新鲜度和 get_trading_status(statusType=security) 判断。

状态码与降级

工具不可用：停止查询，提示检查 MCP 连接和鉴权。
HTTP 401：提示客户端检查 Bearer Token；不索要或记录 Token。
HTTP 400、INVALID_ARGUMENT 或 INVALID_SEMANTIC_INPUT：用 describe_tool 核对参数，修正后最多重试一次。
INVALID_DOWNSTREAM_ARGS：按 details.issues 修正下游字段；UNSUPPORTED：记录不支持，不发起探测调用。
resultStatus=empty、NO_MATCHING_DATA 或空数组：调用成功但无匹配数据，保留原因，不猜代码、不填零。
DOWNSTREAM_TOOL_ERROR、超时或其他失败：保留错误码、请求上下文和 requestId；仅按明确的 retryable 做有限重试，禁止无限重试或把错误当数据。

工具调用

不知道证券代码时，先调用顶层元工具（入参必须为 key，不可用 query）：

{
  "key": "美团"
}

从返回候选中确认 symbol（例如 03690.hk）后，再调用对应业务模块。search 不使用 endpoint 和 params。

业务模块统一采用：

{
  "endpoint": "get_quote",
  "params": {
    "market": "HK",
    "assetType": "stock",
    "symbols": ["00700.hk"]
  }
}

全球基金名称先用 fund_etf.search_funds 解析为稳定标识，再将 fundid / fundclassid 作为 fund_id / fund_class_id 调用目标 endpoint；不要用证券 search 代替。

不确定调用方式时：

{
  "toolNames": ["quote_spot", "get_quote"],
  "detail": "params"
}

按需加载参考文档

| 场景 | 读取文档 | | ----------------------------------------- | --------------------------------------------------------------- | | 高频查询的工具、路由和最小入参 | references/fast-call-paths.md | | 选择数据域、工具和市场 | references/data-domains.md | | 组织最终结果 | references/output-contract.md | | 配置 URL、Token 或处理未连接 | references/setup-and-auth.md | | 使用 Node/Python CLI 调试、复现或批量调用 | references/cli.md | | 查看典型问题与调用示例 | references/examples.md |

调试入口

正常使用优先调用 Host 已连接的原生 MCP 工具。需要调试、复现或批量执行时，读取 references/cli.md。例如：

node scripts/call.js list
node scripts/call.js call search --param key=美团
node scripts/call.js describe quote_kline,get_kline
node scripts/call.js call quote_spot --endpoint get_quote --param market=HK --param assetType=stock --param symbols=03690.hk

Python 环境也可使用 scripts/call.py；全局 --url 参数的位置与 Node 版略有不同，以 CLI 文档为准。