samsclub-research

用途：通过 Crawlora API 以规范化 JSON 查询 Sam's Club 的公开目录数据，用于浏览部门分类、查看分类商品、获取商品详情及相关商品，以及读取精选落地页。需先设置环境变量 CRAWLORA_API_KEY，键值从 https://crawlora.net 获取并仅在环境中保存，缺失或无效返回 401。主要端点：/samsclub/departments 返回顶级部门及其子分类链接，链接类型为 browse（对应分类）或 cp（对应内容页）；/samsclub/category 以 id 和 page 分页返回分类商品网格，含名称、品牌、价格、库存、评分、图片；/samsclub/product/{id} 返回商品详情，含名称、品牌、描述、面包屑、价格、库存、图片、评分与评论数、商品号；/samsclub/product/{id}/related 返回相关商品货架；/samsclub/content/{id} 返回精选页面的标题、面包屑、商品货架和分类导航磁贴。调用示例：scripts/crawlora.sh /samsclub/departments | jq '.'；scripts/crawlora.sh /samsclub/category id=980029 page=1 | jq '.'；scripts/crawlora.sh /samsclub/product/prod20355602 | jq '.data'；scripts/crawlora.sh /samsclub/product/prod20355602/related | jq '.'。限制：仅公开页面数据，需遵守 Sam's Club 条款；按成功计费，2xx 才扣积分，免费额度每月 2000 积分；无全文搜索端点，发现仅基于部门/分类；/samsclub/category 的 id 为查询参数，其余三个端点为路径参数；未知 id 行为不同，未知分类 id 返回零结果页，未知内容 id 返回 404，未知相关商品 id 返回通用兜底货架；内容页无分页。完整端点见 reference/endpoints.md。