核心用法
equal-data-skill 是基于 PyPI 包 equal-data 封装的金融数据服务 Skill，专注于 A 股市场全维度数据查询。用户通过 Python SDK 调用标准化 API，以自然语言或结构化参数获取数据。核心流程为：安装依赖 → 配置 API Key（环境变量或配置文件）→ 调用 EqualDataApi.query_equal_data() 方法，传入 interfaceId 及业务参数即可返回 JSON 数据。
数据覆盖范围
- 行情数据：实时行情、历史日 K、行业/概念板块
- 公司基本面：财务指标、主营业务、十大股东、股东人数、管理层信息
- 重大事件：高管增减持、限售解禁、大宗交易、分红送转、业绩预告、重大合同、机构调研
- 市场热点：龙虎榜、游资追踪、营业部胜率、打板专题
- 机构动向：国家队、外资（北向）、公募、私募、保险、信托、券商、牛散持仓
- 资讯公告：快讯、新闻、研报、公告
典型调用示例
以查询高管增减持金额排行榜为例：
from equal_data import EqualDataApi
api = EqualDataApi(os.getenv('EQUAL_DATA_API_KEY'))
data = api.query_equal_data(interfaceId="B6", period=1, pageSize=20)显著优点
1. 数据维度极全：48 个接口覆盖 6 大分类（特色数据、基础数据、财务数据、资讯、行情、打板专题），满足从基本面到技术面的全场景需求
2. 实时性与专业性：支持近 1 月胜率排行、实时龙虎榜、机构持仓变动等高频数据，数据来源标注为专业金融数据库
3. 自然语言友好：支持通过自然语言输入进行数据查询，降低量化分析门槛
4. 轻量易集成：纯 Python 依赖，PyPI 一键安装，RESTful API 返回标准 JSON，便于二次开发
潜在缺点与局限性
1. 数据地域局限：仅覆盖 A 股市场（5000+ 上市公司），不含港股、美股及其他海外市场
2. API Key 付费门槛：需注册官网获取 EQUAL_DATA_API_KEY，未明确标注免费额度与付费定价
3. 数据源透明度不足：文档未披露底层数据供应商（如是否直连交易所、Wind、同花顺等），权威性存疑
4. 无交易功能：纯数据查询服务，不支持直接下单交易，需用户自行对接券商系统
5. Python 独占：暂无 Node.js、Go 等其他语言 SDK，非 Python 生态用户集成成本较高
适合人群
- 量化研究员/个人投资者：需要批量获取 A 股结构化数据进行策略回测
- 财经自媒体/分析师：快速生成龙虎榜解读、机构持仓变动、热点板块追踪等内容
- 金融科技开发者：构建智能投顾、选股工具、投研平台的底层数据层
- 对游资战法、打板策略感兴趣的交易者：C 类打板专题数据提供营业部胜率、游资操作明细等特色指标
常规风险
- 数据延迟风险：实时行情类数据可能存在秒级延迟，高频交易场景需谨慎
- API 稳定性：第三方商业服务存在接口变更、服务中断或调价可能，建议做好降级方案
- 合规使用：数据仅限研究与信息获取，不得用于非法证券咨询或操纵市场
- 密钥安全：
EQUAL_DATA_API_KEY需妥善保管，避免硬编码提交至代码仓库
综合评估
该 Skill 是 A 股投研数据覆盖度较全的工具型服务，适合中低频量化分析与投研辅助，但在数据源权威性说明、定价透明度及多语言支持方面仍有提升空间。