核心用法
mx_data 是一个专业金融数据查询 Skill,通过妙想金融数据接口对接东方财富权威数据库。用户以自然语言描述查询需求(如"东方财富最新价"),Skill 自动转换为 API 请求并返回结构化数据。
使用流程:
1. 配置环境变量 MX_APIKEY 完成身份认证
2. 构造 JSON 请求体,核心字段为 toolQuery(查询关键词)
3. 向 https://mkapi2.dfcfs.com/finskillshub/api/claw/query 发送 POST 请求
4. 解析返回的 dataTableDTOList(指标数据)、entityTagDTOList(证券主体信息)等字段
5. 以表格或文字形式向用户呈现关键指标
数据覆盖范围:
- 行情类:股票、行业、板块、指数、基金、债券的实时行情、资金流向、估值
- 财务类:公司基本信息、财务指标、高管信息、主营业务、股东结构、融资情况
- 关系与经营类:企业关联关系图谱、经营相关数据
显著优点
1. 数据源权威:直接对接东方财富数据库,避免 LLM 使用训练数据中的过时信息
2. 实时性强:提供实时行情数据,支持投资决策的时效性需求
3. 自然语言交互:无需记忆复杂 API 参数,用日常语言即可查询
4. 标准化输出:返回结构化的 dataTableDTOList,便于下游处理
5. 覆盖全面:涵盖 A 股、基金、债券等多类资产,行情与基本面数据兼备
潜在缺点与局限性
1. 依赖外部认证:需单独申请并配置 MX_APIKEY,增加使用门槛
2. 仅限客观数据:不输出主观分析或投资建议,需用户自行研判
3. 大数据量风险:大范围、长时间序列查询可能导致返回数据过大,引发上下文超限
4. 网络依赖:需稳定连接东方财富服务器,无法离线使用
5. 查询灵活性受限:复杂条件筛选依赖接口支持程度,不如直接 SQL 查询灵活
适合人群
- 个人投资者:快速查询持仓股票的实时价格、财务指标
- 金融分析师:获取标准化数据进行研究分析
- 财经内容创作者:核实数据准确性,避免引用错误信息
- 开发者:构建基于实时金融数据的应用或报告工具
常规风险
- API 密钥泄露:
MX_APIKEY需妥善保管,避免硬编码在公开代码库 - 数据使用合规:获取的数据需遵守东方财富的使用条款,不得用于违规交易或再分发
- 服务可用性:依赖第三方服务稳定性,建议设计降级方案
- 查询成本控制:高频调用可能产生费用或触发限流