Snowball CLI — 雪球数据命令行工具

封装雪球 (xueqiu.com) API，所有输出为 JSON 格式，专为 AI Agent 和脚本设计。

覆盖范围：A 股（沪深）、港股、美股（经雪球）、公募基金（经蛋卷）。

重要：先用再登录

不要一上来就让用户登录。 以下命令无需登录即可使用：

snowball quote SH600519              # 实时行情
snowball market                      # 大盘指数
snowball fund 110011                 # 基金详情
snowball fund 110011 --nav           # 基金净值
snowball fund 110011 --growth        # 基金收益

只有当命令返回「Not logged in」错误时，再引导用户登录。先 snowball status 检查是否已有 token。

安装

如果 snowball 命令不存在，提示用户运行：

npm install -g snowball-cli

登录（仅在需要时）

大部分命令需要雪球登录态。上面列出的 quote、market、fund 无需登录。

遇到「Not logged in」错误时，提示用户自行完成登录。不要代替用户执行认证命令。 告知用户以下方式：

• snowball login — 用雪球 App 扫码登录（需要 Chrome/Chromium）
• snowball export / snowball import <base64> — 从已登录的机器导入 token

可以用 snowball status 检查当前 token 状态。

代码格式

基金代码为纯数字：110011、005827。

命令参考

行情（quote 和 market 无需登录）

snowball quote SH600519                  # 实时行情
snowball quote SH600519 SZ000858 AAPL    # 批量查询
snowball quote SH600519 --detail         # PE、PB、股息率、52 周高低
snowball market                          # 大盘指数总览
snowball pankou SH600519                 # 盘口 / 买卖五档
snowball kline SH600519                  # 日 K 线，默认 120 根
snowball kline SH600519 --period week --count 52
snowball minute SH600519                 # 分时图

财务报表

snowball income SH600519 --count 10      # 利润表
snowball balance SH600519                # 资产负债表
snowball cashflow SH600519               # 现金流量表
snowball indicator SH600519              # 关键指标
snowball business SH600519               # 营收构成
snowball forecast SH600519               # 盈利预测

公司资料（F10）

snowball company SH600519                # 公司简介
snowball holders SH600519 --top          # 十大股东
snowball bonus SH600519                  # 分红送转
snowball industry SH600519               # 行业与概念
snowball org SH600519                    # 机构持仓变动

资金流向

snowball flow SH600519 --history         # 历史资金流向
snowball assort SH600519                 # 大/中/小单分布
snowball margin SH600519                 # 融资融券
snowball block SH600519                  # 大宗交易

社交与资讯

snowball trending day --count 10         # 今日热帖
snowball live --important                # 重要快讯
snowball feed a-shares                   # 沪深信息流
snowball hot cn                          # 热门 A 股
snowball kol SH600519                    # 个股大 V
snowball user <用户ID> --count 10        # 用户帖子
snowball profile <用户ID>               # 用户主页
snowball post <帖子ID>                  # 帖子详情

搜索与基金

snowball search 茅台                     # 搜索股票
snowball search-user 价投                # 搜索用户
snowball screen SH                       # 选股器
snowball fund 110011 --nav               # 基金净值（无需登录）

Agent 工作流

早盘简报

snowball market
snowball live --important --count 10
snowball trending --count 5

个股研究

snowball quote SH600519 --detail
snowball income SH600519 --count 8
snowball indicator SH600519 --count 8
snowball holders SH600519 --top
snowball flow SH600519 --history
snowball forecast SH600519

大 V 舆情

snowball kol SH600519 --count 10
snowball user <ID> --count 10
snowball profile <ID>

认证要求速查

常见问题

• 「Not logged in」 — snowball login 或 snowball token <cookie>
• HTTP 403 / WAF — 等几分钟或重新登录
• Chrome not found — 设置 CHROME_PATH 或 --chrome
• Token 过期 — snowball status 检查，过期重新 login