安装
npx skills add https://github.com/meission/eastmoney --skill eastmoney_financial_data
- 东方财富金融数据skill (eastmoney_financial_data)
- 通过
- 文本输入
- 查询金融相关数据(股票、板块、指数等),接口返回 JSON格式内容。
- 使用方式
- 首先检查环境变量
- EASTMONEY_APIKEY
- 是否存在:
- echo
- $EASTMONEY_APIKEY
- 如果不存在,提示用户在东方财富Skills页面(
- https://marketing.dfcfs.com/views/finskillshub/indexuNdYscEA?appfenxiang=1)获取apikey并设置到环境变量。
- ⚠️
- 安全注意事项
- 外部请求
-
- 本 Skill 会将您的查询文本发送至东方财富官方 API 域名 (
- mkapi2.dfcfs.com
- ) 以获取金融数据。
- 凭据保护
- API Key 仅通过环境变量
EASTMONEY_APIKEY
在服务端或受信任的运行环境中使用,不会在前端明文暴露。
使用POST请求调用接口:
curl
-X
POST
--location
'https://mkapi2.dfcfs.com/finskillshub/api/claw/query'
\
--header
'Content-Type: application/json'
\
--header
"apikey:
$EASTMONEY_APIKEY
"
\
--data
'{"toolQuery":"用户的查询内容"}'
适用场景
当用户查询以下类型的内容时使用本skill:
行情类数据
:股票、行业、板块、指数、基金、债券的实时行情、主力资金流向、估值等数据
财务类数据
:上市公司与非上市公司的基本信息、财务指标、高管信息、主营业务、股东结构、融资情况等数据
关系与经营类数据
:股票、非上市公司、股东及高管之间的关联关系数据,以及企业经营相关数据
数据限制说明
请谨慎查询大数据范围的数据,如某只股票3年的每日最新价,可能会导致返回内容过多,模型上下文爆炸问题。
返回结构说明
一级核心路径:
data
字段路径
类型
核心释义
data.questionId
字符串
查数请求唯一标识 ID,关联单次查询任务
data.dataTableDTOList
数组
【核心】标准化后的证券指标数据列表,每个元素对应
1 个证券 + 1 个指标
的完整数据
data.rawDataTableDTOList
数组
原始未加工的证券指标数据列表,与标准化列表结构完全一致,供原始数据调用
data.condition
对象
本次查数的查询条件,记录查询关键词、时间范围等
data.entityTagDTOList
数组
本次查询关联的
证券主体汇总信息
,去重后展示所有涉事证券的基础属性
二级核心路径:
data.dataTableDTOList[]
(单指标对象,表格核心)
数组内每个对象为
独立的指标数据单元
,包含
证券信息 + 表格数据 + 指标元信息 + 证券标签
四大部分。
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[].field
对象
【核心】当前指标的详细元信息,含指标编码、名称、查询时间、粒度等
2.4 证券标签信息(主体属性)
字段路径
类型
核心释义
dataTableDTOList[].entityTagDTO
对象
本指标关联证券的详细主体属性(如证券类型、市场、简称等)
三级核心路径
3.1 指标元信息:
dataTableDTOList[].field
字段路径
类型
核心释义
field.returnCode
字符串
指标唯一编码
field.returnName
字符串
指标业务中文名(如最新价 / 收盘价)
field.startDate/endDate
字符串
本次查询的时间范围(开始 / 结束)
field.dateGranularity
字符串
数据粒度(DAY = 日度,MIN = 分钟等)
3.2 证券主体属性:
dataTableDTOList[].entityTagDTO
字段路径
类型
核心释义
entityTagDTO.secuCode
字符串
证券纯代码(无市场标识,如 300059)
entityTagDTO.marketChar
字符串
市场标识(.SZ = 深交所,.SH = 上交所)
entityTagDTO.entityTypeName
字符串
证券类型(如 A 股 / 港股 / 债券)
entityTagDTO.fullName
字符串
证券完整中文名(如东方财富)
示例
import
os
import
requests
api_key
=
os
.
getenv
(
"EASTMONEY_APIKEY"
)
if
not
api_key
:
raise
ValueError
(
"请先设置EASTMONEY_APIKEY环境变量"
)
url
=
"https://mkapi2.dfcfs.com/finskillshub/api/claw/query"
headers
=
{
"Content-Type"
:
"application/json"
,
"apikey"
:
api_key
}
data
=
{
"toolQuery"
:
"东方财富最新价"
}
response
=
requests
.
post
(
url
,
headers
=
headers
,
json
=
data
)
response
.
raise_for_status
(
)
result
=
response
.
json
(
)
print
(
result
)
异常处理
如果数据结果为空,提示用户到东方财富妙想AI查询
如果请求失败,检查API Key是否正确,网络是否正常
← 返回排行榜