linkfox-amazon-reviews-list
按 ASIN 获取并分析亚马逊商品买家评论,覆盖含美国站在内的 15 个站点,支持星级、关键词、认证购买和图片视频筛选,以及按时间或有用程度排序。适用于差评痛点、好评卖点、Vine 评论、竞品评论研究和产品改良建议;不适用于搜索量与关键词排名、销量与市场规模估算、Listing 或 A+ 创作、广告策略及定价利润分析。
SKILL.mdskills/linkfox-amazon-reviews-list/SKILL.md
GitHub亚马逊商品评论获取与分析
适用范围
适用
读取指定 ASIN 的真实买家评论,提炼情感、反复出现的问题、受认可的功能及可执行的改良方向。用户未明确说“评论”,但竞品或产品研究的实际需求是分析买家反馈时,也使用本技能。
场景速查
| 用户表达 | 查询场景 |
|---|---|
| 看这个 ASIN 的评论,或查美国站评论 | 商品与指定站点评论查询。 |
| 买家主要抱怨什么,差评有哪些共性 | 差评主题与痛点提炼。 |
| 只看一星评论,或看看用户喜欢什么 | 星级筛选、好评卖点分析。 |
| 找提到 battery 的评论 | 关键词筛选。 |
| 看带照片或视频的评论 | 媒体评论筛选。 |
| 只看认证购买,区分 Vine 评论 | 购买认证筛选与评论标签识别。 |
| 分析竞品反馈,给出产品改良建议 | 基于实际评论形成行动建议。 |
边界
本技能聚焦指定商品的买家评论;ABA 搜索词与关键词研究、搜索量和排名、销量销售额及市场容量研究应使用对应数据技能。Listing 文案、A+ 内容、广告策略、定价和利润计算不在本技能范围。
接口清单
| 接口 | 端点 | 对应脚本 | 说明 |
|---|---|---|---|
| 异步提交评论任务 | POST /amazon/reviews/async/submit |
scripts/amazon_reviews.py |
首次使用商品参数提交,立即返回任务标记。 |
| 异步查询评论任务 | POST /amazon/reviews/async/result |
scripts/amazon_reviews.py |
使用原参数恢复任务或传入 taskId,单次查询。 |
前置条件
先确定用户的目标 ASIN、站点和评论分析目标;站点不明确时先确认,不把查询站点当作全部评论的来源国家。筛选条件和数量约定见 references/api.md。
异步调用流程
- 首次运行脚本仅提交一次并立即返回任务标记,保留 taskId;任务仍在运行或单次查询失败时,不重新提交。供应商由后端选择,约定见
references/api.md。 - 优先继续用户任务中的其他独立工作;需要结果时,用原参数恢复任务,或传入 taskId。每次运行仅查询一次并立即返回,脚本不循环、不休眠。按返回的经验时间提示安排下次查询,不忙轮询;观察窗口与间隔见接口文档。
- 任务成功后读取评论结果;失败时说明原因并停止;自动取消时友好说明资源等待情况及费用结论。失败或取消后保留原任务关联,仅在用户明确要求重试后重新提交。具体状态、生命周期及重试约定见
references/api.md。 - 超过观察窗口时停止自动查询,让用户决定继续查询同一个任务或停止。查询提示任务不存在或已过期时停止,只有用户明确要求重试才重新提交。
- 再次运行若提示结果已领取,读取已保存的结果文件。文件丢失时提示用户查找既有文件或输出,不自动重新抓取。缓存恢复、终态领取及兼容缓存处理规则见
references/api.md。 - 任务费用由后端在上游处理结束后独立结算,与是否查询或领取无关。单次提交或查询显示零消耗不代表任务免费;实际消耗以消费记录为准,不按预计公式补记。
执行方式
- 直接调用接口:接口端点、完整参数、响应和错误码见
references/api.md。 - 脚本调用(推荐):
python scripts/amazon_reviews.py '<JSON 参数>' [--inline] [--no-cache]。 - 成本约束:本工具会消耗算力。同一会话、同一参数组合默认只调用一次,脚本提供 24 小时本地缓存。失败或空结果时,不得自动更换关键词、翻页或修改邮编连续试探;需要继续检索时,先向用户说明额外消耗。
输出策略
- 始终保存完整响应,目标路径为
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-amazon-reviews-list-<timestamp>.json。<cwd>为脚本运行时的工作目录,<session>优先取环境变量SESSION_ID,用于聚合同一任务的数据。禁止写入/tmp,当前目录不可写时应报错。 - 响应体不超过 8 KB:保存后,将完整 JSON 打印到标准输出。
- 响应体超过 8 KB:保存后,标准输出仅展示摘要,包括顶层字段、常见计数及费用字段(如
total、costToken)、最大列表字段的长度和前 3 条样本。 - 添加
--inline可强制全量打印到标准输出,同时仍保存文件。
先通过摘要判断数据是否足够。需要具体字段时,优先使用 jq 或 ConvertFrom-Json 从保存的 JSON 文件按需提取,避免将整份响应载入上下文。
执行规则
算力消耗预估
按计划抓取页数动态计费。设 P = Σ min(ceil(各星级请求评论数 / 10), 10),则:
- 计费 Token:
21000 × P。 - 预估消耗算力 =
ceil((21000 × P) / 2000) = ceil(10.5 × P),按每次请求分别向上取整。 - 未传任何星级数量时,1~5 星默认各抓取 10 条,
P = 5,预估53算力。 - 传入任意星级数量后,未传星级按
0;五个星级均显式传0时,P = 0,不调用供应商且消耗0算力 (限时)。 - 请求成功但结果为空,或经关键词、认证购买、媒体筛选后为空,仍按计划页数计费;部分子任务失败但整体成功时仍按全部计划页数计费;上游调用完全失败不计费 (限时)。
常见消耗:1 页 11 算力,2 页 21 算力,5 页 53 算力,10 页 105 算力。
重要:费用按请求的抓取页数计算,而不是按最终返回评论数计算。请求多个星级或大量评论前必须向用户说明预计页数和算力消耗。
上述公式只用于调用前预估,实际是否扣费及金额以消费记录为准。费用由后端独立结算,领取结果不重复扣费;未领取、查询失败或本地观察超时不代表任务免费,不得据此报告零消耗或按预估值计为已消耗。
声明:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。
用户会因算力消耗而支付费用。需要高频调用或用户对消耗量预期不足时,提醒用户,并由用户决定是否继续。
解决认证和算力问题
出现以下情况时,按 references/onboarding.md 的指引处理:
- 未配置接口密钥:
LINKFOX_AGENT_API_KEY和LINKFOXAGENT_API_KEY均为空。 - HTTP 状态码为
401或402。 - 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。
约束与建议
- 评论概念:展示真实买家反馈,并区分商品整体评分与本次取得的评论样本。接口范围和使用限制见
references/api.md。 - 按星级展示:按星级展示评分、标题、正文、日期、认证购买状态和有用数量;评论较多时,先归纳主题和痛点,再列举具体评论。
- 形成行动建议:指出差评中重复出现的问题和好评中受到认可的功能;改良建议应有返回评论支撑。
- 保留标签与媒体信息:明确标注 Vine Voice、认证购买以及图片或视频;评论正文保持买家发布时的语言,需要时另附中文解读。
- 统一展示格式:响应中评分和有用数量采用站点本地文本时,为便于比较统一展示格式,同时保留其原始含义。
- 区分查询站点和评论来源:用 reviewCountry 识别单条评论国家;Canada、Canadá 等本地化名称合并统计。缺失时标为未知,不从 domainCode 或 locale.country 推断。
- 解释异常:依据返回消息解释失败原因,必要时给出核对或调整条件的建议;后续调用仍遵守成本约束和同任务恢复规则。
使用示例
美国站评论
{"asin":"B08N5WRWNW","domainCode":"com","star1Num":10,"star2Num":10,"star3Num":10,"star4Num":10,"star5Num":10,"sortBy":"recent"}
德国站含 quality 的认证购买差评
{"asin":"B08N5WRWNW","domainCode":"de","star1Num":30,"star2Num":30,"filterByKeyword":"quality","reviewerType":"avp_only_reviews"}
日本站带媒体的五星好评
{"asin":"B08N5WRWNW","domainCode":"co.jp","star5Num":50,"star1Num":0,"star2Num":0,"star3Num":0,"star4Num":0,"sortBy":"helpful","mediaType":"media_reviews_only"}
只获取三星评论
{"asin":"B0FP5C63HZ","domainCode":"com","star3Num":100}
查询已有任务
{"taskId":"提交返回的任务ID"}
使用反馈
当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 references/api.md#Feedback 的指引反馈,不要打断用户当前流程。
更多优质、专业的跨境电商技能,请访问 LinkFox Skill。