clawyi-com / china-market-data

# china-market-data · 中国市场数据
English · 技能入口 · 来源与修改说明 · Apache-2.0
**`clawyi-com/china-market-data`** 是面向中国用户的 **中国市场数据 / 中国股票市场数据 Skill**：让 Cursor、Claude Code、Codex 等 AI Agent 直接调用可运行的 Python CLI，取到 A 股行情、研报、资金、公告、打板、期权、期货与宏观等真实数据，并标明时间戳、覆盖范围和失败降级方式。
**15 层能力 · 87 个端点（含 5 个备用入口）· 34 个数据来源 · 除 iwencai 外全部免 API Key**
> 这不是投顾建议，也不是付费数据商 SDK。
## 目录
- 30 秒开始
- 直接这样问 AI
- 为什么用它
- 15 层能力一览
- 数据来源
- 安装
- 命令行使用
- 数据边界
- 开发与验证
- 许可证与致谢
## 30 秒开始
 [code] 
装好后直接向 AI 助手提问即可。腾讯报价等入口只用 Python 标准库；需要完整数据能力时，再按安装 Python 依赖执行一次初始化脚本。
## 直接这样问 AI
| 你想知道 | 可以这样问 |
| --- | --- |
| 实时行情与估值 | “贵州茅台现在的价格、PE、PB、市值和换手率” |
| 历史 K 线 | “拉宁德时代近一年前复权日 K 线” |
| 打板情绪 | “今天涨停池、连板梯队和炸板率怎么样” |
| 题材热点 | “今天有哪些强势股，分别是什么题材” |
| 资金动向 | “北向资金今天的分钟流向”“概念板块近 5 日主力资金流入排名” |
| 龙虎榜 | “今天全市场龙虎榜净买入排名，以及某只股票的买卖席位” |
| 研报与预期 | “比亚迪最近的券商研报和机构一致预期 EPS” |
| 公告与互动 | “查某公司最新公告 PDF”“公司在互动易上怎么回应这个传闻” |
| 期权 | “300ETF 期权 T 型报价、隐含波动率和希腊字母” |
| 期货与商品 | “螺纹钢主力连续日 K”“上期所持仓前 20 名” |
| 宏观利率 | “最新 LPR、FR007 和中债国债收益率曲线” |
| 事件与可转债 | “本周新股申购”“可转债转股溢价率” |
| 回测准备 | “把这些代码转成聚宽格式，并拉申万行业历史归属” |
只讨论概念或投资观点、不需要实际取数时，技能不会被加载。
## 为什么用它
- **为 Agent 设计**：数据端点都提供 CLI 和 `--help`，SKILL.md 内置端点路由表，AI 按需读取对应章节，不必把全部文档塞进上下文。
- **免 Key 开箱即用**：除 iwencai 语义搜索外，全部接口不需要注册或 API Key。
- **优先官方与稳定来源**：优先腾讯、交易所、中债、人民银行等来源；东财接口内置节流，主源不可用时按“备用源速查”降级。
- **结果可核对**：保留报价来源、行情时间和抓取时间，区分缺失值与真实的 0，失败时明确报错，不用空数据冒充成功。
- **本地运行**：数据直接从来源取回本机，写入 JSON 文件，不经过第三方中转服务。
与 akshare、tushare 等 Python 数据库相比，本项目的定位是让 AI Agent 直接调用的技能包：路由说明、参数、数据边界与降级方式都写给 Agent 读。
## 15 层能力一览
| 层 | 能力 | 主要来源 |
| --- | --- | --- |
| 1 行情 | 实时报价（PE/PB/市值/涨跌停）、日周月前后复权与 1–60 分钟 K 线、逐笔成交、全市场盘后日线、复权因子 | 腾讯、通达信官网、百度、新浪 |
| 2 研报 | 个股/行业研报与 PDF、机构评级、一致预期 EPS、自然语言搜研报 | 东财、同花顺、新浪、iwencai |
| 3 信号 | 强势股与题材、北向资金、板块归属、分钟资金流、龙虎榜席位、解禁、行业与板块排名 | 同花顺、东财 |
| 4 资金与筹码 | 融资融券、大宗交易、股东户数、分红送转、日级资金流、筹码分布、ETF 份额 | 东财、上交所、深交所、本地计算 |
| 5 新闻 | 个股新闻、财联社电报、全球 7×24 快讯、新闻联播文字稿 | 东财、财联社、华尔街见闻、央视网 |
| 6 基础数据 | 财报三表、F10、估值历史、上市退市信息、申万行业变迁、ST 名单 | 新浪、通达信、baostock、申万、东财 |
| 7 公告 | 公告检索与 PDF 下载 | 巨潮 |
| 8 打板 | 涨停/炸板/跌停池、涨停原因、连板梯队与炸板率、监控池、异动 | 东财、同花顺 |
| 9 ETF 期权 | 合约清单、T 型报价、Delta/Gamma/Theta/Vega、隐含波动率 | 新浪 |
| 10 舆情互动 | 互动易、上证 e 互动、同花顺热榜与东财人气榜 | 巨潮、上交所、同花顺、东财 |
| 11 宏观利率 | 社融、PMI、中债收益率曲线、回购定盘利率、LPR、全球宏观日历 | 人民银行、国家统计局、中债、中国货币网 |
| 12 指数与日历 | 指数成分与权重、指数 PE 与股息率、官方交易日历 | 中证、国证、深交所 |
| 13 期货商品 | 五家期货交易所日行情、商品与股指期权、持仓排名、实时期货、A50、上海金 | 各期货交易所、新浪、上金所 |
| 14 事件驱动 | 业绩预告、机构调研、增减持、回购、股权质押、新股申购 | 东财 |
| 15 可转债 | 条款、转股价值、转股溢价率 | 东财 |
另有证券代码归一化、聚宽代码转换和估值计算等本地工具。完整端点、参数和市场限制见 SKILL.md 路由表；能取到某类数据不代表覆盖所有市场或所有日期。
## 数据来源
腾讯财经 · 东方财富 · 同花顺 · 新浪财经 · 百度股市通 · 通达信 · 巨潮资讯 · 财联社 · 华尔街见闻 · 央视网 · baostock · 申万 · iwencai · 上交所 · 深交所 · 上期所 · 上期能源 · 郑商所 · 广期所 · 中金所 · 上海黄金交易所 · 中证指数 · 国证指数 · 中债 · 中国货币网 · 人民银行 · 国家统计局
各接口的用途、限制和备用关系见 来源与降级说明。
## 安装
### 1. 安装 Skill（推荐）
需要 Node.js 22.20+ / npm。Skills CLI 直接以 GitHub 仓库为来源，不需要 npm 包；显式使用 `skills@latest` 可避开旧版全局目录兼容问题：
 [code] 
也可在 skills.sh 查看。不加 `-g` 时安装到当前项目，加 `-g` 后全局可用。Skills CLI 会复制仓库中除 `.git` 外的文件（包括 `tools/setup_env.py`），但不会安装 Python 依赖。
### 2. 安装 Python 依赖
需要 Python 3.9+。初始化脚本会在技能目录内创建 `.