eastmoney skills

基于东方财富权威数据库的金融数据查询工具，支持行情、财务及关联关系数据。

Security Scan

The skill code and instructions match the described purpose (querying Eastmoney/MX API with an API key and producing Excel/JSON/text outputs); minor metadata and packaging omissions are present but nothing indicates malicious behavior.

Purpose & Capability

The skill's name, description, SKILL.md, and mx_data.py consistently implement queries to the Eastmoney/MX API (mkapi2.dfcfs.com) and produce Excel/JSON/text outputs — this is coherent with the stated purpose. Note: the registry metadata did not list the required MX_APIKEY env var even though SKILL.md and the code require it.

Instruction Scope

SKILL.md instructs sending the user's natural-language query to mkapi2.dfcfs.com and storing results locally. The code does exactly that: it posts JSON with the query and API key, parses the response, and prepares Excel/JSON/text outputs. It does not attempt to read unrelated system files or call other external endpoints.

Install Mechanism

There is no install spec (instruction-only plus a .py implementation). The Python code imports pandas and requests but the registry metadata does not declare dependencies or provide an installer; this is an operational omission — the runtime will need those packages available or they must be installed manually.

Credentials

The skill requires a single API credential (MX_APIKEY) which is appropriate for calling the MX/Eastmoney API. However, the registry metadata lists no required env vars while SKILL.md and mx_data.py require MX_APIKEY — this mismatch should be resolved before install. No other secrets or unrelated credentials are requested.

Persistence & Privilege

The skill does not request 'always: true' or any elevated platform privileges. It writes outputs to a workspace path (/root/.openclaw/workspace/mx_data/output/) which is expected for data export; be cautious if running as a privileged user since outputs will be created under that path.

Assessment

This skill appears to do what it claims (query Eastmoney/MX API and save results). Before installing: 1) Ensure you trust mkapi2.dfcfs.com and the skill publisher; 2) Provide a valid MX_APIKEY in your environment (export MX_APIKEY=...) — the registry metadata currently does not declare this, so set it manually; 3) Make sure the runtime has Python and required packages (pandas, requests) installed or install them in a virtualenv; 4) Be aware outputs are written to /root/.openclaw/workspace/mx_data/output/ — avoid running as root if you don't want files created under /root; 5) Review whether sending your query text (which may contain sensitive symbols) to the external API is acceptable for your data/privacy policies.

eastmoney_fin_data 妙想金融数据 skill

本 Skill 基于东方财富权威数据库及最新行情底层数据构建，支持通过自然语言查询以下三类数据：

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

采用此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 数据

使用方式

1. 在妙想Skills页面获取apikey。(链接:https://marketing.dfcfs.com/views/finskillshub/indexIoMv0EzE)
2. 将apikey存到环境变量，命名为MX_APIKEY，检查本地环境变量中是否存在，若存在可直接用。
3. 使用post请求如下接口，务必使用post请求。

   ⚠️ 安全注意事项

   • 外部请求: 本 Skill 会将您的查询文本发送至东方财富官方 API 域名 ( mkapi2.dfcfs.com ) 以获取金融数据。
   • 凭据保护: API Key 仅通过环境变量 MX_APIKEY 在服务端或受信任的运行环境中使用，不会在前端明文暴露。

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

数据限制说明

请谨慎查询大数据范围的数据，如某只股票3年的每日最新价，可能会导致返回内容过多，模型上下文爆炸问题。

返回结果字段释义

一级核心路径：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是否正确，网络是否正常