China Stock Data

中国A股综合数据源技能。集成通达信(TDX)实时行情+5档盘口+K线、腾讯财经PE/PB/市值/换手率、同花顺iFinD/热点、AKShare研报/公告、iWencai问财搜索、JQData聚宽量化、Tushare Pro公告、RiceQuant米筐。8大来源自动降级。

Audits

Warn

ClawScanWarn

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install china-stock-data

China Stock Data - 中国A股综合数据源

Overview

本技能集成 8大数据源 + 3大工具，覆盖 A 股行情、K线、研报、公告、资金流向、板块排行、热点题材、语义搜索、量化指标、价格预警、每日简报等全场景。数据源自动降级，无需担心单点故障。

#	数据源/工具	能力	状态
1	通达信(TDX)	实时行情、5档盘口、K线(日/周/月/分钟)、逐笔成交	✅ 无需Key
2	腾讯财经	PE、PB、市值、换手率、财务估值数据	✅ 公开API
3	同花顺(iFinD)	专业行情、股息率、热点题材、强势股归因	✅ 需配置token
4	AKShare	券商研报、公司公告、资金流向、补充数据	✅ 部分受限
5	iWencai(问财)	自然语言选股、跨主题语义搜索	⚠️需API Key
6	JQData(聚宽)	量化指标、财报因子、宏观数据	✅ 需账号
7	Tushare Pro	公告、日线、北向、两融、财报	✅ 需token
8	RiceQuant(米筐)	量化回测数据	✅ 需账号
9	巨潮资讯网(CNINFO) 🆕	公告全文搜索，覆盖深沪两市全部A股	✅ 公开API，无需Key
🔔	Stock Monitor	价格预警、自选异动检查、自动盯盘	✅ 内置
📰	News Aggregator	每日金融简报、指数行情、头条汇总	✅ 内置

本文就是根据这些微信公众号文章搭建的：

用 Claude Code 搭建大A稳定数据源
A股数据平台及工具大全
金融AI工具10选选型逻辑：通达信+腾讯财经（行情）→ 东财+AKShare（研报）→ 同花顺（热点）→ iWencai（搜索）→ 聚宽/米筐（量化）→ Monitor+News（监控+简报）

When to Use

自然语言输入即可查询：

# 实时行情（自动选择最佳数据源）
查一下 600519 的行情
贵州茅台现在多少钱
批量看 600519,300750,000001

# K线数据
看下 300750 最近30天K线
宁德时代周K线

# 研报与公告
贵州茅台最近研报
300750 最新公告

# 资金流向
茅台资金流向

# 板块排行
今天什么板块涨得好
行业板块排行

# 热点题材
今天热点题材
同花顺热点

# 问财搜索（需配置Token）
搜索：人形机器人 丝杠
问财：华为概念 业绩预增

不要用于：

下单/交易操作（本技能仅提供数据查询）

How It Works

所有查询通过 scripts/china_stock.py 统一执行。

SCRIPT=scripts/china_stock.py
PY=python3

命令速查

# === 智能行情（自动降级）===
$PY $SCRIPT quote 600519            # TDX → 腾讯 → iFinD自动降级（含PE/市值/换手率）
$PY $SCRIPT tencent-quote 000001    # 腾讯财经行情（平安银行）

# === 通达信（实时+盘口）===
$PY $SCRIPT tdx-quote 600519        # 实时行情+5档买卖盘口
$PY $SCRIPT tdx-kline 600519 daily  # K线 (daily/weekly/monthly/60min/30min/15min/5min)
$PY $SCRIPT tdx-kline 300750 weekly # 周K
$PY $SCRIPT tdx-kline 600519 60min  # 60分钟K线

# === 腾讯财经（财务指标）===
$PY $SCRIPT tencent-quote 000001    # PE/PB/市值/换手率
$PY $SCRIPT tencent-batch 600519,300750,000001  # 批量查询

# === 同花顺iFinD（需token）===
$PY $SCRIPT ifind-quote 600519      # 专业行情（含PE/换手率/股息率/振幅）

# === AKShare（研报/资金）===
$PY $SCRIPT report 600519 10        # 最近10份研报
$PY $SCRIPT moneyflow 600519 5      # 最近5天资金流向

# === 公告查询（三级降级：巨潮CNINFO → Tushare Pro → AKShare）===
$PY $SCRIPT announce 600519 20      # 最近20条公告（自动选最佳源）
$PY $SCRIPT moneyflow 600519 5      # 最近5天资金流向

# === 巨潮资讯网(CNINFO) 公告搜索 — 2026年新增首选公告源 ===
$PY $SCRIPT announce 600519           # 自动降级: CNINFO → Tushare → AKShare
$PY $SCRIPT tushare-ann 600519        # Tushare Pro公告（tushare.xyz自定义地址）

