用途:以规范化 JSON 调用 Crawlora API 研究 Wayfair 商品数据,浏览其分类体系、列出某分类商品网格,并获取商品完整详情,无需自行抓取 HTML。位于 crawlora-org/crawlora-skills 仓库,页面地址 https://www.skills.sh/crawlora-org/crawlora-skills/wayfair-research。
主要能力:/wayfair/categories 列出从 Wayfair 站点地图发现的分类,支持分页(page、page_size)和 q 过滤;/wayfair/category 按 category 返回商品网格(含名称、品牌、价格、图片),支持 page 翻页;/wayfair/product/{id} 返回商品详情,包括名称、品牌、价格、库存状态、1-5 星聚合评分、图片、可选变体(颜色、饰面等)及站点特征亮点。id 为商品自身的 W 前缀 ID(如 W100794312),未知 ID 返回 404。
使用方式:需一次性获取 Crawlora 免费 API key(每月 2000 credits,无需信用卡,https://crawlora.net),并将 CRAWLORA_API_KEY 设置为环境变量;helper 会从环境变量读取该 key,请求发送至 https://api.crawlora.net/api/v1,缺失或无效 key 返回 401。示例:scripts/crawlora.sh /wayfair/categories q="office chairs" | jq '.';scripts/crawlora.sh /wayfair/category category=office-chairs-c478390 page=1 | jq '.';scripts/crawlora.sh /wayfair/product/W100794312 | jq '.data'。category 可接受裸 id、c 前缀 id、slug 或完整 wayfair.com 分类 URL,仅取末尾 id。所有请求建议经由 scripts/crawlora.sh,以避免 API key 出现在命令行参数中。
适用场景:按分类查找 department 的分类 id;浏览某分类下的商品;查询单个商品价格、评分、库存;对分类页每个 product_id 批量拉取价格、库存与评分明细。
限制:仅覆盖公开的 Wayfair 分类与商品页,需遵守 Wayfair 条款;采用按成功计费方式,仅 2xx 计费,免费层每月 2000 credits;结果分页,需传 page(分类还支持 page_size);无全文搜索与评论接口,发现只能走分类体系,仅提供聚合评分;商品标识为 W 前缀 id 而非 SKU;分类名由 URL slug 推导(首字母大写),非站点权威标签,仅供参考。