主题
kmore_seller_finder
Seller Finder（卖家筛选）——Product Finder 的卖家版：用同一套筛选语法检索 Amazon 商家库，按评分/评分数、地址国家、FBA、店铺规模、经营类目/品牌、竞对关系等条件找卖家，返回符合条件的卖家 ID 列表。
用途
- 竞品调研：找某卖家的竞对（
competitorSellerIds）、找某类目/品牌的经营者 - 中国卖家分析：按地址国家筛
cn/hk卖家 - 找大卖家 / 高分卖家：按评分数、好评率、店铺 SKU 规模筛选
- 按名字找卖家：
search单词条检索
返回 sellerIdList（有序 ID 列表）+ totalResults（全量匹配数）；数据来自 spider 通路时附带 sellers 数组（与 ID 列表顺序对齐的 name / rating / ratingCount 摘要，"看看这些卖家是谁"到这层就够）。需要完整卖家对象（地址、品类统计、storefront ASIN 等）时，把 ID 分批（≤100）传给 kmore_get_seller。
参数
| 名称 | 类型 | 必填 | 默认 | 约束 | 说明 |
|---|---|---|---|---|---|
domain | integer | — | 1–12 | 站点 domain ID（与 country 二选一） | |
country | enum | — | — | Amazon 站点代码（与 domain 二选一） | |
selection | object | ✅ | — | 见下表 | 筛选条件对象，至少一个筛选条件（分页/排序键不算） |
分页写在
selection内，不要在顶层传page/perPage。
selection 结构
| 名称 | 类型 | 默认 | 说明 |
|---|---|---|---|
perPage | integer | 50 | 每页条目数，限制 50–10000，且 (page+1)*perPage ≤ 10000；<50 仅在 page=0 时自动按 50 请求并截取前 N 条返回 |
page | integer | 0 | 0-indexed 页码 |
sort | array[][] | — | 最多 3 个排序键，如 [["currentRatingCount","desc"]]；默认按 currentRatingCount 降序；未知排序字段不报错，整个 sort 被忽略 |
| 筛选字段 | — | — | 至少一个，否则报错 the query has no filter criteria. |
常用筛选字段
所有筛选条件之间 AND；数组筛选内部 OR（最多 50 项，
-前缀排除，如["cn","hk","-de"]）；字符串不区分大小写。minMatch可把某个数组筛选提高到"至少 K 项命中"，如{"brands": 2}。
检索与身份
| 字段 | 说明 |
|---|---|
search | 单词条全文检索（跨卖家名/商号/地址/ID） |
sellerId / sellerName / businessName | 精确匹配卖家 ID / 卖家名 / 商业名称 |
isAmazon | 是否 Amazon 自营 |
activeOnly | 仅近 31 天内有在架行为的活跃卖家 |
评分与反馈（时间窗 30 / 90 / 365 / Lifetime）
| 字段 | 说明 |
|---|---|
currentRating_gte / _lte | 当前好评率（0–100） |
currentRatingCount_gte / _lte | 累计评分数 |
ratingCount30/90/365/Lifetime_gte / _lte | 时段评分数 |
positiveRating* / neutralRating* / negativeRating* | 同时段好评 / 中评 / 差评数 |
lastRatingUpdate_gte / _lte、lastFeedbackDate_gte / _lte | 最近评分更新 / 反馈日期（KeepaTime 分钟） |
经营画像
| 字段 | 说明 |
|---|---|
addressCountry | 地址国家代码数组，如 ["cn","hk"] |
hasFBA | 是否有 FBA 行为 |
hasBusinessDetails | 是否有可解析的工商信息（卖家档案页） |
businessType / vatID / tradeNumber | 工商类型 / VAT 号 / 营业执照号 |
totalStorefrontAsins_gte / _lte | 店铺在架 SKU 规模 |
rootCategories_include/exclude | 经营根类目 ID 数组 |
brands / primaryBrand | 经营品牌数组 / 主品牌 |
competitorSellerIds | 给定卖家的竞对（目录重叠度最高）——竞品调研利器 |
trackedSince_gte / _lte | 数据源开始追踪时间（KeepaTime 分钟） |
完整字段列表（含 Buy Box 表现、时点在架等）见字段速查。日期类字段误传 Unix 秒/毫秒会被服务端拦截并提示换算公式。
计费
| 项目 | units |
|---|---|
| 基础（每次成功调用） | 10 |
| 结果集附加 | 每返回 100 个卖家 ID +1（向上取整） |
例：返回 50 个 ID = 10 + 1 = 11 units；匹配 0 个也收基础 10 units。预扣按
perPage估算，实际返回更少时自动退差额。缓存 5 分钟 / dedup 3 分钟内重复同参调用不再计费。
使用示例
找美国站地址在中国大陆/香港、累计评分数 ≥ 1000、近 31 天活跃的卖家，按评分数降序前 100：
json
{
"domain": 1,
"selection": {
"addressCountry": ["cn", "hk"],
"currentRatingCount_gte": 1000,
"activeOnly": true,
"sort": [["currentRatingCount", "desc"]],
"perPage": 100,
"page": 0
}
}找某卖家的活跃竞对（按店铺规模降序）：
json
{
"country": "us",
"selection": {
"competitorSellerIds": ["A2L77EE7U53NWQ"],
"activeOnly": true,
"sort": [["totalStorefrontAsins", "desc"]],
"perPage": 50
}
}返回结构
json
{
"success": true,
"data": {
"sellerIdList": ["A2VT4H683M5NNA", "A11HC9SRN13WHM", "A2PKN2PT2YIWJF"],
"totalResults": 23614,
"totalResultsCapped": false,
"sellers": [
{
"sellerId": "A2VT4H683M5NNA",
"name": "ThriftBooks-Chicago",
"rating": 90,
"ratingCount": 1053184
},
{
"sellerId": "A11HC9SRN13WHM",
"name": "BookOutlet USA",
"rating": 92,
"ratingCount": 641773
}
],
"fromCache": false
}
}sellerIdList/totalResults：卖家 ID 列表与命中总数，语义与 HTTP 端点一致sellers：与sellerIdList顺序对齐的名称/评分摘要（spider 通路附带、零额外计费）；null表示本次走了 API 兜底通道——只要名称/评分时可用kmore_get_seller_names批量补totalResultsCapped=true时totalResults是封顶值而非精确数