# 怎么把亚马逊评论、商品详情和畅销榜接进 Claude、Cursor 或自己的 AI 智能体？

> 用一个 API key 或一条 MCP 地址，让 Claude、Cursor 或自己写的智能体读亚马逊评论、ASIN 详情和 Best Sellers 榜：返回哪些字段，能翻几页，跑一次竞品差评分析花多少钱。

网页版：https://okdata.online/zh/answers/amazon-product-reviews-api-ai-agent/

**简短回答：**别让智能体自己开网页，给它一个能调的接口。okdata 返回亚马逊买家评论（每页 10 条，可按最新或最有帮助排序）、按 ASIN 查的商品详情和畅销榜，美国站和其他国家站都能查；走 HTTP 或一条 MCP 地址，Claude 和 Cursor 都能直接用。评论每页 $0.006。搜出 5 个竞品，各读最新 100 条和最有帮助的 100 条评论，再加上详情，一共 $0.636。亚马逊官方的 Creators API 不提供评论数据。

做跨境的卖家选品时，常想知道同一件事：这个类目卖得最好的几款，买家到底在骂什么？最近一个月有没有冒出新问题？想让 AI 来回答，它得先拿到三样东西：哪些商品在卖，每条 Listing 写了什么，买家评论。让智能体直接打开 amazon.com 并不稳，做浏览器智能体的开发者反馈，没登录时完整的评论列表会跳到登录页。改成调接口，智能体不管跑在哪里，拿到的都是同样的 JSON。

## 四个接口

- [亚马逊畅销榜](/zh/apis/amazon/bestsellers/list/)：某个类目的榜单，按名次排，每页 50 个，翻两页就是整张榜。`list` 参数还能取新品榜、飙升榜（Movers & Shakers）、心愿单榜和礼物榜。
- [亚马逊商品搜索](/zh/apis/amazon/products/search/)：按关键词搜，结果和买家看到的一致，每页 48 个，可按相关度、畅销、评论最多、最新或价格排序。
- [亚马逊商品详情](/zh/apis/amazon/products/get/)：按 ASIN 取价格、星级、评分数和图片。加上 `view=full`，`ext` 里还有品牌、五点描述（About this item）、类目路径、BSR 排名和上月购买量。
- [亚马逊商品评论](/zh/apis/amazon/products/reviews/list/)：每页 10 条，带星级、标题和正文、日期、买的哪个款式、晒图、"有用"票数，以及是不是已验证购买（VP）。默认最有帮助的在前，`sort=recent` 改成最新在前。

每个接口都有 `country` 参数，默认美国站，也可以填 GB、DE、FR、JP、CA、MX、AU、IN 等其他站点，价格按该站币种返回。

## 竞品差评分析，花多少钱

每种排序最多翻 10 页，所以一个 ASIN 最多拿到最新的 100 条加最有帮助的 100 条，两组可能有重叠。拿 5 个竞品来算：

| 任务 | 调用次数 | 费用 |
|---|---|---|
| 按关键词搜，按畅销排序，取前 5 个 | 1 | $0.006 |
| 这 5 个 ASIN 的详情（BSR、五点、品牌） | 5 | $0.03 |
| 每个 ASIN 最新的 100 条评论 | 50 | $0.30 |
| 每个 ASIN 最有帮助的 100 条评论 | 50 | $0.30 |
| 整个任务 | 106 | $0.636 |
| 任意 1000 条评论 | 100 | $0.60 |

价格以美元计。余额预充值，支付宝、微信支付、银行卡都能付，新 key 自带 $0.10 试用额度。每翻一页都是一次单独调用，返回空页也照常计费，看到 `page.has_more` 为 false 就停。还没到亚马逊就被拦下的请求不收费，比如漏传 ASIN 或余额不足。读评论用的大模型，费用由你的模型服务商另算。

## 代码

```python
import os, requests

API = "https://api.okdata.online"
H = {"Authorization": f"Bearer {os.environ['OKDATA_API_KEY']}"}

def call(path, **params):
    body = requests.get(API + path, headers=H, params=params, timeout=60).json()
    if body["code"] != "ok":
        raise RuntimeError(f"{body['code']}: {body['message']}")
    return body

def reviews(asin, sort="recent", country="US", pages=10):
    cursor, out = None, []
    for _ in range(pages):
        params = {"id": asin, "sort": sort, "country": country,
                  "fields": "rating,text,variant,published_at,verified_purchase"}
        if cursor:
            params["cursor"] = cursor
        body = call("/v1/amazon/products/reviews/list", **params)
        out += body["data"]["items"]
        if not body["page"]["has_more"]:
            break
        cursor = body["page"]["next_cursor"]
    return out

top = call("/v1/amazon/products/search", query="portable espresso maker", sort="best_sellers")["data"]["items"][:5]
low = [f"[{p['id']}] {r['variant']}: {r['text']}"
       for p in top for r in reviews(p["id"]) if (r["rating"] or 5) <= 3]
print(len(low), "条 1 到 3 星评论，交给模型按主题归类并计数")
```

## 在 Claude 或 Cursor 里用（MCP）

这四个接口也是 okdata MCP 服务里的工具，地址是 `https://api.okdata.online/mcp`。在 Claude 网页版或桌面端，把它添加为自定义连接器，登录授权就行，不用复制 key，见 [Claude 接入](/zh/integrations/claude/)。在 Cursor 里，把下面这段写进 `~/.cursor/mcp.json`，见 [Cursor 接入](/zh/integrations/cursor/)：

