Back to Details

linkfox-amazon-reviews-list

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Amazon Product Reviews

亚马逊商品评论

Fetch and analyze Amazon product reviews to help sellers extract actionable insights from customer feedback.
获取并分析亚马逊商品评论，帮助卖家从买家反馈中提取可落地的洞察。

Core Concepts

核心概念

This tool retrieves real customer reviews for a given Amazon ASIN across 15 marketplaces. You can control how many reviews to fetch per star rating (1-5 stars, up to 100 each), sort by recency or helpfulness, and apply various filters. Only one ASIN per request; for multiple ASINs, make separate calls.
该工具可在15个站点检索指定亚马逊ASIN的真实买家评论。你可以控制每个星级（1-5星，最多100条）的评论获取数量，按最新或最有用排序，并应用多种筛选条件。每次请求仅支持一个ASIN；若需查询多个ASIN，请分开调用。

调用方式

调用方式

  • API 端点：
    POST /amazon/reviews/list
    （完整参数/响应/错误码见 
    references/api.md
    ）
  • Python 脚本：
    python scripts/amazon_reviews.py '<JSON 参数>' [--inline]
  • 成本约束：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。
输出策略（脚本默认行为）：
  • 始终将完整响应写入 
    <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-amazon-reviews-list-<timestamp>.json
    （
    <cwd>
    为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；
    <session>
    取自环境变量 
    SESSION_ID
    ，按用户任务自动聚合；禁止写入 /tmp，当前目录不可写则报错）
  • 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout
  • 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 
    total
    /
    costToken
    、最大列表字段的长度 + 前 3 条样本）
  • 加 
    --inline
    强制全量打印到 stdout（同样落盘）
读数据建议：先看摘要判断是否足够；需要具体字段时优先用 
jq
或
ConvertFrom-Json
从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。
  • API 端点：
    POST /amazon/reviews/list
    （完整参数/响应/错误码见 
    references/api.md
    ）
  • Python 脚本：
    python scripts/amazon_reviews.py '<JSON 参数>' [--inline]
  • 成本约束：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带有24小时本地缓存。失败/空结果不得自动更换关键词、翻页或修改邮编连续试探；需要继续检索时，需先向用户说明会产生额外消耗。
输出策略（脚本默认行为）：
  • 始终将完整响应写入 
    <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-amazon-reviews-list-<timestamp>.json
    （
    <cwd>
    为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；
    <session>
    取自环境变量 
    SESSION_ID
    ，按用户任务自动聚合；禁止写入 /tmp，当前目录不可写则报错）
  • 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout
  • 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 
    total
    /
    costToken
    、最大列表字段的长度 + 前 3 条样本）
  • 加 
    --inline
    强制全量打印到 stdout（同样落盘）
读数据建议：先看摘要判断是否足够；需要具体字段时优先用 
jq
或
ConvertFrom-Json
从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。

解决认证和积分问题

解决认证和积分问题

发生以下异常情况时，采用 references/onboarding.md 引导解决问题：
发生以下异常情况时，采用 references/onboarding.md 引导解决问题：

异常情况

异常情况

  • 未配置API Key：环境变量未配置 
    LINKFOX_AGENT_API_KEY
    ，也未配置 
    LINKFOXAGENT_API_KEY
    。
  • 响应401或402状态码
  • 响应提示积分或余额不足：消息含"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"，或类似含义的内容。
  • 未配置API Key：环境变量未配置 
    LINKFOX_AGENT_API_KEY
    ，也未配置 
    LINKFOXAGENT_API_KEY
    。
  • 响应401或402状态码
  • 响应提示积分或余额不足：消息含"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"，或类似含义的内容。

Parameter Guide

参数指南

ParameterTypeRequiredScopeDescriptionDefault
asinstringYesAllAmazon product ASIN-
star1NumintegerNoMain endpoint1-star reviews to fetch (0-100)10
star2NumintegerNoMain endpoint2-star reviews to fetch (0-100)10
star3NumintegerNoMain endpoint3-star reviews to fetch (0-100)10
star4NumintegerNoMain endpoint4-star reviews to fetch (0-100)10
star5NumintegerNoMain endpoint5-star reviews to fetch (0-100)10
sortBystringNoAll
recent
(newest) or 
helpful
(most helpful)
recent
formatTypestringNoAll
all_formats
or 
current_format
all_formats
domainCodestringNoMain endpointMarketplace code (see Supported Marketplaces); use 
com
for US
com
filterByKeywordstringNoMain endpointFilter reviews by keyword (max 1000 chars)-
reviewerTypestringNoMain endpoint
all_reviews
or 
avp_only_reviews
(verified only)
all_reviews
mediaTypestringNoMain endpoint
all_contents
or 
media_reviews_only
all_contents
参数类型是否必填适用范围描述默认值
asinstring是全部Amazon商品ASIN-
star1Numinteger否主端点要获取的1星评论数量（0-100）10
star2Numinteger否主端点要获取的2星评论数量（0-100）10
star3Numinteger否主端点要获取的3星评论数量（0-100）10
star4Numinteger否主端点要获取的4星评论数量（0-100）10
star5Numinteger否主端点要获取的5星评论数量（0-100）10
sortBystring否全部
recent
（最新）或 
helpful
（最有用）
recent
formatTypestring否全部
all_formats
或 
current_format
all_formats
domainCodestring否主端点站点代码（见支持的站点）；美国站用 
com
com
filterByKeywordstring否主端点按关键词筛选评论（最多1000字符）-
reviewerTypestring否主端点
all_reviews
或 
avp_only_reviews
（仅已验证购买）
all_reviews
mediaTypestring否主端点
all_contents
或 
media_reviews_only
all_contents

