@@ -25,42 +25,37 @@ snowball fund 110011 --growth # 基金收益
2525
2626## 安装
2727
28- 需要 [ Bun] ( https://bun.sh ) 运行时。
29-
3028``` bash
31- cd /Users/baixianger/Desktop/omika.AI/ snowball-cli
32- bun install
29+ npm install -g snowball-cli # 或
30+ bun add -g snowball-cli
3331```
3432
35- 运行命令:` bun run index.ts <命令> [参数] `
36-
37- 全局安装后:` snowball <命令> [参数] `
38-
3933## 登录(仅在需要时)
4034
41- 大部分命令需要雪球登录态(` xq_a_token ` )。上面列出的 ` quote ` 、` market ` 、` fund ` 无需登录。
35+ 大部分命令需要雪球登录态。上面列出的 ` quote ` 、` market ` 、` fund ` 无需登录。
36+
37+ ``` bash
38+ snowball login # 终端内二维码,用雪球 App 扫码
39+ snowball login --manual # 在 Chrome 窗口中扫码
40+ snowball login --chrome /path/to/x # 指定 Chrome/Chromium 路径
41+ snowball token " xq_a_token=x; u=x" # 手动粘贴 cookie
42+ ```
4243
43- ** 登录方式(推荐顺序): **
44+ 设置 ` CHROME_PATH ` 环境变量可以省去每次 ` --chrome ` 。
4445
45- 1 . ** 二维码登录(默认)** — 终端内显示二维码,用雪球 App 扫码确认:
46- ``` bash
47- snowball login
48- ```
49- 原理:启动 Chrome → 访问 xueqiu.com 通过 WAF → 调用 API 生成二维码 → 终端渲染 → 轮询扫码状态 → 过期自动刷新(最多 3 次)→ 失败降级为手动模式。
46+ ** 跨机器传输 token(VPS / Docker):**
5047
51- 2 . ** 手动扫码** — 在 Chrome 窗口中扫码:
52- ``` bash
53- snowball login --manual
54- ```
48+ ``` bash
49+ snowball export # 导出 token 为 base64
50+ snowball import < base64> # 导入 token
51+ ssh vps " snowball import $( snowball export) " # 一行搞定
52+ ```
5553
56- 3 . ** 粘贴 Cookie** — 从浏览器开发者工具复制:
57- ``` bash
58- snowball token " xq_a_token=xxx; u=xxx"
59- ```
54+ ** 管理 token:**
6055
61- Token 保存在 ` ~/.snowball-cli/token.json ` ,通常有效数天。检查状态:
6256``` bash
63- snowball status # 显示来源、时间,自动验证是否仍然有效
57+ snowball status # 验证 token 是否有效
58+ snowball logout # 删除 token
6459```
6560
6661## 代码格式
@@ -69,171 +64,119 @@ snowball status # 显示来源、时间,自动验证是否仍然有效
6964| ---| ---| ---|
7065| ` SHxxxxxx ` | 上交所 | ` SH600519 ` (贵州茅台) |
7166| ` SZxxxxxx ` | 深交所 | ` SZ000858 ` (五粮液)、` SZ300750 ` (宁德时代) |
72- | ` SH000xxx ` | 上证指数 | ` SH000001 ` (上证综指)、 ` SH000300 ` (沪深300) |
73- | ` SZ399xxx ` | 深证指数 | ` SZ399001 ` (深证成指)、 ` SZ399006 ` (创业板指) |
74- | ` xxxxx ` | 港股 | ` 01810 ` (小米)、 ` 00700 ` (腾讯) |
75- | ` XXXX ` | 美股 | ` AAPL ` (苹果)、 ` TSLA ` (特斯拉) |
67+ | ` SH000xxx ` | 上证指数 | ` SH000001 ` (上证综指) |
68+ | ` SZ399xxx ` | 深证指数 | ` SZ399001 ` (深证成指) |
69+ | ` xxxxx ` | 港股 | ` 01810 ` (小米) |
70+ | ` XXXX ` | 美股 | ` AAPL ` (苹果) |
7671
7772基金代码为纯数字:` 110011 ` 、` 005827 ` 。
7873
7974## 命令参考
8075
81- ### 行情数据 (quote 和 market 无需登录)
76+ ### 行情 (quote 和 market 无需登录)
8277
8378``` bash
84- snowball quote SH600519 # 实时行情(无需登录)
79+ snowball quote SH600519 # 实时行情
8580snowball quote SH600519 SZ000858 AAPL # 批量查询
86- snowball quote SH600519 --detail # 详细: PE、PB、股息率、52 周高低
87- snowball market # 大盘指数总览(无需登录)
81+ snowball quote SH600519 --detail # PE、PB、股息率、52 周高低
82+ snowball market # 大盘指数总览
8883snowball pankou SH600519 # 盘口 / 买卖五档
8984snowball kline SH600519 # 日 K 线,默认 120 根
90- snowball kline SH600519 --period week --count 52 # 周线一年
85+ snowball kline SH600519 --period week --count 52
9186snowball minute SH600519 # 分时图
9287```
9388
94- K 线周期:` 1m ` ` 5m ` ` 15m ` ` 30m ` ` 60m ` ` 120m ` ` day ` ` week ` ` month ` ` quarter ` ` year `
95-
9689### 财务报表
9790
9891``` bash
99- snowball income SH600519 # 利润表(默认最近 5 期)
100- snowball balance SH600519 --count 10 # 资产负债表(最近 10 期)
92+ snowball income SH600519 --count 10 # 利润表
93+ snowball balance SH600519 # 资产负债表
10194snowball cashflow SH600519 # 现金流量表
102- snowball indicator SH600519 # 关键指标(ROE、毛利率等)
103- snowball business SH600519 # 营收构成(按业务/地区分拆)
104- snowball forecast SH600519 # 机构盈利预测
95+ snowball indicator SH600519 # 关键指标
96+ snowball business SH600519 # 营收构成
97+ snowball forecast SH600519 # 盈利预测
10598```
10699
107100### 公司资料(F10)
108101
109102``` bash
110103snowball company SH600519 # 公司简介
111- snowball holders SH600519 # 股东人数变化
112104snowball holders SH600519 --top # 十大股东
113- snowball bonus SH600519 # 分红送转历史
114- snowball industry SH600519 # 行业与概念板块
105+ snowball bonus SH600519 # 分红送转
106+ snowball industry SH600519 # 行业与概念
115107snowball org SH600519 # 机构持仓变动
116108```
117109
118110### 资金流向
119111
120112``` bash
121- snowball flow SH600519 # 日内资金流向
122- snowball flow SH600519 --history # 历史每日资金流向
123- snowball assort SH600519 # 按单量分布(大/中/小单)
124- snowball margin SH600519 # 融资融券数据
113+ snowball flow SH600519 --history # 历史资金流向
114+ snowball assort SH600519 # 大/中/小单分布
115+ snowball margin SH600519 # 融资融券
125116snowball block SH600519 # 大宗交易
126117```
127118
128119### 社交与资讯
129120
130121``` bash
131- snowball trending # 今日热帖
132- snowball trending week --count 20 # 本周热帖
133- snowball trending month # 本月热帖
134- snowball live # 7x24 实时快讯
135- snowball live --important # 仅重要快讯
136- snowball feed # 头条信息流
137- snowball feed a-shares --count 30 # 沪深信息流
138- snowball hot # 热门股票(默认 A 股)
139- snowball hot us # 热门美股
140- snowball kol SH600519 # 讨论该股的大 V
141- snowball user < 用户ID> --count 20 # 指定用户最新帖子
142- snowball profile < 用户ID> # 用户主页信息
143- snowball post < 帖子ID> # 单条帖子详情
122+ snowball trending day --count 10 # 今日热帖
123+ snowball live --important # 重要快讯
124+ snowball feed a-shares # 沪深信息流
125+ snowball hot cn # 热门 A 股
126+ snowball kol SH600519 # 个股大 V
127+ snowball user < 用户ID> --count 10 # 用户帖子
128+ snowball profile < 用户ID> # 用户主页
129+ snowball post < 帖子ID> # 帖子详情
144130```
145131
146- 信息流分类:` headlines ` (头条)` today ` (今日话题)` a-shares ` (沪深)` us ` (美股)` hk ` (港股)` funds ` (基金)` private ` (私募)
147-
148- ### 搜索与发现
132+ ### 搜索与基金
149133
150134``` bash
151135snowball search 茅台 # 搜索股票
152- snowball search-user 价投 --count 10 # 搜索用户
153- snowball screen # 选股器(默认沪市)
154- snowball screen HK --count 50 # 港股选股
155- ```
156-
157- ### 基金(经蛋卷 API,无需登录)
158-
159- ``` bash
160- snowball fund 110011 # 基金详情
161- snowball fund 110011 --nav # 净值历史
162- snowball fund 110011 --growth # 收益走势
163- ```
164-
165- ## 输出格式
166-
167- 所有命令输出 JSON,用 ` jq ` 过滤:
168-
169- ``` bash
170- snowball quote SH600519 | jq ' .[0].current' # 当前价格
171- snowball kline SH600519 | jq ' .item | length' # K 线根数
172- snowball income SH600519 | jq ' .[0].report_name' # 最新报告期
173- snowball trending | jq ' .[].author' # 热帖作者列表
136+ snowball search-user 价投 # 搜索用户
137+ snowball screen SH # 选股器
138+ snowball fund 110011 --nav # 基金净值(无需登录)
174139```
175140
176141## Agent 工作流
177142
178143### 早盘简报
179144
180145``` bash
181- snowball market # 指数快照
182- snowball live --important --count 10 # 隔夜要闻
183- snowball hot cn # 今日热门股
184- snowball trending --count 5 # 社区热议
185- ```
186-
187- ### 个股深度研究
188-
189- ``` bash
190- snowball search 贵州茅台 # 查找代码
191- snowball quote SH600519 --detail # 估值快照
192- snowball kline SH600519 --period week --count 104 # 两年周线
193- snowball income SH600519 --count 10 # 10 期利润表
194- snowball indicator SH600519 --count 10 # 关键财务指标
195- snowball business SH600519 # 营收构成
196- snowball holders SH600519 --top # 十大股东
197- snowball org SH600519 # 机构动向
198- snowball flow SH600519 --history # 资金流向趋势
199- snowball forecast SH600519 # 机构一致预期
146+ snowball market
147+ snowball live --important --count 10
148+ snowball trending --count 5
200149```
201150
202- ### 大 V 舆情分析
151+ ### 个股研究
203152
204153``` bash
205- snowball kol SH600519 --count 20 # 找到讨论该股的大 V
206- snowball profile < 大V的ID> # 查看大 V 资质
207- snowball user < 大V的ID> --count 20 # 读最近发帖
208- snowball trending week # 本周社区热门话题
209- snowball search-user " 价值投资" --count 10 # 搜索价投大 V
154+ snowball quote SH600519 --detail
155+ snowball income SH600519 --count 8
156+ snowball indicator SH600519 --count 8
157+ snowball holders SH600519 --top
158+ snowball flow SH600519 --history
159+ snowball forecast SH600519
210160```
211161
212- ### 基金对比
162+ ### 大 V 舆情
213163
214164``` bash
215- snowball fund 110011 # 易方达中小盘
216- snowball fund 110011 --growth # 收益走势
217- snowball fund 005827 # 易方达蓝筹精选
218- snowball fund 005827 --growth # 收益走势
165+ snowball kol SH600519 --count 10
166+ snowball user < ID> --count 10
167+ snowball profile < ID>
219168```
220169
221170## 认证要求速查
222171
223172| 无需登录 | 需要登录 |
224173| ---| ---|
225- | ` quote ` (基础行情) | ` quote --detail ` |
226- | ` market ` | ` pankou ` ` kline ` ` minute ` |
227- | ` fund ` ` fund --nav ` ` fund --growth ` | 所有财务报表命令 |
228- | | 所有公司资料 / F10 命令 |
229- | | 所有资金流向命令 |
230- | | 所有社交 / 资讯命令 |
231- | | ` search ` ` search-user ` ` screen ` |
174+ | ` quote ` ` market ` | ` quote --detail ` ` pankou ` ` kline ` ` minute ` |
175+ | ` fund ` ` fund --nav ` ` fund --growth ` | 所有财务 / F10 / 资金 / 社交命令 |
232176
233177## 常见问题
234178
235- - ** 「Not logged in」** — 运行 ` snowball login ` 或 ` snowball token <cookie> `
236- - ** HTTP 403 / WAF** — 雪球反爬检测,等几分钟或重新登录刷新 Cookie
237- - ** 二维码过期** — CLI 会自动刷新,最多重试 3 次
238- - ** API 报错** — 返回 ` { error_code, error_description } ` ,最常见原因是 token 过期
239- - ** Token 一般有效数天** ,批量操作前先 ` snowball status ` 确认
179+ - ** 「Not logged in」** — ` snowball login ` 或 ` snowball token <cookie> `
180+ - ** HTTP 403 / WAF** — 等几分钟或重新登录
181+ - ** Chrome not found** — 设置 ` CHROME_PATH ` 或 ` --chrome `
182+ - ** Token 过期** — ` snowball status ` 检查,过期重新 ` login `
0 commit comments