mx_self_select
# 妙想自选管理skill (mx_self_select)
通过自然语言查询或操作东方财富通行证账户下的自选股数据,接口返回JSON格式内容。
## 功能列表
- ✅ 查询我的自选股列表
- ✅ 添加指定股票到我的自选股列表
- ✅ 从我的自选股列表中删除指定股票
## 配置
- **API Key**: 通过环境变量 `MX_APIKEY` 设置(与其他妙想技能共享)
- **默认输出目录**: `/root/.openclaw/workspace/mx_data/output/`(自动创建)
- **输出文件名前缀**: `mx_self_select_`
- **输出文件**:
- `mx_self_select_{query}.csv` - 自选股列表 CSV 格式
- `mx_self_select_{query}_raw.json` - API 原始 JSON 数据
## 前置要求
1. 获取东方财富妙想Skills页面的apikey
2. 将apikey配置到环境变量 `MX_APIKEY`
3. 确保网络可以访问 `https://mkapi2.dfcfs.com`
> ⚠️ **安全注意事项**
>
> - **外部请求**: 本 Skill 会将您的查询文本发送至东方财富官方 API 域名 ( `mkapi2.dfcfs.com` ) 以获取金融数据。
> - **凭据保护**: API Key 仅通过环境变量 `EASTMONEY_APIKEY` 在服务端或受信任的运行环境中使用,不会在前端明文暴露。
## 使用方式
### 1. 查询自选股列表
```bash
python3 scripts/mx_self_select.py query
```
或自然语言查询:
```bash
python3 scripts/mx_self_select.py "查询我的自选股列表"
```
### 2. 添加股票到自选股
```bash
python3 scripts/mx_self_select.py add "贵州茅台"
```
或自然语言:
```bash
python3 scripts/mx_self_select.py "把贵州茅台添加到我的自选股列表"
```
### 3. 删除自选股
```bash
python3 scripts/mx_self_select.py delete "贵州茅台"
```
或自然语言:
```bash
python3 scripts/mx_self_select.py "把贵州茅台从我的自选股列表删除"
```
## 接口说明
### 查询接口
- URL: `https://mkapi2.dfcfs.com/finskillshub/api/claw/self-select/get`
- 方法: POST
- Header: `apikey: {MX_APIKEY}`
### 管理接口(添加/删除)
- URL: `https://mkapi2.dfcfs.com/finskillshub/api/claw/self-select/manage`
- 方法: POST
- Header: `apikey: {MX_APIKEY}`
- Body: `{"query": "自然语言指令"}`
## 输出示例
### 查询自选股成功
```
📊 我的自选股列表
================================================================================
股票代码 | 股票名称 | 最新价(元) | 涨跌幅(%) | 涨跌额(元) | 换手率(%) | 量比
--------------------------------------------------------------------------------
600519 | 贵州茅台 | 1850.00 | +2.78% | +50.00 | 0.35% | 1.2
300750 | 宁德时代 | 380.00 | -1.25% | -4.80 | 0.89% | 0.9
================================================================================
共 2 只自选股
```
### 添加/删除成功
```
✅ 操作成功:贵州茅台已添加到自选股列表
```
## 错误处理
- 未配置apikey: 提示设置环境变量 `MX_APIKEY`
- 接口调用失败: 显示错误信息
- 数据为空: 提示用户到东方财富App查询
标签
skill
ai