前言¶

做 A 股相关的自动化分析时，常见做法是分别对接行情源、公告爬虫和各类财经 API，再在本地拼表、对齐字段。对话式 Agent 能写代码、能查资料，却缺少一套在 Skill 里约定好的、可复用的数据入口。下面介绍 SkillHub 上的 equaldata: A股股票金融数据服务（坐标 @org-q59kojk2/equal-data-skill，当前版本 1.0.20），它把 equal-data 侧的多维金融数据封装成 Agent 可调用的 Skill，便于在 Cursor、Claude Code 等环境里用自然语言或脚本拉取结构化结果。

这是什么¶

equaldata: A股股票金融数据服务 是 SkillHub professional 分类下的企业来源（enterprise）Skill，由 上海鸣应 发布。官方简介写明：服务覆盖 A 股 5000+ 家上市公司，提供行情、财报、基本面、重大事件追踪（高管增减持、重大合同、股东变动、大宗交易、限售解禁、定向增发、分红送转、业绩预告等）、股东分析、基金持仓与变动统计、知名机构动向（国家队、外资、私募、公募、信托、保险、证券等）、牛散持仓、资讯与公告等多形态结构化数据。

SkillHub 页面标注 requires_api_key=true，使用前需要准备 equal-data 侧 API Key，并在 Agent 环境中完成配置（具体变量名以安装包内 SKILL.md 为准）。

核心功能¶

以下能力均来自 SkillHub 官方简介，按数据类型归纳，便于对照需求：

1. 行情与基本面：上市公司行情、财报与基本面指标。
2. 事件与公告：重大事件追踪、资讯、公告等结构化条目。
3. 股东与资金：股东分析、基金持仓及变动；机构动向（含国家队、外资、公募私募等类型）；牛散持仓。
4. 底层调用方式：PyPI 包 equal-data（equaldata 官方工具包）通过 EqualDataApi 与 interfaceId 访问接口；包说明称支持 100+ 个金融数据接口，接口文档见 equal-data 数据接口文档。

安装与启用¶

方式一：让 Agent 按 SkillHub 指引安装¶

SkillHub 技能页给出的安装提示如下，可将原文发给当前使用的 AI Client：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@org-q59kojk2/equal-data-skill`。

方式二：使用 SkillHub CLI¶

先按 SkillHub 安装说明 安装 skillhub CLI。安装技能时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。

command -v skillhub && skillhub --version

skillhub install @org-q59kojk2/equal-data-skill --dir <skills 目录>

常用 Client 的 skills 路径（摘自 SkillHub 安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

Python 依赖（直接调 equal-data 时）¶

若 Agent 通过执行 Python 调用数据包，需安装 PyPI 上的 equal-data（要求 Python >=3.6，官方 Quick Start 见 pypi.org/project/equal-data）：

pip install equal-data

API Key 由 equal-data 服务方签发；SkillHub 标签已标明需要 API Key，请在安装 Skill 后按包内说明写入环境变量或 Agent 配置。

典型用法¶

1. 对话式查询¶

equal-data 官方 GitHub 仓库（与 PyPI 包主页一致）README 中的示例：安装并在智能体中加载技能后，可用中文直接描述需求，例如：

获取平安银行历史成交价格

Agent 会按 Skill 约定选择接口并返回结构化数据（具体编排以安装后的 SKILL.md 为准）。

2. 用 equal-data Python API 拉取列表数据¶

下列示例来自 PyPI equal-data 项目页的 Quick Start，演示通过 interfaceId 查询数据（如高管增减持相关接口 B6）：

from equal_data import EqualDataApi

api = EqualDataApi("your equal data api key")
data = api.query_equal_data(
    interfaceId="B6",
    period=4,  # 近1年
    changeType=1,  # 增持
    pageIndex=0,
    pageSize=50,
)

interfaceId、分页与筛选字段的完整说明见 接口文档。

适用场景与注意¶

适合谁

• 需要在 Agent 工作流里查 A 股行情、财报、事件、股东与机构持仓等，并希望少写零散爬虫的开发者或研究员。
• 已持有或愿意申请 equal-data API Key，并能在本机或 Agent 环境配置密钥的团队。

限制与注意

• 数据能力与配额以 equal-data 服务条款及 API Key 权限为准；Skill 提供的是接入与编排，不替代合规审查与投资决策。
• SkillHub 当前统计（抓取时）：评分 100000，下载 13610，安装 507；版本 1.0.20。升级后请以技能页与包内 SKILL.md 为准。
• 未在 SkillHub 页面单独列出 Cursor / Codex / Claude Code 的差异配置时，按各 Client 的 skills 目录安装即可；API Key 配置请遵循安装包说明。

结尾¶

equaldata: A股股票金融数据服务 把 A 股多维度结构化数据收敛到 SkillHub 上的一个坐标，适合在 Agent 里做查询、汇总与脚本化分析。官方入口：

• SkillHub 页面：https://www.skillhub.cn/skills/org-q59kojk2/equal-data-skill
• API 坐标页：https://api.skillhub.cn/org-q59kojk2/equal-data-skill