SuperAPI AI 工具集

kohls-research

写作与研究

查看项目

更新于 10-15 20:29

技能介绍

用途:该技能用于研究 Kohl's 公开目录数据,包括按分类浏览商品(含价格、评分与分面)、按 web_id 拉取某商品评论、查找附近门店,以及获取搜索框联想词,全部以规范化 JSON 返回,无需 HTML 抓取。

主要能力:/kohls/category 返回某分类或活动页的商品网格(仅第 1 页)及用于发现更多分类值的分面;/kohls/product/reviews 按 web_id 拉取评论(标题、正文、评分、次级评分、评论者、日期、照片,每页 10 条);/kohls/stores 按城市/州、邮编或地址查找附近门店(地址、电话、营业时间、距离、服务标签);/kohls/suggest 返回搜索框联想短语。

使用方式:先在 https://crawlora.net 获取免费 Crawlora API 密钥(每月 2000 积分,无需信用卡),将 CRAWLORA_API_KEY 设置到环境变量,请求发往 https://api.crawlora.net/api/v1。使用 scripts/crawlora.sh 发起请求,避免密钥出现在命令行参数中。分类参数为 Kohl's 自身分类字符串,如 "Room:Dorm" 或 "Department:Kitchen & Dining";组合多个维度用字面 +,并百分号编码为 %2B,例如 "Room%3ADorm%2BDepartment%3ABedding"。可从已知分类出发,跟随 facets[].options[].category 值枚举相关分类。

限制:仅公开数据,需遵守 Kohl's 条款;密钥只存于 CRAWLORA_API_KEY,不得硬编码、作为查询参数或提交。无全文商品搜索或单品查询,商品发现只能通过分类浏览与联想词,自由文本需先解析为分类字符串;/kohls/category 仅返回第 1 页,无分页参数;评论的 web_id 必须来自先前 /kohls/category 响应的 products[].web_id,无法用商品名或 URL 直接查评论。计费按成功(2xx)计,缺失或无效密钥返回 401。