用途:在 amazon.com 上研究商品、价格、库存与搜索建议,通过 Crawlora API 返回规范化 JSON,无需自行抓取 HTML。适用于“某商品在 Amazon 多少钱”“搜索某关键词”“查询某 ASIN 的价格与库存”“Amazon 自动补全建议”以及 Amazon 范围内的竞品定价与目录调研。
主要能力:搜索接口 /amazon/search 用关键词 k 查找候选商品,支持 page 分页与 s 排序;详情接口 /amazon/product/{asin} 获取指定商品的价格、库存、概览数据、内嵌评论样本与描述内容,可按货币/语言限定;建议接口 /amazon/suggest/{keyword} 返回 Amazon 自身的输入联想关键词,便于先扩展搜索词再执行完整搜索。
使用方式:先在 https://crawlora.net 获取免费 Crawlora API 密钥(每月 2000 积分,无需信用卡),将 CRAWLORA_API_KEY 设置到环境变量后再运行辅助脚本。脚本从环境变量读取密钥并请求 https://api.crawlora.net/api/v1,密钥缺失或无效会返回 401。示例:scripts/crawlora.sh /amazon/search k="standing desk" | jq '.';scripts/crawlora.sh /amazon/product/B0XXXXXXX | jq '.data';scripts/crawlora.sh /amazon/suggest/standing | jq '.'。所有请求建议统一使用 scripts/crawlora.sh,以避免密钥出现在命令行参数中。
限制与注意:仅面向 amazon.com;仅使用公开商品/列表页面,需遵守 Amazon 条款。按成功计费,仅 2xx 计费,免费额度每月 2000 积分。结果分页,需在 /amazon/search 传 page 遍历列表。asin 与 keyword 是路径参数而非查询参数,应作为 URL 最后一段传入,例如 /amazon/product/B0XXXXXXX,而非 asin=B0XXXXXXX。密钥只存放于 CRAWLORA_API_KEY,切勿硬编码、放入查询参数或提交到仓库。完整端点、方法与参数见 reference/endpoints.md。