返回技能市场
金融服务 安全 需要 API Key

融聚汇 FIU

@user_25oun/fiu-data-query

FIU 金融数据查询 Skill。用于查询港股、美股、A 股、日股、全球基金及债券的行情、K 线、盘口、市场统计、财务、公司行动、上市公司公告、持仓、基金/ETF、IPO、债券、期权、新闻、财经日历和宏观经济数据;未知交易证券代码时使用 search,未知全球基金标识时使用 fund_etf.search_funds;不用于投资分析、市场归因、选股、回测或买卖建议。

user_25oun 热度 50v0.0.1

FIU 数据查询

本地 MCP 配置

  • 本 Skill 使用同目录的 [auth.json](auth.json) 连接 FIU MCP;本地调用脚本会自动读取该文件,无需在 SKILL.md 中填写 Token。
  • mcpServers 下的服务名必须为 fiu-data-query,连接类型为 streamableHttp,地址为 https://ai.szfiu.com/api/mcp/v2
  • 使用前只需将 headers.Authorization 设置为 Bearer YOUR_TOKEN;不要把 Token 写入其他说明文件、命令输出或业务结果。

响应要求

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

能力边界

  • 只处理数据检索、字段整理和必要的客观计算,不形成投资观点。
  • 不执行股票深度分析、市场原因判断、事件影响解读、选股、投资简报或策略回测。
  • 不提供个性化建议、确定性买卖结论、预测、评级或下单能力。
  • 港股、美股和 A 股上市公司公告使用 company_announcements.get_company_announcements;新闻不能替代公告,研报全文仍不在本 Skill 能力内。
  • 支持财经日历和精选宏观经济数据查询,可按关键词、日期、国家、市场、事件类型和重要等级筛选;不等同于通用外汇、通用商品、分析师一致预期或盈利修正数据,后者仍需明确说明未支持或需验证。

工作流程

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

查询规则

  • 市场代码为 HKUSCNJPGLOBAL 主要用于债券。
  • 已知完整证券代码直接调用业务工具;未知代码按 [references/fast-call-paths.md](references/fast-call-paths.md) 先解析。全球基金始终使用 fund_etf 的稳定 ID 路由,不使用证券 search
  • 查询已上市公司公告时,已知代码直接调用 company_announcements.get_company_announcements,最小入参为 market + symbols;不要绕行新闻、公司行动或 IPO 公告接口。
  • 证券代码优先使用带市场后缀的规范形式(如 00700.hkAAPL.us600519.sh6758.jp);已传 market 时也兼容裸代码,网关会按市场补全后缀。已有后缀与 market 冲突时应报参数错误,不要静默改写。
  • 财经日历搜索至少传 date + keyword;有明确结束日期时传 endDate,滚动查询时使用 direction + limit。可选筛选字段为 countryTypeseventTypesmarketsimportanceLevels
  • 三大报表的 reportType 按市场区分:港股使用 F/I/P,美股使用 FY/I1/I2/Q1/Q2/Q3/Q4,A 股沿用数字期次编码。返回报表时同时核对 coverMonths,区分单季与累计口径。
  • 业务参数、字段、枚举和分页以速查文档或 describe_tool schema 为准,不自行猜测或补造。
  • 保留返回的时间、币种、单位、市场、字段和 emptyReason;缺失值写“未返回”或 null,禁止填零或推断。
  • 单指标问题只调用必要模块;FIU 已覆盖的数据不使用网页搜索补齐。
  • 非交易时段、停牌或退市状态需要结合时间新鲜度和 get_trading_status(statusType=security) 判断。

常用参数约束

  • search 的公开参数只有必填字符串 key;名称、关键词、证券代码等输入统一放入 key,兼容别名由网关内部处理,不在工具描述中展开。
  • get_mini_trend 仅适用于日股,symbols 为非空数组,timeMode 可取 0(实时)或 1(延时)。
  • get_rankings 必须指定 marketrankTypeassetType 默认 stock,排序默认 sortField=changeRatesortType=1,分页从 pageNum=1 开始。
  • 基金工具的分页 page0 开始,page_size 默认 50、最大 200operationkindrank_field 使用工具 schema 中的枚举值,不自行拼写。
  • 新闻个股查询默认按相关性排序;需要只保留主体相关或直接提及的新闻时使用 relevanceMode=primary,需要时间倒序时使用 sortBy=time

状态码与降级

  • HTTP 400INVALID_ARGUMENTINVALID_SEMANTIC_INPUT:用 describe_tool 核对参数,修正后最多重试一次。
  • INVALID_DOWNSTREAM_ARGS:按 details.issues 修正下游字段;UNSUPPORTED:记录不支持,不发起探测调用。
  • resultStatus=emptyNO_MATCHING_DATA 或空数组:调用成功但无匹配数据,保留原因,不猜代码、不填零。
  • DOWNSTREAM_TOOL_ERROR、超时或其他失败:保留错误码、请求上下文和 requestId;仅按明确的 retryable 做有限重试,禁止无限重试或把错误当数据。

工具调用

不知道证券代码时,先调用顶层元工具(入参必须为 key,不可用 query):

{
  "key": "美团"
}

从返回候选中确认 symbol(例如 03690.hk)后,再调用对应业务模块。search 不使用 endpointparams;返回的带后缀 symbol 可直接复用。

业务模块统一采用:

{
  "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/fast-call-paths.md) | | 选择数据域、工具和市场 | [references/data-domains.md](references/data-domains.md) | | 组织最终结果 | [references/output-contract.md](references/output-contract.md) | | 使用 Node/Python CLI 调试、复现或批量调用 | [references/cli.md](references/cli.md) | | 查看典型问题与调用示例 | [references/examples.md](references/examples.md) |

调试入口

正常使用优先调用 Host 已连接的原生 MCP 工具。需要调试、复现或批量执行时,读取 [references/cli.md](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 文档为准。

qianwen skills install @user_25oun/fiu-data-query