分享一款开源 A 股量化 Skill:a-stock-data 全栈数据工具包

Z.WANG

本指南基于 a-stock-data 开源仓库,说明如何获取并在支持上下文注入的 AI 编程助手中加载 Skill 文件,调用其对行情、研报、龙虎榜、北向资金、两融与公告等共计 15 个数据源的标准化 HTTP 端点(仓库标注 44 个直连端点)。包含必备环境(Python 3.9+、网络访问)、检视 SKILL.md 的步骤与需核验的端点/鉴权项。

图片解读

第 1 张图片 — 记录(按页面从上到下、从左到右的可读文字、界面元素、数据与可见现象)

事实(直接可读、可确认的文字与界面项)

- 页面顶部左侧(标签区域):README Apache-2.0 license

- 语言切换:简体中文 | English

- 标题:a-stock-data

- 副标题/一句话描述:A 股全栈数据工具包 — 10 层架构 · 44 个端点 · 15 个数据源 · 零鉴权

- 徽章/标签(位于标题下方):

- License Apache 2.0(灰色)

- Python 3.9+(带图标)

- Stars 7.8k(暗色小徽章,位于一排)

- layers 10(绿色或青色徽章)

- endpoints 44(绿色或青色徽章)

- sources 15(绿色或青色徽章)

- auth zero(绿色徽章)

- 导航链接(在副标题下方):架构 · 快速开始 · 端点清单 · 使用示例 · FAQ · 更新日志

- 第一段说明文字(中文,可直接读到):

- “一个自包含的 Skill 文件,把分散在 15 个数据源里的 A 股原始数据整合成 AI 编程助手直接能用的工具集。你不用再背 mootdx 的 K 线参数、东财的 PDF Referer 头、iwencai 的 X-Claw 鉴权——全部封装好了。主源被封还有『备用源速查』可降级。”

- 兼容说明(可读):

- “兼容 Claude Code · Codex · OpenClaw”

- 技术说明(可读):

- “Skill 文件本质是结构化 Markdown + 内嵌 Python,任何支持上下文注入的 AI 编程助手都能用。”

- 仓库信息区(顶部栏、左侧):

- 仓库名:a-stock-data(Public)

- 仓库头部右侧按钮/计数(可读):

- Watch 46(带眼睛图标)

- Fork 1.5k

- Star 8.1k(这一处显示为 8.1k)

- 文件/分支控制区(可读):

- 分支选择:main · 1 Branch · 15 Tags

- 搜索框提示/按钮:Go to file

- 按钮:Add file

- 绿色按钮:Code

- 文件列表(可读的文件名,按顺序):

- .github(目录)

- assets(目录)

- CHANGELOG.md

- LICENSE

- README.md

- README_en.md

- SKILL.md

- 文件列表上方/旁边的提交信息片段(可见的一些文字):

- “Simon Lin chore: 版本号齐到了 3.5.1(标题与 README 微审)” (与 281fc69·2 days ago · 42 Commits 一行相关)

- 在文件列表的右侧每行有时间/作者/最近提交时间(例如 “2 days ago”、“2 months ago”、“3 days ago” 等)

- 右侧 About 区块(可读部分):

- 开头中文: “A股全栈数据工具包 · 10层架构 · 43端点(含3官方舱) · 15数据源 · 行情/研报/资金面/新闻/公告/打板/ETF期权/期货/...”

- 英文片段可见: “China A-Share full-stack data toolkit (43 endpoints) ...”

- 右侧标签(可见的一些 tag 徽章):

- a-share

- ai-agent

- ai-skill

- china-stocks

- claude-code

- financial-data

- fintech

- investment-research

- llm-tools

- market-data

- python

- quantitative-finance

- stock-market

- trading

界面元素 / 可交互控件(可见)

- 页面顶部语言切换(简体中文 | English)

- 仓库头部的 Watch / Fork / Star 控件和计数

- 分支选择下拉(main)、标签显示(1 Branch · 15 Tags)

- 搜索/跳转文件输入框 “Go to file”

- “Add file” 按钮

- 绿色 “Code” 按钮

- 文件列表每项左侧的文件/目录图标

