a-stock-data 是什么?

a-stock-data 是一个自包含的 AI 编程助手 Skill,用 Markdown 与内嵌 Python 封装 A 股及相关市场的公开数据入口。v3.9.0 覆盖行情、研报、财务、公告、期权、宏观、期货和可转债等 15 层,定位是取数工具,不包含回测或交易执行引擎。

⭐ 10,775 Stars 🍴 1,952 Forks Python Apache-2.0 作者: simonlin1212
来源:github.com/simonlin1212/a-stock-data 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

数据入口从 27 个扩到按项目口径计算的 85 个,并明确记录通达信公开服务器 K 线命令失效等上游变化,旧教程已经不能准确反映可用路径。

来源:github.com/simonlin1212/a-stock-data/releases/tag/v3.9.0

核心功能

15 层公开市场数据入口

官方 v3.9.0 按 80 个主入口与 5 个备胎统计 85 项能力,覆盖 A 股行情、研报、资金面、财务公告、期权、宏观利率、期货大宗、事件和可转债。

来源:github.com/simonlin1212/a-stock-data/releases/tag/v3.9.0
面向 Agent 的单文件 Skill

核心 SKILL.md 同时写明调用方法、Python 代码、来源优先级和错误边界,可放入 Claude Code 的 skill 目录,也可作为 Codex 或其他 Agent 的项目上下文。

来源:github.com/simonlin1212/a-stock-data/blob/main/SKILL.md
主源失败时的降级路径

仓库记录多个来源和备胎,并在 v3.9.0 将失效的 mootdx 行情路径改为腾讯 K 线与通达信官网盘后包;降级不代表数据自动同口径,使用者仍要检查字段、日期和单位。

来源:github.com/simonlin1212/a-stock-data/releases/tag/v3.9.0
离线与显式联网测试

README 给出从 SKILL.md 抽取发布代码的离线 unittest,也为 v3.9 新入口提供必须显式设置交易日环境变量的真实网络测试。

来源:github.com/simonlin1212/a-stock-data

技术架构

项目不是常驻服务,也不是普通 Python 包。核心 SKILL.md 按数据层组织来源说明与内嵌 Python 函数;Agent 在任务中选取函数并访问腾讯、交易所、巨潮、东财、新浪等公开端点。tests 从 SKILL.md 提取代码做离线契约检查,联网测试另行开启。来源优先级、串行限流、会话复用、分页完整性和字段异常处理写在 Skill 与 release 说明中。

来源:github.com/simonlin1212/a-stock-data

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) Python 3.9+ mootdx、requests、pandas、stockstats、numpymootdx、reques… baostock、xlrd、openpyxlbaostock、xlrd… iwencai 是官方所列唯一需要额外鉴权的来源iwencai 是官方… 15 层公开市场数据入口 面向 Agent 的单文件 Skill面向 Agent 的单文件… 主源失败时的降级路径 离线与显式联网测试 a-stock-data 项目本体 核心功能 关键依赖

技术栈

语言Markdown 与内嵌 Python框架Claude Code Skill,可作为 Codex 或其他支持上下文注入的 Agent 资料
Python 3.9+mootdx、requests、pandas、stockstats、nu…baostock、xlrd、openpyxliwencai 是官方所列唯一需要额外鉴权的来源
本机 Python 直接访问多个公开数据源;没有项目自有后端
来源:github.com/simonlin1212/a-stock-data/releases/tag/v3.9.0

快速上手

创建 ~/.claude/skills/a-stock-data,把官方 main 分支的 SKILL.md 下载到该目录,再执行 pip install mootdx requests pandas stockstats numpy baostock xlrd openpyxl。启动 Claude Code 后先用一个已知交易日和一只熟悉股票请求少量字段,核对 source、source_url、fetched_at、日期、币种与单位。Codex 用户可以把 SKILL.md 作为项目 skill 或上下文接入。自动化环境应改用固定 tag 或提交,避免 main 更新后结果无法复现。
来源:github.com/simonlin1212/a-stock-data

