@renxqoo/rxstock (rxstock)

A 股股票数据命令行工具 —— 行情/K 线/财务/板块/资金流/公告,完全免费、稳定、生产可用。

基于 @renxqoo/agent-data-cli 框架。

English · 中文

⚠️ 免责声明(使用前必读)

本项目仅供学习交流和技术研究使用,不构成任何投资建议。

1. 数据来源:本工具通过公开渠道获取 A 股行情数据,数据归各原始数据源所有。本工具不存储、不转售数据,仅作为命令行查询的便利封装。
2. 数据版权:所有数据的版权归原作者/数据源所有。如有数据源认为本项目侵犯其权益,请通过 Issues 联系,确认后将在第一时间删除相关代码或下架项目。
3. 投资风险:股票市场有风险,本工具提供的数据可能存在延迟、错误或缺失。任何基于本工具数据的投资决策,风险自负,作者不承担任何责任。
4. 使用限制:本工具仅供个人学习研究使用,禁止用于商业转售、高频量化轰炸数据源、或任何违反数据源使用条款的场景。请合理控制调用频率。
5. 合规义务:使用者需自行遵守所在地区关于证券数据使用的法律法规。本作者不对使用者的行为承担责任。

简言之:数据是公开的、工具是免费的、用途是学习的、风险是自负的、有异议请联系删除。

这是什么

rxstock 是一个开箱即用的 A 股股票数据 CLI,把多个公开数据源封装成统一接口,提供实时行情、K 线、分时、财务、板块、资金流、公告等常用数据。

特性:

• 🔓 完全免费 —— 通过公开渠道获取数据,无需注册、无需 API key
• 📊 数据全 —— 实时行情 + K 线 + 分时 + 财务 + 板块 + 资金流 + 公告
• 🔄 多源 fallback —— 任一数据源失败自动回落
• ⚡ 性能优化 —— 进程内 TTL 缓存(秒级~分钟级)+ singleflight
• 🔁 自动重试 —— 网络错误/5xx 自动 2 次指数退避重试
• 📦 JSON 统一输出 —— agent 可直接解析;--no-json 切人类可读表格
• 🚇 管道友好 —— unix 管道串联,与 jq / ripgrep 等工具组合
• 📖 skill 自服务 —— AI agent 读 SKILL.md 自动学会所有命令

agent / 终端用户
    │  rxstock quote 600519
    ▼
@renxqoo/rxstock (本包,业务命令)
    │  缓存 + 多源 fallback + 重试
    ▼
┌──────────────────────────────────────────────────────────┐
│  公开数据源 A (行情/K线/分时,主)                        │
│  公开数据源 B (财务/龙虎榜/北向/分红/股东/三表/两融,主)  │
│  公开数据源 C (行情/K线/列表,备)                        │
│  公开数据源 D (K线/盘口,兜底)                           │
│  公开数据源 E (列表/资金流/分笔,境内增强)              │
│                                                            │
│  注:均为公开渠道,具体源见 src/sources/,仅供学习研究     │
└──────────────────────────────────────────────────────────┘

快速开始

一键安装(推荐)

npx @renxqoo/rxstock install

自动完成两步:① 全局安装 CLI → ② 安装 Skill 到你的 AI 工具发现目录(~/.agents 始终写 + 已装工具 ~/.claude/~/.codex/~/.cursor/~/.zcode/~/.openclaw/~/.pi 自动探测)。需 Node ≥ 20。无需 API key,开箱即用。

npx 无需预装,跑完即得全局 rxstock 命令 + 已就位的 skill。

手动安装(分步,等价于一键安装)

如果一键安装某步失败或想单独执行:

第 1 步:安装 CLI

npm install -g @renxqoo/rxstock

安装后跑 rxstock --help 确认可用。不想全局装?用 npx @renxqoo/rxstock <命令> 临时执行。

第 2 步:安装 Skill(让 AI 工具发现)

把 skill 同步到你的 AI 工具发现目录(~/.agents 始终写 + 已装工具如 ~/.claude/~/.cursor/~/.zcode 自动探测——覆盖 Claude Code / Cursor / Codex / ZCode / OpenClaw / Pi / Trae):

