金融数据查询

密钥来源与安全说明

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

功能范围

1. 支持查询的对象范围

• 股票（A 股、港股、美股）
• 板块、指数、股东
• 企业发行人、债券、非上市公司
• 股票市场、基金市场、债券市场

2. 支持查询的数据类型

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

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

3. 查询方式与处理逻辑

统一使用 --query 传入自然语言问句（包含实体与指标），并使用 --indicators 传入从问句中提取的金融指标等关键信息。Skill 会先对 query 做实体识别，再按识别结果选择查数路径：

• 识别实体数 ≤ 5：直接查数
• 识别实体数 > 5：批量查数，最多处理识别结果中的前 500 个有效实体，如需大于500个实体，可分批多次调用

注意：当用户问句中只包含代词，需结合上下文或者提供文件读取所有实体名称，一并输入query。

--indicators 参数说明

调用本 Skill 前，需根据 --query 从用户问句中提取需要查询的金融指标（或指标组），填入 --indicators：

• 只填指标和时间范围等除实体外所有有效信息，不含实体名称等修饰语。
• 多个指标用用户原话拼接，如 市盈率(动)和总市值、涨跌幅、营收、毛利、净利。
• 不要在 --indicators 里重复写实体。
• 尽量用用户原话表述，不要二次改写。

示例
用户问「查询贵州茅台、五粮液近一年营收」
→ --query "查询贵州茅台、五粮液近一年营收" --indicators "近一年营收"

用户问「这批股票的涨跌幅是多少」或列出 6 只以上股票
→ --query "查询 A、B、C、D、E、F 六只股票的涨跌幅、pe、市值" --indicators "涨跌幅、pe、市值"

4. 输出结果

Skill 执行后会输出两个文件：

• Excel（.xlsx）：多 sheet 结构化数据表，每个实体/指标组合对应一个 sheet
• Markdown（.md）：与 Excel 内容一致的 Markdown 表格，按 sheet 分二级标题

---

前提条件

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

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

2. 配置 Token

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

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

macOS：

source ~/.zshrc

Linux：

source ~/.bashrc

3. 安装依赖

pip3 install httpx pandas openpyxl --user

快速开始

在工作目录下执行：

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

多实体示例：

python3 {baseDir}/scripts/get_data.py --query "查询贵州茅台、五粮液、宁德时代、比亚迪、隆基绿能、中芯国际的市盈率(动)" --indicators "市盈率(动)"

参数说明：

参数	必填	默认值	说明
--query	是	-	自然语言查询问句，需包含所有查询实体名称
--indicators	是	-	从 query 中提取的金融指标、时间范围等关键信息

---

输出示例

直接查数：

识别实体数: 1
查数模式: 直接查数
返回实体数: 1
文件: /path/to/miaoxiang/mx_finance_data/mx_finance_data_9535fe18.xlsx
Markdown: /path/to/miaoxiang/mx_finance_data/mx_finance_data_9535fe18.md
表格行数: 42

多实体查数：

识别实体数: 128
查数模式: 多实体
返回实体数: 128
文件: /path/to/miaoxiang/mx_finance_data/mx_finance_data_a1b2c3d4.xlsx
Markdown: /path/to/miaoxiang/mx_finance_data/mx_finance_data_a1b2c3d4.md
表格行数: 150

输出文件说明

文件	说明
mx_finance_data_<查询id>.xlsx	结构化数据表，包含请求的实体与指标
mx_finance_data_<查询id>.md	与 Excel 内容一致的 Markdown 表格

常见问题

错误：请设置 EM_API_KEY 环境变量

• 请访问 https://ai.eastmoney.com/mxClaw 获取API_KEY。
• 配置EM_API_KEY环境变量

多实体查数报错：缺少 --indicators

• 识别实体数 > 5 时必须提供 --indicators，否则无法构造有效的查数问句。

当前一次请求的数据量过大，部分数据可能会有缺失，请减少指标数量和查询日期范围

• 可分批多次（分不同指标或者日期）调用该技能，一次性请求压力过大。

多实体查数最多处理识别结果中前 500 个有效实体

• 可分批多次（每次500个实体数量以内）调用该技能