类目查询与畅销榜
yasina-keepa-category-explorer按 ID 或名称查类目树拿到编号，或拉取该类目的畅销排行。
这个技能能做什么
基于 Keepa 处理亚马逊类目相关的三件事。主用法按类目 ID 查类目详情：名称、上级类目、下级子类目列表、该类目的商品数量，用于把「运动户外」这样的说法落成具体的类目 ID，再喂给选品筛选的 `categories_include` 条件（**不是 `rootCategory`** —— 那个只认一级类目，喂子类目 ID 会返回 0 条且不报错）。`--search` 子命令反过来做：给一个类目名称关键词，返回匹配的类目及其 ID，不知道 ID 是多少时先用它。`--bestsellers` 子命令拉某个类目的畅销榜：按销售排名从高到低返回 **ASIN 列表**（只有 ASIN，没有价格/评分/评论数），要看头部长什么样、价格带集中在哪，得把 ASIN 再喂给 `yasina-keepa-asin-insight`。类目 ID 是数据源与亚马逊共用的数字标识，各站点的 ID 体系不同 —— 美国站的 ID 在德国站是另一个类目，切站点必须重新查。当用户提到 Keepa、keepa、类目、品类、分类、类目 ID、子类目、category、类目树、这个类目下面有什么、畅销榜、销量榜、bestseller、best sellers、热销、排行榜、类目前 100、头部商品、category lookup, category id, subcategories, best seller rank list 时触发此技能。即使用户未明确提及“类目”，只要其需求涉及把一个品类说法转成 ID、或者查看某个品类里卖得最好的那批商品，也应触发。不适用于：按关键词搜商品（用 yasina-keepa-product-scout）、按量化条件筛选（用 yasina-keepa-product-finder）、单个商品的排名历史（用 yasina-keepa-asin-history）、正在降价的商品（用 yasina-keepa-deal-radar）。
怎么用
复制下面这句话，发给你的 AI 助手（WorkBuddy、Claude Code、Codex 都可以）：
下载 https://plusskill.oss-cn-guangzhou.aliyuncs.com/skills/yasina-keepa-category-explorer.zip 并安装这个 skill，然后阅读这个 skill 告诉我如何使用
助手会自动下载安装并读懂用法，然后告诉你能问它什么。 首次使用它会引导你用手机号注册，赠送 50 积分。
入参
本技能覆盖 4 个端点，参数各不相同，按各自的表来传。
类目查询与畅销榜
POST /v2/keepa/category-lookup| 参数 | 类型 | 必填 | 说明 | 默认 |
|---|---|---|---|---|
categoryIds | array | 是 | 类目 ID 数组（数字），1~10 个。传 | 无 |
domain | string | 否 | 站点，见下方取值表 | com |
includeParents | bool | 否 | 是否带上完整的上级类目链 | false |
按名称搜类目
--searchPOST /v2/keepa/search-categories| 参数 | 类型 | 必填 | 说明 | 默认 |
|---|---|---|---|---|
term | string | 是 | 类目名称关键词，每个词至少 3 个字符且都要匹配 | 无 |
domain | string | 否 | 站点，见下方取值表 | com |
maxResults | int | 否 | 返回条数上限，1~50 | 15 |
类目畅销榜
--bestsellersPOST /v2/keepa/get-best-sellers| 参数 | 类型 | 必填 | 说明 | 默认 |
|---|---|---|---|---|
category | string | 是 | 类目 ID 或商品组名称，是字符串（如 | 无 |
domain | string | 否 | 站点，见下方取值表 | com |
maxResults | int | 否 | 返回多少个 ASIN，1~2000 | 100 |
rankAverageDays | number | 否 | 按哪种排名排： | 0 |
year | int | 否 | 查历史榜单的年份（近 36 个月内），要和 | 无 |
month | int | 否 | 查历史榜单的月份 1~12，与 | 无 |
商品详情（内置）
--detailsPOST /v2/keepa/get-products| 参数 | 类型 | 必填 | 说明 | 默认 |
|---|---|---|---|---|
asins | array | 是 | ASIN 数组，最多 20 个。上一步的结果直接传进来 | 无 |
domain | string | 否 | 站点，见下方取值表 | com |
statsDays | int | 否 | 价格统计窗口天数，1~3650 | 90 |
buybox | bool | 否 | 带回 Buy Box 归属与价格（判断能不能跟卖的关键） | false |
refreshIfOlderThanHours | int | 否 | 数据源数据超过 N 小时则去亚马逊重取。0=每次实时，-1=绝不刷新 | 数据源默认 |
返回值
类目查询与畅销榜
POST /v2/keepa/category-lookup| 字段 | 怎么用 |
|---|---|
categories[].catId / name | 类目 ID 与名称。⚠️ 类目树里有一层名字就叫 `Categories` 的无意义中间节点（如 493964、2619534011）—— 沿 |
categories[].isBrowseNode | 真类目还是促销节点。 |
categories[].parent / isRootCategory | 上级类目与是否一级类目。 |
categories[].childCategoryIds / childCategoryCount | 只有子类目的 ID，没有名称 —— 要名称得拿这些 ID 再查一次。 |
categories[].productCount | 该类目下的商品数量，判断类目大小 |
categories[].avgBuyBoxPrice / avgBuyBoxPrice90Day | 类目均价与 90 天均价。带币种字符串，这是判断价格带的现成数据 |
categories[].avgRating / avgReviewCount | 类目平均评分与评论数，评论数就是这个类目的进入门槛 |
categories[].fbaPercent / soldByAmazonPercent | FBA 占比、Amazon 自营占比 —— 自营占比高的类目不好做 |
categories[].sellerCount / brandCount | 卖家数与品牌数。主用法下每行都有（实测 3/3），但 |
categories[].topBrands | 头部品牌，看清谁在把持这个类目 |
按名称搜类目
--searchPOST /v2/keepa/search-categories| 字段 | 怎么用 |
|---|---|
term / matchCount | 回显关键词与匹配数。 |
categories[].catId | 类目 ID。喂给选品的 |
categories[].name | 类目名称 |
categories[].isBrowseNode | 先看这个字段： |
categories[].parent | 上级类目 ID —— 同名类目靠它和 `productCount` 分辨 |
categories[].productCount | 商品数量 |
categories[].childCategoryCount | 子类目数量。⚠️ 本子命令只给计数、不给 ID 数组（实测 0/7 行有 |
categories[].avgBuyBoxPrice / avgRating / avgReviewCount | 类目均价、平均评分与评论数。促销节点这几个字段为空（实测 5~6/7 行才有） |
categories[].fbaPercent / soldByAmazonPercent | FBA 与自营占比 |
categories[].sellerCount / brandCount / topBrands | 卖家数、品牌数、头部品牌。只有真类目行才有（实测 3/7）—— 为空基本等同于 |
类目畅销榜
--bestsellersPOST /v2/keepa/get-best-sellers| 字段 | 怎么用 |
|---|---|
asins | 按排名从高到低的 ASIN 数组，只有 ASIN 没有详情 —— 要价格接着用本技能的 |
category | 回显榜单所属类目 |
totalCount | ⚠️ 多数类目是封顶常数 500000，不是真实榜单容量：实测宠物 / 电子 / 图书 / Beauty 全都返回 500000，只有小类目才给真值（Musical Instruments 是 321518）。不要拿它当「这个类目有多少个品」 —— 那个数看类目查询的 |
lastUpdate | 榜单快照时间（ISO-8601 UTC） |
商品详情（内置）
--detailsPOST /v2/keepa/get-products| 字段 | 怎么用 |
|---|---|
products[].title / brand | 标题与品牌 |
products[].monthlySold | 月销量（区间估算，转述时说“约”） |
products[].salesRank / salesRank90DayAvg | 当前排名与 90 天均值。当前值远好于均值 = 正在上升 |
products[].salesRankDrops90 | 排名下降次数，是出单次数的代理指标，比排名本身更贴近销量 |
products[].prices | 各价格类型，每个含 current、avg30/90/180、allTimeLow/High |
products[].offerCounts | 各条件的报价数，判断竞争密度 |
products[].fbaPickAndPackFee / referralFeePercentage | FBA 配送费与佣金比例，算利润用得上 |
products[].availabilityAmazon | Amazon 自营在不在场 —— 跟卖决策的一票否决项 |
products[].package | 包装重量（克）与长宽高（毫米） |
积分收费规则
类目详情与 --search 查类目 ID 都是 1 积分/次。
--bestsellers 畅销榜 3 积分/次，一次能拉整张榜（最多 2000 个商品）—— 拉多少条都是 3 积分。
调用失败（参数错误、数据源不可用）不扣积分。
对应的 API 端点
- POST
/v2/keepa/category-lookup - POST
/v2/keepa/search-categories - POST
/v2/keepa/get-best-sellers - POST
/v2/keepa/get-products