rxstock skills sync

同步后 AI 工具即可在用户提到股票、行情、K 线、财务等关键词时自动触发本 skill。验证:

rxstock skills list             # 列出已装的 skill
ls ~/.agents/skills/rx-stock/   # 确认 skill 文件就位

无需凭证配置——rxstock 走公开数据源,开箱即用。

命令一览

实时行情

rxstock quote 600519                  # 快速查询(单只)
rxstock quote get 600519              # 等价
rxstock quote batch 600519,000001,300750  # 批量(逗号分隔,最多 100 只)
rxstock quote get 600519 --source eastmoney  # 强制指定数据源

输出字段:code, name, price, prevClose, open, high, low, change, changePercent, volume, amount, turnoverRate, volumeRatio, amplitude, peRatio, pbRatio, circulateMarketCap, totalMarketCap, limitUp, limitDown, time, bids (五档买盘), asks (五档卖盘), source

K 线

rxstock kline get 600519 --period day --limit 30         # 日 K
rxstock kline get 600519 --period week --limit 20        # 周 K
rxstock kline get 600519 --period month --limit 12       # 月 K
rxstock kline get 600519 --period day --adjust qfq       # 前复权
rxstock kline get 600519 --period day --adjust hfq       # 后复权
rxstock kline get 600519 --period m5                     # 5 分钟级
rxstock kline get 600519 --period day --start 2026-01-01 --end 2026-08-08  # 区间查询

rxstock kline minute 600519           # 当日分时图(每分钟累计价/量/均价)
rxstock kline tick 600519 --limit 50  # 当日分笔成交

搜索 / 列表 / 公司信息

rxstock stock search 茅台               # 按名称搜索(支持中文/拼音/代码)
rxstock stock search gzmt               # 拼音首字母
rxstock stock search 600519             # 按代码

rxstock stock list                      # 全市场股票列表(默认按涨跌幅降序)
rxstock stock list --market sh          # 只看沪市
rxstock stock list --market sz          # 只看深市
rxstock stock list --market bj          # 只看北交所
rxstock stock list --sort amount        # 按成交额排序
rxstock stock list --page 2 --size 50   # 分页

rxstock stock info 600519               # 公司基本信息(总股本/流通股本 等)

指数 / 北向资金

rxstock index list                      # 9 个常用指数清单(上证/深证/沪深 300/创业板 等)
rxstock index get sh000001              # 上证指数
rxstock index get sz399001              # 深证成指
rxstock index get sh000300              # 沪深 300
rxstock index get sz399006              # 创业板指
rxstock index get sh000688              # 科创 50
rxstock index kline sh000001 --limit 30 # 指数 K 线
rxstock index northbound                # 北向资金(沪深股通)
rxstock index northbound --type 001     # 仅沪股通(003=深股通)

板块 / 行业

rxstock sector list                      # 行业板块(默认)
rxstock sector list --kind concept       # 概念板块
rxstock sector list --kind area          # 地域板块
rxstock sector list --sort amount        # 按成交额排序
rxstock sector stocks BK1600             # 板块成分股(代码 BK 前缀)
rxstock sector quote BK1600              # 板块实时行情

财务 / 财报 / 资金面

rxstock financial main 600519             # 主要财务指标(连续多期)
rxstock financial main 600519 --limit 50  # 拉更多期
rxstock financial forecast 600519         # 业绩预告
rxstock financial fundflow 600519         # 资金流向(主力/大单/中单/小单,境内增强)
rxstock financial fundflow 600519 --limit 60
rxstock financial announcements 600519   # 个股公告
rxstock financial announcements 600519 --size 50

# 财报三表
rxstock financial balancesheet 600519     # 资产负债表
rxstock financial income 600519           # 利润表
rxstock financial cashflow 600519         # 现金流量表

# 股东与分红
rxstock financial dividend 600519         # 分红送配历史
rxstock financial holders 600519          # 十大股东
rxstock financial holdercount 600519      # 股东人数变化

