妙想金融数据 Skill (mx_data)

Overview

此 Skill 通过妙想（Meixiang）金融数据接口，为用户提供实时、权威的金融数据查询能力，覆盖三大类信息：

1. 行情类 – 股票、行业、板块、指数、基金、债券的实时行情、主力资金流向、估值等。
2. 财务类 – 上市公司及非上市公司的基本信息、财务指标、高管信息、主营业务、股东结构、融资情况等。
3. 关系与经营类 – 股票、非上市公司、股东及高管之间的关联关系，以及企业经营相关数据。

Prerequisites

1. 在 妙想 Skills 页面获取 API key。
2. 将 API key 写入环境变量 MX_APIKEY：

   export MX_APIKEY="your_api_key_here"
   

3. 本地需安装 curl（macOS 默认已装）。

Usage Steps

1. 构造请求 – 根据业务需求准备 JSON payload，最基本的字段为 toolQuery（查询关键词），如

   {"toolQuery": "东方财富最新价"}
   

2. 发送 POST 请求：

   curl -X POST \
     --location 'https://mkapi2.dfcfs.com/finskillshub/api/claw/query' \
     --header 'Content-Type: application/json' \
     --header "apikey:${MX_APIKEY}" \
     --data '{"toolQuery": "<YOUR_QUERY>"}'
   

3. 解析响应 – 关键返回字段（仅展示需向下游暴露的核心内容）：
   • data.questionId – 本次查询的唯一标识。
   • data.dataTableDTOList – 标准化的证券指标数据列表，每个元素对应 1 个证券 + 1 个指标，包含 code、entityName、title、table（指标值）、nameMap（列名映射） 等。
   • data.entityTagDTOList – 本次查询涉及的证券主体信息（代码、市场、证券类型、全名等），用于去重展示。
   • data.condition – 本次查询的条件描述（关键词、时间范围等）。
4. 返回给用户 – 将 title、关键指标值、关联证券（entityTagDTO）以可读表格或简要文字形式呈现。必要时可将完整 JSON 保存到工作目录（mx_data_result.json）。

Example

用户查询："东方财富最新价"

命令：

curl -X POST --location 'https://mkapi2.dfcfs.com/finskillshub/api/claw/query' \
  --header 'Content-Type: application/json' \
  --header 'apikey:${MX_APIKEY}' \
  --data '{"toolQuery": "东方财富最新价"}'

返回（示例）：

{
  "status":0,
  "message":"ok",
  "data":{
    "questionId":"Q20260314-001",
    "dataTableDTOList":[{
      "code":"300059.SZ",
      "entityName":"东方财富 (300059.SZ)",
      "title":"最新价",
      "table":{"f2":[22.45]},
      "nameMap":{"f2":"最新价"},
      "indicatorOrder":["f2"]
    }],
    "entityTagDTOList":[{
      "secuCode":"300059",
      "marketChar":"SZ",
      "entityTypeName":"A股",
      "fullName":"东方财富",
      "entityId":"ent_300059",
      "className":"沪深A股"
    }]
  }
}

向用户展示：

• 证券：东方财富 (300059.SZ)
• 最新价：22.45 元
• 查询 ID：Q20260314-001

Data Size Warning

查询涉及大范围、长时间序列或大量证券时，返回数据量可能非常大，导致上下文超限或性能下降。建议在 toolQuery 中加入 具体筛选条件（如具体股票代码、时间范围）或使用分页参数（若接口支持）。

When Not to Use

• 非金融/非财务相关查询。
• 需要主观分析或意见建议的场景（本 Skill 只返回原始数据）。

References

• Meixiang API 文档（内部）。
• 示例查询表格列映射说明（nameMap）。