使用场景

适合在 Agent 会话中快速查找 A 股公开行情、公司披露、研报索引、宏观数据与交易日历,也可把返回数据交给自己的分析或回测代码。它不提供投资建议、订单执行、稳定 SLA 或数据授权保证;正式研究应保存抓取时间和原始来源,并与交易所、监管披露或第二来源复核。

来源:github.com/simonlin1212/a-stock-data

优势与局限

优势

  • 单个 Skill 集中记录多类 A 股公开数据入口和来源切换方法
  • v3.9.0 对分页、字段、日期和错误传播增加了较具体的检查
  • 提供离线测试与按日期显式开启的真实网络测试

局限

  • 大量入口依赖第三方公开网页和非正式接口,上游改版、限流或封禁会直接影响结果
  • 除 iwencai 外免 Key 不等于获得数据再分发权或服务级保证
  • mootdx 的 K 线、五档和逐笔路径在 2026-09 已失效,只保留财务与 F10 用途
  • 本轮没有安装依赖或发起真实行情请求,项目的行数和端点可用性均未本地复现
来源:github.com/simonlin1212/a-stock-data/releases/tag/v3.9.0

最新版本

截至 2026-09-23,最新正式 release 是 v3.9.0,发布于 2026-09-20。该版新增期货与大宗商品、事件驱动、可转债三层及 25 个能力入口,并补充腾讯 K 线、通达信盘后包、新浪研报、ETF 份额和利率曲线等路径;旧函数签名保留,官方标注无 breaking change。

来源:github.com/simonlin1212/a-stock-data/releases/tag/v3.9.0

实测与证据

status: docs-only  |  checked_at: 2026-09-23  |  environment: 只核对官方 README、SKILL.md、CHANGELOG 与 v3.9.0 release  |  limitations: 未下载 SKILL.md,未安装 Python 依赖,未运行离线测试或联网端点,也未验证任何市场数据值  |  observed_output: 官方最新 release 为 v3.9.0,发布于 2026-09-20;release 明确写明 Python 3.9 兼容、依赖不变、15 层、85 个入口和 34 个来源,并记录 mootdx 行情返回 0 行的变更

来源:github.com/simonlin1212/a-stock-data/releases/tag/v3.9.0

同类项目对比

AKShare 是可 pip 安装的 Python 财经数据接口库,公开函数通常返回 pandas.DataFrame,官方还提供接口检索与详细分类文档;a-stock-data 则把较小的一组 A 股相关入口、来源降级和调用规则集中进 Agent 可读的 SKILL.md。写传统 Python 数据程序、需要广泛资产类别时优先评估 AKShare;希望 Agent 在会话中按固定规则取 A 股数据时,a-stock-data 的单文件形态更直接。两者都依赖上游公开网站,均要处理来源变化和数据复核。

来源:github.com/akfamily/akshare

总结评价

a-stock-data 适合把常见 A 股取数动作装进 Agent,但不能把“接口能返回”当作“数据已权威确认”。固定版本、保存来源和抓取时间、对关键数字做第二来源复核,才适合研究使用。

来源:github.com/simonlin1212/a-stock-data

常见问题

a-stock-data 真的完全不需要 API Key 吗?

官方当前口径是除 iwencai 外零鉴权。零鉴权不代表上游不会限流、改接口或限制使用。

v3.9.0 还能用 mootdx 获取 K 线和五档吗?

官方 release 记录显示这些公开服务器路径在 2026-09 返回 0 行。目前只保留 mootdx 的财务与 F10 用途,行情应使用文档列出的替代入口。

a-stock-data 自带回测和交易执行吗?

不带。它负责数据获取,返回结果可以交给用户自己的分析或回测框架。

怎样确认某个端点今天仍然可用?

先跑离线测试,再按 README 显式开启真实网络测试,并检查来源、交易日、字段和单位;关键数字还应回到原始披露复核。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件