# 亚马逊标签监控工具：待解决问题清单

本文档用于新版工具开发前的口径确认和任务拆分。

## 1. 国家关键词待补充

原工具只覆盖英文关键词：

```text
Frequently returned
usually keep this item
Highly retained
```

全国家版本需要补充各国家本地语言表达。

优先补充站点：

```text
美国, 加拿大, 英国, 德国, 法国, 意大利, 西班牙, 日本, 墨西哥, 澳洲
```

每个站点至少需要确认：

| 标签类型 | 需要确认的页面文案 |
|---|---|
| 高退货标签 | 与 `Frequently returned item` 对应的本地语言表达 |
| 高保留标签 | 与 `Customers usually keep this item` 对应的本地语言表达 |
| 验证码/机器人拦截 | Amazon 拦截页、机器人验证页、异常页关键词 |

建议处理方式：

- 第一版关键词全部放在配置表中
- 不把关键词写死在代码里
- 每发现一个站点新文案，就补充到关键词配置表
- 新关键词先标记为待验证，确认后再启用

## 2. 标签位置是否一致待确认

原工具做法是扫描详情页全文文本，而不是定位标签模块。

需要确认：

- 不同国家的标签是否都直接出现在详情页 HTML 中
- 是否有站点通过前端异步接口加载标签
- 登录状态是否影响标签展示
- 配送地区、语言、邮编是否影响标签展示
- 桌面端和移动端文案是否不同
- 父 ASIN 页面和子 ASIN 页面是否展示不同

风险：

```text
如果标签不是直接在 HTML 中出现，普通 HTTP 抓取会漏判。
```

可能的升级方案：

- 使用浏览器渲染模式
- 保存 HTML 快照用于人工排查
- 针对 Amazon 页面结构做模块定位
- 针对异步接口做单独解析

## 3. 多站点 URL 规则待确认

需要维护国家和域名映射表。

重点域名：

| 站点 | 域名 |
|---|---|
| US | amazon.com |
| CA | amazon.ca |
| MX | amazon.com.mx |
| UK | amazon.co.uk |
| DE | amazon.de |
| FR | amazon.fr |
| IT | amazon.it |
| ES | amazon.es |
| NL | amazon.nl |
| SE | amazon.se |
| PL | amazon.pl |
| BE | amazon.com.be |
| TR | amazon.com.tr |
| JP | amazon.co.jp |
| AU | amazon.com.au |
| SG | amazon.sg |
| AE | amazon.ae |
| SA | amazon.sa |
| BR | amazon.com.br |

待确认：

- 是否需要覆盖更多 Amazon 国家
- 输入完整链接时如何反推国家
- ASIN 在某国家不存在时如何标记
- 父 ASIN、子 ASIN 是否都要查
- 同一 SKU 是否允许绑定多个站点和多个 ASIN

## 4. 变化判断口径待确认

当前建议口径：

```text
只有本次明确检测为无标签，才判定标签消失。
请求失败、验证码、页面异常不算标签消失。
```

待确认：

| 场景 | 建议口径 | 待确认点 |
|---|---|---|
| 无标签 -> 高退货 | 新增高退货标签 | 是否设为最高风险 |
| 无标签 -> 高保留 | 新增高保留标签 | 是否作为正向信号 |
| 高退货 -> 无标签 | 高退货标签消失 | 是否需要记录恢复日期 |
| 高保留 -> 无标签 | 高保留标签消失 | 是否需要记录恢复日期 |
| 高退货 -> 高保留 | 标签类型变化 | 是否拆成“高退货消失 + 高保留新增” |
| 高保留 -> 高退货 | 标签类型变化 | 是否升级风险等级 |
| 首次检测即有标签 | first_seen | 是否纳入新增清单 |
| 多次检测失败 | stale / 过期 | 多久未成功检测算过期 |

## 5. 请求频率和反爬策略待确认

原工具每条随机等待 3 到 6 秒。新版全国家建议更保守。

建议默认值：

| 参数 | 默认值 |
|---|---|
| 单请求超时 | 20 秒 |
| 单国家请求间隔 | 5 到 12 秒随机 |
| 跨国家请求间隔 | 2 到 5 秒随机 |
| 单 URL 最大重试 | 1 次 |
| 同国家连续验证码熔断 | 3 次 |
| 全局验证码熔断 | 5 次 |
| 同国家连续失败熔断 | 5 次 |

待确认：

- 每天预计检测多少 ASIN
- 每个国家预计检测多少条
- 是否需要代理
- 是否需要 Cookie
- 是否允许保存 HTML 快照
- 是否需要夜间自动跑
- 是否需要失败重试

## 6. 历史数据存储方式待确认

第一版可以使用 CSV，稳定版建议使用 SQLite。

待确认：

- 历史记录保留多久
- 是否按检测批次归档
- 是否要导出 Excel
- 是否保存原始 HTML
- 是否按 MSKU、SPU、国家维度汇总
- 是否需要多人共享访问
- 是否需要自动备份

## 7. 输入字段待确认

当前建议输入字段：

```text
enabled
sku
spu
asin
country
product_url
check_frequency
owner
note
```

待确认是否增加：

```text
店铺
品牌
产品线
负责人
采购状态
是否新品
是否重点监控
父ASIN
子ASIN
Listing状态
上架时间
类目
```

## 8. 输出结果待确认

当前建议输出：

- 检测明细
- 变化汇总

待确认是否增加：

- 异常清单
- 验证码清单
- 新增风险清单
- 标签恢复清单
- 国家维度汇总
- SPU 维度汇总
- SKU 维度汇总
- 负责人维度汇总
- 每日变化报表

## 9. 执行方式待确认

第一版建议：

```text
上传输入表 -> 点击开始 -> 查看进度 -> 导出结果
```

后续可升级：

- 每日自动检测
- 每周自动检测
- 检测完成后推送飞书
- 只推送新增风险和标签消失
- 自动生成周报

待确认：

- 是否只做本地工具
- 是否需要放到内网服务器
- 是否需要多人同时使用
- 是否需要权限控制
- 是否需要任务队列

## 10. 验证样本待准备

为了验证准确性，需要准备样本。

每个重点国家建议准备：

| 样本类型 | 数量 |
|---|---:|
| 已知高退货标签 ASIN | 3 到 5 个 |
| 已知高保留标签 ASIN | 3 到 5 个 |
| 已知无标签 ASIN | 3 到 5 个 |
| 已知不存在/下架 ASIN | 1 到 2 个 |
| 已知容易触发验证码链接 | 1 到 2 个 |

没有样本时，第一版只能先按关键词逻辑实现，再边跑边校准。

## 11. 第一阶段建议处理顺序

1. 确认输入字段是否够用
2. 确认国家范围
3. 准备 美国、德国、日本、UK、FR 的样本
4. 先用英文关键词跑通流程
5. 保存 HTML 快照，人工查看漏判站点
6. 补充国家关键词
7. 固化变化判断口径
8. 再开发自动化和提醒功能