zach-listing-health-checker

Name: zach-listing-health-checker
Author: zach22-1999

123stars32forks

How to install zach-listing-health-checker?

zach22-1999/amazon-skills/zach-listing-health-checker

$npx -y skills add zach22-1999/amazon-skills --skill zach-listing-health-checker

Installs into the current project.

Summary

以真实消费者视角检查亚马逊Listing健康状态。通过网页抓取模拟消费者浏览体验，检查页面可见性、价格、卖家信息、购物车、配送、类目节点、排名、差评等关键指标，并验证关键词搜索可见性。使用时机：新品上架后验收、日常巡检、排查Listing异常。触发词：/zach-listing-health-checker

Files · 1

View on GitHub

SKILL.md

1	## 前置建议
2
3	本公开版 Skill 是自包含的，不依赖任何私有工作区文件、内部参考库或品牌专属协议。
4
5	开始执行前，建议先通读本 Skill 自身的方法论部分，重点关注：
6
7	- 页面可访问性判断
8	- Buy Box / Add to Cart / 配送状态的异常标准
9	- 搜索可见性验证逻辑
10
11	如果你已经有自己的 Listing 诊断框架，可以作为补充背景使用；但本 Skill 的执行不依赖外部私有资料。
12
13	# Listing 健康检查器 — 完整方法论
14
15	## 1. 技能定位
16
17	### 核心理念
18
19	通过 curl + BeautifulSoup 抓取亚马逊服务端渲染的 HTML，不借助任何 API 或第三方数据工具。
20
21	原因：我们要验证的是"消费者打开亚马逊能看到什么"。任何 API 返回的数据都可能与前台页面不一致（缓存、区域差异、权限差异）。这个技能的价值就在于所见即所得。
22
23	亚马逊商品页面的核心数据（标题、价格、卖家、BSR、评论等）全部在服务端渲染的 HTML 中，无需 JavaScript 执行。curl 配合正确的浏览器 Headers 可稳定获取完整页面（~2.4MB HTML）。
24
25	### Script Directory
26
27	脚本位于 `skills/zach-listing-health-checker/scripts/`：
28	- browser_utils.py — 通用网页抓取模块（curl 封装、站点配置、反爬检测），其他 Skill 可复用
29	- fetch_amazon_page.py — 商品页面抓取，提取 9 项检查数据，输出 JSON
30	- fetch_amazon_search.py — 搜索结果页抓取，检查 ASIN 搜索可见性，输出 JSON
31
32	### 工作流位置
33
34	```
35	新品上架流程：
36	zach-new-product-listing-writer → zach-launch-checklist-generator
37	→ 【zach-listing-health-checker：上架验收】
38	→ zach-ad-campaign-builder → 广告投放
39
40	日常运营：
41	定期巡检 → 【zach-listing-health-checker】→ 发现问题 → 人工修复 → 复检
42	```
43
44	### 上下游
45
46	\| 方向 \| 技能 \| 关系 \|
47	\|------\|------\|------\|
48	\| 上游 \| zach-new-product-listing-writer \| Listing 创建完成后需要验收 \|
49	\| 上游 \| zach-launch-checklist-generator \| 上架检查清单的执行环节之一 \|
50	\| 下游 \| 人工修复 \| 检查出问题后需要人工介入 \|
51	\| 下游 \| 复检（再次调用本技能） \| 修复后重新验证 \|
52
53	---
54
55	## 2. 输入参数
56
57	\| 参数 \| 必需 \| 默认值 \| 说明 \|
58	\|------\|------\|--------\|------\|
59	\| ASIN \| ✅ 是 \| — \| 10 位字母数字，通常以 B0 开头 \|
60	\| 站点代码 \| 否 \| US \| 支持的站点见下方列表 \|
61	\| 卖家名称 \| 否 \| — \| 用于校验 Sold By 是否正确 \|
62	\| 核心关键词 \| 否 \| — \| 逗号分隔，用于搜索可见性验证 \|
63
64	### 支持站点配置
65
66	\| 站点代码 \| 域名 \| 默认邮编 \| 货币 \|
67	\|----------\|------\|----------\|------\|
68	\| US \| amazon.com \| 90001 \| USD \|
69	\| UK / GB \| amazon.co.uk \| SW1A 1AA \| GBP \|
70	\| DE \| amazon.de \| 10115 \| EUR \|
71	\| FR \| amazon.fr \| 75001 \| EUR \|
72	\| IT \| amazon.it \| 00100 \| EUR \|
73	\| ES \| amazon.es \| 28001 \| EUR \|
74	\| CA \| amazon.ca \| M5V 2T6 \| CAD \|
75	\| JP \| amazon.co.jp \| 100-0001 \| JPY \|
76	\| MX \| amazon.com.mx \| 06600 \| MXN \|
77	\| AU \| amazon.com.au \| 2000 \| AUD \|
78
79	---
80
81	## 3. 检查项详细定义
82
83	### 3.1 页面可访问性
84
85	检查内容：页面是否正常渲染商品信息。
86
87	\| 状态 \| 判断条件 \|
88	\|------\|----------\|
89	\| ✅ 正常 \| 页面包含商品标题、图片、价格等核心元素 \|
90	\| ❌ 异常 \| 出现狗狗页面（Dog page）、404、"Looking for something?"、"Currently unavailable"、验证码页面 \|
91
92	常见异常场景：
93	- ASIN 被下架 → 狗狗页面或 "Currently unavailable"
94	- ASIN 被合并到其他变体 → 自动跳转
95	- 区域限制 → "This item does not ship to your location"
96
97	### 3.2 价格与优惠
98
99	检查内容：当前售价、划线价、折扣、优惠券。
100
101	\| 状态 \| 判断条件 \|
102	\|------\|----------\|
103	\| ✅ 正常 \| 有明确售价显示 \|
104	\| ⚠️ 需关注 \| 价格与预期差异较大（需用户判断） \|
105	\| ❌ 异常 \| 无价格显示、显示 "See price in cart"、或价格为 $0 \|
106
107	记录字段：
108	- 当前售价
109	- 划线价（List Price / Was Price）
110	- 折扣百分比
111	- 优惠券（Coupon）金额或百分比
112	- 是否有"Subscribe & Save"折扣
113
114	### 3.3 卖家信息（Buy Box）
115
116	检查内容：Sold by 和 Ships from 信息。
117
118	\| 状态 \| 判断条件 \|
119	\|------\|----------\|
120	\| ✅ 正常 \| Sold by 显示为用户指定的卖家名称 \|
121	\| ❌ 异常 \| Sold by 不是指定卖家（Buy Box 被抢） \|
122	\| ⚠️ 需关注 \| 用户未指定卖家，仅记录当前信息 \|
123
124	记录字段：
125	- Sold by：卖家名称
126	- Ships from：发货方（Amazon / 卖家名 / 第三方）
127	- 是否为 FBA（Ships from Amazon）
128
129	### 3.4 购物车状态
130
131	检查内容：是否有 Add to Cart / Buy Now 按钮。
132
133	\| 状态 \| 判断条件 \|
134	\|------\|----------\|
135	\| ✅ 正常 \| 同时显示 Add to Cart 和 Buy Now \|
136	\| ⚠️ 需关注 \| 只有 Add to Cart 没有 Buy Now，或显示 "See All Buying Options" \|
137	\| ❌ 异常 \| 无购买按钮，或显示 "Currently unavailable" \|
138
139	### 3.5 配送信息
140
141	检查内容：预计送达时间和 Prime 状态。
142
143	\| 状态 \| 判断条件 \|
144	\|------\|----------\|
145	\| ✅ 正常 \| 有明确的预计送达日期，且在 7 天以内 \|
146	\| ⚠️ 需关注 \| 配送时间 7-14 天 \|
147	\| ❌ 异常 \| 配送时间超过 14 天、或无配送信息 \|
148
149	记录字段：
150	- 预计送达日期
151	- 是否有 Prime 标识
152	- 配送费用（免费/具体金额）
153
154	### 3.6 类目与节点
155
156	检查内容：
157	1. 搜索栏旁的大类（department selector）
158	2. 面包屑导航中的销售节点路径（通常在主图上方）
159
160	\| 状态 \| 判断条件 \|
161	\|------\|----------\|
162	\| ✅ 正常 \| 能正常显示类目信息 \|
163	\| ⚠️ 需人工确认 \| 类目信息显示正常，但需人工确认是否为期望的节点 \|
164
165	记录字段：
166	- 搜索栏大类名称
167	- 面包屑完整路径（如 `Musical Instruments › Electronic Music, DJ & Karaoke › Karaoke Equipment › Systems › Portable Systems`）
168
169	> 注意：类目节点的"正确性"需要人工判断，技能只负责抓取和展示，不做自动判断。
170
171	### 3.7 BSR 排名
172
173	检查内容：Best Sellers Rank 在各层级类目中的排名。
174
175	\| 状态 \| 判断条件 \|
176	\|------\|----------\|
177	\| ✅ 正常 \| 有 BSR 排名数据 \|
178	\| ⚠️ 需关注 \| 排名显著下跌（需历史对比） \|
179	\| ❌ 异常 \| 无 BSR 排名（可能表示商品未正常入库或类目异常） \|
180
181	记录字段：
182	- 每个层级的类目名称 + 排名数字
183	- 示例：`#152 in Musical Instruments` → `#3 in Portable Karaoke Systems`
184
185	### 3.8 差评监控
186
187	检查内容：首页评论中的差评（1-3 星）数量和内容。
188
189	\| 状态 \| 判断条件 \|
190	\|------\|----------\|
191	\| ✅ 正常 \| 首页 0 条差评 \|
192	\| ⚠️ 需关注 \| 首页 1-2 条差评 \|
193	\| ❌ 异常 \| 首页 3 条及以上差评 \|
194
195	记录字段：
196	- 总评分（星级）
197	- 总评论数
198	- 首页差评条数
199	- 每条差评的：星级、标题、简要内容、日期
200	- 差评趋势判断：首次检查标注「首次检查，无历史对比基线」；有历史报告时对比差评数变化
201
202	### 3.9 搜索可见性
203
204	检查内容：用核心关键词搜索后，商品是否出现在搜索结果首页。
205
206	\| 状态 \| 判断条件 \|
207	\|------\|----------\|
208	\| ✅ 正常 \| 在首页自然位找到 \|
209	\| ⚠️ 需关注 \| 仅在广告位找到，自然位未找到 \|
210	\| ❌ 异常 \| 首页完全未找到（可能被压制或搜索不可见） \|
211
212	关键操作：
213	- 搜索时确保选择 "All Departments"，不要被限定在某个子类目
214	- 区分自然位（Organic）和广告位（Sponsored）
215	- 记录具体位置编号
216
217	---
218
219	## 4. 执行步骤（详细）
220
221	### Step 1：参数解析与准备
222
223	1. 从用户输入中提取 ASIN、站点代码、卖家名称、核心关键词
224	2. 验证 ASIN 格式（10 位字母数字）
225	3. 根据站点代码查找域名和默认邮编
226	4. 如果用户未提供站点代码，默认使用 US
227	5. 构建商品页面 URL：`https://{domain}/dp/{ASIN}`
228
229	### Step 2：抓取商品页面
230
231	运行 `fetch_amazon_page.py` 脚本抓取商品页面并提取结构化数据：
232
233	```bash
234	python3 skill

People who liked this also viewed

6 picks

Type

zach-listing-health-checker

123stars32forks

View on GitHub

How to install zach-listing-health-checker?

zach22-1999/amazon-skills/zach-listing-health-checker

$npx -y skills add zach22-1999/amazon-skills --skill zach-listing-health-checker

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	## 前置建议
2
3	本公开版 Skill 是自包含的，不依赖任何私有工作区文件、内部参考库或品牌专属协议。
4
5	开始执行前，建议先通读本 Skill 自身的方法论部分，重点关注：
6
7	- 页面可访问性判断
8	- Buy Box / Add to Cart / 配送状态的异常标准
9	- 搜索可见性验证逻辑
10
11	如果你已经有自己的 Listing 诊断框架，可以作为补充背景使用；但本 Skill 的执行不依赖外部私有资料。
12
13	# Listing 健康检查器 — 完整方法论
14
15	## 1. 技能定位
16
17	### 核心理念
18
19	通过 curl + BeautifulSoup 抓取亚马逊服务端渲染的 HTML，不借助任何 API 或第三方数据工具。
20
21	原因：我们要验证的是"消费者打开亚马逊能看到什么"。任何 API 返回的数据都可能与前台页面不一致（缓存、区域差异、权限差异）。这个技能的价值就在于所见即所得。
22
23	亚马逊商品页面的核心数据（标题、价格、卖家、BSR、评论等）全部在服务端渲染的 HTML 中，无需 JavaScript 执行。curl 配合正确的浏览器 Headers 可稳定获取完整页面（~2.4MB HTML）。
24
25	### Script Directory
26
27	脚本位于 `skills/zach-listing-health-checker/scripts/`：
28	- browser_utils.py — 通用网页抓取模块（curl 封装、站点配置、反爬检测），其他 Skill 可复用
29	- fetch_amazon_page.py — 商品页面抓取，提取 9 项检查数据，输出 JSON
30	- fetch_amazon_search.py — 搜索结果页抓取，检查 ASIN 搜索可见性，输出 JSON
31
32	### 工作流位置
33
34	```
35	新品上架流程：
36	zach-new-product-listing-writer → zach-launch-checklist-generator
37	→ 【zach-listing-health-checker：上架验收】
38	→ zach-ad-campaign-builder → 广告投放
39
40	日常运营：
41	定期巡检 → 【zach-listing-health-checker】→ 发现问题 → 人工修复 → 复检
42	```
43
44	### 上下游
45
46	\| 方向 \| 技能 \| 关系 \|
47	\|------\|------\|------\|
48	\| 上游 \| zach-new-product-listing-writer \| Listing 创建完成后需要验收 \|
49	\| 上游 \| zach-launch-checklist-generator \| 上架检查清单的执行环节之一 \|
50	\| 下游 \| 人工修复 \| 检查出问题后需要人工介入 \|
51	\| 下游 \| 复检（再次调用本技能） \| 修复后重新验证 \|
52
53	---
54
55	## 2. 输入参数
56
57	\| 参数 \| 必需 \| 默认值 \| 说明 \|
58	\|------\|------\|--------\|------\|
59	\| ASIN \| ✅ 是 \| — \| 10 位字母数字，通常以 B0 开头 \|
60	\| 站点代码 \| 否 \| US \| 支持的站点见下方列表 \|
61	\| 卖家名称 \| 否 \| — \| 用于校验 Sold By 是否正确 \|
62	\| 核心关键词 \| 否 \| — \| 逗号分隔，用于搜索可见性验证 \|
63
64	### 支持站点配置
65
66	\| 站点代码 \| 域名 \| 默认邮编 \| 货币 \|
67	\|----------\|------\|----------\|------\|
68	\| US \| amazon.com \| 90001 \| USD \|
69	\| UK / GB \| amazon.co.uk \| SW1A 1AA \| GBP \|
70	\| DE \| amazon.de \| 10115 \| EUR \|
71	\| FR \| amazon.fr \| 75001 \| EUR \|
72	\| IT \| amazon.it \| 00100 \| EUR \|
73	\| ES \| amazon.es \| 28001 \| EUR \|
74	\| CA \| amazon.ca \| M5V 2T6 \| CAD \|
75	\| JP \| amazon.co.jp \| 100-0001 \| JPY \|
76	\| MX \| amazon.com.mx \| 06600 \| MXN \|
77	\| AU \| amazon.com.au \| 2000 \| AUD \|
78
79	---
80
81	## 3. 检查项详细定义
82
83	### 3.1 页面可访问性
84
85	检查内容：页面是否正常渲染商品信息。
86
87	\| 状态 \| 判断条件 \|
88	\|------\|----------\|
89	\| ✅ 正常 \| 页面包含商品标题、图片、价格等核心元素 \|
90	\| ❌ 异常 \| 出现狗狗页面（Dog page）、404、"Looking for something?"、"Currently unavailable"、验证码页面 \|
91
92	常见异常场景：
93	- ASIN 被下架 → 狗狗页面或 "Currently unavailable"
94	- ASIN 被合并到其他变体 → 自动跳转
95	- 区域限制 → "This item does not ship to your location"
96
97	### 3.2 价格与优惠
98
99	检查内容：当前售价、划线价、折扣、优惠券。
100
101	\| 状态 \| 判断条件 \|
102	\|------\|----------\|
103	\| ✅ 正常 \| 有明确售价显示 \|
104	\| ⚠️ 需关注 \| 价格与预期差异较大（需用户判断） \|
105	\| ❌ 异常 \| 无价格显示、显示 "See price in cart"、或价格为 $0 \|
106
107	记录字段：
108	- 当前售价
109	- 划线价（List Price / Was Price）
110	- 折扣百分比
111	- 优惠券（Coupon）金额或百分比
112	- 是否有"Subscribe & Save"折扣
113
114	### 3.3 卖家信息（Buy Box）
115
116	检查内容：Sold by 和 Ships from 信息。
117
118	\| 状态 \| 判断条件 \|
119	\|------\|----------\|
120	\| ✅ 正常 \| Sold by 显示为用户指定的卖家名称 \|
121	\| ❌ 异常 \| Sold by 不是指定卖家（Buy Box 被抢） \|
122	\| ⚠️ 需关注 \| 用户未指定卖家，仅记录当前信息 \|
123
124	记录字段：
125	- Sold by：卖家名称
126	- Ships from：发货方（Amazon / 卖家名 / 第三方）
127	- 是否为 FBA（Ships from Amazon）
128
129	### 3.4 购物车状态
130
131	检查内容：是否有 Add to Cart / Buy Now 按钮。
132
133	\| 状态 \| 判断条件 \|
134	\|------\|----------\|
135	\| ✅ 正常 \| 同时显示 Add to Cart 和 Buy Now \|
136	\| ⚠️ 需关注 \| 只有 Add to Cart 没有 Buy Now，或显示 "See All Buying Options" \|
137	\| ❌ 异常 \| 无购买按钮，或显示 "Currently unavailable" \|
138
139	### 3.5 配送信息
140
141	检查内容：预计送达时间和 Prime 状态。
142
143	\| 状态 \| 判断条件 \|
144	\|------\|----------\|
145	\| ✅ 正常 \| 有明确的预计送达日期，且在 7 天以内 \|
146	\| ⚠️ 需关注 \| 配送时间 7-14 天 \|
147	\| ❌ 异常 \| 配送时间超过 14 天、或无配送信息 \|
148
149	记录字段：
150	- 预计送达日期
151	- 是否有 Prime 标识
152	- 配送费用（免费/具体金额）
153
154	### 3.6 类目与节点
155
156	检查内容：
157	1. 搜索栏旁的大类（department selector）
158	2. 面包屑导航中的销售节点路径（通常在主图上方）
159
160	\| 状态 \| 判断条件 \|
161	\|------\|----------\|
162	\| ✅ 正常 \| 能正常显示类目信息 \|
163	\| ⚠️ 需人工确认 \| 类目信息显示正常，但需人工确认是否为期望的节点 \|
164
165	记录字段：
166	- 搜索栏大类名称
167	- 面包屑完整路径（如 `Musical Instruments › Electronic Music, DJ & Karaoke › Karaoke Equipment › Systems › Portable Systems`）
168
169	> 注意：类目节点的"正确性"需要人工判断，技能只负责抓取和展示，不做自动判断。
170
171	### 3.7 BSR 排名
172
173	检查内容：Best Sellers Rank 在各层级类目中的排名。
174
175	\| 状态 \| 判断条件 \|
176	\|------\|----------\|
177	\| ✅ 正常 \| 有 BSR 排名数据 \|
178	\| ⚠️ 需关注 \| 排名显著下跌（需历史对比） \|
179	\| ❌ 异常 \| 无 BSR 排名（可能表示商品未正常入库或类目异常） \|
180
181	记录字段：
182	- 每个层级的类目名称 + 排名数字
183	- 示例：`#152 in Musical Instruments` → `#3 in Portable Karaoke Systems`
184
185	### 3.8 差评监控
186
187	检查内容：首页评论中的差评（1-3 星）数量和内容。
188
189	\| 状态 \| 判断条件 \|
190	\|------\|----------\|
191	\| ✅ 正常 \| 首页 0 条差评 \|
192	\| ⚠️ 需关注 \| 首页 1-2 条差评 \|
193	\| ❌ 异常 \| 首页 3 条及以上差评 \|
194
195	记录字段：
196	- 总评分（星级）
197	- 总评论数
198	- 首页差评条数
199	- 每条差评的：星级、标题、简要内容、日期
200	- 差评趋势判断：首次检查标注「首次检查，无历史对比基线」；有历史报告时对比差评数变化
201
202	### 3.9 搜索可见性
203
204	检查内容：用核心关键词搜索后，商品是否出现在搜索结果首页。
205
206	\| 状态 \| 判断条件 \|
207	\|------\|----------\|
208	\| ✅ 正常 \| 在首页自然位找到 \|
209	\| ⚠️ 需关注 \| 仅在广告位找到，自然位未找到 \|
210	\| ❌ 异常 \| 首页完全未找到（可能被压制或搜索不可见） \|
211
212	关键操作：
213	- 搜索时确保选择 "All Departments"，不要被限定在某个子类目
214	- 区分自然位（Organic）和广告位（Sponsored）
215	- 记录具体位置编号
216
217	---
218
219	## 4. 执行步骤（详细）
220
221	### Step 1：参数解析与准备
222
223	1. 从用户输入中提取 ASIN、站点代码、卖家名称、核心关键词
224	2. 验证 ASIN 格式（10 位字母数字）
225	3. 根据站点代码查找域名和默认邮编
226	4. 如果用户未提供站点代码，默认使用 US
227	5. 构建商品页面 URL：`https://{domain}/dp/{ASIN}`
228
229	### Step 2：抓取商品页面
230
231	运行 `fetch_amazon_page.py` 脚本抓取商品页面并提取结构化数据：
232
233	```bash
234	python3 skill

People who liked this also viewed

6 picks

Type