Star Count Defaults

星级数量默认规则

  • If no star count fields are provided, 
    star1Num
    to 
    star5Num
    all default to 
    10
    .
  • If any star count field is provided, unspecified star counts default to 
    0
    .
  • 若未提供任何星级数量字段，
    star1Num
    至 
    star5Num
    均默认设为 
    10
    。
  • 若提供任意星级数量字段，未指定的星级数量默认设为 
    0
    。

Supported Marketplaces

支持的站点

MarketplaceCode
United States
com
Canada
ca
United Kingdom
co.uk
Germany
de
France
fr
Italy
it
Spain
es
Japan
co.jp
India
in
Australia
com.au
Brazil
com.br
Mexico
com.mx
Netherlands
nl
Sweden
se
United Arab Emirates
ae
Use 
domainCode
for every supported marketplace. Always confirm the user's intended marketplace.
站点代码
美国
com
加拿大
ca
英国
co.uk
德国
de
法国
fr
意大利
it
西班牙
es
日本
co.jp
印度
in
澳大利亚
com.au
巴西
com.br
墨西哥
com.mx
荷兰
nl
瑞典
se
阿联酋
ae
所有支持的站点均使用 
domainCode
参数。请始终确认用户目标站点。

Usage Examples

使用示例

1. Fetch US reviews (Amazon.com)
json
{"asin": "B08N5WRWNW", "domainCode": "com", "star1Num": 10, "star2Num": 10, "star3Num": 10, "star4Num": 10, "star5Num": 10, "sortBy": "recent"}
2. Fetch negative reviews with keyword filter (Germany)
json
{"asin": "B08N5WRWNW", "domainCode": "de", "star1Num": 30, "star2Num": 30, "filterByKeyword": "quality", "reviewerType": "avp_only_reviews"}
3. Fetch 5-star reviews with media (Japan)
json
{"asin": "B08N5WRWNW", "domainCode": "co.jp", "star5Num": 50, "star1Num": 0, "star2Num": 0, "star3Num": 0, "star4Num": 0, "sortBy": "helpful", "mediaType": "media_reviews_only"}
4. Fetch only 3-star reviews (explicit star mode)
json
{"asin": "B0FP5C63HZ", "domainCode": "com", "star3Num": 100}
1. 获取美国站评论（Amazon.com）
json
{"asin": "B08N5WRWNW", "domainCode": "com", "star1Num": 10, "star2Num": 10, "star3Num": 10, "star4Num": 10, "star5Num": 10, "sortBy": "recent"}
2. 获取带关键词筛选的差评（德国站）
json
{"asin": "B08N5WRWNW", "domainCode": "de", "star1Num": 30, "star2Num": 30, "filterByKeyword": "quality", "reviewerType": "avp_only_reviews"}
3. 获取带媒体内容的5星评论（日本站）
json
{"asin": "B08N5WRWNW", "domainCode": "co.jp", "star5Num": 50, "star1Num": 0, "star2Num": 0, "star3Num": 0, "star4Num": 0, "sortBy": "helpful", "mediaType": "media_reviews_only"}
4. 仅获取3星评论（显式星级模式）
json
{"asin": "B0FP5C63HZ", "domainCode": "com", "star3Num": 100}

Display Rules

展示规则

  1. Present data clearly: Show reviews grouped by star rating with key fields: rating, title, text, date, verified status, helpful count.
  2. Summarize when appropriate: For many reviews, provide a theme/pain-point summary before listing individuals.
  3. Highlight actionable insights: Call out recurring complaints in negative reviews; note praised features in positive reviews.
  4. Vine and verified labels: Clearly indicate Vine Voice and verified purchase status.
  5. Media indicators: Note when reviews include images or videos.
  6. Response normalization: Normalize rating and helpful-count fields for consistent display when the raw response uses marketplace-specific text formats.
  7. Error handling: When a query fails, explain the reason based on the response message and suggest adjusting parameters.
  8. Single ASIN limitation: If the user asks about multiple ASINs, make separate requests for each.
  1. 清晰呈现数据：按星级分组展示评论，包含核心字段：评分、标题、内容、日期、已验证状态、有用投票数。
  2. 适时总结：评论数量较多时，先列出主题/痛点总结，再展示单条评论。
  3. 突出可落地洞察：标注差评中反复出现的投诉点；记录好评中被称赞的功能。
  4. Vine与已验证标签：明确标注Vine Voice和已验证购买状态。
  5. 媒体标识：标注评论是否包含图片或视频。
  6. 响应标准化：当原始响应使用站点特定文本格式时，统一评分和有用投票数字段的展示格式。
  7. 错误处理：查询失败时，根据响应消息解释原因，并建议调整参数。
  8. 单ASIN限制：若用户查询多个ASIN，需为每个ASIN单独发起请求。

