shield_lock
JinDaGe
← Back to skills
extension
Category: OtherAPI key required

China Stock Data

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

personAuthor: kekewaterhubclawhub
open_in_newRepositorydownloadDownload package

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 | 每日金融简报、指数行情、头条汇总 | ✅ 内置 |

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

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

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

Verification Checklist

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