用途：通过 Crawlora API 查询与比较 Costco 商品、分类、配送可用性、附近仓库和评论，结果均为规范化 JSON，无需 HTML 抓取。
主要能力：分类浏览（/costco/categories 返回分类 slug 与商品数量，可按关键词过滤，slug 可直接用作搜索的分类过滤）；商品搜索（/costco/search 按关键词和/或分类 slug 返回标题、品牌、型号、图片、评分）；商品详情（/costco/product/{id} 返回标题、描述、厂商、图片、价格、库存状态、评分）；库存与配送（/costco/product/{id}/availability 按 postal_code + state 返回库存与预计配送）；评论（/costco/product/{id}/reviews 返回标题、正文、评分、作者、是否推荐）；附近仓库（/costco/warehouses 按经纬度返回并按距离排序）。
使用方式：在 https://crawlora.net 获取免费 Crawlora API Key（每月 2000 积分，无需信用卡），设置环境变量 CRAWLORA_API_KEY 后再运行辅助脚本；请求发送至 https://api.crawlora.net/api/v1，缺失或无效 Key 返回 401。示例命令：scripts/crawlora.sh /costco/search query="robot vacuum" | jq '.'；scripts/crawlora.sh /costco/product/1234567/availability postal_code=98101 state=WA | jq '.'。建议统一用 scripts/crawlora.sh 发请求，以避免 API Key 出现在命令行参数中。
适用场景：仓库库存核查（先搜索拿 id，再查可用性）；分类比价（先解析分类 slug，再按分类搜索比较价格与评分）；购买前尽调（查价格、库存状态并汇总近期评分与推荐）；查找最近门店。
限制：积分按成功计费（仅 2xx 计费），免费额度每月 2000 积分；仅针对公开 Costco 页面数据，需遵守 Costco 条款；Key 仅存于 CRAWLORA_API_KEY，切勿硬编码、作为查询参数或提交；可用性查询仅限美国，需美国邮编与两字母州代码，无美国以外配送查询；/costco/warehouses 需要经纬度，不能使用自由文本地址或邮编，只有地名时需先地理编码。完整端点、方法与参数见 reference/endpoints.md。