Documentation
README
前置建议
本公开版 Skill 是自包含的,不依赖任何私有工作区文件、内部参考库或品牌专属协议。
开始执行前,建议先通读本 Skill 自身的方法论部分,重点关注:
- 页面可访问性判断
- Buy Box / Add to Cart / 配送状态的异常标准
- 搜索可见性验证逻辑
如果你已经有自己的 Listing 诊断框架,可以作为补充背景使用;但本 Skill 的执行不依赖外部私有资料。
Listing 健康检查器 — 完整方法论
1. 技能定位
核心理念
通过 curl + BeautifulSoup 抓取亚马逊服务端渲染的 HTML,不借助任何 API 或第三方数据工具。
原因:我们要验证的是"消费者打开亚马逊能看到什么"。任何 API 返回的数据都可能与前台页面不一致(缓存、区域差异、权限差异)。这个技能的价值就在于所见即所得。
亚马逊商品页面的核心数据(标题、价格、卖家、BSR、评论等)全部在服务端渲染的 HTML 中,无需 JavaScript 执行。curl 配合正确的浏览器 Headers 可稳定获取完整页面(~2.4MB HTML)。
Script Directory
脚本位于 skills/zach-listing-health-checker/scripts/:
- browser_utils.py — 通用网页抓取模块(curl 封装、站点配置、反爬检测),其他 Skill 可复用
- fetch_amazon_page.py — 商品页面抓取,提取 9 项检查数据,输出 JSON
- fetch_amazon_search.py — 搜索结果页抓取,检查 ASIN 搜索可见性,输出 JSON
工作流位置
This is the opening of the README. Read the full README on GitHub.