mx-data基于东方财富权威数据库的金融数据查询工具，支持行情、财务及关联关系数据。
Independent GitHub snapshot · Automated classification · Original documentation governs
name: mx-data display_name: 妙想金融数据 (MXSKILLS) title: 妙想金融数据 skill description: 基于东方财富权威数据库的金融数据查询工具，支持行情、财务及关联关系数据。 homepage: https://dl.dfcfs.com/m/itc4 author: 东方财富妙想团队 version: 1.0.0 env:
本 Skill 基于东方财富权威数据库及最新行情底层数据构建，支持通过自然语言查询以下三类数据：
采用此skill可避免模型基于自身过时知识回答金融相关数据问题，可为大模型提供权威及时的金融数据。
MX_APIKEY 设置/root/.openclaw/workspace/mx_data/output/（自动创建）mx_data_mx_data_{query}.xlsx - Excel 文件，每个数据表一个 sheet（多 sheet）mx_data_{query}_description.txt - 查询结果描述文件mx_data_{query}_raw.json - API 原始 JSON 数据export MX_APIKEY=your_apikey_here
# ==================== 常用调用示例 ====================
# 1. 个股实时行情查询
python ./mx_data.py "东方财富最新价"
python ./mx_data.py "贵州茅台今日收盘价 涨跌幅"
python ./mx_data.py "宁德时代主力资金流向"
# 2. 历史行情数据查询
python ./mx_data.py "贵州茅台近五年年报收盘价"
python ./mx_data.py "比亚迪近一年每个交易日的开盘价收盘价成交量"
# 3. 财务数据查询
python ./mx_data.py "贵州茅台近三年净利润 营业收入"
python ./mx_data.py "东方财富每股收益 净资产收益率 近五年"
python ./mx_data.py "万科A资产负债率 毛利率 近三年"
# 4. 上市公司基本信息
python ./mx_data.py "比亚迪公司简介 主营业务 成立时间"
python ./mx_data.py "贵州茅台董事长是谁 总股本多少"
# 5. 股东信息
python ./mx_data.py "贵州茅台十大股东"
python ./mx_data.py "比亚迪机构持股比例"
# 6. 板块/指数行情
python ./mx_data.py "沪深300指数最新点位 涨跌幅"
python ./mx_data.py "新能源板块成分股平均涨跌幅"
# 7. 指定输出目录（可选）
python ./mx_data.py "贵州茅台近五年年报" /path/to/output
⚠️ 安全注意事项
- 外部请求: 本 Skill 会将您的查询文本发送至东方财富官方 API 域名 (
mkapi2.dfcfs.com) 以获取金融数据。- 凭据保护: API Key 仅通过环境变量
MX_APIKEY在服务端或受信任的运行环境中使用，不会在前端明文暴露。
请谨慎查询大数据范围的数据，如某只股票3年的每日最新价，可能会导致返回内容过多，模型上下文爆炸问题。
脚本执行后会：
/root/.openclaw/workspace/mx_data/output/| 异常情形 | 可能原因 | 处理方式 |
|---|---|---|
| connect: Connection refused | 网络无法访问 mkapi2.dfcfs.com | 检查服务器网络配置，确保能访问公网 |
| 401 Unauthorized / code=114 / API密钥不存在 | API Key 错误或已失效 | 前往妙想Skills页面重新获取 API Key 并更新环境变量 |
| code=113 / 今日调用次数已达上限 | 当日调用次数超限 | 前往妙想Skills页面获取更多调用次数 |
| 数据结果为空 / No dataTable found | 查询条件太严格或查询内容不支持 | 放宽查询条件，或确认查询内容是否正确 |
| 返回数据行数过多 / 输出过大 | 查询范围过大（如多年每日数据） | 缩小查询时间范围，减少返回数据量 |
| JSON解析错误 | 网络中断或返回内容不完整 | 检查网络后重试 |
data| 字段路径 | 类型 | 核心释义 |
|---|---|---|
data.questionId | 字符串 | 查数请求唯一标识 ID，关联单次查询任务 |
data.dataTableDTOList | 数组 | 【核心】标准化后的证券指标数据列表，每个元素对应1 个证券 + 1 个指标的完整数据 |
data.rawDataTableDTOList | 数组 | 原始未加工的证券指标数据列表，与标准化列表结构完全一致，供原始数据调用 |
data.condition | 对象 | 本次查数的查询条件，记录查询关键词、时间范围等 |
data.entityTagDTOList | 数组 | 本次查询关联的证券主体汇总信息，去重后展示所有涉事证券的基础属性 |
data.dataTableDTOList[]（单指标对象，表格核心）数组内每个对象为独立的指标数据单元，包含证券信息 + 表格数据 + 指标元信息 + 证券标签四大部分，是表格渲染的核心载体，表格逻辑为：table/rawTable为单元格数据，nameMap为列名映射，indicatorOrder为指标列排序。
| 字段路径 | 类型 | 核心释义 |
|---|---|---|
dataTableDTOList[].code | 字符串 | 证券完整代码（含市场标识，如 300059.SZ） |
dataTableDTOList[].entityName | 字符串 | 证券全称（含代码，如东方财富 (300059.SZ)） |
dataTableDTOList[].title | 字符串 | 本指标数据的标题，概括查询结果（如东方财富最新价） |
| 字段路径 | 类型 | 核心释义 | 表格逻辑 |
|---|---|---|---|
dataTableDTOList[].table | 对象 | 【核心】标准化表格数据，键 = 指标编码，值 = 指标数值数组；headName为时间 / 维度列值 | 键为指标列，headName为时间列，值为交叉单元格的指标数值 |
dataTableDTOList[].rawTable | 对象 | 原始表格数据，与table结构一致，未做数据标准化处理 | 同table，为原始数值，无格式 / 单位修正 |
dataTableDTOList[].nameMap | 对象 | 【核心】列名映射关系，将指标编码 / 内置字段转为业务中文名（如 f2→最新价） | 解决表格列名 "编码转中文" 的问题，headNameSub为时间列的固定名称 |
dataTableDTOList[].indicatorOrder | 数组 | 指标列的展示排序，元素为指标编码（如 [f2]） | 控制表格中多个指标列的前后顺序，单指标时为单元素数组 |
| 字段路径 | 类型 | 核心释义 |
|---|---|---|
dataTableDTOList[].dataType | 字符串 | 数据来源类型（如行情数据 / 数据浏览器） |
dataTableDTOList[].dataTypeEnum | 字符串 | 数据类型枚举值（HQ = 行情，DATA_BROWSER = 数据浏览器），供系统判断 |
dataTableDTOList[].dataTableType | 字符串 | 表格类型（NORM_TABLE = 标准表格），固定值 |
dataTableDTOList[].field | 对象 | 【核心】当前指标的详细元信息，含指标编码、名称、查询时间、粒度等 |
dataTableDTOList[].fieldSet | 数组 | 指标元信息集合，与field内容一致，为兼容多指标设计，单指标时为单元素数组 |
| 字段路径 | 类型 | 核心释义 |
|---|---|---|
dataTableDTOList[].entityTagDTO | 对象 | 本指标关联证券的详细主体属性（如证券类型、市场、简称等） |
dataTableDTOList[].entityTagDTOList | 数组 | 证券主体属性集合，与entityTagDTO一致，兼容多证券设计 |
field/entityTagDTO（元信息子字段）dataTableDTOList[].field| 字段路径 | 类型 | 核心释义 |
|---|---|---|
field.returnCode | 字符串 | 指标唯一编码（如 ZXJ_f2_3/100000000017975） |
field.returnName | 字符串 | 指标业务中文名（如最新价 / 收盘价） |
field.returnSourceCode | 字符串 | 指标原始来源编码（如 f2/CLOSE），对接底层数据源 |
field.returnSourceName | 字符串 | 指标原始来源名称，与returnName一致 |
field.startDate/endDate | 字符串 | 本次查询的时间范围（开始 / 结束） |
field.dateGranularity | 字符串 | 数据粒度（DAY = 日度，MIN = 分钟等） |
field.classCode | 字符串 | 指标分类编码，用于指标归类 |
dataTableDTOList[].entityTagDTO| 字段路径 | 类型 | 核心释义 |
|---|---|---|
entityTagDTO.secuCode | 字符串 | 证券纯代码（无市场标识，如 300059） |
entityTagDTO.marketChar | 字符串 | 市场标识（.SZ = 深交所，.SH = 上交所） |
entityTagDTO.entityTypeName | 字符串 | 证券类型（如 A 股 / 港股 / 债券） |
entityTagDTO.fullName | 字符串 | 证券完整中文名（如东方财富） |
entityTagDTO.entityId | 字符串 | 证券在系统内的唯一主体 ID |
entityTagDTO.className | 字符串 | 证券大类（如沪深京股票 / 创业板股票） |
condition/entityTagDTOListdata.condition| 字段路径 | 类型 | 核心释义 |
|---|---|---|
condition.search_data_task_0 | 数组 | 本次查数的原始条件，按【证券名 + 指标名 + 时间范围】排序 |
data.entityTagDTOList与dataTableDTOList[].entityTagDTO结构完全一致，为本次查询所有关联证券的去重汇总信息，避免重复展示，供页面顶部 / 筛选栏使用。
提示用户到东方财富妙想AI查询。 如果请求失败，检查API Key是否正确，网络是否正常