东方财富妙想skills套件/eastmoney MX skills suite
东方财富妙想金融技能套件(mx-skills-suite),包含 5 个专业金融子技能: 1. eastmoney_fin_data - 金融数据查询(行情、财务、关联关系) 2. eastmoney_fin_search - 金融资讯搜索(新闻、公告、研报、政策) 3. mx_select_stock - 智能...
Rank
62
Safety
84
Downloads
2.0k
Updated
Oct 9, 2026
Version
1.0.0
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 2K downloads reported by the source. Last updated 10/9/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 9, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 9, 2026
- Adoption signal
- 2K downloadsadoption · observed Oct 9, 2026
- Latest release
- 1.0.0release · observed Apr 3, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s179rjgyhzv1p1esffzv3whf0h83gw0g:eastmoney-mx-skills-suite- Install using `clawhub skill install s179rjgyhzv1p1esffzv3whf0h83gw0g:eastmoney-mx-skills-suite` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/kooui/eastmoney-mx-skills-suite before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-kooui-eastmoney-mx-skills-suite/snapshot"
Documentation
CLAWHUB
25,821 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: mx-skills-suite
description: >
东方财富妙想金融技能套件(mx-skills-suite),包含 5 个专业金融子技能:
1. eastmoney_fin_data - 金融数据查询(行情、财务、关联关系)
2. eastmoney_fin_search - 金融资讯搜索(新闻、公告、研报、政策)
3. mx_select_stock - 智能选股(条件筛选、板块查询、股票推荐)
4. mx_self_select - 自选股管理(查询、添加、删除自选股)
5. eastmoney_stock_simulator - 模拟组合管理(持仓、买卖、撤单、委托、资金)
触发词:东方财富、妙想、金融数据、行情查询、股票资讯、选股、自选股、模拟交易、模拟炒股、持仓查询、东方财富数据、东方财富API。
author: Community (based on 东方财富妙想团队 original work)
version: 2.0.0
required_env_vars:
- MX_APIKEY
credentials:
- type: api_key
name: MX_APIKEY
description: 从东方财富妙想平台获取的 API Key,首次使用需注册获取
setup_url: "https://marketing.dfcfs.com/views/mktemplate/route1?activityId=738&appfenxiang=1"
---
# mx-skills-suite - 东方财富妙想金融技能套件
本技能套件基于**东方财富妙想平台 API**构建,提供一站式金融数据查询、资讯搜索、智能选股、自选股管理和模拟交易功能。所有子技能通过统一的 `MX_APIKEY` 认证,支持自然语言交互。
## 包含的子技能
| # | 技能名称 | 功能说明 | 详细文档 |
|---|---------|---------|---------|
| 1 | **eastmoney_fin_data** | 金融数据查询:股票/行业/板块/指数/基金/债券的实时行情、主力资金、估值、财务指标、股东结构等 | `references/mx-data.md` |
| 2 | **eastmoney_fin_search** | 金融资讯搜索:新闻、公告、研报、政策、交易规则、事件分析等时效性信息 | `references/mx-search.md` |
| 3 | **mx_select_stock** | 智能选股:基于行情/财务指标条件筛选股票、板块成分股查询、股票推荐 | `references/mx-select-stock.md` |
| 4 | **mx_self_select** | 自选股管理:查询/添加/删除东方财富通行证账户下的自选股 | `references/mx-selfselect.md` |
| 5 | **eastmoney_stock_simulator** | 模拟组合管理:持仓查询、买卖操作、撤单、委托查询、资金查询 | `references/mx-stock-simulator.md` |
## 首次使用 - 获取 API Key
**所有子技能都需要 `MX_APIKEY` 环境变量才能使用。** 如果用户尚未配置,按以下步骤引导:
### 步骤 1:获取 API Key
打开东方财富妙想平台注册页面:
**https://marketing.dfcfs.com/views/mktemplate/route1?activityId=738&appfenxiang=1**
### 步骤 2:下载并安装东方财富 APP
### 步骤 3:领取 API Key
注册/登录后,在首页搜索 **Skill**,领取 **API KEY**
### 步骤 4:配置环境变量
获取到 API Key 后,直接复制指引文字,或手动设置环境变量:
```bash
# Linux / macOS
export MX_APIKEY=你的API_KEY
# Windows PowerShell
$env:MX_APIKEY = "你的API_KEY"
# Windows CMD
set MX_APIKEY=你的API_KEY
```
### 验证配置
配置完成后,尝试调用任意子技能接口验证 Key 是否有效。如果返回 `114` 或 `116` 错误码,说明 Key 无效,需要重新获取。
## 使用方式
根据用户请求自动匹配对应子技能,按需加载 `references/` 下的详细文档:
- **查行情/财务数据** → 加载 `references/mx-data.md`,调用金融数据查询接口
- **搜新闻/研报/公告** → 加载 `references/mx-search.md`,调用资讯搜索接口
- **筛选股票/选股** → 加载 `references/mx-select-stock.md`,调用智能选股接口
- **管理自选股** → 加载 `references/mx-selfselect.md`,调用自选股管理接口
- **模拟交易/查持仓** → 加载 `references/mx-stock-simulator.md`,调用模拟组合接口
## API 基础信息
- **API 域名**: `https://mkapi2.dfcfs.com/finskillshub`
- **认证方式**: HTTP Header `apikey: {MX_APIKEY}`
- **请求方法**: 所有接口均使用 `POST`
- **Content-Type**: `application/json`
## 错误码说明
| 错误码 | 含义 | 处理方式 |
|--------|------|---------|
| 113 | 调用次数达上限 | 提示用户等待或更新 API Key |
| 114 | API 密钥失效 | 提示用户重新获取 Key |
| 115 | 未携带密钥 | 提示用户配置 `MX_APIKEY` |
| 116 | 密钥不存在 | 提示用户检查 Key 是否正确 |
| 404 | 未绑定模拟组合 | 提示用户先在妙想页面创建模拟账户 |
## 安全说明
- 数据仅发送至东方财富官方 API 域名 `mkapi2.dfcfs.com`
- API Key 通过环境变量 `MX_APIKEY` 在服务端使用,不会在前端明文暴露
- 模拟交易功能仅用于学习练手,不涉及真实资金README.md
# mx-skills-suite - 东方财富妙想金融技能套件
> 基于 [东方财富妙想平台 API](https://mkapi2.dfcfs.com/finskillshub) 构建的一站式金融技能套件,为 AI 助手提供专业的金融数据查询、资讯搜索、智能选股、自选股管理和模拟交易能力。
## 功能概览
| 技能 | 功能 | 典型用法 |
|------|------|---------|
| **eastmoney_fin_data** | 金融数据查询 | "查一下贵州茅台的最新价"、"看看东方财富近3年营收" |
| **eastmoney_fin_search** | 金融资讯搜索 | "搜一下格力电器的最新研报"、"新能源板块有什么新闻" |
| **mx_select_stock** | 智能选股 | "帮我选市盈率低于20的股票"、"今天涨停的股票有哪些" |
| **mx_self_select** | 自选股管理 | "查看我的自选股"、"把宁德时代加到自选" |
| **eastmoney_stock_simulator** | 模拟交易 | "买入100股贵州茅台"、"查询我的模拟持仓" |
## 快速开始
### 1. 获取 API Key
首次使用需要注册东方财富妙想平台并获取 API Key:
**点击下方链接注册并领取 API Key:**
👉 **[https://marketing.dfcfs.com/views/mktemplate/route1?activityId=738&appfenxiang=1](https://marketing.dfcfs.com/views/mktemplate/route1?activityId=738&appfenxiang=1)**
流程:
1. 打开链接,下载安装**东方财富 APP**
2. 注册/登录东方财富通行证
3. 在首页搜索 **Skill**,领取 **API KEY**
### 2. 配置环境变量
获取到 API Key 后,设置环境变量 `MX_APIKEY`:
```bash
# Linux / macOS
export MX_APIKEY=你的API_KEY
# Windows PowerShell
$env:MX_APIKEY = "你的API_KEY"
# Windows CMD
set MX_APIKEY=你的API_KEY
```
> 建议将环境变量写入 shell 配置文件(`~/.bashrc`、`~/.zshrc` 等)或系统环境变量中,避免每次重启后需要重新设置。
### 3. 安装依赖(使用脚本时需要)
```bash
pip install -r scripts/requirements.txt
```
## 安装到 WorkBuddy
将 `mx-skills-suite` 文件夹复制到以下路径:
```
~/.workbuddy/skills/mx-skills-suite/
```
完整路径示例:
- Windows: `C:\Users\你的用户名\.workbuddy\skills\mx-skills-suite\`
- macOS/Linux: `~/.workbuddy/skills/mx-skills-suite/`
## 目录结构
```
mx-skills-suite/
├── SKILL.md # 主技能描述文件
├── README.md # 本文档
├── scripts/ # 可执行脚本
│ ├── mx_data.py # 金融数据查询脚本
│ ├── mx_search.py # 资讯搜索脚本
│ ├── mx_select_stock.py # 智能选股脚本
│ ├── mx_self_select.py # 自选股管理脚本
│ ├── mx_stock_simulator.py # 模拟交易脚本
│ └── requirements.txt # Python 依赖
└── references/ # 子技能详细参考文档
├── mx-data.md # 金融数据查询 API 文档
├── mx-search.md # 资讯搜索 API 文档
├── mx-select-stock.md # 智能选股 API 文档
├── mx-selfselect.md # 自选股管理 API 文档
└── mx-stock-simulator.md # 模拟交易 API 文档
```
## 使用脚本(独立于 AI 助手)
每个子技能都提供了独立的 Python 脚本,可以直接命令行使用:
### 金融数据查询
```bash
python scripts/mx_data.py "东方财富最新价"
python scripts/mx_data.py "贵州茅台最近3年每日收盘价"
```
### 资讯搜索
```bash
python scripts/mx_search.py "格力电器最新研报"
python scripts/mx_search.py "商业航天板块近期新闻"
```
### 智能选股
```bash
python scripts/mx_select_stock.py "今天A股价格大于10元"
python scripts/mx_select_stock.py "市盈率小于20且涨幅超过2%的股票"
```
### 自选股管理
```bash
python scripts/mx_self_select.py query # 查询自选股
python scripts/mx_self_select.py add "贵州茅台" # 添加自选
python scripts/mx_self_select.py delete "贵州茅台" # 删除自选
python scripts/mx_self_select.py "把宁德时代加入自选" # 自然语言
```
### 模拟交易
```bash
pyt_meta.json
{
"ownerId": "kn7anzdmqhf61cp0q40shpxcqx832jxf",
"slug": "eastmoney-mx-skills-suite",
"version": "1.0.0",
"publishedAt": 1775209178538
}references/mx-data.md
# eastmoney_fin_data - 妙想金融数据查询
基于东方财富权威数据库及最新行情底层数据构建,支持通过自然语言查询以下三类数据:
1. **行情类数据** - 股票、行业、板块、指数、基金、债券的实时行情、主力资金流向、估值等
2. **财务类数据** - 上市公司基本信息、财务指标、高管信息、主营业务、股东结构、融资情况等
3. **关系与经营类数据** - 关联关系数据、企业经营相关数据
## API 接口
- **URL**: `POST https://mkapi2.dfcfs.com/finskillshub/api/claw/query`
- **Header**: `apikey: {MX_APIKEY}`, `Content-Type: application/json`
- **Body**: `{"toolQuery": "查询问句"}`
### 示例
```bash
curl -X POST 'https://mkapi2.dfcfs.com/finskillshub/api/claw/query' \
--header 'Content-Type: application/json' \
--header 'apikey: YOUR_API_KEY' \
--data '{"toolQuery": "东方财富最新价"}'
```
## 使用方式
1. 确认 `MX_APIKEY` 环境变量已配置
2. 构造自然语言查询问句(如 "贵州茅台最近3年每日收盘价")
3. 发送 POST 请求到上述接口
4. 解析返回的 JSON 数据
### Python 调用
```python
import requests, os
url = "https://mkapi2.dfcfs.com/finskillshub/api/claw/query"
headers = {
"Content-Type": "application/json",
"apikey": os.getenv("MX_APIKEY")
}
data = {"toolQuery": "东方财富最新价"}
response = requests.post(url, headers=headers, json=data, timeout=30)
result = response.json()
```
也可直接使用本套件提供的脚本 `scripts/mx_data.py`:
```bash
python scripts/mx_data.py "东方财富最新价"
python scripts/mx_data.py "贵州茅台最近3年每日收盘价" [输出目录]
```
## 返回结果字段释义
### 一级核心路径:`data`
| 字段路径 | 类型 | 核心释义 |
|---------|------|---------|
| `data.questionId` | 字符串 | 查数请求唯一标识 ID |
| `data.dataTableDTOList` | 数组 | 【核心】标准化后的证券指标数据列表 |
| `data.rawDataTableDTOList` | 数组 | 原始未加工的证券指标数据列表 |
| `data.condition` | 对象 | 本次查询条件 |
| `data.entityTagDTOList` | 数组 | 关联证券主体汇总信息 |
### 二级核心路径:`data.dataTableDTOList[]`
#### 证券基础信息
| 字段路径 | 类型 | 核心释义 |
|---------|------|---------|
| `.code` | 字符串 | 证券完整代码(如 300059.SZ) |
| `.entityName` | 字符串 | 证券全称(如 东方财富 (300059.SZ)) |
| `.title` | 字符串 | 指标数据标题(如 东方财富最新价) |
#### 表格数据核心
| 字段路径 | 类型 | 核心释义 |
|---------|------|---------|
| `.table` | 对象 | 【核心】标准化表格数据,键=指标编码,值=指标数值数组;`headName`为时间列 |
| `.rawTable` | 对象 | 原始表格数据,未做标准化处理 |
| `.nameMap` | 对象 | 【核心】列名映射,将指标编码转为中文(如 f2 → 最新价) |
| `.indicatorOrder` | 数组 | 指标列展示排序 |
#### 指标元信息
| 字段路径 | 类型 | 核心释义 |
|---------|------|---------|
| `.dataType` | 字符串 | 数据来源类型 |
| `.dataTypeEnum` | 字符串 | 枚举值(HQ=行情,DATA_BROWSER=数据浏览器) |
| `.field` | 对象 | 指标详细元信息(编码、名称、时间范围、粒度等) |
#### 证券标签
| 字段路径 | 类型 | 核心释义 |
|---------|------|---------|
| `.entityTagDTO.secuCode` | 字符串 | 证券纯代码(如 300059) |
| `.entityTagDTO.marketChar` | 字符串 | 市场标识(.SZ=深交所,.SH=上交所) |
| `.entityTagDTO.entityTypeName` | 字符串 | 证券类型(如 A股/港股/债券) |
| `.entityTagDTO.fullName` | 字符串 | 证券中文名 |
| `.entityTagDTO.className` | 字符串 | 证券大类(如 沪深京股票/创业板股票) |
### 三级:`field` 元信息
| 字段路径 | 类型 | 核心释义 |
|---------|------|---------|
| `.returnCode` | 字符串 | 指标唯一编码 |
| `.returnName` | 字符串 | 指标中文名(如 最新价/收盘价) |
| `.returnSourceCode` | 字符串 | 原始来源编码(如 f2/CLOSE) |
| `.startDate/.endDate` | 字符串 | 查询时间范围 |
| `.dateGranularity` | 字符串 | 数据粒度(DAY/MIN等) |
## 注意事项
- 避免查询大数据范围(如某股票3年每日最新价),可能导致返回内容过多
- 数据结果为空时,提示用户到东方财富妙想 AI 查询
- 请求失败时,检查 API Kereferences/mx-search.md
# eastmoney_fin_search - 妙想资讯搜索
基于东方财富妙想搜索能力,基于金融场景进行信源智能筛选,用于获取涉及时效性信息或特定事件信息的任务,包括新闻、公告、研报、政策、交易规则、具体事件、各种影响分析等。
## 功能说明
根据用户问句搜索相关金融资讯,获取与问句相关的资讯信息(如研报、新闻、解读等),并返回可读的文本内容。
## API 接口
- **URL**: `POST https://mkapi2.dfcfs.com/finskillshub/api/claw/news-search`
- **Header**: `apikey: {MX_APIKEY}`, `Content-Type: application/json`
- **Body**: `{"query": "搜索问句"}`
### 示例
```bash
curl -X POST 'https://mkapi2.dfcfs.com/finskillshub/api/claw/news-search' \
--header 'Content-Type: application/json' \
--header 'apikey: YOUR_API_KEY' \
--data '{"query": "立讯精密的资讯"}'
```
## 使用方式
1. 确认 `MX_APIKEY` 环境变量已配置
2. 构造自然语言搜索问句
3. 发送 POST 请求到上述接口
4. 解析返回的 JSON 数据
### Python 调用
```python
import requests, os
url = "https://mkapi2.dfcfs.com/finskillshub/api/claw/news-search"
headers = {
"Content-Type": "application/json",
"apikey": os.getenv("MX_APIKEY")
}
data = {"query": "格力电器最新研报"}
response = requests.post(url, headers=headers, json=data, timeout=30)
result = response.json()
```
也可直接使用本套件提供的脚本 `scripts/mx_search.py`:
```bash
python scripts/mx_search.py "格力电器最新研报"
python scripts/mx_search.py "商业航天板块近期新闻" [输出目录]
```
## 问句示例
| 类型 | 示例问句 |
|------|---------|
| 个股资讯 | 格力电器最新研报、贵州茅台机构观点 |
| 板块/主题 | 商业航天板块近期新闻、新能源政策解读 |
| 宏观/风险 | A股具备自然对冲优势的公司、美联储加息对A股影响 |
| 综合解读 | 今日大盘异动原因、北向资金流向解读 |
## 返回结果字段释义
| 字段路径 | 类型 | 简短释义 |
|---------|------|---------|
| `title` | 字符串 | 信息标题,高度概括核心内容 |
| `secuList` | 数组 | 关联证券列表 |
| `secuList[].secuCode` | 字符串 | 证券代码(如 002475) |
| `secuList[].secuName` | 字符串 | 证券名称(如 立讯精密) |
| `secuList[].secuType` | 字符串 | 证券类型(如 股票/债券) |
| `trunk` | 字符串 | 信息核心正文/结构化数据块 |
### 搜索结果数据路径
```
result.data.data.llmSearchResponse.data[]
```
每条结果包含:
- `title` - 标题
- `content` - 正文内容
- `date` - 日期
- `insName` - 机构名称
- `informationType` - 类型(REPORT=研报, NEWS=新闻, ANNOUNCEMENT=公告)
- `rating` - 评级
- `entityFullName` - 关联证券全称AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/kooui/skills/eastmoney-mx-skills-suite",
"sourceUrl": "https://clawhub.ai/kooui/skills/eastmoney-mx-skills-suite",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T20:05:07.096Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-kooui-eastmoney-mx-skills-suite/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-kooui-eastmoney-mx-skills-suite/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-09T20:05:07.096Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "2K downloads",
"href": "https://clawhub.ai/kooui/eastmoney-mx-skills-suite",
"sourceUrl": "https://clawhub.ai/kooui/eastmoney-mx-skills-suite",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T20:05:07.096Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.0",
"href": "https://clawhub.ai/kooui/eastmoney-mx-skills-suite",
"sourceUrl": "https://clawhub.ai/kooui/eastmoney-mx-skills-suite",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-04-03T09:39:38.538Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-kooui-eastmoney-mx-skills-suite/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-kooui-eastmoney-mx-skills-suite/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.0",
"description": "mx-skills-suite 2.0.0 发布:集成东方财富妙想多子技能套件 - 全面升级为东方财富妙想金融技能套件(mx-skills-suite),一站式集成行情、资讯、选股、自选股和模拟交易五大子技能 - 支持统一 API Key 配置(MX_APIKEY),详细配置与获取说明 - 提供五个子技能的分模块调用及详细文档指引 - 统一安全与错误码说明,提升易用性和合规性 - 新增对进阶金融数据、智能选股、模拟炒股、资讯时效性搜索等复杂任务的原生支持",
"href": "https://clawhub.ai/kooui/eastmoney-mx-skills-suite",
"sourceUrl": "https://clawhub.ai/kooui/eastmoney-mx-skills-suite",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-04-03T09:39:38.538Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
