SuperAPI AI 工具集

hm-research

写作与研究

查看项目

更新于 10-15 20:29

技能介绍

用途:通过 Crawlora API 查询 H&M 公开商品与门店数据,返回规范化 JSON,无需自行抓取 HTML。适用于查询某商品价格、浏览某部门分类、关键词搜索、获取商品颜色/尺码/评价,以及查找附近实体门店。

主要能力:/hm/categories 返回 H&M 门店导航分类,可按 department 过滤,仅部分条目带有已验证的 category_id;/hm/listing 按 category_id(如 ladies_newarrivals_all)列出商品;/hm/search 按 query 自由文本搜索;两者均返回含价格、图片、颜色和各尺码库存的规范化商品,支持 page/page_size 分页;/hm/product/{product_id} 获取每个可购颜色的各尺码价格与库存,以及聚合评分和带合身反馈标签(如 True to Size)的真实评价;/hm/stores 按 zip/地点或经纬度查找附近门店,可设 radius_meters。

使用方式:先在 https://crawlora.net 获取免费 Crawlora API key(每月 2000 credits,无需信用卡),将 CRAWLORA_API_KEY 设置到环境变量,请求发往 https://api.crawlora.net/api/v1,缺失或无效密钥返回 401。所有请求通过 scripts/crawlora.sh 发起,以避免密钥出现在命令行参数中。示例:scripts/crawlora.sh /hm/listing category_id=ladies_newarrivals_all page=1 | jq '.';scripts/crawlora.sh /hm/search query="linen shirt" | jq '.';scripts/crawlora.sh /hm/product/1234567 | jq '.data';scripts/crawlora.sh /hm/stores search="98101" radius_meters=15000 | jq '.'。完整端点、方法与参数见 reference/endpoints.md。

限制:仅限公开数据,需遵守 H&M 条款;按成功计费,仅 2xx 计费,免费额度每月 2000 credits;密钥只存于 CRAWLORA_API_KEY,切勿硬编码、放入查询参数或提交;无分类树查询端点,/hm/listing 的 category_id 来自已知 H&M 门店 slug,/hm/categories 仅对已确认的子集暴露 category_id;颜色/尺码/评价仅来自商品详情,列表与搜索只含一个代表价格和每色库存数;分页请求超出末页返回空 products 数组而非错误。