CLAUDE CODE MARKETPLACES

CNEquity

开源中国股市(A股)本地数据湖:沪深股票行情、A股股票数据与金融数据,面向量化研究、量化交易与回测,含财务数据、期货数据、资金流向、公告、指数行业与宏观。86个日更数据集,复权与历史成分内置,行级溯源、PIT,MCP原生。免注册、免 Token,自托管。Open-source China stock market data lake for quant research, backtesting and AI agents.

README.md
<div align="center"> <img src="docs/assets/cnequity-readme-banner.png" alt="CNEquity · 开源 A股本地数据湖,用于量化研究与回测" width="100%"> <h1>CNEquity · 中国市场金融数据湖</h1> <p>免注册、免 Token · 复权与 PIT 内置 · 保留退市股 · 行级溯源 · MCP 原生</p>

CNEquity 是开源的中国 A股本地数据湖:整理沪深股票行情、股票数据、财务与期货数据,面向量化研究、量化交易与回测。86 个数据集落到本地 Parquet,可增量续跑,也能通过 MCP 让 AI 直接查 A 股。

CI PyPI Python 3.11+ Apache-2.0 GitHub stars Glama MCP score

English · 完整文档 · 数据集目录 · 更新日志

</div>

cne serve 控制台录屏:A股数据湖状态、覆盖热力、日线详情与质量审计

cne serve 控制台真实录屏。

为什么用 CNEquity

和常用取数工具的区别(完整说明见对比页):

AKShareTushare ProBaostockCNEquity
账号与 Token不需要注册 + Token,按积分开放不需要,匿名登录基础采集不需要
数据落盘与增量调用方自己做调用方自己做调用方自己做本地 Parquet,内置增量与续跑
退市股与 PIT 财报取决于接口取决于接口部分提供保留退市股,财报按公告日严格 PIT
行级溯源无无无每行带来源、版本和抓取时间
给 AI 用自己封装自己封装自己封装cne mcp 只读接入

快速开始

需要 Python 3.11+(macOS / Linux / Windows),不需要账号或 token。

① 一分钟试用。 用真实数据源抓 5 只股票最近 30 个交易日,建在独立目录里,不影响以后的正式湖:

pip install cnequity
cne init --profile demo   # 约 1 分钟;结束时打印行情表、查询示例和接给 AI 的命令
cne serve --config configs/cnequity.demo.toml   # 在浏览器里打开上面的控制台

② 让 AI 直接查 A 股。 把湖以只读方式接给 Claude、ChatGPT、Codex、Gemini CLI、Cursor、VS Code 等支持 MCP 的客户端(--config 用绝对路径)。以 Claude Code 为例:

claude mcp add cnequity -- cne mcp --config /abs/path/to/configs/cnequity.demo.toml

各家客户端的写法见 MCP 接入指南;ChatGPT 只接公网网址,用 cne mcp --http --token 加隧道接入。然后直接问:「宁德时代最近 30 个交易日的最高收盘价是哪天?」

在 Claude Code 里通过 cne mcp 查询 A股:宁德时代最近 30 个交易日的最高收盘价

真实 MCP 工具调用与返回;收盘价为未复权价。

③ 建正式湖。 沪深京全市场、最近 3 年:

cne init     # 开始建正式湖,支持中断续传
cne check    # 检查数据是否完整、可用
from cnequity.query import load

bars = load("daily_bars", symbols=["600519.SH"])
print(bars.tail())

之后每天运行一次 cne run daily 保持更新。想要更长的历史,或了解 init 具体做了什么,见初始化指南。

能用它研究什么

你的问题数据与入口
跨分红、送转后的历史收益daily_bars + adj_factors · 复权示例
某个调仓日已经知道哪些财报信息financial_statement_items · PIT 示例
历史股票池、退市前行情instruments、trading_status、delisting_events · 股票池画像
估值、资金流、行业轮动valuation_metrics、资金面与结构数据 · 查询指南
期货期限结构、期权链与 Greeks逐合约行情和派生数据 · 衍生品指南

数据范围

支持 86 个数据集(78 个 curated、8 个 derived),按用途分为 L0–L9。字段、主键、历史起点和来源见数据集目录与数据源说明。

层次研究用途代表数据集
L0基础参考证券主数据、交易日历、交易状态
L1行情日线、指数、复权因子、可选分钟线与分笔、退市事件
L2公司事件公司行为、公告索引、业绩披露预约
L3基本面财报、估值、股本、股东、一致预期
L4资金面北向、融资融券、龙虎榜、大宗交易、资金流
L5结构行业指数成分、行业与板块成分、行业指数
L6宏观宏观指标、市场宽度
L7舆情与轮动新闻、快讯、情绪、人气、板块行情与资金流
L8风险合规解禁日程、监管事件
L9衍生品期货与期权合约、逐合约行情、连续合约、Greeks、分钟线

分钟线、分笔、期货/期权,以及资金流、新闻、人气榜等拓展数据集默认关闭,需要时用户自行打开。

架构

CNEquity 从多源采集、编排到本地 Parquet 湖及研究消费的架构图

幸存者偏差

今天的名单不能代替历史股票池。

A股回测幸存者偏差:含退市股与只留幸存者的历史等权持有结果对比

日常更新与升级

cne schedule install   # 为当前用户安装每日定时任务(macOS / Linux / Windows)
cne run daily          # 或者自己每天运行一次
cne check              # 验收;有缺口或质量 error 时返回非零

升级:pip install -U cnequity,然后 cne config upgrade 和 cne migrate(先预览,确认后加 --apply)。调度、操作页和失败后续见日常运维,范围与续跑见初始化指南。

适合与边界

适合持续积累历史、反复查询和自托管。

项目处于 0.x,不含回测引擎或下单。代码采用 Apache-2.0,数据另受上游许可约束,仓库不附带数据湖。

文档与参与

想做什么从这里开始
安装、跑通首个查询安装 · 快速开始
常见问题免费获取 A股历史数据 · 回测避免未来函数 · 用 AI 查 A股 · 与 AKShare、Tushare、Baostock 对比
找数据、确认口径目录 · 字段 · 研究示例
查命令、参数和副作用CLI · 参数默认值 · 联网与写入清单
配调度、处理失败运行手册 · 取数与源保护 · 排障
理解产品方向与反馈问题产品设计 · 升级与反馈

欢迎提交带最小复现的 Issue、文档修正或数据适配 PR。研究引用见 CITATION.cff;安全问题请按安全策略私下报告。

觉得有用?点一个 Star,或把项目分享给同样在维护 A 股数据的人。

<!-- mcp-name: io.github.rootSunc/cnequity -->