亚马逊 KeyAPI 数据工作流

解决什么问题

亚马逊数据查询常卡在“自然语言”与 REST 接口之间：业务方想要类目热销、卖家对比、评论与报价证据，但开发者要先找端点、确认参数、处理分页和响应包。keyapi-amazon 把这层翻译固定下来，先识别目标、实体、范围、指标和分页深度，再基于 KeyAPI 官方文档解析当前端点，最后通过脚本或宿主 HTTP 客户端执行请求。

如何工作

技能把请求收敛为几个决策字段：Goal、Entity、Scope、Metric or sort、Pagination depth、Output format。核心流程包括：

• 场景路由：从产品发现、类目热销、卖家画像、评论与报价、达人橱窗、ASIN/GTIN 转换等场景中选择最接近路径。
• 文档优先：用 docs.keyapi.ai/llms.txt 与端点页作为方法、/v1/... 路径、参数、枚举、分页、请求体和响应结构的真值来源。
• 受控执行：优先使用 scripts/keyapi-api.mjs 发起真实请求，检查 HTTP 状态和 code = 0 的业务响应。
• 可审计输出：把 API 观察事实与推断分开，输出简洁答案、表格、原始 JSON 或结构化报告。

适用边界

它适合依赖 KeyAPI 的亚马逊数据查询、排行、搜索、对比和报告，不适合绕开官方接口去爬网页，也不保证文档外端点可用。涉及大范围报告时，需要先确认板块和最大范围；缺少 KEYAPI_TOKEN 时应先完成本地配置。多端点任务要选“用户输入更少、过滤更强”的接口，避免临时拼接不可靠路径。