用途:在 Zalando 上查询和比较产品、分类与搜索结果,全部以 Crawlora API 返回的规范化 JSON 呈现,无需自行抓取 HTML。适用于“某商品在 Zalando 多少钱”“在德国站找某商品”“按 SKU 查产品”“补全搜索词”“有哪些国家站点”等场景,以及限定 Zalando 的竞品定价与目录研究。
主要能力:/zalando/markets 列出可用国家站点代码;/zalando/search(q+market)按关键词搜索,返回含价格、品牌、图片的结果卡片及 total_count;/zalando/suggest(q+market)补全部分搜索词;/zalando/product(sku+market)获取品牌、描述、图片及按尺码的价格、库存、GTIN;/zalando/category(category+market)按站点专属 URL slug 浏览分类或品牌列表。
使用方式:先在 https://crawlora.net 获取免费 Crawlora API key(每月 2000 credits,无需信用卡),将 CRAWLORA_API_KEY 设置到环境变量,helper 会读取该变量并向 https://api.crawlora.net/api/v1 发请求,缺失或无效 key 返回 401。所有请求通过 scripts/crawlora.sh 发起,以避免 key 出现在命令行参数中。示例:scripts/crawlora.sh /zalando/markets | jq '.';scripts/crawlora.sh /zalando/search q="running shoes" market=de | jq '.';scripts/crawlora.sh /zalando/product sku=AD116A0FL-Q11 market=de | jq '.data';scripts/crawlora.sh /zalando/category category=shoes market=de | jq '.';scripts/crawlora.sh /zalando/suggest q="running sho" market=de | jq '.'。完整端点、方法与参数见 reference/endpoints.md。
限制:每个 Zalando 端点都必须提供 market(如 de、fr、com),无默认值,不确定时先用 /zalando/markets 查询;sku 通常只在被发现的市场有售,搜索/分类与产品详情调用需保持 market 一致;分类 slug 因市场而异,应取自该市场自身导航或产品的 url 字段;/zalando/search 与 /zalando/category 仅返回第一页,暂不支持更深分页。计费按成功计费,仅 2xx 计费,免费额度每月 2000 credits。仅限公开数据,需遵守 Zalando 条款;key 只存于 CRAWLORA_API_KEY,切勿硬编码、放入查询参数或提交到仓库。