关键词搜索商品
yasina-keepa-product-scout用关键词搜商品库,按亚马逊相关性返回前 20 条,摸清价格带与评论门槛。
这个技能能做什么
基于 Keepa 用关键词搜索亚马逊商品,像消费者在搜索框里输入那样:给一个词,返回匹配的商品列表,每条带标题、品牌、当前价、销售排名与月销量(**不含评分与评论数**,这个端点不返回)。用于摸一个词底下都有谁在卖、价格带落在哪个区间、头部商品卖得多好 —— 也就是进入一个词之前的市场体感。**一次最多返回 20 条**(`maxResults` 上限就是 20,没有翻页),所以它给的是这个词的头部样本,不是完整的市场盘点。用 `domain` 切站点、`asinsOnly` 只要 ASIN 列表(随后批量查档案),`refreshIfOlderThanHours` 控制数据新鲜度。返回的价格是带币种的字符串。关键词搜索与按条件筛选是两条不同的路:这里输入的是词,结果的排序逻辑接近亚马逊自己的相关性,胜在**看到的顺序和买家看到的一致**;**本技能不能改排序**(没有 sort 参数)——要按销量、价格、评论数排序取前 N 个,或者按月销量、排名、报价数这类量化条件从全库收窄(也能同时加标题关键词),用 yasina-keepa-product-finder。当用户提到 Keepa、keepa、搜索、搜一下、查一下有什么、关键词、这个词、搜关键词、按名字找商品、市场调研、这个品类都有谁在卖、价格带、头部卖家是谁、竞品有哪些、同类商品、search products, keyword search, market research, who sells, price range of keyword 时触发此技能。即使用户未明确提及“搜索”,只要其需求是给出一个商品名称或品类词并想看到这个词下的商品列表与价格分布,也应触发。不适用于:**按销量等指标排序取前 N 个**(本技能不能改排序)、要超过 20 条结果、或关键词要配合量化条件(这三种都用 yasina-keepa-product-finder,它的 `title` 能做关键词过滤、`sort` 能按销量排,每页 50~500 条)、已知 ASIN 查详情(用 yasina-keepa-asin-insight)、找类目 ID 或看类目榜(用 yasina-keepa-category-explorer)、查某个卖家在卖什么(用 yasina-keepa-seller-profile)。
怎么用
复制下面这句话,发给你的 AI 助手(WorkBuddy、Claude Code、Codex 都可以):
下载 https://plusskill.oss-cn-guangzhou.aliyuncs.com/skills/yasina-keepa-product-scout.zip 并安装这个 skill,然后阅读这个 skill 告诉我如何使用
助手会自动下载安装并读懂用法,然后告诉你能问它什么。 首次使用它会引导你用手机号注册,赠送 50 积分。
入参
关键词搜索商品
POST /v2/keepa/search-products| 参数 | 类型 | 必填 | 说明 | 默认 |
|---|---|---|---|---|
term | string | 是 | 搜索关键词 | 无 |
domain | string | 否 | 站点,见下方取值表 | com |
maxResults | int | 否 | 返回条数,1~20。上限就是 20,没有翻页;要更多结果用 | 10 |
asinsOnly | bool | 否 | 只回 ASIN 列表,不回商品详情。想拿一批 ASIN 再批量查档案时用 | false |
statsDays | int | 否 | 均值统计窗口天数 | 90 |
refreshIfOlderThanHours | int | 否 | 数据源数据超过 N 小时则去亚马逊重取。0=每次实时,-1=绝不刷新 | 数据源默认 |
返回值
| 字段 | 怎么用 |
|---|---|
products[].asin / title / brand / mainImage | 商品标识 |
products[].prices.<类型>.current | 当前价。带币种的字符串(如 |
products[].salesRank | 销售排名,数字越小越好卖 |
products[].offerCounts | 在售报价数 |
products[].monthlySold | 月销量,可能为 null |
products[].categoryTree | 类目路径,可用来找类目 ID |
asinList |
|
积分收费规则
1 积分/次,返回多少条都是这个价。
所以想多看几条时直接把 maxResults 提上去,一次拿够。
调用失败(参数错误、数据源不可用)不扣积分。
对应的 API 端点
- POST
/v2/keepa/search-products