东方财富金融数据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是否正确，网络是否正常