a-stock-data 中文教程：安装 v3.9.0 Skill 并核对 A 股数据
a-stock-data 的主体是一份给 AI 编程助手读取的 SKILL.md，不是行情服务器，也不是可直接下单的交易系统。它把分散在多个公开网站的取数代码、来源优先级和失败处理写进同一个文件，让 Agent 能按任务选择入口。
1. v3.9.0 现在包含什么
官方按 80 个主入口和 5 个备胎统计 85 项能力，分成 15 层：行情、研报、市场信号、资金面、新闻、财务、公告、打板、ETF 期权、舆情、宏观利率、指数日历、期货大宗、事件驱动和可转债。v3.9.0 新增后三层，也补充腾讯 K 线、通达信官网盘后包、新浪研报、ETF 份额、收益率曲线等路径。
这些入口来自腾讯、交易所、巨潮、东财、新浪等外部站点。仓库会做分页、字段和日期检查，也准备部分备用源，但无法给第三方接口提供 SLA。某个函数昨天可用，不代表今天仍会返回同样字段。
2. 固定版本后安装
# Claude Code：先创建 skill 目录 mkdir -p ~/.claude/skills/a-stock-data # 官方 README 使用 main；正式流程建议改成固定 tag 或提交的 raw 地址 curl -o ~/.claude/skills/a-stock-data/SKILL.md \ https://raw.githubusercontent.com/simonlin1212/a-stock-data/main/SKILL.md # v3.9.0 的依赖 python3 -m pip install mootdx requests pandas stockstats numpy baostock xlrd openpyxl
v3.9.0 release 写明仍兼容 Python 3.9，依赖没有变化。Codex 或其他支持项目上下文的 Agent 可以读取同一份 SKILL.md。若团队需要复现，不能长期指向会变化的 main，应记录 tag 或提交哈希。
3. 第一次取数怎样检查
先选一个已发布数据的交易日和一只熟悉股票，只请求少量字段。逐项核对返回中的 source、source_url、fetched_at，再看代码、日期、币种、复权口径和单位。关键财务数字应回到交易所公告、巨潮披露或另一独立来源复算。
README 给出的离线检查是：
python3 -m unittest discover -s tests -v
联网测试必须显式传入真实交易日，例如 v3.9 新入口用 ASTOCK_LIVE_V39=2026-09-18 启动对应测试。这样做能避免测试默认悄悄访问网络，也方便区分“代码解析失败”和“当天上游尚未发布数据”。
4. 两个容易误解的边界
第一，“除 iwencai 外免 Key”只表示当前调用路径不要求项目提供的 API Key，不等于获得数据再分发权，也不保证不会限流。第二，mootdx 的公开服务器在 2026-09 出现 K 线、五档和逐笔返回 0 行的问题。官方当前只保留它的财务与 F10 用途，行情转向腾讯 K 线和盘后包等路径。
5. 与 AKShare 对比
AKShare 官方项目 是可通过 pip 安装的 Python 财经数据接口库，覆盖更多资产类别，公开函数通常返回 DataFrame，并提供接口检索和分类文档。a-stock-data 更像 Agent 的一张 A 股取数手册，把一组入口、降级规则和内嵌代码集中在单个 Skill。写传统 Python 数据程序时优先评估 AKShare；希望 Agent 按固定规则查 A 股资料时，a-stock-data 更直接。
这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。
先判断这个项目是否适合你
适合谁用
适合在 Agent 会话中快速查找 A 股公开行情、公司披露、研报索引、宏观数据与交易日历，也可把返回数据交给自己的分析或回测代码。它不提供投资建议、订单执行、稳定 SLA 或数据授权保证；正式研究应保存抓取时间和原始来源，并与交易所、监管披露或第二来源复核。
采用建议
a-stock-data 适合把常见 A 股取数动作装进 Agent，但不能把“接口能返回”当作“数据已权威确认”。固定版本、保存来源和抓取时间、对关键数字做第二来源复核，才适合研究使用。
原教程未展开的系统信息
核心功能
15 层公开市场数据入口
官方 v3.9.0 按 80 个主入口与 5 个备胎统计 85 项能力，覆盖 A 股行情、研报、资金面、财务公告、期权、宏观利率、期货大宗、事件和可转债。
面向 Agent 的单文件 Skill
核心 SKILL.md 同时写明调用方法、Python 代码、来源优先级和错误边界，可放入 Claude Code 的 skill 目录，也可作为 Codex 或其他 Agent 的项目上下文。
主源失败时的降级路径
仓库记录多个来源和备胎，并在 v3.9.0 将失效的 mootdx 行情路径改为腾讯 K 线与通达信官网盘后包；降级不代表数据自动同口径，使用者仍要检查字段、日期和单位。
离线与显式联网测试
README 给出从 SKILL.md 抽取发布代码的离线 unittest，也为 v3.9 新入口提供必须显式设置交易日环境变量的真实网络测试。
架构与数据流
项目不是常驻服务，也不是普通 Python 包。核心 SKILL.md 按数据层组织来源说明与内嵌 Python 函数；Agent 在任务中选取函数并访问腾讯、交易所、巨潮、东财、新浪等公开端点。tests 从 SKILL.md 提取代码做离线契约检查，联网测试另行开启。来源优先级、串行限流、会话复用、分页完整性和字段异常处理写在 Skill 与 release 说明中。
常见问题
a-stock-data 真的完全不需要 API Key 吗？
官方当前口径是除 iwencai 外零鉴权。零鉴权不代表上游不会限流、改接口或限制使用。
v3.9.0 还能用 mootdx 获取 K 线和五档吗？
官方 release 记录显示这些公开服务器路径在 2026-09 返回 0 行。目前只保留 mootdx 的财务与 F10 用途，行情应使用文档列出的替代入口。
a-stock-data 自带回测和交易执行吗？
不带。它负责数据获取，返回结果可以交给用户自己的分析或回测框架。
怎样确认某个端点今天仍然可用？
先跑离线测试，再按 README 显式开启真实网络测试，并检查来源、交易日、字段和单位；关键数字还应回到原始披露复核。