使用教程

从注册到导出 Excel，一共 6 步。第一次用照着做一遍就会了。

1

注册并领取试用

在注册页建账号（用户名 3–32 位、密码至少 8 位且含两类字符）。注册后进我的账户，点「领取免费试用」——7 天 / 300 个 SKU，先验证能不能抓到你要的品类。每个账号只能领一次。

2

下载并解压客户端

到下载页拿免安装版，解压到固定目录（如 D:\FanNozzle）。双击 FanNozzle.exe，它会起本机服务并自动打开浏览器界面。

3

在本机界面登录本站账号

本机界面右侧「站点账号」卡片 → 填本站用户名密码 → 登录。卡片上会显示会员状态与剩余额度。没登录或会员过期时「开始采集」是灰的，这是刻意的：服务器会在开跑前校验一次，绕不过去。

4

填采集设置并保存

关键词（逗号分隔，默认「不锈钢扇形喷嘴」）、取销量前 N 条（默认 100）、品类口径。改完必须先点「保存设置」，否则开始按钮不可点—— 服务端只认已保存的设置，这一步是为了避免"填了却不生效"。

5

开始采集

点「完整采集」。电脑上会弹出浏览器窗口——第一次要先登录淘宝 （扫码即可，登录态会存进该账号独立的浏览器配置目录，下次不用重登）。界面会实时显示进度，可随时暂停/继续。

6

看结果、导出

采完在「SKU」「跨店比价」「分析报告」页看结果，每个页都有导出条，可导出Excel（.xlsx）/ Markdown / CSV。每一轮采集都会留档在「采集记录」，随时切回去读，不会把上一轮冲掉。

三个网址（别搞混）

客户端启动时会在控制台打印可直接打开的本机地址；端口从 8848 起自动找空闲的，所以不一定正好是 8848。

项	默认	说明
关键词	不锈钢扇形喷嘴	逗号分隔，每个词独立抓取后合并去重（要多个词就自己加）
取销量前 N 条	100	按「销量」排序后取前 N 条链接
每词抓几页	5	搜索页翻几页，页数不够会取不满 N 条
详情间隔（秒）	30,50	两次打开详情页之间的空档。越大越不容易被反爬
详情页停留时间（秒）	30,60	详情页开着多久才提取。页面重、SKU 面板加载慢时要调大
搜索间隔（秒）	30,50	翻搜索页之间的空档。留空则用命令行默认（同为 30,50）

间隔管的是两次访问之间的空档，停留管的是页面开着多久——两件事，别混。想更快出结果就调小，但被拦截的概率会明显上升。

被反爬拦住了 / 出现滑块验证怎么办？

先停一会儿（30–60 分钟）或换个网络，然后点「只补详情」—— 它不会重抓搜索页，只把缺详情的链接补齐，可以反复执行直到采齐。连续被拦到阈值会自动熔断并标记该账号冷却，轮换到下一个账号。

SKU 一个都采不到？

先确认淘宝登录态还有效（账号状态卡片里显示「已验证」）。再跑一次带 --diag-detail 的诊断，它会把详情页每一层的原始情况打出来，不做采集。

「刚采的数据看不到了」？

两个原因：① 切了「采集记录」批次——在采集记录页切回来即可； ② 你跑的是 EXE 独立包，而它默认自带空的数据目录。用 /api/health 看 root 字段能确认它读的是哪个目录。

换电脑 / 换网络还能用吗？

能。把整个客户端目录拷过去即可。淘宝登录态存在各账号独立的浏览器配置目录里，换机器需要重新登录一次淘宝。本站账号在哪台机器都能登录。

额度怎么算？

按 SKU 计。采集前报到一次（校验会员与额度），采集完成后按实际采到的 SKU 数扣减。刻意允许最后一轮略微超额——不会在你跑到一半时把任务掐掉。

管理员账号为什么不受限制？

管理员（role=admin）免检会员与额度，方便自测；但服务器上依然不能采集（数据中心 IP 抓不了淘宝，接口直接 403 并说明原因）。

请遵守目标网站的 robots 与用户协议，控制采集频率，不要用于绕过访问限制或批量倒卖数据。默认的间隔（30–50 秒）已经比较保守，不建议为了快而调到几秒。采集结果仅用于你自己的选品与比价分析。