给 AI

问答

怎么把亚马逊评论、商品详情和畅销榜接进 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 的反馈,值得开通。

其他办法

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

资料来源

  1. Amazon Creators API 介绍:需加入联盟计划,过去 30 天至少 10 笔合格销售affiliate-program.amazon.com · 读取于
  2. Creators API 资源列表:类目节点、图片、商品信息、报价、父 ASIN、搜索筛选、变体汇总affiliate-program.amazon.com · 读取于
  3. PA-API 5 停用公告:由 Creators API 取代affiliate-program.amazon.com · 读取于
  4. SP-API Customer Feedback API:评论洞察、所需角色、覆盖站点、每周更新developer-docs.amazon · 读取于

这个问题出现过的地方(读取于 2026-11-17)

更新于

接上一次,以后直接问 AI。

新 key 自带 $0.10 试用额度。贴一句话,就能接进你的智能体。

免费开始
一句话接进你的 AI

把这句话发给你的智能体

读一下 https://okdata.online/zh/agents.md,帮我把 okdata 配好;我的 key 在环境变量 OKDATA_API_KEY 里。

Claude Code、Cursor、Codex 等能打开网址的智能体,读完会自己配好。

MCP 地址https://api.okdata.online/mcp