Important Limitations

重要限制

  • One ASIN per request: Only a single ASIN can be queried at a time.
  • Per-star cap: Each star rating returns max 100 reviews per request.
  • Parameter scope: 
    filterByKeyword
    , 
    reviewerType
    , 
    mediaType
    are available on 
    /amazon/reviews/list
    , including 
    domainCode: "com"
    .
  • No historical snapshots: Reviews are fetched in real-time.
  • Review text language: Reviews are returned in their original language as posted.
  • 每次请求仅一个ASIN：一次查询只能针对单个ASIN。
  • 单星级上限：每个星级每次请求最多返回100条评论。
  • 参数范围：
    filterByKeyword
    、
    reviewerType
    、
    mediaType
    仅在 
    /amazon/reviews/list
    端点可用，包括 
    domainCode: "com"
    。
  • 无历史快照：评论为实时获取。
  • 评论语言：评论以发布时的原始语言返回。

User Expression & Scenario Quick Reference

用户表述与场景速查

Applicable — Tasks involving Amazon product reviews:
User SaysScenario
"Show me the reviews for this ASIN"Direct review lookup
"Get US reviews for B08N5WRWNW"Marketplace-specific lookup
"What are customers complaining about"Negative review analysis
"Get me all the 1-star reviews"Star-filtered retrieval
"Any common issues in the bad reviews"Pain point mining
"What do people like about this product"Positive review analysis
"Find reviews mentioning 'battery'"Keyword-filtered reviews
"Show me reviews with photos"Media-filtered reviews
"Verified purchase reviews only"Reviewer-type filtering
"Help me analyze competitor reviews"Competitor review research
"Product improvement suggestions from reviews"Actionable insight extraction
Not applicable — Needs beyond product review data:
  • ABA search term data / keyword research (use ABA Data Explorer instead)
  • Sales estimation or revenue analysis
  • Listing copywriting or A+ content creation
  • Advertising / PPC strategy
  • Pricing strategy or profit margin calculations
Boundary judgment: If "product research" or "competitor analysis" boils down to reading customer reviews for specific ASINs, this skill applies. If it involves search volume, keyword rankings, sales estimates, or market sizing, it does not.
适用场景 — 涉及亚马逊商品评论的任务：
用户表述场景
"帮我查看这个ASIN的评论"直接查询评论
"获取B08N5WRWNW的美国站评论"指定站点查询
"买家都在抱怨什么"差评分析
"给我所有1星评论"按星级筛选检索
"差评里有什么常见问题"痛点挖掘
"用户喜欢这个产品的哪些点"好评分析
"找提到'battery'的评论"关键词筛选评论
"展示带图片的评论"媒体内容筛选评论
"仅看已验证购买的评论"评论者类型筛选
"帮我分析竞品的评论"竞品评论研究
"从评论里提取产品改良建议"可落地洞察提取
不适用场景 — 超出商品评论数据的需求：
  • ABA搜索词数据/关键词研究（请使用ABA Data Explorer）
  • 销量预估或营收分析
  • 商品文案或A+内容创作
  • 广告/PPC策略
  • 定价策略或利润率计算
边界判断：若“产品调研”或“竞品分析”核心是读取特定ASIN的买家评论，则适用此技能；若涉及搜索量、关键词排名、销量预估或市场规模测算，则不适用。

积分消耗规则

积分消耗规则

按计划抓取页数动态计费。设 
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
积分。
重要：费用按请求的抓取页数计算，而不是按最终返回评论数计算。请求多个星级或大量评论前必须向用户说明预计页数和积分消耗。
Feedback:
Auto-detect and report feedback via the Feedback API when any of the following apply:
  1. The functionality or purpose described in this skill does not match actual behavior
  2. The skill's results do not match the user's intent
  3. The user expresses dissatisfaction or praise about this skill
  4. Anything you believe could be improved
Call the feedback API as specified in the references. Do not interrupt the user's flow.
For more high-quality, professional cross-border e-commerce skills, visit LinkFox Skills.
按计划抓取页数动态计费。设 
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
积分。
重要提示：费用按请求的抓取页数计算，而非最终返回的评论数。请求多个星级或大量评论前，必须向用户说明预计页数和积分消耗。
反馈：
出现以下任意情况时，通过Feedback API自动检测并提交反馈：
  1. 本技能描述的功能或用途与实际行为不符
  2. 技能结果与用户意图不匹配
  3. 用户表达了对本技能的不满或赞扬
  4. 任何你认为可以改进的内容
请按照参考文档中的说明调用反馈API，不要中断用户的操作流程。
如需更多高质量专业跨境电商技能，请访问 LinkFox Skills。