# 资金面
rxstock financial margin 600519           # 融资融券明细
rxstock financial lhb                     # 龙虎榜(默认当日)
rxstock financial lhb --date 2026-08-07   # 指定日期
rxstock financial lhb --code 600519       # 指定个股上榜历史

代码格式

rxstock 自动判定市场:

| 输入 | 解析 | | -------------------------------- | --------------- | | 600519 | 沪市(默认) | | 000001 | 深市 | | 300750 | 深市创业板 | | 688981 | 沪市科创板 | | 836473 | 北交所 | | sh600519 sz000001 bj836473 | 显式指定 | | 1.600519 0.000001 | 东财 secid 形态 | | 600519.SH 000001.SZ | 行业标准后缀 |

数据源

本工具通过多个公开渠道获取 A 股行情数据(均为各财经网站前端调用的公开接口)。具体数据源实现见 src/sources/,此处不再列举具体名称以避免商标误解。各数据归原始来源所有。

| 数据 | 源链(按优先级) | 备注 | | ---------------- | ----------------------------------------- | ---- | | 实时行情 | 主源 → 备源1 → 备源2 → 境内增强 | 多源 fallback | | 日/周/月 K 线 | 主源 → 备源1 → 备源2 → 境内增强 | 多源,复权仅部分源 | | 分钟级 K 线 | 备源1 → 境内增强 | 2 源 | | 分时 | 主源(失败明确报错) | 不静默返回空 | | 搜索 | 单源 | 公开 token | | 列表 / 板块 | 备源 → 境内增强 | 备源境外可用 | | 财务/龙虎榜/分红/股东/三表/两融/北向/公告 | 主源(单源) | 境内外都通,稳定 | | 资金流 / 分笔 | 境内增强源(仅境内) | 境外不可用,明确报错 |

稳定性说明: 核心数据(行情/K线/财务)境内外网络都通,多源 fallback;部分数据(资金流/分笔)仅境内 IP 可用,境外会明确报错。

输出模式

默认(JSON 统一输出)

$ rxstock quote 600519
{
  "ok": true,
  "identity": "user",
  "data": {
    "code": "600519", "name": "贵州茅台", "price": 1309.22, ...
  },
  "meta": { "count": 1 }
}

人类可读(--no-json)

$ rxstock quote 600519 --no-json
贵州茅台 (600519)  1309.22 +0.67 (+0.05%)
开 1308.66  高 1315.28  低 1301.00  昨收 1308.55
量 24976 手  额 3266920000 换手 0.2% 量比 114
PE 19.79  PB 7.03
总市值 16366.32  流通市值 16366.32
涨跌停 [1439.41 / 1177.70]  20260807161437

五档盘口:
  卖五       1309.8         1 手
  ...

在管道里组合

# 找到涨幅前 10 的股票,批量查实时行情
rxstock stock list --size 10 --sort changePercent | jq '.data[].code' | \
  xargs -I {} rxstock quote get {} | jq '.data'

# 拉 5 分钟 K 线,转 CSV
rxstock kline get 600519 --period m5 --limit 100 --json | \
  jq -r '.data[] | [.date, .open, .high, .low, .close, .volume] | @csv' > 600519.csv

# 找最近一年的所有财报
rxstock financial main 600519 --limit 4 | jq '.data[] | {date: .reportDate, eps: .eps, roe: .roe}'

错误处理

所有错误走 9 类类型化错误(对应 cli-sdk 标准):

| 错误 | 原因 | 处理 | | ------------------------------ | ----------------------- | ------------------------------------------- | | not_found | 代码不存在或已停牌 | 检查代码 / rxstock stock search <keyword> | | network / connection_refused | 网络问题 | 重试 / 换数据源 --source tencent/sina | | timeout | 5xx + 重试 2 次后仍超时 | 稍后再试 | | bad_response | 数据源返回非 JSON | 已自动重试,可能源端临时异常 | | rate_limited (429) | 数据源限流 | 已自动重试 |

开发

pnpm install        # 装依赖
pnpm build          # 构建
pnpm typecheck      # 类型检查
pnpm test           # 跑测试(vitest)

License

MIT © renxqoo