amazon-h10-api/docs/requirements-h10.md
chii a1c8770e1e docs: 移交 playbook 与 H10 需求草稿
将 sif 提炼的抓取微服务范式作为开发建议入库,并标明本仓移交其他团队落实开发;不含凭据与实现代码。

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-07 11:52:55 +08:00

1.8 KiB
Raw Blame History

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)。
  • 若导出仅为浏览器下载文件,需在契约中明确:是直链下载、异步任务轮询,还是必须走浏览器下载流。
  • 开放对外 API 前须确认 Helium 10 侧计费 / 风控 / ToS 边界。