# === 板块排行 & 热点 ===
$PY $SCRIPT sector                  # 行业板块排行  TOP20
$PY $SCRIPT themes                  # 热点题材（行业+概念）

# === 问财语义搜索（需配置 WENCAI_TOKEN）===
$PY $SCRIPT search 人形机器人 丝杠   # 自然语言选股

# === Tushare Pro（公告数据当前可用）===
$PY $SCRIPT tushare-ann 600519 20  # 最新20条公告

# === JQData聚宽（需 export JQ_USER/JQ_PASS）===
$PY $SCRIPT jq-financial 600519    # 财报指标数据
$PY $SCRIPT jq-macro               # 宏观数据（GDP/CPI）

# === Stock Monitor 股票监控 ===
MON=~/.hermes/skills/financial/china-stock-data/scripts/stock_monitor.py
$PY $MON check 600519              # 检查贵州茅台当前价格
$PY $MON check 600519 1300 below   # 检查是否跌破1300
$PY $MON watchlist                 # 自选股异动扫描
$PY $MON watchlist 600519,300750,000001  # 指定列表异动

# === News Aggregator 新闻简报 ===
NEWS=~/.hermes/skills/financial/china-stock-data/scripts/news_aggregator.py
$PY $NEWS daily                    # 当日金融简报（指数+头条）
$PY $NEWS indices                  # 主要指数行情
$PY $NEWS headlines                # 同花顺快讯

# === 系统状态 ===
$PY $SCRIPT status                  # 全部数据源状态

数据源降级策略

行情查询自动按顺序降级：
  [1] 通达信(TDX) ── 5档盘口 + 实时行情
  [2] 腾讯财经    ── 补充PE/市值/换手率（与TDX并行）
  [3] 同花顺iFinD ── 专业级行情（需配置token）

板块排行/热点：
  [1] 同花顺官网  ── 实时行业/概念涨幅排行
  [2] EastMoney   ── 被限流时自动切换同花顺

股票代码格式

市场	格式	示例
上海A股	6xxxxx	600519
深圳主板	00xxxx	000001
深圳创业板	30xxxx	300750
科创板	688xxx	688xxx

脚本自动识别代码前缀（6→沪，0/3→深），无需加 sh/sz 前缀。

Setup

# 安装核心依赖
pip install -r requirements.txt

# 或手动安装
pip install pytdx akshare beautifulsoup4 requests lxml pandas openpyxl

# 可选：数据源增强（按需安装）
pip install jqdatasdk    # JQData聚宽量化数据（需账号）
pip install rqdatac      # RiceQuant米筐量化数据（需账号）
pip install tushare      # Tushare Pro综合数据（需token）
pip install wencai       # 同花顺问财语义搜索（需API Key）

# 配置同花顺iFinD token（提升专业行情质量）
# 编辑 ifind_config.json 并放在脚本同目录：
# {"access_token": "your_token", "refresh_token": "your_token"}

# 可选环境变量
export WENCAI_TOKEN=your_token   # 问财搜索
export JQ_USER=your_phone       # JQData账号
export JQ_PASS=your_password    # JQData密码
export RQ_USER=your_username    # RiceQuant账号
export RQ_PASS=your_password    # RiceQuant密码

Data Source Details

1️⃣ 通达信(TDX) — 实时交易数据之王

协议: pytdx (开源TCP协议实现)
特点: 无需API Key，直连通达信行情服务器
数据: 实时价格、5档买卖盘口、K线(日/周/月/分钟)、逐笔成交
延迟: 约3-5秒（与通达信客户端同步）
限速保护:
- 🛡️ 每次TDX调用间隔 ≥0.5秒（随机加0-0.2秒jitter）
- 🔄 4台服务器轮询（成都电信、北京联通、上海电信、杭州电信）
- 📦 批量查询优化：指数日报用1次连接查6个指数，而非6次独立连接
状态: ✅ 可用

2️⃣ 腾讯财经 — 财务指标补充

接口: https://qt.gtimg.cn/q={code}
特点: 公开HTTP API，调用简单
数据: PE(市盈率)、PB(市净率)、市值(总/流通)、换手率
状态: ✅ 可用

3️⃣ 同花顺(iFinD) — 专业行情

接口: https://quantapi.51ifind.com/api/v1/
特点: 专业级金融数据，含股息率、振幅、PE_TTM
数据: 实时行情、K线、公告(含PDF)、板块排行、热点题材
配置: 需 ifind_config.json（access_token + refresh_token）
状态: ✅ 需配置token

4️⃣ AKShare — 研报/公告

接口: 开源Python库
特点: 多源聚合（东方财富/新浪等），免费
数据: 券商研报、公司公告、资金流向、补充财务数据
注意: EastMoney接口可能被限流，建议降频调用
状态: ✅ 可用（部分源可能限流）

