核心功能与用法
mx_macro_data 是一款面向宏观经济研究的专业数据查询工具，基于东方财富妙想数据库，通过自然语言交互获取全球范围内的经济、金融、产业及商品价格数据。用户仅需用中文或英文描述查询需求，系统即可自动解析并返回标准化的CSV数据文件及配套说明文档。
核心用法
- 自然语言查询：支持"中国过去五年GDP增速""美国上月非农就业数据"等灵活表述，无需记忆指标代码
- 多维度覆盖：涵盖国民经济核算（GDP）、价格指数（CPI/PPI）、货币金融（M1/M2/社融）、财政收支、对外贸易、就业民生（失业率/非农）、产业运行及大宗商品价格
- 智能频率匹配：根据查询语境自动识别年/季/月/周/日频数据，同一查询可能返回多个频率的CSV文件
显著优点
1. 降低专业门槛：用"查询中国M2同比"替代传统数据库的代码检索，研究员无需学习SQL或API文档
2. 数据权威性：底层接入东方财富金融终端级别的官方数据源，覆盖中国及全球主要经济体
3. 结构化输出：自动生成UTF-8编码CSV及description.txt，直接对接Excel、Python pandas或BI工具
4. 时间灵活性：支持"今年""过去三年"等相对时间表述，无需手动计算日期范围
局限性与风险
- 输入约束严格：禁止模糊商品类别（如"稀土金属"需明确为"氧化镨钕"）、禁止无指标的经济泛指（如"中国经济状况"需明确为"GDP、CPI"）
- 数据完整性依赖上层：工具本身不做全量校验，"中国各省GDP"可能遗漏部分省份，需调用方（规划引擎）执行完整性复核与补全迭代
- 单Token鉴权：仅依赖
EM_API_KEY，密钥泄露即导致未授权访问，需严格遵循"禁止硬编码"的安全规范 - 覆盖盲区：动态排名类表述（如"Top 5新兴市场"）建议上层解包为具体国家列表，以确保数据源一致性
适合人群
宏观经济研究员、证券分析师、政策智库、金融机构投研团队、高校经济学科师生，以及需要批量获取标准化宏观数据进行量化建模的开发者。
常规风险提示
- 输出目录的CSV文件可能包含敏感经济数据的本地副本，需确保
MX_MACRO_DATA_OUTPUT_DIR指向受控存储路径 - 高频查询可能触发东方财富API的速率限制，建议上层实现指数退避重试机制
- 最大补全迭代次数限制为5次，极端情况下可能存在未覆盖数据项