File contents mx-data 妙想金融数据 skill
本 Skill 基于东方财富权威数据库 及最新行情底层数据 构建,支持通过自然语言 查询以下三类数据:
行情类数据 股票、行业、板块、指数、基金、债券的实时行情、主力资金流向、估值等数据。
财务类数据 上市公司与非上市公司的基本信息、财务指标、高管信息、主营业务、股东结构、融资情况等数据。
关系与经营类数据 股票、非上市公司、股东及高管之间的关联关系数据,以及企业经营相关数据。
采用此skill可避免模型基于自身过时知识回答金融相关数据问题,可为大模型提供权威及时的金融数据。
配置
API Key : 通过环境变量 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 数据
使用方式(直接 Python 脚本调用)
在妙想Skills页面获取apikey。(链接:https://dl.dfcfs.com/m/itc4 )
将apikey存到环境变量,命名为MX_APIKEY:export MX_APIKEY=your_apikey_here
直接运行 Python 脚本查询,支持自然语言问句:
# ==================== 常用调用示例 ====================
# 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年的每日最新价,可能会导致返回内容过多,模型上下文爆炸问题。
输出说明
脚本执行后会:
在终端输出查询结果预览(前20行)
自动创建输出目录 /root/.openclaw/workspace/mx_data/output/
保存完整数据到 Excel 文件(多 sheet)
保存原始 JSON 响应供二次处理
保存描述文件记录查询条件和结果统计
异常情形与处理方式
异常情形
可能原因
处理方式
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为指标列排序 。
2.1 证券基础信息
字段路径
类型
核心释义
dataTableDTOList[].code
字符串
证券完整代码(含市场标识,如 300059.SZ)
dataTableDTOList[].entityName
字符串
证券全称(含代码,如东方财富 (300059.SZ))
dataTableDTOList[].title
字符串
本指标数据的标题,概括查询结果(如东方财富最新价)
2.2 表格数据核心(渲染用)
字段路径
类型
核心释义
表格逻辑
dataTableDTOList[].table
对象
【核心】标准化表格数据,键 = 指标编码,值 = 指标数值数组 ;headName为时间 / 维度列值
键为指标列 ,headName为时间列 ,值为交叉单元格的指标数值
dataTableDTOList[].rawTable
对象
原始表格数据,与table结构一致,未做数据标准化处理
同table,为原始数值,无格式 / 单位修正
dataTableDTOList[].nameMap
对象
【核心】列名映射关系,将指标编码 / 内置字段 转为业务中文名 (如 f2→最新价)
解决表格列名 "编码转中文" 的问题,headNameSub为时间列的固定名称
dataTableDTOList[].indicatorOrder
数组
指标列的展示排序,元素为指标编码(如 [f2])
控制表格中多个指标列的前后顺序,单指标时为单元素数组
2.3 指标元信息(属性 / 规则)
字段路径
类型
核心释义
dataTableDTOList[].dataType
字符串
数据来源类型(如行情数据 / 数据浏览器)
dataTableDTOList[].dataTypeEnum
字符串
数据类型枚举值(HQ = 行情,DATA_BROWSER = 数据浏览器),供系统判断
dataTableDTOList[].dataTableType
字符串
表格类型(NORM_TABLE = 标准表格),固定值
dataTableDTOList[].field
对象
【核心】当前指标的详细元信息,含指标编码、名称、查询时间、粒度等
dataTableDTOList[].fieldSet
数组
指标元信息集合,与field内容一致,为兼容多指标设计,单指标时为单元素数组
2.4 证券标签信息(主体属性)
字段路径
类型
核心释义
dataTableDTOList[].entityTagDTO
对象
本指标关联证券的详细主体属性(如证券类型、市场、简称等)
dataTableDTOList[].entityTagDTOList
数组
证券主体属性集合,与entityTagDTO一致,兼容多证券设计
三级核心路径:field/entityTagDTO(元信息子字段)
3.1 指标元信息: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
字符串
指标分类编码,用于指标归类
3.2 证券主体属性:dataTableDTOList[].entityTagDTO
字段路径
类型
核心释义
entityTagDTO.secuCode
字符串
证券纯代码(无市场标识,如 300059)
entityTagDTO.marketChar
字符串
市场标识(.SZ = 深交所,.SH = 上交所)
entityTagDTO.entityTypeName
字符串
证券类型(如 A 股 / 港股 / 债券)
entityTagDTO.fullName
字符串
证券完整中文名(如东方财富)
entityTagDTO.entityId
字符串
证券在系统内的唯一主体 ID
entityTagDTO.className
字符串
证券大类(如沪深京股票 / 创业板股票)
其他核心路径:condition/entityTagDTOList
4.1 查询条件:data.condition
字段路径
类型
核心释义
condition.search_data_task_0
数组
本次查数的原始条件,按【证券名 + 指标名 + 时间范围】排序
4.2 证券主体汇总:data.entityTagDTOList
与dataTableDTOList[].entityTagDTO结构完全一致,为本次查询所有关联证券的去重汇总信息,避免重复展示,供页面顶部 / 筛选栏使用。
数据结果为空
提示用户到东方财富妙想AI查询。
如果请求失败,检查API Key是否正确,网络是否正常
1 --- 2 name: mx-data 3 description: 基于东方财富权威数据库的金融数据查询工具,支持行情、财务及关联关系数据。 4 --- 5 6 # mx-data 妙想金融数据 skill 7 8 本 Skill 基于**东方财富权威数据库**及**最新行情底层数据**构建,支持通过**自然语言**查询以下三类数据: 9 10 1. **行情类数据** 11 股票、行业、板块、指数、基金、债券的实时行情、主力资金流向、估值等数据。 12 2. **财务类数据** 13 上市公司与非上市公司的基本信息、财务指标、高管信息、主营业务、股东结构、融资情况等数据。 14 3. **关系与经营类数据** 15 股票、非上市公司、股东及高管之间的关联关系数据,以及企业经营相关数据。 16 17 采用此skill可避免模型基于自身过时知识回答金融相关数据问题,可为大模型提供权威及时的金融数据。 18 19 ## 配置 20 21 - **API Key**: 通过环境变量 `MX_APIKEY` 设置 22 - **默认输出目录**: `/root/.openclaw/workspace/mx_data/output/`(自动创建) 23 - **输出文件名前缀**: `mx_data_` 24 - **输出文件**: 25 - `mx_data_{query}.xlsx` - Excel 文件,每个数据表一个 sheet(多 sheet) 26 - `mx_data_{query}_description.txt` - 查询结果描述文件 27 - `mx_data_{query}_raw.json` - API 原始 JSON 数据 28 29 ## 使用方式(直接 Python 脚本调用) 30 31 1. 在妙想Skills页面获取apikey。(链接:https://dl.dfcfs.com/m/itc4) 32 2. 将apikey存到环境变量,命名为MX_APIKEY: 33 ```bash 34 export MX_APIKEY=your_apikey_here 35 ``` 36 3. 直接运行 Python 脚本查询,支持自然语言问句: 37 38 ```bash 39 # ==================== 常用调用示例 ==================== 40 41 # 1. 个股实时行情查询 42 python ./mx_data.py "东方财富最新价" 43 python ./mx_data.py "贵州茅台今日收盘价 涨跌幅" 44 python ./mx_data.py "宁德时代主力资金流向" 45 46 # 2. 历史行情数据查询 47 python ./mx_data.py "贵州茅台近五年年报收盘价" 48 python ./mx_data.py "比亚迪近一年每个交易日的开盘价收盘价成交量" 49 50 # 3. 财务数据查询 51 python ./mx_data.py "贵州茅台近三年净利润 营业收入" 52 python ./mx_data.py "东方财富每股收益 净资产收益率 近五年" 53 python ./mx_data.py "万科A资产负债率 毛利率 近三年" 54 55 # 4. 上市公司基本信息 56 python ./mx_data.py "比亚迪公司简介 主营业务 成立时间" 57 python ./mx_data.py "贵州茅台董事长是谁 总股本多少" 58 59 # 5. 股东信息 60 python ./mx_data.py "贵州茅台十大股东" 61 python ./mx_data.py "比亚迪机构持股比例" 62 # 6. 板块/指数行情 63 python ./mx_data.py "沪深300指数最新点位 涨跌幅" 64 python ./mx_data.py "新能源板块成分股平均涨跌幅" 65 66 # 7. 指定输出目录(可选) 67 python ./mx_data.py "贵州茅台近五年年报" /path/to/output 68 ``` 69 70 > ⚠️ **安全注意事项** 71 > 72 > - **外部请求**: 本 Skill 会将您的查询文本发送至东方财富官方 API 域名 ( `mkapi2.dfcfs.com` ) 以获取金融数据。 73 > - **凭据保护**: API Key 仅通过环境变量 `MX_APIKEY` 在服务端或受信任的运行环境中使用,不会在前端明文暴露。 74 75 ## 数据限制说明 76 77 请谨慎查询大数据范围的数据,如某只股票3年的每日最新价,可能会导致返回内容过多,模型上下文爆炸问题。 78 79 ## 输出说明 80 81 脚本执行后会: 82 1. 在终端输出查询结果预览(前20行) 83 2. 自动创建输出目录 `/root/.openclaw/workspace/mx_data/output/` 84 3. 保存完整数据到 Excel 文件(多 sheet) 85 4. 保存原始 JSON 响应供二次处理 86 5. 保存描述文件记录查询条件和结果统计 87 88 ## 异常情形与处理方式 89 90 | 异常情形 | 可能原因 | 处理方式 | 91 |----------|----------|----------| 92 | **connect: Connection refused** | 网络无法访问 mkapi2.dfcfs.com | 检查服务器网络配置,确保能访问公网 | 93 | **401 Unauthorized / code=114 / API密钥不存在** | API Key 错误或已失效 | 前往妙想Skills页面重新获取 API Key 并更新环境变量 | 94 | **code=113 / 今日调用次数已达上限** | 当日调用次数超限 | 前往妙想Skills页面获取更多调用次数 | 95 | **数据结果为空 / No dataTable found** | 查询条件太严格或查询内容不支持 | 放宽查询条件,或确认查询内容是否正确 | 96 | **返回数据行数过多 / 输出过大** | 查询范围过大(如多年每日数据) | 缩小查询时间范围,减少返回数据量 | 97 | **JSON解析错误** | 网络中断或返回内容不完整 | 检查网络后重试 | 98 99 ## 返回结果字段释义 100 101 ### 一级核心路径:`data` 102 103 |字段路径|类型|核心释义| 104 |----|----|----| 105 |`data.questionId`|字符串|查数请求唯一标识 ID,关联单次查询任务| 106 |`data.dataTableDTOList`|数组|【核心】标准化后的证券指标数据列表,每个元素对应**1 个证券 + 1 个指标**的完整数据| 107 |`data.rawDataTableDTOList`|数组|原始未加工的证券指标数据列表,与标准化列表结构完全一致,供原始数据调用| 108 |`data.condition`|对象|本次查数的查询条件,记录查询关键词、时间范围等| 109 |`data.entityTagDTOList`|数组|本次查询关联的**证券主体汇总信息**,去重后展示所有涉事证券的基础属性| 110 111 ### 二级核心路径:`data.dataTableDTOList[]`(单指标对象,表格核心) 112 113 数组内每个对象为**独立的指标数据单元**,包含**证券信息 + 表格数据 + 指标元信息 + 证券标签**四大部分,是表格渲染的核心载体,表格逻辑为:`table/rawTable`为**单元格数据**,`nameMap`为**列名映射**,`indicatorOrder`为**指标列排序**。 114 115 #### 2.1 证券基础信息 116 117 |字段路径|类型|核心释义| 118 |----|----|----| 119 |`dataTableDTOList[].code`|字符串|证券完整代码(含市场标识,如 300059.SZ)| 120 |`dataTableDTOList[].entityName`|字符串|证券全称(含代码,如东方财富 (300059.SZ))| 121 |`dataTableDTOList[].title`|字符串|本指标数据的标题,概括查询结果(如东方财富最新价)| 122 123 #### 2.2 表格数据核心(渲染用) 124 125 |字段路径|类型|核心释义|表格逻辑| 126 |----|----|----|----| 127 |`dataTableDTOList[].table`|对象|【核心】标准化表格数据,**键 = 指标编码,值 = 指标数值数组**;`headName`为时间 / 维度列值|键为**指标列**,`headName`为**时间列**,值为交叉单元格的**指标数值**| 128 |`dataTableDTOList[].rawTable`|对象|原始表格数据,与`table`结构一致,未做数据标准化处理|同`table`,为原始数值,无格式 / 单位修正| 129 |`dataTableDTOList[].nameMap`|对象|【核心】列名映射关系,将**指标编码 / 内置字段**转为**业务中文名**(如 f2→最新价)|解决表格列名 "编码转中文" 的问题,`headNameSub`为时间列的固定名称| 130 |`dataTableDTOList[].indicatorOrder`|数组|指标列的展示排序,元素为指标编码(如 \[f2\])|控制表格中多个指标列的前后顺序,单指标时为单元素数组| 131 132 #### 2.3 指标元信息(属性 / 规则) 133 134 |字段路径|类型|核心释义| 135 |----|----|----| 136 |`dataTableDTOList[].dataType`|字符串|数据来源类型(如行情数据 / 数据浏览器)| 137 |`dataTableDTOList[].dataTypeEnum`|字符串|数据类型枚举值(HQ = 行情,DATA_BROWSER = 数据浏览器),供系统判断| 138 |`dataTableDTOList[].dataTableType`|字符串|表格类型(NORM_TABLE = 标准表格),固定值| 139 |`dataTableDTOList[].field`|对象|【核心】当前指标的详细元信息,含指标编码、名称、查询时间、粒度等| 140 |`dataTableDTOList[].fieldSet`|数组|指标元信息集合,与`field`内容一致,为兼容多指标设计,单指标时为单元素数组| 141 142 #### 2.4 证券标签信息(主体属性) 143 144 |字段路径|类型|核心释义| 145 |----|----|----| 146 |`dataTableDTOList[].entityTagDTO`|对象|本指标关联证券的详细主体属性(如证券类型、市场、简称等)| 147 |`dataTableDTOList[].entityTagDTOList`|数组|证券主体属性集合,与`entityTagDTO`一致,兼容多证券设计| 148 149 ### 三级核心路径:`field`/`entityTagDTO`(元信息子字段) 150 151 #### 3.1 指标元信息:`dataTableDTOList[].field` 152 153 |字段路径|类型|核心释义| 154 |----|----|----| 155 |`field.returnCode`|字符串|指标唯一编码(如 ZXJ_f2_3/100000000017975)| 156 |`field.returnName`|字符串|指标业务中文名(如最新价 / 收盘价)| 157 |`field.returnSourceCode`|字符串|指标原始来源编码(如 f2/CLOSE),对接底层数据源| 158 |`field.returnSourceName`|字符串|指标原始来源名称,与`returnName`一致| 159 |`field.startDate/endDate`|字符串|本次查询的时间范围(开始 / 结束)| 160 |`field.dateGranularity`|字符串|数据粒度(DAY = 日度,MIN = 分钟等)| 161 |`field.classCode`|字符串|指标分类编码,用于指标归类| 162 163 #### 3.2 证券主体属性:`dataTableDTOList[].entityTagDTO` 164 165 |字段路径|类型|核心释义| 166 |----|----|----| 167 |`entityTagDTO.secuCode`|字符串|证券纯代码(无市场标识,如 300059)| 168 |`entityTagDTO.marketChar`|字符串|市场标识(.SZ = 深交所,.SH = 上交所)| 169 |`entityTagDTO.entityTypeName`|字符串|证券类型(如 A 股 / 港股 / 债券)| 170 |`entityTagDTO.fullName`|字符串|证券完整中文名(如东方财富)| 171 |`entityTagDTO.entityId`|字符串|证券在系统内的唯一主体 ID| 172 |`entityTagDTO.className`|字符串|证券大类(如沪深京股票 / 创业板股票)| 173 174 ### 其他核心路径:`condition`/`entityTagDTOList` 175 176 #### 4.1 查询条件:`data.condition` 177 178 |字段路径|类型|核心释义| 179 |----|----|----| 180 |`condition.search_data_task_0`|数组|本次查数的原始条件,按【证券名 + 指标名 + 时间范围】排序| 181 182 #### 4.2 证券主体汇总:`data.entityTagDTOList` 183 184 与`dataTableDTOList[].entityTagDTO`结构完全一致,为本次查询所有关联证券的去重汇总信息,避免重复展示,供页面顶部 / 筛选栏使用。 185 186 ## 数据结果为空 187 188 提示用户到东方财富妙想AI查询。 189 如果请求失败,检查API Key是否正确,网络是否正常
datawhalechina/hello-agents/tree/main/Co-creation-projects/lcyting-StockSage-agent/skills/金融数据/mx-data commit 3e1c4476f2
Frequently asked questions How do I install the Mx Data skill? Run npx skillmds@latest add datawhalechina/mx-data in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the Mx Data skill do? 基于东方财富权威数据库的金融数据查询工具,支持行情、财务及关联关系数据。 It is listed under AI & ML on SkillMD.
Is Mx Data safe to use? This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with Mx Data? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is Mx Data free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published Mx Data? datawhalechina (@datawhalechina) published this skill. Their other Agent Skills are listed on their SkillMD profile.