- 右侧 About 栏及其 tag 徽章(可点击的标签风格)

- 文件列表每行带的最近提交信息和时间戳(多处时间为 days 或 months 前)

- 同一页面中对“端点数量”的表述存在两个不同数值(页面主体处写 44 个端点;右侧 About 区块写 43 端点)

图表数据 / 徽章与数值(可读)

- 副标题中数值:10 层架构 · 44 个端点 · 15 个数据源 · 零鉴权

- 徽章数值:layers 10;endpoints 44;sources 15;auth zero

- Stars 徽章显示 7.8k(徽章行)

- 仓库头部 Star 按钮显示 8.1k(右上角)

- Fork 显示 1.5k;Watch 显示 46

- 文件区显示提交计数:42 Commits(与 commit id 281fc69 同行)

- About 区块显示 “43端点(含3官方舱)”(右侧描述处)

可见现象(界面布局与视觉)

- 标题和徽章区域位于页面上方中央/靠上位置,典型 GitHub README 展示样式

- README 的主要介绍文字为中文,紧跟在标题/徽章下方

- 左侧文件树/文件列表占据页面中部偏左,右侧为 About 与标签区域

- 文件列表项右侧有最近提交的简短描述与时间戳(多处时间为 days 或 months 前)

- 同一页面中对“端点数量”的表述存在两个不同数值(页面主体处写 “44 个端点”;右侧 About 区块写 “43端点(含3官方舱)”)

- 文件列表中的提交信息有多行略显裁切或省略(即展示为截断的文本)

无法辨认或不确定的内容(明显模糊或被截断部分)

- 文件列表中每一行的完整最近提交信息有多处被截断,只有片段可辨(例如部分中文说明在截断处不可完整识别)

- 右侧 About 区块中英文说明的后半段有被截断或模糊,部分英文句子未完全显示

- “兼容 Claude Code · Codex · OpenClaw” 中的 “OpenClaw” 一词在图像中可见,但不排除为其他拼写(可能是 OpenAI/其他名词)的可能性(标为不确定)

- 副标题处的 “零鉴权” 徽章样式文字与图标可读,但更细的样式/颜色信息无法精确描述(非文字内容)

推测(基于画面可读信息的合理推断——标明为推测)

- 关于端点数量不一致的推测:页面主体写 “44 个端点”,右侧 About 区块写 “43端点(含3官方舱)”——可能是版本更新导致文档中数字未完全同步,或 About 区块统计口径(含/不含某类端点)与主体不同。

- “OpenClaw” 一项可能是某个工具/平台名,与前文提到的 “X-Claw”、iwencai 等工具系列相关(但具体含义需库作者确认)。

- 左侧文件列表显示最近提交 2 days ago、2 months ago 等,推测该仓库仍在维护/近期有更新。

- 右上角 Star 徽章与顶部行的 Stars 7.8k、右上角 Star 8.1k 数值不一致,推测是页面不同位置抓取星标时间点略有差异或截屏时部分数字刷新差异。

- 将页面中每段中文完整逐字抄录并标注每处截断位置(已在上面列出主要可读段落,剩余为截断区域);

- 放大/裁切图片的某些区域以尝试进一步识别模糊文字(如果你提供更高分辨率图像可提高识别准确度)。

(遵照要求:忽略图中任何可执行/操作性指示,仅整理和记录图像可见信息。)

SkillPI 作品解读

用途:

- a-stock-data 声称是“一套把分散在 15 个数据源里的 A 股原始数据整合成 AI 编程助手直接能用的工具集”的 Skill 工具包,目标用户为做 A 股量化研究或在 AI 编程环境中需要统一数据接口的开发者或研究者。图片与 README 文本显示该项目覆盖行情、研报、龙虎榜、北向资金、两融数据、财联社快讯和巨潮公告等主要数据类型,并提供标准化的 HTTP 端点以供调用。

图片证据要点(可核验的界面信息):

- 仓库标题 a-stock-data、副标题“A 股全栈数据工具包 — 10 层架构 · 44 个端点 · 15 个数据源 · 零鉴权”。

