Stoke — A股数据层技能

纯数据获取层，零 API Key 依赖，所有数据源免注册。兼容 Claude Code · OpenClaw · Hermes。

🔧 安装（macOS / Windows 通用）

1. 安装 uv（如果还没有）： macOS: brew install uv | Windows: winget install astral.uv 或官网脚本：https://docs.astral.sh/uv/getting-started/installation/

2. 克隆项目：

git clone https://github.com/birdilsss-byte/stoke.git ~/stoke
cd ~/stoke && uv sync

3. 设置 STOKE_HOME 环境变量：

环境变量只需设置一次，重启终端后生效。也可手动 export 当前会话立即使用。

⚠️ 限流铁律

同一 Source 实例内调用自动限流。跨实例（akshare + 腾讯）需手动停顿。

数据源速查

📈 mootdx（通达信 TCP）— 行情层

from stoke.sources.mootdx_source import MootdxSource
m = MootdxSource()

📰 akshare（东财/同花顺/巨潮/财联社）— 新闻+研报+公告+信号

from stoke.sources.akshare_source import AKShareSource
a = AKShareSource()

💹 腾讯财经 — 估值层

from stoke.sources.tencent_source import TencentSource
t = TencentSource()

统一入口（Stoke 门面类）

所有数据源通过一个类访问，无需记忆哪个接口来自哪个源：

from stoke import Stoke
s = Stoke()

s.realtime(["000001"])       # 实时行情     → mootdx
s.kline("000001")            # K线          → mootdx
s.news("000001")             # 个股新闻     → akshare
s.research("000001")         # 研报         → akshare
s.limit_up()                 # 涨停板       → akshare
s.strong_stocks()            # 强势涨停     → akshare
s.index_pe("上证50")          # PE估值       → tencent
s.market_pb()                # PB估值       → tencent

各底层 Source 仍可直接访问：s.mootdx.get_kline(...)、s.akshare.get_news(...)。

常用查询模板

查实时行情（统一入口）

cd "$STOKE_HOME" && uv run python3 -c "
from stoke import Stoke
s = Stoke()
df = s.realtime(['000001', '600000', '000858'])
print(df[['code', 'price', 'open', 'high', 'low', 'vol', 'amount']].to_string())
"

查K线

cd "$STOKE_HOME" && uv run python3 -c "
from stoke import Stoke
s = Stoke()
df = s.kline('000001')
print(df.tail(5)[['open', 'close', 'high', 'low', 'volume']].to_string())
"

查今日强势涨停（含题材归因）

cd "$STOKE_HOME" && uv run python3 -c "
from stoke import Stoke
s = Stoke()
df = s.strong_stocks()
print(df[['代码', '名称', '涨跌幅', '入选理由', '所属行业']].head(20).to_string())
"

查研报

cd "$STOKE_HOME" && uv run python3 -c "
from stoke import Stoke
s = Stoke()
df = s.research('000001')
print(df[['报告名称', '机构', '东财评级', '日期']].head(10).to_string())
"

查PE/PB估值

cd "$STOKE_HOME" && uv run python3 -c "
from stoke import Stoke
s = Stoke()
pe = s.index_pe('上证50')
pb = s.market_pb()
print(f'上证50 PE: {pe[\"滚动市盈率\"].iloc[-1]:.2f} (日期: {pe[\"日期\"].iloc[-1]})')
print(f'全市场 PB: {pb[\"middlePB\"].iloc[-1]:.2f} (日期: {pb[\"date\"].iloc[-1]})')
"

执行规则

1. 运行前先检测 STOKE_HOME：优先用环境变量，其次查找本地克隆
2. 首次使用需安装：cd "$STOKE_HOME" && uv sync
3. akshare 查询必须单条执行：每次调用自动 5 秒限流，不能并行
4. 结果中有中文时：用 to_string() 而非直接 print DataFrame
5. 单次查询数据量过大时：用 .head(N) 或 .tail(N) 截断
6. 日期格式：YYYYMMDD，如 20260518。不传则默认今天
7. 股票代码：mootdx 用纯数字（"000001"），akshare 也用纯数字

故障排查

平台兼容性

基于 agentskills.io 开放标准，兼容 27+ 个 AI Agent 平台。

Hermes 安装路径： ~/.hermes/skills/stoke/SKILL.md