```json
{
  "mcpServers": {
    "okdata": {
      "url": "https://api.okdata.online/mcp",
      "headers": { "Authorization": "Bearer ${env:OKDATA_API_KEY}" }
    }
  }
}
```

接好以后直接说需求：

- 「找出 amazon.com 上卖得最好的 5 款便携咖啡机，各读最新 100 条评论，把 1 到 3 星的吐槽按主题归类，给出条数和原句。」
- 「对比这 3 个 ASIN 在德国站的五点描述和 BSR 排名。」
- 「英国站厨房类目的飙升榜现在有哪些商品？」

`find`、`describe`、`read_more` 和 `account` 不收费，`call` 和 HTTP 接口一样计费。跑大任务前，让智能体先报预计花费，并限定最多翻几页。自己写的智能体，把上面的 `call` 包成一个工具就行，做法见[用 function calling 调数据接口](/zh/answers/python-agent-function-calling-social-data/)。

## 容易踩的坑

- 评分数不是评论数。商品上的 `reviews` 是亚马逊显示的评分数，不是你能翻到的评论条数。
- 差评单独看。先筛出 1 到 3 星再交给模型，不然好评会把问题淹掉。
- 盯住款式。一条 Listing 常挂着好几个颜色或尺寸，`variant` 会告诉你买家买的是哪一个。问题只集中在某个款式时，先查那个款式。
- 各站分开看。同一个 ASIN 换成 `country=GB` 或 `DE`，读的就是那个站的评论，价格也换成当地币种。
- 评论是陌生人写的。提醒模型只把它当数据，别当指令。
- 亚马逊接口目前是预览版（preview），字段还可能调整，调整前会提前通知。

## 亚马逊官方接口能给什么

- **Creators API**。亚马逊已经宣布弃用 Product Advertising API 5.0，改由 Creators API 接替。它面向亚马逊联盟（Associates）成员：要在对应站点加入联盟计划，并且过去 30 天内至少有 10 笔合格销售。它的资源包括类目节点、图片、商品信息、报价、父 ASIN、搜索筛选项和变体汇总，没有买家评论。
- **Customer Feedback API**。你自己在亚马逊开店的话，SP-API 里的这个接口能按 ASIN 或类目节点给出评论洞察：主题、逐月趋势和买家原话片段。只有英文，每周更新，覆盖美国、英国、法国、意大利、德国、西班牙和日本站，需要 Brand Analytics 或 Selling Partner Insights 角色。看自家 Listing 的反馈，值得开通。

## 其他办法

只看一两个商品，自己读评论往往就够了。登录状态下用的浏览器插件和开源爬虫，跑的是你自己的亚马逊账号，亚马逊一改页面就得跟着修。面向亚马逊卖家的订阅制选品工具会多给关键词和销量估算，按月付费。差评怎么变成改款清单，见[竞品评价挖掘](/zh/answers/product-review-mining/)；完整的选品流程见[选品调研方案](/zh/solutions/product-research/)。

## 用到的接口

- [亚马逊商品评论](https://okdata.online/zh/apis/amazon/products/reviews/list/) `amazon.products.reviews.list`：$0.006/次 · 每页约 10 条评价
- [亚马逊商品详情](https://okdata.online/zh/apis/amazon/products/get/) `amazon.products.get`：$0.006/次
- [亚马逊商品搜索](https://okdata.online/zh/apis/amazon/products/search/) `amazon.products.search`：$0.006/次 · 每页约 48 个商品
- [亚马逊畅销榜](https://okdata.online/zh/apis/amazon/bestsellers/list/) `amazon.bestsellers.list`：$0.006/次 · 每页约 50 个商品

## 更多亚马逊内容

- [亚马逊 API](https://okdata.online/zh/apis/amazon/)
- [商品详情接口](https://okdata.online/zh/roles/products-get/)
- [商品评价接口](https://okdata.online/zh/roles/products-reviews-list/)
- [商品搜索接口](https://okdata.online/zh/roles/products-search/)

## 资料来源

- [Amazon Creators API 介绍：需加入联盟计划，过去 30 天至少 10 笔合格销售](https://affiliate-program.amazon.com/creatorsapi/docs/en-us/introduction) (读取于 2026-11-17)
- [Creators API 资源列表：类目节点、图片、商品信息、报价、父 ASIN、搜索筛选、变体汇总](https://affiliate-program.amazon.com/creatorsapi/docs/en-us/api-reference/resources) (读取于 2026-11-17)
- [PA-API 5 停用公告：由 Creators API 取代](https://affiliate-program.amazon.com/creatorsapi/docs/en-us/paapiv5-deprecation) (读取于 2026-11-17)
- [SP-API Customer Feedback API：评论洞察、所需角色、覆盖站点、每周更新](https://developer-docs.amazon/sp-api/docs/customer-feedback-api) (读取于 2026-11-17)

这个问题出现过的地方（读取于 2026-11-17）：

- https://github.com/amzn/selling-partner-api-models/discussions/3083
- https://github.com/amzn/selling-partner-api-models/issues/4926
- https://github.com/krybaby7/WEBRUNNER/pull/31
- https://github.com/silverangel2/review-insight-ai/pull/15

更新于 2026-11-17