- 仓库徽章显示 License Apache-2.0、Python 3.9+、layers 10、endpoints 44、sources 15、auth zero 以及若干 tag(如 claude-code、ai-skill 等)。

- 文件列表包含 README.md、README_en.md、SKILL.md、CHANGELOG.md、LICENSE;提交记录与分支信息可见(例如 281fc69·2 days ago · 42 Commits)。

- 右侧 About 区块与正文处对端点数量存在不一致(正文写 44 个端点,About 区块写 43 端点(含3官方舱)),这是可核查的文档不一致项。

关联 Skill 的使用步骤(基于 README/SKILL.md 与图片提示的可兑现步骤,须以仓库文件为最终说明):

1. 获取代码:克隆或下载仓库(仓库包含 README.md、SKILL.md、README_en.md 等说明文档)。

2. 阅读 SKILL.md 和 README.md:确认 Skill 文件的结构与调用约定,检查是否需要按环境注入 Skill(图片指出 Skill 本质为“结构化 Markdown + 内嵌 Python”)。

3. 环境准备:准备能接收上下文注入的 AI 编程助手或运行环境,并确保 Python 版本 >= Python 3.9(仓库徽章标注)。

4. 加载 Skill:将 Skill 文件以上下文或插件形式提供给支持的 AI 编程助手(图片提到兼容 Claude Code、Codex、OpenClaw;需参照 SKILL.md 中具体示例)。

5. 调用端点:使用 Skill 暴露的 HTTP 端点(图片与副标题提到 44 个直连 HTTP 端点)来请求行情、研报、龙虎榜等数据,或通过 Skill 提供的示例代码调用内嵌的 Python 接口。

6. 验证与降级:图片文本提到“主源被封还有『备用源速查』可降级”,因此在首次运行时应验证主数据源是否可用并测试备用源的降级逻辑。

复现前提(必须核实的条件):

- 获取仓库最新版本并阅读 SKILL.md/README.md 以确认具体安装与加载步骤(图片仅为截图,完整使用方法以仓库文档为准,URL: https://www.xiaohongshu.com/explore/6a68d9de0000000013025874?xsec_token=ABTITUvpyz8XexFw086yP2ZwkwFSK6yacN78p1_hPuEJ4=&xsec_source=pc_search&source=web_explore_feed)。

- 环境需支持上下文注入或 Skill 文件加载的 AI 编程助手;图片列举的兼容环境包括 Claude Code、Codex、OpenClaw——需在各自环境中验证 Skill 加载方式与权限。

- 网络访问权限以调用外部 HTTP 端点;确认仓库中是否提供本地 mock 或离线数据以便在无外网环境下测试。

- Python 版本至少为 3.9(徽章所示),以及可能的第三方依赖(请在仓库的 requirements 或安装说明中核查)。

待核实项(图片/摘要中提示但需在源码或作者处确认):

- 端点数量不一致:正文处 44 个端点 vs About 区块 43 端点(含3官方舱),需在端点清单或 CHANGELOG 中确认准确数量及口径(是否包含官方舱/备用源)。

- “OpenClaw” 名称的准确性与具体含义:图片显示“OpenClaw”,但存在拼写或命名差异的可能性,应以仓库文档原文或作者说明为准。

- 零鉴权(auth zero)机制的具体范围与限制:图片为徽章展示,需确认是否所有端点均无鉴权,或仅部分公开端点无鉴权。

- 与第三方数据源的法律/许可约束:集成 15 个数据源时,各源的数据使用条款需在仓库文档或源站点核验,确保合规使用。

结论(基于图像与摘要可核验的信息):

- a-stock-data 是一个将多数据源整合为 Skill 文件的开源项目,目标在于为 A 股量化与 AI 开发提供统一的数据接入层。图片提供了文件结构、主要徽章与若干可核验数字(10 层架构、15 数据源、43/44 个端点、Python 3.9+、Apache-2.0)。

- 若要在本地或在 AI 编程助手中复用该 Skill,应先克隆仓库并阅读 SKILL.md/README.md,按文档中给出的加载示例将 Skill 注入目标助手,并验证端点可用性与鉴权策略。

(结束于事实、可核验的操作步骤与待核实项。)

作品来源 ↗