linkfox-amazon-reviews

Amazon 产品评论

获取并分析 Amazon 产品评论，帮助卖家从客户反馈中提取可执行的洞察。

核心概念

此工具可从 15 个站点获取指定 Amazon ASIN 的真实客户评论。你可以控制每个星级（1-5 星）要获取的评论数量（每个星级最多 100 条）、按最新或最有帮助排序，并应用各种筛选条件。每次请求只能查询一个 ASIN；如需查询多个 ASIN，请分别调用。

API 用法

所有 15 个站点（包括美国）都使用同一个统一端点：

• 调用 scripts/amazon_reviews.py，传入 domainCode: "<code>"。Amazon.com 使用 domainCode: "com"。请参阅 references/api.md

参数指南

参数	类型	必填	适用范围	描述	默认值
asin	string	是	全部	Amazon 产品 ASIN	-
star1Num	integer	否	主端点	要获取的 1 星评论数量（0-100）	10
star2Num	integer	否	主端点	要获取的 2 星评论数量（0-100）	10
star3Num	integer	否	主端点	要获取的 3 星评论数量（0-100）	10
star4Num	integer	否	主端点	要获取的 4 星评论数量（0-100）	10
star5Num	integer	否	主端点	要获取的 5 星评论数量（0-100）	10
sortBy	string	否	全部	recent（最新）或 helpful（最有帮助）	recent
formatType	string	否	全部	current_format 或 all_formats	current_format
domainCode	string	否	主端点	站点代码（请参阅“支持的站点”）；美国使用 com	com
filterByKeyword	string	否	主端点	按关键词筛选评论（最多 1000 个字符）	-
reviewerType	string	否	主端点	all_reviews 或 avp_only_reviews（仅已验证评论）	all_reviews
mediaType	string	否	主端点	all_contents 或 media_reviews_only	all_contents

星级数量默认值

• 如果未提供任何星级数量字段，star1Num 至 star5Num 的默认值均为 10。
• 如果提供了任意星级数量字段，未指定的星级数量默认值为 0。

支持的站点

站点	代码
美国	com
加拿大	ca
英国	co.uk
德国	de
法国	fr
意大利	it
西班牙	es
日本	co.jp
印度	in
澳大利亚	com.au
巴西	com.br
墨西哥	com.mx
荷兰	nl
瑞典	se
阿联酋	ae

所有受支持的站点都使用 domainCode。请务必确认用户指定的站点。

使用示例

1. 获取美国评论（Amazon.com）

{"asin": "B08N5WRWNW", "domainCode": "com", "star1Num": 10, "star2Num": 10, "star3Num": 10, "star4Num": 10, "star5Num": 10, "sortBy": "recent"}

2. 使用关键词筛选获取差评（德国）

{"asin": "B08N5WRWNW", "domainCode": "de", "star1Num": 30, "star2Num": 30, "filterByKeyword": "quality", "reviewerType": "avp_only_reviews"}

3. 获取带媒体的 5 星评论（日本）

{"asin": "B08N5WRWNW", "domainCode": "co.jp", "star5Num": 50, "star1Num": 0, "star2Num": 0, "star3Num": 0, "star4Num": 0, "sortBy": "helpful", "mediaType": "media_reviews_only"}

4. 仅获取 3 星评论（显式星级模式）

{"asin": "B0FP5C63HZ", "domainCode": "com", "star3Num": 100}

展示规则

1. 清晰呈现数据：按星级分组展示评论，并包含关键字段：评分、标题、正文、日期、已验证状态、有帮助数。
2. 适时总结：评论较多时，先总结主题或痛点，再列出单条评论。
3. 突出可执行的洞察：指出差评中反复出现的问题；注明好评中受到称赞的功能。
4. Vine 和已验证标签：清楚标明 Vine Voice 和已验证购买状态。
5. 媒体标记：注明评论是否包含图片或视频。
6. 响应标准化：当原始响应使用特定站点的文本格式时，统一评分和有帮助数的字段格式，以便一致展示。
7. 错误处理：查询失败时，根据响应消息说明原因，并建议调整参数。
8. 单 ASIN 限制：如果用户询问多个 ASIN，请分别为每个 ASIN 发起请求。

重要限制

• 每次请求仅支持一个 ASIN：每次只能查询单个 ASIN。
• 每个星级的数量上限：每次请求中，每个星级评分最多返回 100 条评论。
• 参数适用范围：filterByKeyword、reviewerType、mediaType 可用于 /amazon/reviews/list，包括 domainCode: "com"。
• 无历史快照：评论为实时抓取。
• 评论文本语言：评论以发布时的原始语言返回。

用户表达与场景快速参考

适用 — 涉及亚马逊商品评论的任务：

用户说	场景
“显示此 ASIN 的评论”	直接查询评论
“获取 B08N5WRWNW 的美国站评论”	按商城查询
“顾客在抱怨什么”	负面评论分析
“获取所有 1 星评论”	按星级筛选评论
“差评中有哪些常见问题”	挖掘痛点
“大家喜欢这款商品的哪些方面”	正面评论分析
“查找提到‘电池’的评论”	按关键词筛选评论
“显示带照片的评论”	按媒体类型筛选评论
“仅显示已验证购买的评论”	按评论者类型筛选
“帮我分析竞争对手的评论”	竞品评论调研
“根据评论提出商品改进建议”	提取可执行的见解

不适用 — 需求超出商品评论数据范围：

• ABA 搜索词数据／关键词调研（改用 ABA Data Explorer）
• 销量估算或收入分析
• 商品详情页文案撰写或 A+ 内容创作
• 广告／PPC 策略
• 定价策略或利润率计算

边界判断：如果“商品调研”或“竞品分析”归根结底是阅读特定 ASIN 的顾客评论，则适用此技能。如果涉及搜索量、关键词排名、销量估算或市场规模，则不适用。

反馈：

出现以下任一情况时，通过 Feedback API 自动检测并报告反馈：

1. 此技能所描述的功能或用途与实际行为不符
2. 此技能的结果与用户意图不符
3. 用户表达了对该技能的不满或赞扬
4. 任何你认为可以改进的方面

按照参考文档中的说明调用反馈 API。不要打断用户的操作。

处理大型响应

为避免超出 Agent 上下文限制，请将响应保存到磁盘，并仅提取所需字段：

python scripts/response_io.py run --script scripts/amazon_reviews.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # or --path "<JMESPath>"

将 --out-dir 设在任何 git 工作树之外（例如，Unix 上的 /tmp/...，Windows 上的 %TEMP%/...）。持久化响应可能包含个人身份信息、定价或认证敏感数据——请勿提交这些文件。文件不会自动删除；任务完成后请清理。

此技能仅提供一个入口脚本：amazon_reviews.py。

run 会将完整响应写入文件，并仅输出架构预览和文件路径。read 可投影指定字段，并通过 --limit/--offset 切片；还可通过 --format json|jsonl|csv|table 指定输出格式。

优先采用此模式的情况 — 根据响应特征自行判断，例如：

• 每条记录的字段较多，或包含不需要的字段
• 批量／分页结果（每次调用返回多个项目）
• 长文本字段（描述、评论、HTML、时间序列）
• 后续步骤还会复用输出，而非立即使用

对于小型、仅使用一次的响应，直接调用主脚本即可。

⚠️ 预览内容是经过截断的架构和样例，并非完整数据。任何字段级判断都必须通过 read 从持久化文件中读取。

---

如需了解更多优质、专业的跨境电商技能，请访问 LinkFox Skills。