Internal Scope Reference

Listing Health Checker审查范围

从消费者实际可见的 Amazon 前台页面出发,检查影响访问、成交、内容呈现和搜索曝光的关键环节。 本页说明它会检查什么、如何判定,以及哪些结论仍需要人工或业务数据确认。

数据来源
Amazon 公开前台 HTML
输出形式
JSON + Markdown 报告
支持模式
单 ASIN / 批量巡检
文档版本
2026-07-29
11核心审查项目
13支持站点代码
6本地化解析语言
10标准化 Deal 类型

Audit Coverage

11 项核心检查

字段存在不代表自动给出业务结论。涉及目标价格、目标卖家、正确类目等预期值时,报告会要求人工确认。

01

页面可访问性

成交链路

识别正常商品页、验证码、404、Dog Page、无内容和不可售状态。页面异常时,不把缺失字段误报为“没有优惠”。

page_status anomalies
真实页面验证异常页保护
02

价格与优惠

成交链路

Regular、Prime Member 和 Deal Price 只从各自明确购买选项读取;仅有金额但类型证据不足时写入 Current Price,不替代为 Regular。单位价不会误写为划线价。

current regular deal_price prime_member strikethrough_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 价格。

delivery prime location_status
多站点验证AE 匿名定位受限
06

A+ 与 Brand Story

内容与口碑

仅按明确模块结构识别标准或 Premium A+ 与 Brand Story,排除嵌套模块重复计数。缺少结构证据时返回未知,不以文本长度推断。

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
USamazon.com90001USDEnglish (US)en_US
UK / GBamazon.co.ukSW1A 1AAGBPEnglish (UK)en_GB
DEamazon.de10115EURDeutschde_DE
FRamazon.fr75001EURFrançaisfr_FR
ITamazon.it00100EURItalianoit_IT
ESamazon.es28001EUREspañol (ES)es_ES
CAamazon.caM5V 2T6CADEnglish (CA)en_CA
JPamazon.co.jp100-0001JPY日本語ja_JP
MXamazon.com.mx06600MXNEspañol (MX)es_MX
AUamazon.com.au2000AUDEnglish (AU)en_AU
SAamazon.sa12211SAREnglishen_SA
AEamazon.ae不提交邮编AEDEnglishen_AE
AE 的匿名位置弹窗要求登录,因此脚本不会伪造邮编,并将严格检查标记为定位未验证。其他站点定位失败或接口变化时也停止商品判断,不使用第一次抓到的未定位页面。

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 容器内模糊匹配,并保留页面原文。

价格类型不互相替代

Regular、Prime Member 与 Deal Price 分别要求对应购买选项证据;只有金额但类型未知时保留为 Current Price,current_type 返回 null。

单位价不等于划线价

包含 /count、/unit、/ea、/each 或 per-unit 结构的金额单独标记,只有真正的划线价属性或标签才进入划线价字段。

评论星级必须有明确证据

仅接受 Amazon 评论星级节点与完整本地化格式。无法解析时 stars 和 is_negative 都返回 null,禁止补成 5 星。

模块未确认时不输出 No

只有对应价格或成交模块已被结构证据确认时,报告才显示 No coupon、No deal 等结论;否则返回 null 并显示“未确认”。

Output Contract

结构化与可读输出

JSON 保留稳定字段并使用 null 表示未检测到或未知;只有对应模块确认后,Markdown 才把空优惠转换为明确的 No 文案。

true页面证据确认存在。
false对应模块已确认,并明确未检测到该项。
null字段或模块证据不足,不能判断;结合 page_status 和模块 status 解读。
原始文本Deal badge、配送与库存文本保留站点语言,标准化枚举保持英文。
{
  "page_status": "ok",
  "price": {
    "status": "ok",
    "current": "$399.00",
    "current_type": null,
    "regular": null,
    "deal_price": null,
    "prime_member": null,
    "strikethrough_price": "$499.99",
    "strikethrough_price_type": "List Price",
    "is_per_unit_price": false,
    "savings": "-20%",
    "coupon": null
  },
  "deal": {
    "has_deal": false,
    "deal_type": null,
    "badge_text": null
  },
  "a_plus": {
    "has_a_plus": true,
    "module_count": 7,
    "has_brand_story": true
  }
}

Validation Status

当前验证证据

验证分为固定 HTML 回归测试和真实 Amazon 页面抽样。它能证明解析路径可工作,但不能保证 Amazon 后续不调整页面结构。

44 项测试通过

覆盖价格隔离、单位价、A+ 去重、Deal、本地化、BSR、评论星级、位置失败和未知状态。

6 套语言 fixture

English、Deutsch、Français、Italiano、Español、Japanese 均有商品页和搜索页固定样本。

DE / JP 实页复核

价格、卖家、购物车、配送、类目、BSR、评论星级、库存和搜索页均做过真实页面抽样。

US 实页已复核严格价格分类与 A+ 顶层模块计数;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