| name | mofa-eastmoney |
| description | 东方财富金融数据查询 Skill。整合金融数据、宏观经济、资讯搜索、选股四大能力。支持 A股/港股/美股/基金/债券的全方位金融数据分析。Triggers: eastmoney, 东方财富, 股票数据, 选股, 宏观经济, 金融资讯 |
| requires_bins | python3, pip3 |
| requires_env | EM_API_KEY |
| always | false |
东方财富金融数据 (MoFA-Eastmoney)
整合东方财富妙想大模型 API 的全方位金融数据查询 Skill，包含四大核心能力：
- 金融数据查询 (FinData) - 股票、板块、指数、债券等多维金融指标
- 宏观经济数据 (MacroData) - GDP、CPI、货币供应量等宏观指标
- 金融资讯搜索 (FinSearch) - 新闻、公告、研报等时效性资讯
- 智能选股 (StockPick) - A股/港股/美股/基金/ETF 筛选
Onboarding / 开始使用
第一步：注册并获取 API Key
1. 访问东方财富妙想平台
打开 https://ai.eastmoney.com/ ，点击右上角「注册/登录」。
2. 完成注册
3. 获取 API Key
登录后 → 控制台 → API 管理 → 创建 API Key
复制生成的 EM_API_KEY（格式类似 em_xxxxx）。
第二步：配置环境变量
macOS / Linux:
export EM_API_KEY="your_em_api_key_here"
Windows PowerShell:
$env:EM_API_KEY="your_em_api_key_here"
永久配置（推荐）:
添加到 ~/.zshrc 或 ~/.bashrc:
echo 'export EM_API_KEY="your_em_api_key_here"' >> ~/.zshrc
source ~/.zshrc
第三步：安装依赖
pip3 install httpx pandas openpyxl
第四步：验证安装
cd /Users/yao/Desktop/code/work/mofa-org/mofa-skills/mofa-eastmoney
python3 scripts/mx_findata.py "贵州茅台的市值"
看到输出文件路径即表示成功！
Architecture
┌─────────────────────────────────────────────────────────────────────────────┐
│ MOFA-EASTMONEY 金融数据架构 │
└─────────────────────────────────────────────────────────────────────────────┘
User Query (自然语言)
↓
┌─────────────────────────────────────────────────────────┐
│ 1. Intent Parser │
│ ───────────── │
│ • 金融数据 → MX_FinData │
│ • 宏观经济 → MX_MacroData │
│ • 资讯搜索 → MX_FinSearch │
│ • 选股选基 → MX_StockPick │
└─────────────────────────┬───────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────┐
│ 2. API Router │
│ ────────── │
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ FinData │ │ MacroData │ │ FinSearch │ │
│ │ 金融数据 │ │ 宏观经济 │ │ 资讯搜索 │ │
│ └──────┬──────┘ └──────┬──────┘ └──────┬──────┘ │
│ └─────────────────┼─────────────────┘ │
│ │ │
│ ┌────────┴────────┐ │
│ │ StockPick │ │
│ │ 选股选基 │ │
│ └────────┬────────┘ │
└─────────────────────────────┼───────────────────────────┘
↓
┌─────────────────────────────────────────────────────────┐
│ 3. Eastmoney API │
│ ───────────── │
│ https://ai-saas.eastmoney.com/proxy/b/mcp/tool/ │
│ │
│ Headers: em_api_key: {EM_API_KEY} │
└─────────────────────────┬───────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────┐
│ 4. Data Processing │
│ ─────────────── │
│ • 数据清洗 │
│ • 格式转换 (Excel/CSV/TXT) │
│ • 中文列名映射 │
└─────────────────────────┬───────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────┐
│ 5. Output Files │
│ ─────────── │
│ • .xlsx / .csv - 结构化数据 │
│ • .txt - 结果说明文档 │
└─────────────────────────────────────────────────────────┘
核心功能
1. 金融数据查询 (MX_FinData)
支持对象:
- 股票（A股、港股、美股）
- 板块、指数、股东
- 企业发行人、债券、非上市公司
支持数据类型:
- 实时行情（现价、涨跌幅、盘口）
- 量化数据（技术指标、资金流向）
- 报表数据（营收、净利润、财务比率）
- 公司基本信息、高管、主营业务、股东
查询限制:
使用示例:
python3 scripts/mx_findata.py "东方财富的基本面"
python3 scripts/mx_findata.py "当前300059的实时买单"
python3 scripts/mx_findata.py "东方财富、拼多多、贵州茅台最近一年的营收、毛利、净利"
输出文件:
MX_FinData_<id>.xlsx - 多 sheet ExcelMX_FinData_<id>_description.txt - 结果说明
2. 宏观经济数据 (MX_MacroData)
支持指标:
- GDP、CPI、PPI、PMI、失业率
- M1/M2 货币供应量、社融规模
- 国债利率、汇率
- 商品价格（黄金、白银、原油、铜等）
输入约束（重要）:
- ✅ 必须指定具体省/市/国家全称
- ✅ 必须指定具体商品名称
- ✅ 必须转换为绝对时间格式
YYYY-MM-DD
- ✅ 必须指定具体指标名称
使用示例:
python3 scripts/mx_macrodata.py "中国GDP同比增速"
python3 scripts/mx_macrodata.py "上海市、江苏省、浙江省的GDP数据"
python3 scripts/mx_macrodata.py "氧化镨钕、铜、铝的现货价格走势"
python3 scripts/mx_macrodata.py "华东五市GDP"
python3 scripts/mx_macrodata.py "稀土价格走势"
python3 scripts/mx_macrodata.py "中国经济数据"
输出文件:
macro_data_<query>_年.csvmacro_data_<query>_季.csvmacro_data_<query>_description.txt
3. 金融资讯搜索 (MX_FinSearch)
适用场景:
- 最新新闻与政策动态
- 公司公告与事件跟踪
- 券商研报与市场解读
- 宏观事件对市场影响分析
使用示例:
python3 scripts/mx_finsearch.py "格力电器最新研报与公告"
python3 scripts/mx_finsearch.py "商业航天板块近期新闻"
python3 scripts/mx_finsearch.py "美联储加息对A股影响"
python3 scripts/mx_finsearch.py "新能源板块政策" --no-save
输出文件:
financial_search_<query>.txt - 资讯正文
4. 智能选股 (MX_StockPick)
支持类型:
筛选条件:
- 财务指标：股价、市值、市盈率、涨跌幅
- 技术指标：连续上涨、突破均线等
- 主营业务、行业板块
- 高管信息、股东信息、龙虎榜
使用示例:
python3 scripts/mx_stockpick.py --query "股价大于100元的股票" --select-type "A股"
python3 scripts/mx_stockpick.py --query "港股的科技龙头" --select-type "港股"
python3 scripts/mx_stockpick.py --query "白酒主题基金近一年收益排名" --select-type "基金"
python3 scripts/mx_stockpick.py --query "规模超2亿的电力ETF" --select-type "ETF"
python3 scripts/mx_stockpick.py --query "价格低于110元、溢价率超5个点的可转债" --select-type "可转债"
输出文件:
MX_StockPick_<query>.csv - 全量数据（中文列名）MX_StockPick_<query>_description.txt - 数据说明
快速参考
| 功能 | 命令 | 输出 |
|---|
| 金融数据 | python3 scripts/mx_findata.py "{query}" | .xlsx + .txt |
| 宏观经济 | python3 scripts/mx_macrodata.py "{query}" | .csv + .txt |
| 资讯搜索 | python3 scripts/mx_finsearch.py "{query}" | .txt |
| 选股选基 | python3 scripts/mx_stockpick.py --query "{query}" --select-type "{类型}" | .csv + .txt |
代码调用示例
import asyncio
from pathlib import Path
from scripts.mx_findata import query_financial_data
from scripts.mx_macrodata import query_macro_data
from scripts.mx_finsearch import query_financial_news
from scripts.mx_stockpick import query_select_stock
async def main():
fin_result = await query_financial_data(
query="贵州茅台近期走势如何",
output_dir=Path("workspace/MX_FinData")
)
print(f"Excel: {fin_result['file_path']}")
print(f"行数: {fin_result['row_count']}")
macro_result = await query_macro_data(
query="中国近五年GDP",
output_dir=Path("workspace/macro_data")
)
print(f"CSV: {macro_result['csv_paths']}")
news_result = await query_financial_news(
query="新能源板块近期政策与龙头公司动态",
output_dir=Path("workspace/financial_search"),
save_to_file=True
)
print(f"资讯: {news_result['content'][:500]}...")
stock_result = await query_select_stock(
query="A股半导体板块市值前20",
selectType="A股",
output_dir=Path("workspace/MX_StockPick")
)
print(f"选中 {stock_result['row_count']} 只股票")
asyncio.run(main())
环境变量
| 变量 | 说明 | 必填 |
|---|
EM_API_KEY | 东方财富 API Key | ✅ |
MX_StockPick_OUTPUT_DIR | 选股输出目录 | 可选 |
常见问题
Q: 如何获取 EM_API_KEY？
A: 访问 https://ai.eastmoney.com/ → 注册登录 → 控制台 → API 管理 → 创建 API Key
Q: 提示 "EM API KEY REQUIRED" 怎么办？
A: 确保已设置环境变量：export EM_API_KEY="your_key"
Q: 金融数据查询有数量限制吗？
A: 单次查询最多 5 个实体 + 3 个指标，超限会自动截取前 5 个实体和前 3 个指标
Q: 宏观经济查询有什么限制？
A: 必须使用明确的地域、商品、时间、指标名称，禁止模糊表述
Q: 输出文件在哪里？
A: 默认在 workspace/ 目录下，每个功能有独立的子目录
相关 Skills
mofa-research-2.0
组合使用:
mofa-research-2.0: 发现投资机会
mofa-eastmoney (StockPick): 筛选标的
mofa-eastmoney (FinData): 深度分析财务数据
mofa-research-2.0: 生成投资报告
mofa-news
区别:
- mofa-news: 通用新闻聚合（RSS）
- mofa-eastmoney (FinSearch): 专业金融资讯（东方财富）
mofa-public-apis
组合使用:
mofa-public-apis: 发现其他金融 API
mofa-eastmoney: 获取东方财富专业数据
API 文档
- 官方平台: https://ai.eastmoney.com/
- API 端点:
https://ai-saas.eastmoney.com/proxy/b/mcp/tool/
- 认证方式: Header
em_api_key: {EM_API_KEY}
合规说明
- 禁止硬编码 API Key，必须使用环境变量
- API Key 按敏感信息处理，不在日志中泄露
- 检索失败时不得编造事实
- 输出应保持可追溯、可审计
