amazon-research

Amazon 商品研究

通过 Crawlora API 查询和搜索 Amazon 商品——获取价格、库存情况、概览数据、内嵌评论和搜索建议，并全部以规范化 JSON 格式返回，无需抓取 HTML。

何时使用此技能

• “X 在 Amazon 上卖多少钱？”／“在 Amazon 上找这个商品。”
• “在 Amazon 上搜索 X”，并返回候选商品列表。
• “查询此 ASIN”／“获取 B0XXXXXXX 的价格和库存情况。”
• “Amazon 针对此关键词的自动补全建议是什么？”
• 仅针对 Amazon 的竞品定价或商品目录研究。

设置（仅需一次）

• 在 https://crawlora.net 获取免费的 Crawlora API 密钥（每月 2,000 个点数，无需信用卡）。
• 运行辅助脚本前，在环境中设置 CRAWLORA_API_KEY。
• 辅助脚本会从环境中读取 CRAWLORA_API_KEY，并向 https://api.crawlora.net/api/v1 发送请求。密钥缺失或无效时会返回 401。

工作原理

1. 搜索 — 使用关键词 (k) 调用 /amazon/search 查找候选商品；使用 page 分页，使用 s 排序。
2. 详情 — 调用 /amazon/product/{asin} 获取特定商品的价格、库存情况、概览数据、内嵌评论样本和描述内容；可选按 currency／language 限定。
3. 建议 — 调用 /amazon/suggest/{keyword} 获取 Amazon 自带的输入联想关键词建议，可在完整搜索前用于发现相关搜索词。

完整的端点列表、方法和参数：reference/endpoints.md。

调用 API

# Search Amazon (GET, key=value params):
scripts/crawlora.sh /amazon/search k="standing desk" | jq '.'

# Product detail (ASIN is a path param):
scripts/crawlora.sh /amazon/product/B0XXXXXXX | jq '.data'

# Search suggestions (keyword is a path param):
scripts/crawlora.sh /amazon/suggest/standing | jq '.'

所有请求均使用 scripts/crawlora.sh；它可避免将 API 密钥暴露在命令行参数中。

端点参考

参阅 reference/endpoints.md，查看此技能使用的所有 Amazon 端点（方法、路径、参数和说明）。

示例

• 按 ASIN 查询价格： 调用 /amazon/product/{asin}，并从响应中读取 price／availability。
• 从关键词到商品列表的流程： 调用 /amazon/suggest/{keyword}，将宽泛的查询扩展为 Amazon 自带的建议词，然后对最佳关键词调用 /amazon/search，收集候选商品列表。
• 商品目录扫描： 使用 page 对某个关键词调用 /amazon/search 并分页，从每个结果中收集 asin + price，以生成价格快照。

注意事项和限制

• 点数／成功后计费： 仅在返回 2xx 时计费；免费套餐每月提供 2,000 个点数。密钥可在 https://crawlora.net 获取。
• 仅限公开数据 — 仅限 Amazon 公开的商品／商品列表页面；请遵守 Amazon 的条款。
• 安全性： 密钥仅存放在 CRAWLORA_API_KEY 中——切勿将其硬编码、作为查询参数传递或提交到代码库。
• 结果采用分页形式 — 在 /amazon/search 上传入 page 以遍历商品列表。
• asin 和 keyword 是路径参数（会替换到 URL 中），而非查询参数 — 将它们作为路径的最后一段传入，例如 /amazon/product/B0XXXXXXX，而不是 asin=B0XXXXXXX。
• 所有端点均仅针对 amazon.com。