← 全部技能
亚马逊15 积分/次

亚马逊商品搜索

yasina-amazon-search

实时抓亚马逊搜索结果页,看关键词下的真实排名与广告位。

这个技能能做什么

抓取亚马逊真实搜索结果页,看一个关键词的竞争格局:首页有几个广告位、价格带集中在哪、头部评论数是多少门槛。返回结果页位次 + 是否广告位(两者配合才能算出真实自然排名)、标题、现价与划线价(都是数值可直接排序)、单位价原文、评分与评论数、由页面「上月售出 N 件」解析出的月销量与月销售额估算(把首页十几条加总就是这个词的大致市场容量)、角标徽章(Amazon's Choice、Best Seller)、配送信息。**排序只支持亚马逊搜索页自带的这 6 种**:相关度、价格升、价格降、评论数、上架时间倒序、热度 —— **没有「按销量排序」,也没有「按评分排序」、「按月销额排序」**,亚马逊前台不提供这些选项。用户要「按销量倒序取前 N 个」「销量最高的 50 个」这类需求,**这个技能做不到,要用 yasina-keepa-product-finder**(它在商品数据库里排序,支持按月销量、销售排名、价格、评论数、评分排,一次能取 50~500 条)。另外每页只有约 20~48 条、翻页要逐页调用,凑不出「前 50」这种整数。支持关键词搜索或按类目节点浏览、翻页、指定配送邮编与页面语言、设备类型。要看真实自然排名必须用相关度排序,换了排序位次就不是用户实际看到的。覆盖 25 个亚马逊站点。当用户提到搜索排名、自然排名、关键词排名、首页第几位、排在第几、搜这个词出来什么、搜索结果、SERP、广告位、sponsored、竞价广告、谁在打广告、广告多不多、类目节点浏览、按价格排序、按上架时间找新品、价格带分布、市场容量、这个词竞争大不大、值不值得打、amazon search, search results, organic rank, keyword ranking, sponsored ads, serp analysis, sort by price, market size 时触发此技能。即使用户未明确提及“搜索”,只要其需求涉及一个关键词的竞争格局、谁在首页、价格带分布如何、有没有大量广告位、这个词的容量有多大,也应触发。不适用于:**按销量/评分排序取前 N 个**(本技能没有这两种排序,用 yasina-keepa-product-finder 的 `sort`)、按月销评分等数值条件筛选全库(同样用 yasina-keepa-product-finder)、商品数据库检索(用 yasina-keepa-product-scout,那个不反映排名)、单品详情页的文案与图片(用 yasina-amazon-product-detail)、关键词的搜索热度趋势(用 yasina-keyword-trend)。

怎么用

复制下面这句话,发给你的 AI 助手(WorkBuddy、Claude Code、Codex 都可以):

下载 https://plusskill.oss-cn-guangzhou.aliyuncs.com/skills/yasina-amazon-search.zip 并安装这个 skill,然后阅读这个 skill 告诉我如何使用

助手会自动下载安装并读懂用法,然后告诉你能问它什么。 首次使用它会引导你用手机号注册,赠送 50 积分。

入参

亚马逊商品搜索

POST /v2/amazon/search
参数类型必填说明默认
kstring否

搜索关键词。与 node 互斥,同传会报错(官方规定)

—
nodestring否

类目节点 ID。与 k 互斥

—
amazon_domainstring否

站点域名

amazon.com
sstring否

排序:relevanceblender(相关度) / price-asc-rank(价格升) / price-desc-rank(价格降) / review-rank(好评) / date-desc-rank(最新) / exact-aware-popularity-rank(热度)

relevanceblender
pageint否

页码

1
rhstring否

属性筛选,形如 n:16318031,p_72:1248897011

—
dcbool否

true 丢弃自动纠错结果

false
devicestring否

desktop / tablet / mobile

desktop
languagestring否

语言。不传按站点推导

—
delivery_zipstring否

配送邮编。不传按站点推导

—
shipping_locationstring否

配送地区。不传按站点推导

—

返回值

字段怎么用
organic_results[]

搜索结果原样(asin / title / link / price / rating / reviews / thumbnail / bought_last_month / position / sponsored 等)。⚠️ 名字叫 organic 但里面混着广告位 —— 见下方 sponsored 与 position

organic_results[].sponsored

是否广告位。⚠️ 取值只有 `True` 与 `None`,没有 `False` —— 写 == False 或 is False 会把所有自然位都漏判,要用 if not row.get("sponsored") 判自然位。实测覆盖:pressure cooker 22 行里 6 行是广告、cordless drill 60 行里 12 行、yoga mat 48 行里 0 行

organic_results[].position

页内序号。⚠️ 它含广告位,不是自然排名 —— 实测 pressure cooker 的广告落在 position 1/2/7/12/17/22(首屏前两名都是广告),真实自然第 1 名是 position=3;cordless drill 更狠,前四名 1/2/3/4 全是广告。要自然排名必须先滤掉 `sponsored` 再重新编号。

⚠️ 跨页时 position 每页都从 1 重排(page=2 也是 1..22),算绝对位次要自己加偏移,而页大小随词变(实测 22 / 48 / 60 行),偏移量不能写死。另外页间有重叠:三页去重后只有 58 个 ASIN 而不是 66

search_information

结果总数与纠错信息。total_results 实测很稳(同词 4 次都是 9682),但它是全站匹配数,不是可追踪的位次数 —— 别拿它当 SOV 的分母

product_ads

广告位商品。⚠️ 只在部分关键词下出现 —— 实测 laptop stand 有,pressure cooker / yoga mat / cordless drill 都没有。所以「广告都在 product_ads 里」是错的,商品广告主要混在 organic_results 里

sponsored_brands

品牌广告位(顶部横幅那类)。实测每个词都有,稳定 2 行。算加权 SOV 时它占的版面比自然位大,要单独给权重

featured_products

精选商品。只在部分关键词下出现

video_results

视频结果。只在部分关键词下出现(实调 yoga mat 有)

related_searches

相关搜索词

categories

类目筛选项(含 node ID,可回填给 node 参数)

filters

其他筛选项(可回填给 rh 参数)

积分收费规则

15 积分/次,实时抓取搜索结果页。翻页是另一次调用。

调用失败(参数错误、数据源不可用)不扣积分。

对应的 API 端点

  • POST/v2/amazon/search

同类技能