simonlin1212/a-stock-data 是一个 Apache-2.0 协议开源的 A 股数据工具包，GitHub 上已有 9.4k star 与 1.7k fork。它以单个 Skill 文件的形式，把 19 个数据源整合成 54 个数据端点，按十一层架构覆盖行情、研报、资金面、打板、宏观等场景，全部数据接口零鉴权、免费、无需 API Key。装进 Claude Code、Codex 或 OpenClaw 后，用自然语言提问即可取数——「帮我估一下 688017」「今天哪些行业涨幅最大」这类问题可以直接得到数据答案。

一个文件装下整个数据栈

项目的核心是一个自包含的 SKILL.md 文件：结构化 Markdown 加上内嵌 Python 代码。把它放进 AI 编程助手的 skills 目录，助手就能按需调用其中的取数函数。作者把「单文件自包含」定位为有意设计——拷一个文件就能用、离线可携、便于分发（相关讨论见仓库 #21 / #22 / #29），项目坚持这一形态到 v3.7.1，不做目录化拆分。

快速开始共三步、约 2 分钟：创建 ~/.claude/skills/a-stock-data/ 目录，用 curl 下载 SKILL.md 文件，再执行 pip install mootdx requests pandas stockstats numpy baostock xlrd openpyxl。v3.0 起不再依赖 akshare，改为直连底层 HTTP API，减少中间层故障点。

十一层架构：从 K 线到社融

数据按十一层组织：

  • 行情层：mootdx、腾讯、百度K线、新浪四路源，提供 K 线（带 MA5/10/20）、五档盘口、PE/PB/市值、指数/ETF；v3.7 新增复权因子 qfq/hfq。
  • 研报层：东财 reportapi、同花顺、iwencai，覆盖个股/行业研报、PDF 下载、一致预期、自然语言检索。
  • 信号层：强势股、题材归因、北向资金、板块归属、资金流向、龙虎榜、限售解禁日历。
  • 资金面/筹码层：融资融券、大宗交易、股东户数、分红送转、120 日资金流、筹码分布 CYQ（本地计算）。
  • 新闻层：个股新闻、财联社电报、全球资讯（7×24）。
  • 基础数据：季报 37 字段、F10 九大类、财报三表、估值历史（可回溯至 2016 年）、上市退市日、申万行业变迁史。
  • 公告层：沪深北全量公告。
  • 打板层：涨停池、炸板池、跌停池、昨日涨停池、涨停揭秘、重点监控池、日内异动池。
  • 期权层：ETF 期权 T 型报价、希腊字母、隐含波动率。
  • 舆情互动层：互动易问答、同花顺热榜、东财人气榜、概念命中。
  • 宏观层（v3.7 新增）：人民银行社会融资规模增量（月度 12 列）、国家统计局 PMI（分大中小型企业）。

打板层是端点最密集的一块：涨停池返回连板数、封板资金、炸板次数；重点监控池列出交易所风险警示名单与生效时间窗；日内异动池给出严重异常波动明细，并附 12 条异动规则解释。

零鉴权与防封设计

除 iwencai 语义搜索需单独申请 API Key 外，其余数据源全部零注册、零 key，包括 v3.7 新增的 baostock、申万、人民银行、国家统计局。

数据源按封 IP 风险排优先级：mootdx（通达信 TCP 7709 协议）与腾讯财经不封 IP，行情、实时价、市值这类高频请求一律优先走它们；东财系接口（datacenter/push2/reportapi 等）有访问频率风控，只用于独有数据，并统一经 em_get() 串行限流。每个数据层另配独立备胎——上交所/深交所官方龙虎榜接口、新浪资金流、巨潮公告等，主源被封时按「备用源速查」降级切换，不同域名互不牵连。

项目 FAQ 对 mootdx 停更的疑虑给出了实测结论：mootdx 库最后 commit 停留在 2024-07，但通达信 TCP 协议本身照常运行，内置的 tdx_client() 已绕开 BESTIP bug，实测 mootdx 0.11.7 在 httpx 0.28.1 下取数正常；若与 MCP 工具（要求 httpx 0.27.1+）冲突，用 pip install --no-deps 升级 httpx 即可绕过。

内置 4 套调研流程

项目内置四套开箱即用的调研流程：

  • 单票估值：实时价 → 一致预期 EPS → 前向 PE / PEG / PE 消化年数，约 30 秒。
  • 批量对比：多只股票横向估值排列，约 1 分钟。
  • 主题研报：iwencai 多关键词检索 + 东财 PDF 交叉补充，约 2 分钟。
  • 新标的调研：机构覆盖 → 估值 → 概念板块 → 资金流向 → 龙虎榜 → 解禁 → 两融，约 1 分钟。

版本动态

v3.7.1 于 2026-08-20 发布，修复了 get_prefix() 后缀路由问题；v3.7 新增 1 个数据层、7 个端点、4 个数据源，全部端点于 2026-08-19 实跑验证。仓库当前 47 次提交、19 个 Releases、1 名贡献者，作者 Simon Lin 在 README 中注明正寻找深圳地区 AI 相关岗位。

最后提醒一句：README 明确声明本项目仅提供数据获取工具，不构成投资建议。它解决的是「数据从哪来」的问题，投资决策仍要自己判断。