SuperAPI AI 工具集

ulta-research

通用与其它

查看项目

更新于 10-16 09:54

技能介绍

用途:借助 Crawlora API 浏览和搜索 Ulta Beauty 的商品目录,获取商品详情、色号/规格变体、顾客问答、评论以及附近实体门店位置,结果均为规范化 JSON,无需自行抓取 HTML。

主要能力:

  • 分类发现:/ulta/categories 返回店铺导航,含 department、group 及可传给 /ulta/category 的 category 值。
  • 浏览与搜索:/ulta/category 按 category 分页返回商品网格及筛选 facet 码;/ulta/search 做关键词搜索;/ulta/suggest 返回输入联想及每个建议的顶部商品匹配。
  • 商品详情:/ulta/product/{productId} 返回名称、品牌、描述、价格、评分及所有可购买颜色/色号变体,可用 sku 锁定特定色号。
  • 问答与评论:/ulta/product/questions 和 /ulta/product/reviews 以 product_id 为键,分页返回顾客问答与评论及评分摘要。
  • 附近门店:/ulta/stores 用搜索串(邮编、城市、地址)或显式 lat/lng 解析附近 Ulta 门店,含营业时间、服务与电话。

使用方式:先在 https://crawlora.net 获取免费 Crawlora API 密钥(每月 2,000 积分,无需信用卡),将 CRAWLORA_API_KEY 设置到环境变量后再运行辅助脚本。脚本从环境读取密钥并向 https://api.crawlora.net/api/v1 发送请求;密钥缺失或无效返回 401。所有请求通过 scripts/crawlora.sh 发起,以让密钥不出现在命令行参数中。

示例:

关键词搜索:

scripts/crawlora.sh /ulta/search query="vitamin c serum" | jq '.'

筛选浏览分类:

scripts/crawlora.sh /ulta/category category="shop/skin-care/serums" filter="BENEFIT--BRIGHTENING" | jq '.'

特定色号的商品详情:

scripts/crawlora.sh /ulta/product/pimprod2020260 sku=2540468 | jq '.data'

附近门店:

scripts/crawlora.sh /ulta/stores search="60614" | jq '.'

限制:仅使用公开数据(公开的 Ulta Beauty 商品/分类/门店页面),需遵守 Ulta 条款。计费按成功结果(仅 2xx 计费),免费层每月 2,000 积分。结果为分页返回,需传 page(从 1 开始)遍历分类、搜索、问答与评论列表。商品标识为 product_id(即 productId,来自搜索结果字段或商品 URL),/ulta/product/{productId}、/ulta/product/questions、/ulta/product/reviews 均以其为键;sku 可选,仅将商品详情收窄到某一色号/颜色变体。/ulta/stores 需提供 search,或同时提供 lat 与 lng;无法解析的搜索或空半径返回结构良好的空结果而非报错,/ulta/search 与 /ulta/suggest 的无意义查询同理。product_id 无法识别时,/ulta/product/questions 与 /ulta/product/reviews 返回空结果;/ulta/category 的无法识别分类返回 404。安全上密钥仅存于 CRAWLORA_API_KEY,切勿硬编码、放入查询参数或提交到代码库。