01
页面可访问性
成交链路识别正常商品页、验证码、404、Dog Page、无内容和不可售状态。页面异常时，不把缺失字段误报为“没有优惠”。
page_status anomalies
真实页面验证异常页保护
11核心审查项目
13支持站点代码
6本地化解析语言
10标准化 Deal 类型
Internal Scope Reference
Listing Health Checker审查范围
从消费者实际可见的 Amazon 前台页面出发，检查影响访问、成交、内容呈现和搜索曝光的关键环节。 本页说明它会检查什么、如何判定，以及哪些结论仍需要人工或业务数据确认。
Audit Coverage
11 项核心检查
字段存在不代表自动给出业务结论。涉及目标价格、目标卖家、正确类目等预期值时，报告会要求人工确认。
02
价格与优惠
成交链路区分 Regular、Deal、Prime Member、划线价、Savings 与 Coupon。单位价会单独标记，不会误写为划线价；有 Deal 时成交价按 Deal Price 返回。
regular deal_price prime_member strikethrough_price is_per_unit_price
真实页面验证稳定空值输出
03
卖家与 Buy Box
成交链路记录 Sold by、Ships from 与 FBA 线索。只有提供期望卖家时，才能自动判断 Buy Box 是否偏离预期。
sold_by ships_from
真实页面验证目标卖家需输入
04
购物车状态
成交链路检查 Add to Cart、Buy Now 和购买选项是否存在，帮助定位消费者无法直接成交的链路断点。
add_to_cart buy_now
真实页面验证前台按钮结构
05
配送与 Prime
成交链路按站点默认配送位置初始化会话，读取预计送达、配送费用与 Prime 状态。Prime 支持文案不会被误当成 Prime 价格。
delivery prime location_status
多站点验证AE 匿名定位受限
06
A+ 与 Brand Story
内容与口碑分别识别标准或 Premium A+ 模块和 Brand Story，避免将 Brand Story 卡片计入 A+ 模块数。未检测到 A+ 时标记为需关注。
has_a_plus module_count has_brand_story
结构测试动态结构需复核
07
Deal 标志
成交链路仅检查当前商品价格区和 Buy Box，排除推荐轮播。具体活动词精确匹配，通用 Deal 词允许在 badge 内模糊匹配。
has_deal deal_type badge_text
六语言测试三态输出
08
类目与节点
内容与口碑提取搜索栏大类和面包屑路径。脚本确认“抓到了什么”，但类目是否符合运营预期仍需人工判断。
department breadcrumbs
需人工复核不自动判定正确性
09
BSR 排名
内容与口碑按本地页面结构提取各层级排名；已针对德国“排名后跟类目”和日本“类目后跟排名”的结构分别处理。
bsr
DE / JP 实页验证趋势需历史数据
10
评分与首页评论
内容与口碑星级只从明确评论星级节点和完整本地化格式读取，不扫描普通文本、title 或 aria-label。缺失时返回未知，不默认 5 星。
rating reviews_on_page stars is_negative
六语言测试严格证据规则
11
搜索可见性
搜索曝光检查指定关键词的首屏搜索结果，区分自然位与广告位并记录目标 ASIN 是否出现。未找到不等同于全站无排名。
found position is_sponsored first_page_results
多站点验证仅当前首页快照
没有匹配的检查项。
Marketplace Matrix
站点与本地化覆盖
站点配置同时决定域名、匿名配送位置、显示货币和页面解析语言。ES 与 MX 使用独立 profile。
| 站点 | 域名 | 默认配送位置 | 货币 | 页面语言 | 解析 profile |
|---|---|---|---|---|---|
| US | amazon.com | 90001 | USD | English (US) | en_US |
| UK / GB | amazon.co.uk | SW1A 1AA | GBP | English (UK) | en_GB |
| DE | amazon.de | 10115 | EUR | Deutsch | de_DE |
| FR | amazon.fr | 75001 | EUR | Français | fr_FR |
| IT | amazon.it | 00100 | EUR | Italiano | it_IT |
| ES | amazon.es | 28001 | EUR | Español (ES) | es_ES |
| CA | amazon.ca | M5V 2T6 | CAD | English (CA) | en_CA |
| JP | amazon.co.jp | 100-0001 | JPY | 日本語 | ja_JP |
| MX | amazon.com.mx | 06600 | MXN | Español (MX) | es_MX |
| AU | amazon.com.au | 2000 | AUD | English (AU) | en_AU |
| SA | amazon.sa | 12211 | SAR | English | en_SA |
| AE | amazon.ae | 不提交邮编 | AED | English | en_AE |
AE 的匿名位置弹窗要求登录，因此脚本不会伪造邮编。定位失败或 Amazon 接口变化时，其他站点也会降级为公开前台抓取，并在结果中保留定位状态。
Decision Rules
关键判定规则
这些规则用于减少“页面有文字就算命中”的误报，并让结构化结果在不同站点保持一致。
Deal 只看当前商品成交区
价格区与 Buy Box 内命中才算 Deal；推荐商品、轮播和其他 ASIN 的 badge 会被排除。
Limited time dealPrime Exclusive DealDeal of the Day
Lightning DealBlack FridayPrime Day
Prime Big Deal DaysPrime Early Access Sale
Amazon Smile SALEDeal
具体活动精确，通用 Deal 模糊
季节活动和明确 Deal 类型按本地化词典精确映射；通用 Deal 词只允许在 badge 容器内模糊匹配，并保留页面原文。
Deal Price 优先于 Regular Price
检测到有效 Deal 时，当前成交价标记为 Deal Price，不再把同一金额重复解释为 Regular Price。
单位价不等于划线价
包含 /count、/unit、/ea、/each 或 per-unit 结构的金额单独标记，只有真正的划线价属性或标签才进入划线价字段。
评论星级必须有明确证据
仅接受 Amazon 评论星级节点与完整本地化格式。无法解析时 stars 和 is_negative 都返回 null，禁止补成 5 星。
页面失败时不推断“无优惠”
只有页面正常解析时，报告才显示 No coupon、No deal 等可读结论；验证码或抓取失败时只报告页面异常。
Output Contract
结构化与可读输出
JSON 保留稳定字段并使用 null 表示未检测到或未知；Markdown 报告将正常页面上的空优惠转换为明确的 No 文案。
true页面证据确认存在。
false页面正常，但未检测到该项。
null未检测到值，或页面状态不足以判断；结合 page_status 解读。
原始文本Deal badge、配送与库存文本保留站点语言，标准化枚举保持英文。
{
"page_status": "ok",
"price": {
"regular": "$499.99",
"deal_price": null,
"prime_member": "$449.00",
"strikethrough_price": null,
"strikethrough_price_type": null,
"is_per_unit_price": false,
"savings": null,
"coupon": null
},
"deal": {
"has_deal": false,
"deal_type": null,
"badge_text": null
},
"a_plus": {
"has_a_plus": true,
"module_count": 3,
"has_brand_story": true
}
}
Validation Status
当前验证证据
验证分为固定 HTML 回归测试和真实 Amazon 页面抽样。它能证明解析路径可工作，但不能保证 Amazon 后续不调整页面结构。
覆盖价格、单位价、A+、Deal、本地化、BSR、评论星级、位置和货币偏好。
English、Deutsch、Français、Italiano、Español、Japanese 均有商品页和搜索页固定样本。
价格、卖家、购物车、配送、类目、BSR、评论星级、库存和搜索页均做过真实页面抽样。
FR、IT、ES、MX 已复核定位与货币；季节性活动 Deal 主要依赖固定 HTML 测试，因为并非全年都有可稳定复现的真实活动页面。
Known Boundaries
明确不做与需要复核的内容
这是一套前台可见性巡检，不是 Amazon 后台诊断、业务分析或账号操作工具。
不读取 Seller Central
不检查后台抑制原因、库存数量、账号绩效、合规通知或具体发布状态。
不替代经营数据
不读取销量、广告花费、转化率、利润或竞品历史，无法单独解释销量变化。
不证明类目“正确”
只提取当前类目和面包屑；是否符合品牌运营预期需要人工提供目标节点。
不代表全量关键词排名
搜索检查是指定配送地、指定时点的首页快照，未找到不代表 ASIN 在后续页面没有排名。
动态内容可能缺失
Amazon 按账号、设备、网络和实验组动态渲染内容，公开 HTML 可能不含全部个性化模块。
验证码会阻断判断
脚本复用站点 cookie 并控制请求间隔，但不会绕过验证码；触发后会保留未知状态并停止误判。
Batch Run
批量巡检入口
总控脚本支持同一站点批量 ASIN、关键词检查、随机延迟和站点级 cookie 复用。
python3 scripts/run_health_check.py \ --asins B0XXXXXXX1,B0XXXXXXX2 \ --site US \ --keywords "3d printer" \ --delay-min 10 \ --delay-max 30 \ --output-dir outputs