SuperAPI AI 工具集

macys-research

写作与研究

查看项目

更新于 10-15 20:29

技能介绍

用途:按已知的数字 productId 查询 Macy's 商品完整详情与顾客评论,并获取 Macy's 搜索框(typeahead)联想词,结果均为 Crawlora API 返回的规范化 JSON,无需 HTML 抓取。不覆盖搜索或分类浏览,只能从已知 productId 出发。

主要能力:详情接口 /macys/product/{productId} 返回名称、品牌、描述、部门/分部、分类面包屑、价格(含促销识别)、库存、图片、综合评分,以及每个可购买颜色变体及其价格。评论接口 /macys/product/reviews(参数 product_id、page 分页)返回一页规范化顾客评论及站点级评分摘要(数量、平均分、推荐比例、直方图)。联想接口 /macys/suggest(参数 query)返回 Macy's 自身搜索框的联想短语,为纯字符串列表,不含商品数据。

使用方式:先在 https://crawlora.net 获取免费 Crawlora API 密钥(每月 2,000 积分,无需信用卡),将 CRAWLORA_API_KEY 设置到环境变量;helper 从环境变量读取密钥并请求 https://api.crawlora.net/api/v1,缺失或无效密钥返回 401。productId 取自 macys.com 商品页 ?ID= 查询参数。示例:scripts/crawlora.sh /macys/product/12345678 | jq '.data';scripts/crawlora.sh /macys/product/reviews product_id=12345678 page=1 | jq '.';scripts/crawlora.sh /macys/suggest query="winter coat" | jq '.'。所有请求均通过 scripts/crawlora.sh,避免密钥出现在命令行参数中。

适用场景:已知商品做价格/描述/变体尽调,再拉取评论总结顾客反馈;用联想词发现相关搜索词作为上下文。

限制:无搜索或分类浏览端点,必须已有数字 productId;/macys/suggest 只返回联想短语,不能替代搜索。仅公开数据,需遵守 Macy's 条款。计费按成功(2xx)计,免费额度每月 2,000 积分。密钥仅存于 CRAWLORA_API_KEY,切勿硬编码、放入查询参数或提交。评论 product_id 与详情 productId 为同一数字 id;零评论或格式正确但未识别的 id 返回正常空结果而非错误;评论分页从 1 开始,默认第 1 页。