chii
a1c8770e1e
将 sif 提炼的抓取微服务范式作为开发建议入库，并标明本仓移交其他团队落实开发；不含凭据与实现代码。 Co-authored-by: Cursor <cursoragent@cursor.com>
56 lines
1.8 KiB
Markdown
56 lines
1.8 KiB
Markdown
# H10 关键词数据反查与导出 — 需求草稿
|
||
|
||
> **性质**：业务需求说明（草稿），供接手团队澄清与排期。
|
||
> **目标站**：https://members.helium10.com/
|
||
> **凭据**：向移交方索取，**禁止写入本仓库**。
|
||
|
||
## 功能概览
|
||
|
||
| # | 能力 | 说明 |
|
||
|---|------|------|
|
||
| 1 | 词表反查 | 按顺序：先产品词表反查，再全量词表反查；ASIN 由调用方/用户提供 |
|
||
| 2 | 排名监控录入 | 将 ASIN + 关键词加入 H10 排名监控；多组则循环添加 |
|
||
| 3 | 排名表格抓取 | 与词表反查独立，单独执行 |
|
||
|
||
---
|
||
|
||
## 1. 词表反查（顺序执行）
|
||
|
||
本品 ASIN、竞品 ASIN **由用户自行提供**。
|
||
|
||
### 1.1 产品词表反查
|
||
|
||
1. 进入 Helium 10 对应功能页，按产品词表反查流程操作。
|
||
2. 输入本品 ASIN。
|
||
3. 完成反查后导出。
|
||
4. **导出名**：`{本品ASIN}+反查词表`。
|
||
|
||
### 1.2 全量词表反查
|
||
|
||
在 1.1 完成后的界面继续：
|
||
|
||
1. 在本品 ASIN 基础上输入竞品 ASIN。
|
||
2. 按全量词表反查流程操作并导出。
|
||
3. **导出名**：`{本品ASIN}+全量词表`。
|
||
|
||
---
|
||
|
||
## 2. 排名监控录入
|
||
|
||
- 输入的 ASIN、关键词均由用户提供。
|
||
- 若提供多组「ASIN ↔ 关键词」，则**重复执行添加步骤**，直到全部录入完毕。
|
||
|
||
---
|
||
|
||
## 3. 排名表格抓取
|
||
|
||
- 与「词表反查」区分开，**单独任务**执行。
|
||
- 进入对应页面后按既定 UI 流程抓取排名表格数据。
|
||
|
||
---
|
||
|
||
## 实现提示（对接 playbook）
|
||
|
||
- 优先用浏览器逆向还原 HTTP 契约，再 HTTP 直连取数（见 [scraper-service-playbook.md](./scraper-service-playbook.md)）。
|
||
- 若导出仅为浏览器下载文件，需在契约中明确：是直链下载、异步任务轮询，还是必须走浏览器下载流。
|
||
- 开放对外 API 前须确认 Helium 10 侧计费 / 风控 / ToS 边界。
|