linkfox-amazon-reviews-list

按 ASIN 获取并分析亚马逊商品买家评论,覆盖含美国站在内的 15 个站点,支持星级、关键词、认证购买和图片视频筛选,以及按时间或有用程度排序。适用于差评痛点、好评卖点、Vine 评论、竞品评论研究和产品改良建议;不适用于搜索量与关键词排名、销量与市场规模估算、Listing 或 A+ 创作、广告策略及定价利润分析。

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。

异步调用流程

  1. 首次运行脚本仅提交一次并立即返回任务标记,保留 taskId;任务仍在运行或单次查询失败时,不重新提交。供应商由后端选择,约定见 references/api.md。
  2. 优先继续用户任务中的其他独立工作;需要结果时,用原参数恢复任务,或传入 taskId。每次运行仅查询一次并立即返回,脚本不循环、不休眠。按返回的经验时间提示安排下次查询,不忙轮询;观察窗口与间隔见接口文档。
  3. 任务成功后读取评论结果;失败时说明原因并停止;自动取消时友好说明资源等待情况及费用结论。失败或取消后保留原任务关联,仅在用户明确要求重试后重新提交。具体状态、生命周期及重试约定见 references/api.md。
  4. 超过观察窗口时停止自动查询,让用户决定继续查询同一个任务或停止。查询提示任务不存在或已过期时停止,只有用户明确要求重试才重新提交。
  5. 再次运行若提示结果已领取,读取已保存的结果文件。文件丢失时提示用户查找既有文件或输出,不自动重新抓取。缓存恢复、终态领取及兼容缓存处理规则见 references/api.md。
  6. 任务费用由后端在上游处理结束后独立结算,与是否查询或领取无关。单次提交或查询显示零消耗不代表任务免费;实际消耗以消费记录为准,不按预计公式补记。

执行方式

  • 直接调用接口:接口端点、完整参数、响应和错误码见 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。