a-stock-data

name	a-stock-data
description	A股全栈数据工具包 — 覆盖行情(mootdx+腾讯)、信号(同花顺热点+北向)、研报(东财+iwencai)、新闻(akshare)、基础数据(mootdx财务/F10)、公告(巨潮)六层数据源。适用于个股估值、研报检索、题材归因、产业链调研、批量筛选等场景。
origin	custom
version	2

A股全栈数据工具包 V2

六层数据架构，15 个端点，7 个数据源实测可用。

When to Activate

• 用户要查 A 股个股估值（一致预期 / PE / PEG / PE消化）
• 用户要拉实时行情（价格 / 五档盘口 / K线 / 涨跌停价）
• 用户要搜研报（按主题 / 按标的 / 按行业 / 下载PDF）
• 用户要看当日强势股 / 题材归因 / 概念热点
• 用户要看北向资金动向（沪股通/深股通分钟流向）
• 用户要看新闻资讯（个股新闻 / 财联社快讯 / 全球资讯）
• 用户要查公告（巨潮公告全文）
• 用户要做产业链调研 / 批量横向对比
• 关键词：估值、一致预期、机构预测、市盈率、PEG、市值、研报、产业链、K线、盘口、公告、新闻、强势股、题材、热点、概念归因、北向资金、沪股通、深股通

Prerequisites

pip install mootdx akshare requests pandas typer

iwencai 语义搜索需要 API Key（可选，其他数据源全部免费无 Key）：

export IWENCAI_API_KEY="your_key_here"
# 申请地址: https://www.iwencai.com/skillhub

CLI Commands

所有命令输出 JSON（AI 友好模式）。加 -o table 可切换为人读表格。

行情层

# K线数据
python -m astock_data.cli market kline 688017 -c day -n 20
python -m astock_data.cli market kline 000001 -c 5m -n 100

# 实时报价（五档盘口）
python -m astock_data.cli market quote 688017 300476

# PE/PB/市值/换手率（腾讯财经）
python -m astock_data.cli market valuation 688017 600519

信号层

# 当日强势股 + 题材归因
python -m astock_data.cli signal hotspot
python -m astock_data.cli signal hotspot --sectors  # 只看题材热度排名

# 北向资金
python -m astock_data.cli signal northbound --realtime  # 分钟级流向
python -m astock_data.cli signal northbound --history --type 001  # 沪股通历史

研报层

python -m astock_data.cli research reports 688017
python -m astock_data.cli research expectations 688017
python -m astock_data.cli research search "人形机器人 丝杠" --channel report

新闻层

python -m astock_data.cli news stock 688017
python -m astock_data.cli news flash -n 20
python -m astock_data.cli news global

基础数据

python -m astock_data.cli fund finance 688017
python -m astock_data.cli fund f10 688017 -c "公司概况"
python -m astock_data.cli fund basics 688017

公告

python -m astock_data.cli ann list 688017
python -m astock_data.cli ann latest 688017

调研流程

# 单票完整估值（PE/PEG/消化年数）
python -m astock_data.cli workflow valuate 688017

# 批量对比
python -m astock_data.cli workflow compare 688017 300308 300476

# 主题研报检索
python -m astock_data.cli workflow thematic "人形机器人 丝杠" "减速器 国产"

# 新标的快速调研
python -m astock_data.cli workflow newstock 688017

Architecture

行情层（实时，不封IP）
├── mootdx        → K线 + 五档盘口 + 逐笔成交 (TCP 7709)
└── 腾讯财经 API   → PE/PB/市值/换手率/涨跌停 (HTTP)

信号层（V2 新增）
├── 同花顺热点     → 当日强势股 + 题材归因 reason tags (零鉴权)
└── 同花顺北向     → hgt/sgt 分钟资金流向 + 历史日级 (hsgtApi)

研报层
├── 东财 reportapi → 研报列表 + PDF下载
├── 同花顺 THS     → 一致预期EPS (akshare封装)
└── iwencai        → NL语义搜索研报 (需Key)

新闻层
├── akshare → 个股新闻 (东财)
├── akshare → 财联社快讯
└── akshare → 东财全球资讯

基础数据层
├── mootdx finance → 季报快照 (37字段)
├── mootdx F10     → 公司资料 (9大类文本)
└── akshare        → 个股基本面

公告层
├── 巨潮 cninfo    → 公告全文 (akshare封装)
└── mootdx F10     → 最新公告摘要

估值框架

• 前向PE = 当前股价 / 未来年度一致预期EPS
• PEG = 前向PE / (CAGR × 100)，PEG < 1 便宜，1-1.5 合理，> 1.5 贵
• PE消化 = 当前PE消化到30x锚定需要多少年 (< 2年合理，> 4年太贵)
• 30x锚点 = A股成长股估值重力线，所有行业统一

数据源优先级

优先级	数据源	用途	封IP风险
1	mootdx (TCP)	K线+盘口+财务+F10	极低
2	腾讯财经 (HTTP)	PE/PB/市值	低
3	akshare (Python)	研报+新闻+公告	中(东财源)
4	iwencai (OpenAPI)	NL主题搜索	低(需Key)
5	同花顺热点 (HTTP)	强势股+题材归因	极低(零鉴权)
6	同花顺 hsgtApi (HTTP)	北向资金	极低(零鉴权)