zalando-research

Zalando 研究

在 Zalando 上查找并比较商品、类别和搜索结果 — 全部通过 Crawlora API 获取标准化 JSON，无需抓取 HTML。

适用场景

• “Zalando 上 X 的价格是多少？”或“在 Zalando 德国站查找 X。”
• “在 Zalando 上搜索 X”／“Zalando 上的跑鞋类别里有哪些商品？”
• “按 SKU 查找这款 Zalando 商品。”
• “为这条 Zalando 搜索查询提供自动补全。”
• “有哪些 Zalando 国家站点可用？”
• 针对 Zalando 的竞争定价或商品目录研究。

设置（一次性）

• 获取免费的 Crawlora API 密钥（每月 2,000 个积分，无需银行卡）：https://crawlora.net。
• 运行辅助脚本前，在环境中设置 CRAWLORA_API_KEY。
• 辅助脚本会从环境中读取 CRAWLORA_API_KEY，并向 https://api.crawlora.net/api/v1 发送请求。缺少或无效的密钥会返回 401。

工作原理

1. 解析市场 — 所有其他 Zalando 端点都需要 market（例如 de、fr、com 这样的国家站点代码），且没有默认值。如果不确定使用哪个代码，请通过 /zalando/markets 列出可用代码。
2. 搜索 — 使用 /zalando/search（q+market）按关键词查找候选商品；返回包含价格、品牌和图片的标准化结果卡片，以及 total_count。仅提供第一页结果。
3. 自动补全 — 使用 /zalando/suggest（q+market）补全部分搜索词（例如“running sho” → “running shoes”），然后再进行搜索。
4. 商品详情 — 使用 /zalando/product（sku+market）获取某件商品的品牌、描述、图片，以及各尺码的价格／库存情况／GTIN；sku 可从搜索或类别结果中获取。
5. 浏览类别 — 使用 /zalando/category（category+market），按特定市场的 URL slug 浏览类别或品牌列表；返回与搜索相同的结果卡片，以及 total_count。

完整的端点列表、方法和参数：reference/endpoints.md。

调用 API

# Resolve storefronts, then search a market (GET, key=value params):
scripts/crawlora.sh /zalando/markets | jq '.'
scripts/crawlora.sh /zalando/search q="running shoes" market=de | jq '.'

# Product detail (sku from a search/category result, same market):
scripts/crawlora.sh /zalando/product sku=AD116A0FL-Q11 market=de | jq '.data'

# Browse a category, and autocomplete a partial query:
scripts/crawlora.sh /zalando/category category=shoes market=de | jq '.'
scripts/crawlora.sh /zalando/suggest q="running sho" market=de | jq '.'

所有请求都使用 scripts/crawlora.sh；它会避免将 API 密钥暴露在命令行参数中。

端点参考

有关此技能使用的所有 Zalando 端点（方法、路径、参数、说明），请参阅 reference/endpoints.md。

示例

• 按站点查询价格： 使用 /zalando/markets 确认正确的代码，然后在对应市场使用 /zalando/search 获取关键词的当前价格。
• 类别审查： 使用 /zalando/category 和特定市场的 slug（例如，de／gb 上的 shoes，fr 上的 chaussures）列出类别商品目录，并标记价格高于／低于指定阈值的商品。
• 从搜索到详情的逐步查询： 使用 /zalando/search 查找候选 SKU，然后对最佳匹配项调用 /zalando/product，获取完整的价格／尺码／库存情况。

注意事项与限制

• 积分／成功后计费： 仅对 2xx 响应计费；免费套餐每月提供 2,000 个积分。密钥获取地址：https://crawlora.net。
• 仅限公开数据 — 公开的商品／列表页面；请遵守 Zalando 的条款。
• 安全性： 密钥仅存放在 CRAWLORA_API_KEY 中 — 切勿将其硬编码、放入查询参数或提交到代码库。
• Zalando 始终需要 market（没有默认站点）— 如果不确定，请通过 /zalando/markets 确认有效代码。sku 通常仅在发现该商品的市场上有售，因此搜索／类别调用与商品详情调用中的 market 应保持一致。
• 类别 slug 因市场而异（每个站点都使用本地语言的 slug）— 请从该市场网站的导航或商品的 url 字段中获取，不要使用其他市场的 slug。
• /zalando/search 和 /zalando/category 仅返回第一页结果；目前不支持翻阅后续页面。