mx_finance_data

# 金融数据查询

## 密钥来源与安全说明

- 本技能仅使用一个环境变量：`EM_API_KEY`。
- `EM_API_KEY` 由东方财富妙想服务（`https://ai.eastmoney.com/mxClaw`）签发，用于其接口鉴权。
- 在提供密钥前，请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。
- 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。

## 功能范围

### 1. 支持查询的对象范围
* 股票（A 股、港股、美股）
* 板块、指数、股东
* 企业发行人、债券、非上市公司
* 股票市场、基金市场、债券市场

### 2. 支持查询的数据类型

支持查询以下类型的结构化数据：

* **实时行情**（现价、涨跌幅、盘口数据等）
* **量化数据**（技术指标、资金流向等）
* **报表数据**（营收、净利润、财务比率等）

### 3. 支持的查询方式与**严格限制**

支持多实体、多指标、多时间范围的组合查询。**受后端接口限制，单次查询必须遵循以下配额：**

* **实体上限**：单次最多支持 **5 个** 股票/金融实体。
* **处理逻辑**：若用户请求超过上述限制，Skill 将优先处理前 5 个实体，并在结果说明文件中予以提示。

> **示例：** “查询 A、B、C、D、E、F 六只股票的营收” -> 仅返回前五只。

### 4. 输出结果

Skill 执行后会输出以下文件：

- 一个查数结果 `xlsx` 文件，用于承载结构化查询结果
- 一个结果说明 `txt` 文件，用于描述查询内容、结果含义及必要说明

------

## 查询示例

### 基础指标查询

- 东方财富的基本面
- 贵州茅台最近一年的营业收入和净利润
- 半导体etf的业绩表现

### 实时行情与盘口查询

- 当前300059的实时买单
- 英伟达现在的最新价和涨跌幅
- 沪深300当前点位和成交额

### 多实体、多指标、多时间查询（注意配额）

* **合规示例**：对比创业板指、沪深300、中证500（3个实体）春节以来的涨幅（1个指标）。
* **合规示例**：东方财富、拼多多（2个实体）最近一年的营收、毛利、净利（3个指标）。
* **超限提示**：若查询“沪深前十大权重股的PE”，系统将截取前 5 名进行查询。

------

## 补充说明

- 本 Skill 面向金融结构化数据与关系数据查询，不侧重主观分析、投资建议或资讯解读。
- 语句中必须包含明确的金融实体名称。
- 当用户使用自然语言发起查询时，Skill 可根据问句内容识别查询对象、指标和时间范围，并输出结构化结果文件。
- 对于支持范围内的查询请求，优先输出结构化查数结果，并同时生成结果说明文件，便于后续使用。

## 前提条件

### 1. 注册东方财富妙想账号

访问 https://ai.eastmoney.com/mxClaw 注册账号并获取API_KEY。

### 2. 配置 Token

```bash
# macOS 添加到 ~/.zshrc，Linux 添加到 ~/.bashrc
export EM_API_KEY="your_api_key_here"
```

然后根据系统执行对应的命令：

**macOS：**
```bash
source ~/.zshrc
```

**Linux：**
```bash
source ~/.bashrc
```

### 3. 安装依赖


```bash
pip3 install httpx pandas openpyxl --user
```

## 快速开始

### 在工作目录下执行

```bash
python3 {baseDir}/scripts/get_data.py --query "贵州茅台近期走势如何"
```

### 输出示例

```
xlsx: /path/to/miaoxiang/mx_finance_data/mx_finance_data_9535fe18.xlsx
描述: /path/to/miaoxiang/mx_finance_data/mx_finance_data_9535fe18_description.txt
行数: 42
```

### 输出文件说明

| 文件 | 说明 |
| --- | --- |
| `mx_finance_data_<查询id>.xlsx` | 结构化数据表，包含请求的实体与指标 |
| `mx_finance_data_<查询id>_description.txt` | 包含查询逻辑说明、字段含义及**配额截断提示** |