问答
怎么把亚马逊评论、商品详情和畅销榜接进 Claude、Cursor 或自己的 AI 智能体?
简短回答
别让智能体自己开网页,给它一个能调的接口。okdata 返回亚马逊买家评论(每页 10 条,可按最新或最有帮助排序)、按 ASIN 查的商品详情和畅销榜,美国站和其他国家站都能查;走 HTTP 或一条 MCP 地址,Claude 和 Cursor 都能直接用。评论每页 $0.006。搜出 5 个竞品,各读最新 100 条和最有帮助的 100 条评论,再加上详情,一共 $0.636。亚马逊官方的 Creators API 不提供评论数据。
做跨境的卖家选品时,常想知道同一件事:这个类目卖得最好的几款,买家到底在骂什么?最近一个月有没有冒出新问题?想让 AI 来回答,它得先拿到三样东西:哪些商品在卖,每条 Listing 写了什么,买家评论。让智能体直接打开 amazon.com 并不稳,做浏览器智能体的开发者反馈,没登录时完整的评论列表会跳到登录页。改成调接口,智能体不管跑在哪里,拿到的都是同样的 JSON。
四个接口
- 亚马逊畅销榜:某个类目的榜单,按名次排,每页 50 个,翻两页就是整张榜。
list参数还能取新品榜、飙升榜(Movers & Shakers)、心愿单榜和礼物榜。 - 亚马逊商品搜索:按关键词搜,结果和买家看到的一致,每页 48 个,可按相关度、畅销、评论最多、最新或价格排序。
- 亚马逊商品详情:按 ASIN 取价格、星级、评分数和图片。加上
view=full,ext里还有品牌、五点描述(About this item)、类目路径、BSR 排名和上月购买量。 - 亚马逊商品评论:每页 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 或余额不足。读评论用的大模型,费用由你的模型服务商另算。
代码
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 接入。在 Cursor 里,把下面这段写进 ~/.cursor/mcp.json,见 Cursor 接入:
{
"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 调数据接口。
容易踩的坑
- 评分数不是评论数。商品上的
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 的反馈,值得开通。
其他办法
只看一两个商品,自己读评论往往就够了。登录状态下用的浏览器插件和开源爬虫,跑的是你自己的亚马逊账号,亚马逊一改页面就得跟着修。面向亚马逊卖家的订阅制选品工具会多给关键词和销量估算,按月付费。差评怎么变成改款清单,见竞品评价挖掘;完整的选品流程见选品调研方案。
资料来源
- Amazon Creators API 介绍:需加入联盟计划,过去 30 天至少 10 笔合格销售
- Creators API 资源列表:类目节点、图片、商品信息、报价、父 ASIN、搜索筛选、变体汇总
- PA-API 5 停用公告:由 Creators API 取代
- SP-API Customer Feedback API:评论洞察、所需角色、覆盖站点、每周更新
这个问题出现过的地方(读取于 2026-11-17)
更新于