# Keepa 全功能复制蓝图（逐页评估 + 分期方案）— 2026-09-27

**依据**：三轮登录态遍历实测（`keepa-ui-archive/traverse*/`，15 路由截图+DOM+API 请求明文）+ 5 份用户上传 PDF + `aba_keepa_full` 43 列现状 + `/query` 端点真 key 验证。
**铁律**：每页结论三选一——**[可复制]**（库内已有数据）/ **[需扩采集]**（数据缺口在 B 需求单 R1~R10）/ **[不复制]**（营销/账户页或与 SaaS 定位无关）。无数据字段 UI 显式「无数据（需扩采集）」，不显示误导 0。

## 一、逐页评估（11 个工具页）

| Keepa 页 | 定位 | 结论 | 说明 |
|---|---|---|---|
| 产品搜索工具 finder | 选品筛选引擎 | **[可复制]≈25 项已上**（explore）+ **[需扩采集]≈90 项**（R1/R2/R4/R5/R6/R8/R9/R10） | A 项 ### 多值 OR 已照抄；窗口族/BuyBox 统计/属性族等数据缺口见 B 单 |
| 产品查看器 viewer | 单品价格历史图表 | **[需扩采集-时序]**（B 单未含——价格历史 CSV 是新数据形态，非快照列） | 需 Keepa 价格历史按 ASIN 拉时序落库；图表前端可复用 UVPVP 风格 |
| 产品畅销榜 bestseller | BSR 榜单（按类目） | **[可复制-简化]** 当前列已有（BSR 快照+类目映射）；月度趋势列 [需扩采集] | 榜单=explore 按 BSR 排序的视图；「历史月份锚点/上月购买/90天变化%」需历史 |
| 热销商家列表 topseller | 卖家榜（1000行/页） | **[需扩采集]** R3 卖家维度整块 | 库内无卖家表 |
| 卖家查询 sellerlookup | 卖家检索（名称/ID/VAT/邮箱） | **[需扩采集]** R3 | 同上 |
| 类别树 categorytree | 全类目树浏览 | **[可复制]** | 类目映射已有（explore chips 同源）；静态树渲染纯前端 |
| 促销 deals | 降价/促销流 | **[需扩采集]**（实时流+LIGHTNING_DEAL 族） | 无管道；优先级低 |
| 追踪 tracking+提醒 | 价格提醒 | **[需扩采集-时序]**（同 viewer）+ SaaS 通知系统已有 | 需定时价格轮询管道 |
| 站内搜索 search | 全库产品搜索 | **[可复制]（并入 explore）** | explore 关键词/批量 ASIN 已覆盖，不单开页 |
| data/api/features/news/manage/notification | 数据下载/API 文档/营销/账户 | **[不复制]** | 与 SaaS 租户定位无关 |

## 二、分期方案（供拍板）

- **分期一（零采集改造，纯 SaaS 侧）**：①类别树页（新页面，数据全有）②畅销榜页=explore BSR 排序视图+类目锚点（现有列）③search 并入 explore 导航。工期最短，立即可做。
- **分期二（B 单 R1+R2 落库后）**：finder 窗口族+BuyBox 统计筛选全量补齐（字段名已实测，见 B 单追记）。
- **分期三（B 单 R3 落库后）**：热销商家列表 + 卖家查询两页。
- **分期四（价格历史时序管道建立后）**：产品查看器图表 + 追踪提醒（依赖最重，最后）。
- 挂账：deals 促销流（R9 之外还需实时管道，单独评估）。

## 三、验收口径

1. 每页复制后跑四道回归门（逐道单独）+ 双视口截图存档进 changelog
2. 无数据字段在 UI 显式「无数据（需扩采集）」
3. 筛选语义与 Keepa 一致以「显示API请求」selection 格式为准（`_gte/_lte`/`###` OR/sort 数组/perPage≥50/page 0 基）
4. 采集侧每期回报字段映射+非空率，SaaS 复验 explore fields/conds 命中
