前言¶

做 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