# 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 边界。