5️⃣ iWencai(问财) — 语义搜索

接口: 同花顺问财API（需SkillHub API Key）
特点: 自然语言选股，独一档的语义搜索能力
数据: 跨主题筛选、复杂选股条件
配置: 设置环境变量 WENCAI_TOKEN
获取Key: 访问 SkillHub 或联系文章作者
状态: ⚠️ 待配置（已实现接口封装）

6️⃣ JQData(聚宽) — 量化因子与宏观数据

接口: jqdatasdk (Python SDK)
特点: 免费注册可用，提供量化指标、财报因子、宏观数据
数据: 基本面指标、GDP/CPI等宏观、因子数据
配置: export JQ_USER=手机号 JQ_PASS=密码
注册: JoinQuant聚宽官网免费注册
状态: ✅ 需配置账号

7️⃣ Tushare Pro — 综合数据平台

接口: tushare Python SDK (HTTP API)
特点: 免费注册得基础积分，签到/分享可获取更多积分
数据: 公告、日线、北向、两融、财报（⚠️高级数据需积分）
配置: 在脚本中设置 token，国内用户需配置自定义URL：client.DataApi._DataApi__http_url = "http://tushare.xyz"
注册: Tushare Pro官网注册获取token
状态: ✅ 需配置账号和token

8️⃣ RiceQuant(米筐) — 量化回测数据

接口: rqdatac (Python SDK)
特点: 免费注册可用，提供回测数据和研究环境
配置: export RQ_USER=用户名 RQ_PASS=密码
状态: ✅ 已安装，需认证

References

文件	内容
`scripts/china_stock.py`	主脚本，8大数据源集成（行情/K线/研报/公告/资金/板块/搜索/量化）
`scripts/stock_monitor.py`	股票监控/预警（价格检查、自选异动、可配cronjob定时盯盘）
`scripts/news_aggregator.py`	金融新闻聚合（每日简报、指数行情、头条快讯）
`requirements.txt`	Python依赖列表
`references/tdx-protocol-notes.md`	TDX通达信协议细节 + 限速策略
`references/eastmoney-limitations.md`	EastMoney限流备忘 / 替代方案
`references/tdx-rate-limiting.md`	TDX限速策略文档（全局间隔/服务器轮询/批量查询）
`references/tonghuashun-headlines-api.md`	同花顺快讯API响应结构说明
`references/cninfo-api.md`	巨潮CNINFO公告API接口文档
`references/cninfo-pdf-extraction.md`	CNINFO PDF下载方法（浏览器工具）

Common Pitfalls

TDX服务器可能变化 — 脚本内置了4台服务器（成都、北京、上海、杭州），自动轮询+最多尝试4次。每次调用间隔≥0.5秒，防被封IP
腾讯财经字段索引 — 返回的 ~ 分隔字符串，按固定顺序解析（0:市场 1:名称 2:代码 3:现价 4:昨收 ...）
EastMoney被限流 — 服务器IP可能被东方财富临时封禁，板块排行已自动切换到同花顺页面抓取
iFinD Token过期 — iFinD access_token 7天有效，脚本自动用 refresh_token 刷新
iWencai需API Key — 问财搜索目前被IP级别封禁（403），需通过 SkillHub 获取 API Key 配置后使用
行业板块 vs 概念板块 — 同花顺行业板块(thshy)可直接抓取HTML表格数据；概念板块(gn)为历史事件列表，不是当前涨幅排行
港股/美股支持 — 当前脚本主要面向A股，港股/美股需通过其他工具查询
pandas降级风险 — 安装 jqdatasdk 或 rqdatac 时会自动降级 pandas 至 2.3.x，可能影响 akShare 等依赖新版 pandas 的库。降级后需执行 pip install --upgrade pandas 恢复
同花顺快讯 API 响应结构变化 (2026-05) — data 现在是对象 {"list":[...], "filter":..., "total": N} 而非数组。字段 share_url → shareUrl
公告查询优先走巨潮 CNINFO — 三级降级：CNINFO(全文搜索) → Tushare Pro → AKShare。CNINFO 不需要 Key/Token
CNINFO PDF下载需用浏览器工具 — 巨潮公告详情页的PDF地址是动态生成的，需用浏览器打开详情页获取真实链接

Verification Checklist

quote 600519 — TDX行情含PE/市值/换手率
tdx-quote 600519 — 实时价格+5档盘口
tdx-kline 300750 daily — 30条日K线
tencent-quote 000001 — 平安银行PE/市值
sector — 行业板块排行TOP20
themes — 行业+概念热点
status — 全部数据源状态
search 人形机器人丝杠 — 需配置WENCAI_TOKEN
report 600519 — AKShare研报（可能限流）