- name
- ashare-market-data-fetcher
- description
- 抓取并整理 A股市场数据。Use for: 获取 A股股票基础资料、交易日历、日线/分钟线/复权行情、停复牌、财务三表、财务指标、板块题材、资金流、公告与专业市场数据说明；当用户要求尽可能全面、详细、准确地获取 A股市场数据时使用。
A股市场数据抓取技能
在用户要求 抓取 A股市场数据、核对行情/财务/公告、为研究或回测准备数据、解释不同数据源为何不一致，或者 尽量全面且准确地整理某只股票、某个板块或某个时间段的数据 时，使用此技能。
本技能的核心目标不是随便抓到一些数字，而是使用 分层数据源策略、明确字段口径和多源校验规则，产出可用于研究、复盘、回测和半自动交易辅助的数据结果。
核心原则
始终把准确性优先级放在抓取速度之前。对 A股数据，必须区分 官方口径、商业专业口径、开源聚合口径 与 网页抓取口径，不要把它们混为一谈。[1] [2] [3] [4]
默认采用如下优先级：
| 优先级 | 数据源层级 | 适用场景 | 使用原则 |
|---|---|---|---|
| P1 | 交易所官方 / 官方授权链路 | Level-2、逐笔、订单簿、交易制度、权威市场口径 | 只要用户追求“最准确”且涉及高等级实时数据，先说明官方或持牌链路的必要性 |
| P2 | 专业商业数据接口 | 高稳定性、机构级序列数据、基本面深度字段 | 当用户需要专业级质量且可接受付费时优先考虑 |
| P3 | AKShare | 历史行情、部分财务报表、交易日历、市场统计、板块题材、公告补充、回测研究 | 作为免费结构化与聚合数据主源 |
| P4 | 巨潮资讯 / 交易所公开页面 | 定期报告、公告、交易制度、市场统计与权威披露 | 作为免费权威补源 |
| P5 | 其他网页公开页面 | 无正式接口但需补全信息时 | 只能作为补救方案，必须标注口径与抓取时间 |
数据源定位
1. AKShare
优先将 AKShare 用于 股票基础资料、交易日历、日线、分钟线、复权相关行情、市场统计、板块题材、资金流、龙虎榜、公告补充 等免费可得的结构化与聚合数据。[1] [2]
当任务涉及下列目标时，优先想到 AKShare：
| 任务 | 默认主源 |
|---|---|
| 历史回测数据准备 | AKShare |
| 财报分析底稿 | AKShare + 巨潮资讯 |
| 股票清单、上市公司信息、交易日历 | AKShare |
| 复权价格与交易状态补充 | AKShare + 交易所公开披露 |
不要把 AKShare 当作最高权威口径。它更适合承担 免费主抓取层 与 广覆盖聚合层。
2. 巨潮资讯 / 交易所公开页面
优先将 巨潮资讯 用于 公告、定期报告、上市公司披露文件 的免费权威补充；将 上交所/深交所公开页面 用于 交易制度、市场统计、市场概览与权威披露 的交叉核验。[3] [4] [5]
当用户要求“尽量准确”且任务涉及财报、公告、交易制度或市场统计时，应主动用巨潮资讯或交易所公开页面做第二来源校验。
3. Choice / EMQuant
当用户追求更高稳定性、更多专业字段、机构化使用体验，且接受商业数据接口时，将 Choice 视为升级选项。官方手册明确说明其可通过函数调用提供 基本面、财务、序列数据，并支持多种语言环境。[6]
4. 交易所官方 / 官方授权链路
当用户要求 Level-2、逐笔、订单簿、盘口深度、最准确实时市场数据 时，先明确说明：上交所官方市场数据产品包括 Level-1 与 Level-2，Level-2 包含逐笔、委托、撤单、订单档位等更丰富信息，并通过授权分发链路提供。[5]
遇到这类需求时，不要假装免费公开源等价于官方链路。应明确指出授权、权限、费用和分发限制。
触发决策
按下面顺序判断任务类型：
- 如果用户要 某只股票的基础资料、历史行情、财务三表、停复牌、复权，走“结构化主数据工作流”。
- 如果用户要 板块、题材、资金流、龙虎榜、公告、新闻或情绪信息，走“市场扩展信息工作流”。
- 如果用户要 分钟级、逐笔、Level-2、盘口、订单簿，先走“高精度实时数据说明工作流”，优先解释权限边界，再决定能否继续抓取。
- 如果用户要 为回测、选股、研究报告准备一组可复用字段，走“研究数据集工作流”。
- 如果用户明确说“要最准确”，必须主动补充 数据源优先级、字段口径、抓取时间和交叉校验。
工作流总览
按以下顺序执行，不要跳步：
- 识别数据对象与范围。
- 明确时间范围、频率和复权口径。
- 为每类字段选择主源与补源。
- 先抓结构化核心数据，再抓扩展信息。
- 对关键字段做交叉校验。
- 输出时强制声明来源、时间和口径。
- 若存在冲突或缺失，显式标注“待校验”或“数据不可得”。
第一步：识别对象与范围
先把任务拆成下面四个维度，并在内部明确：
| 维度 | 需要确认的内容 |
|---|---|
| 标的范围 | 单只股票、股票列表、板块、指数、全市场 |
| 时间范围 | 最新、当日、近 5 日、近 1 年、指定区间 |
| 数据频率 | 静态资料、日频、分钟频、Tick、Level-2 |
| 数据类型 | 行情、财务、公告、资金流、题材、交易状态、市场统计 |
如果用户没有说清楚，优先用当前任务上下文推断；实在无法推断时再询问最小必要问题。
第二步：确定字段口径
对行情类请求，必须先在内部确定以下口径：
| 字段 | 必须明确的口径 |
|---|---|
| 价格 | 前复权 / 后复权 / 不复权 |
| 时间粒度 | 日线 / 1 分钟 / 5 分钟 / Tick |
| 成交量 | 股数、手数或接口默认单位 |
| 成交额 | 元、万元、亿元或接口默认单位 |
| 涨跌幅 | 相对昨收还是相对复权基准 |
| 财报期间 | 单季度、累计值、TTM、年报、半年报 |
如果用户没有指定复权方式，默认优先提供 不复权 + 说明可切换复权口径；若任务用于回测，可额外提供前复权版本。
第三步：选择数据源
遵循下表，不要随意切换主源：
| 数据类别 | 默认主源 | 默认补源 | 备注 |
|---|---|---|---|
| 股票基础资料 | AKShare | 交易所公开页面 / 网页公开源 | 含代码、上市状态、行业、地域等 |
| 交易日历 | AKShare | 交易所公开日历 / 商业源 | 用于回测和调度前校验 |
| 日线历史行情 | AKShare | 网页公开源 | 需要说明复权口径 |
| 分钟行情 | AKShare | 网页公开源 | 若免费源不稳定，显式标注 |
| Tick / Level-2 | 官方授权链路 | 商业供应商 | 优先解释权限，不要误导 |
| 停复牌与复权相关信息 | AKShare | 交易所公告 / 网页公开源 | 回测任务务必优先校验 |
| 财务三表与财务指标 | AKShare | 巨潮资讯 / Choice | 财报类字段优先用结构化源并交叉核验 |
| 板块题材 / 资金流 / 龙虎榜 | AKShare | 商业源 / 网页补充 | 多为扩展层，不宜冒充官方口径 |
| 公告与资讯 | 巨潮资讯 / AKShare / 网页公开源 | 商业资讯源 | 必须标注抓取时间和来源 |
| 市场总貌 / 统计 | AKShare | 交易所公开页面 | 适合盘前盘后摘要 |
第四步：执行抓取
A. 结构化主数据工作流
在用户要股票基础资料、历史行情、财务与交易状态时，按以下顺序执行：
- 先抓股票代码与基础资料。
- 再抓交易日历，确认区间内是否有交易日。
- 再抓行情数据。
- 若用于研究或回测，再抓停复牌与复权因子。
- 若涉及基本面，再抓财务三表与财务指标。
- 最后统一整理字段名与单位。
B. 市场扩展信息工作流
在用户要板块、题材、资金流、龙虎榜、公告、新闻或情绪信息时，按以下顺序执行：
- 先抓核心标的或板块清单。
- 再抓扩展字段，如资金流、题材归属、龙虎榜、公告标题。
- 只把这些内容当作 辅助解释层，不要替代主行情或主财务数据。
- 若要给出结论，必须回到核心行情或财务字段做支撑。
C. 高精度实时数据说明工作流
当用户要 Level-2、逐笔、订单簿、盘口深度时，按以下顺序执行：
- 先说明此类数据通常依赖交易所官方授权链路或持牌供应商。[4]
- 再说明当前可用来源是否只是近似替代或公开聚合。
- 如果无法获得官方授权数据，不要假称“已经拿到最准确数据”。
- 若继续提供替代数据，必须写清“替代来源”“限制”“与官方口径可能存在偏差”。
D. 研究数据集工作流
当用户要“帮我准备回测/选股/研究的数据集”时，优先产出结构化表格，并最少包含：
| 字段组 | 建议内容 |
|---|---|
| 标识字段 | ts_code / 股票代码 / 股票名称 / 市场 |
| 时间字段 | trade_date / report_date / ann_date |
| 行情字段 | open / high / low / close / vol / amount |
| 状态字段 | 是否停牌 / 复权因子 / 上市状态 |
| 财务字段 | 营收、净利润、资产负债率、ROE、经营现金流 |
| 扩展字段 | 板块、题材、资金流、公告摘要 |
| 元数据 | 数据源、抓取时间、字段口径 |
第五步：执行校验
校验是本技能最重要的部分。至少对下面内容做一致性检查：
| 校验项 | 检查方法 |
|---|---|
| 股票代码 | 校验交易所后缀和市场归属 |
| 交易日期 | 校验是否为有效交易日 |
| 行情完整性 | 检查 open / high / low / close / vol 是否缺失 |
| 高低价逻辑 | high 不得低于 open / close / low |
| 停牌逻辑 | 停牌日不应给出正常成交量 |
| 财报期间 | 区分单季、累计、TTM 与年报口径 |
| 多源一致性 | 对 close、volume、announcement_date 等关键字段做抽样对比 |
如果多源数据冲突，按下面规则处理：
- 官方或官方授权链路优先于商业源。
- 商业源优先于开源聚合源。
- 结构化 API 优先于网页抓取。
- 无法确认时，保留冲突并明确写出“待校验”。
第六步：统一输出
除非用户明确要求原始 JSON 或 CSV，否则默认使用下面的输出结构。
输出模板
始终尽量采用这个结构：
A股市场数据结果
请求概述
说明抓取对象、时间范围、数据频率与任务目的。
数据来源与口径
用表格列出主源、补源、抓取时间、复权方式、单位说明。
核心数据
给出结构化表格，按任务展示基础资料、行情、财务或扩展字段。
关键校验结果
说明哪些字段已经交叉验证，哪些字段存在冲突或限制。
结论与使用建议
说明这些数据适合拿去做什么，例如研究、回测、盘前观察、财报分析；如果不适合用于自动交易，也要明确说明。
风险与限制
说明权限限制、延迟、非官方口径、字段缺失、网页抓取不稳定等问题。
必备元数据表
无论输出什么内容，都优先补上这张表：
| 字段 | 内容 |
|---|---|
| 数据对象 | 股票 / 板块 / 指数 / 全市场 |
| 标的代码 | 如 600519.SH |
| 时间范围 | 如 2025-01-01 至 2025-12-31 |
| 数据频率 | 日频 / 分钟 / Tick |
| 价格口径 | 不复权 / 前复权 / 后复权 |
| 主数据源 | AKShare / 巨潮资讯 / Choice / 官方链路 |
| 补充数据源 | 第二来源或无 |
| 抓取时间 | 实际抓取时间 |
| 关键限制 | 如“非官方逐笔”“分钟线存在延迟”等 |
输出质量要求
保持克制，不要因为抓到很多字段就制造过度确定性。任何结论都必须区分 事实字段 与 解释性判断。
当用户只是要数据，不要自动延伸成荐股意见。只有用户明确要求分析时，才在数据之后补充解释。
示例触发语句
当用户说出类似下面的话时，优先触发本技能：
| 用户说法 | 处理方向 |
|---|---|
| 帮我抓取 600519 最近 1 年日线和前复权数据 | 结构化主数据工作流 |
| 给我整理宁德时代最新财报三表和关键财务指标 | 结构化主数据工作流 |
| 帮我抓今天 A股热点板块、资金流和龙虎榜 | 市场扩展信息工作流 |
| 我要最准确的 Level-2 和逐笔数据 | 高精度实时数据说明工作流 |
| 给我做一个能回测的 A股研究数据集 | 研究数据集工作流 |
不要做的事
不要把以下做法当成合格输出：
| 错误做法 | 为什么不行 |
|---|---|
| 不标数据源就直接报数字 | 无法判断可信度 |
| 把免费网页聚合数据说成官方权威 | 容易误导用户 |
| 不区分复权与不复权 | 会污染研究与回测 |
| 不区分财报期间口径 | 会导致财务分析失真 |
| 遇到字段冲突仍强行给唯一答案 | 容易制造伪确定性 |
何时建议升级数据方案
如果用户出现下面任一需求，主动建议从免费或开源方案升级到商业或官方链路：
| 需求 | 建议 |
|---|---|
| 高频或准实时稳定抓取 | 升级商业专业源 |
| Level-2 / 逐笔 / 订单簿 | 使用官方授权链路或持牌商 |
| 大规模机构化研究 | 评估 Choice 等商业接口 |
| 交易执行前的严肃风控校验 | 使用更高权威级别数据源复核 |
References
[1]: https://akshare.akfamily.xyz/data/stock/stock.html "AKShare 股票数据文档" [2]: https://akshare.akfamily.xyz/data/index.html "AKShare 数据字典" [3]: http://www.cninfo.com.cn/ "巨潮资讯" [4]: https://www.szse.cn/marketServices/deal/disclosure/notice/index.html "深圳证券交易所 信息披露公告" [5]: https://english.sse.com.cn/markets/dataservice/products/ "Shanghai Stock Exchange Market Data Products" [6]: https://quantapi.eastmoney.com/Manual?from=web "Choice 数据量化接口产品手册"