linkfox-sellersprite-product-search

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

SellerSprite Product Search

SellerSprite 商品搜索

This skill guides you on how to search, filter, and analyze Amazon product data via the SellerSprite product database, helping Amazon sellers make data-driven product selection decisions.

本技能将指导您如何通过SellerSprite商品数据库搜索、筛选和分析亚马逊商品数据，帮助亚马逊卖家基于数据做出选品决策。

Core Concepts

核心概念

SellerSprite Product Search provides access to a comprehensive Amazon product database with rich filtering dimensions. It supports real-time data (last 30 days) as well as monthly historical snapshots for year-over-year and month-over-month comparisons. Supported

marketplace

codes are only: US, UK, DE, FR, JP, CA, IT, ES, MX, and IN (same as the gateway schema).

BSR (Best Sellers Rank): A lower BSR value means better sales performance in its category. A BSR of 1 means the top-selling product in that category. When a user says "BSR improved", it means the numeric value decreased; "BSR dropped" means the value increased.

Data snapshot: The

dataSnapshotMonth

parameter controls which time period to query. Use

nearly

(the default) for real-time last-30-day data, or a

yyyyMM

string (e.g.,

) to query a historical monthly snapshot. This is useful for seasonal analysis and year-over-year comparison.

Match types for keywords: When searching by keyword, three matching strategies are available:

Phrase match (default): Product titles must contain the keyword phrase
Fuzzy match: Broader matching with related terms
Exact match: Strict exact-string matching

SellerSprite商品搜索功能可访问全面的亚马逊商品数据库，具备丰富的筛选维度。它支持实时数据（最近30天）以及月度历史快照，可用于同比和环比对比。支持的

marketplace

代码仅包括：US、UK、DE、FR、JP、CA、IT、ES、MX和IN（与网关架构一致）。

BSR（畅销排名）：BSR数值越低，代表该品类下的销售表现越好。BSR为1意味着是该品类的销量冠军。当用户提到“BSR提升”时，指的是数值下降；“BSR下滑”指的是数值上升。

数据快照：

dataSnapshotMonth

参数用于控制查询的时间段。使用

nearly

（默认值）可查询最近30天的实时数据，或使用

yyyyMM

格式的字符串（例如

）查询历史月度快照。这对季节性分析和同比对比非常有用。

关键词匹配类型：按关键词搜索时，提供三种匹配策略：

短语匹配（默认）：商品标题必须包含该关键词短语
模糊匹配：更宽泛的匹配，包含相关词汇
精确匹配：严格的字符串精确匹配

Parameter Guide

参数指南

Search & Filtering

搜索与筛选

Parameter	Type	Description	Default
keyword	string	Search keyword; translate to the target marketplace language (e.g., English for US, German for DE)	-
matchType	integer	1 = Phrase match, 2 = Fuzzy match, 3 = Exact match	1
excludeKeywords	string	Keywords to exclude from results	-
marketplace	string	Marketplace code (allowed set only): US, UK, DE, FR, JP, CA, IT, ES, MX, IN	US
nodeLabel	string	Amazon category name	-
nodeIdPath	string	Amazon category node ID	-
filterSubNode	boolean	Whether to filter by subcategory node (only effective when nodeLabel or nodeIdPath is set)	-
dataSnapshotMonth	string	Data snapshot month in `yyyyMM` format, or `nearly` for real-time last 30 days	nearly

参数	类型	描述	默认值
keyword	string	搜索关键词；需转换为目标站点的语言（例如美国站点用英文，德国站点用德文）	-
matchType	integer	1 = 短语匹配，2 = 模糊匹配，3 = 精确匹配	1
excludeKeywords	string	需从结果中排除的关键词	-
marketplace	string	站点代码（仅允许以下值）：US、UK、DE、FR、JP、CA、IT、ES、MX、IN	US
nodeLabel	string	亚马逊品类名称	-
nodeIdPath	string	亚马逊品类节点ID	-
filterSubNode	boolean	是否按子品类节点筛选（仅当设置了nodeLabel或nodeIdPath时生效）	-
dataSnapshotMonth	string	数据快照月份，格式为 `yyyyMM` ，或使用 `nearly` 查询最近30天实时数据	nearly

Price & Financials

价格与财务指标

Parameter	Type	Description
minPrice / maxPrice	number	Price range filter
minProfit / maxProfit	number	Gross margin range (1-100, unit: %)
minRevenue / maxRevenue	number	Monthly revenue range
minFba / maxFba	number	FBA fee range

参数	类型	描述
minPrice / maxPrice	number	价格范围筛选
minProfit / maxProfit	number	毛利率范围（1-100，单位：%）
minRevenue / maxRevenue	number	月度营收范围
minFba / maxFba	number	FBA费用范围

Sales & Ranking

销量与排名

Parameter	Type	Description
minUnits / maxUnits	integer	Monthly sales volume range
minAmzUnit / maxAmzUnit	integer	Child-ASIN last-30-day sales range (only when querying last-30-day style data, e.g. `dataSnapshotMonth: "nearly"` )
minUnitsGrowthRate / maxUnitsGrowthRate	number	Monthly sales growth rate (%)
minBsr / maxBsr	integer	Main-category BSR rank range
minBsrGrowthRate / maxBsrGrowthRate	number	BSR growth rate (%)
minBsrGrowthCount / maxBsrGrowthCount	integer	BSR growth count
minSubNodeBsrRank / maxSubNodeBsrRank	integer	Subcategory BSR rank (requires filterSubNode = true)

参数	类型	描述
minUnits / maxUnits	integer	月度销量范围
minAmzUnit / maxAmzUnit	integer	子ASIN最近30天销量范围（仅在查询最近30天数据时生效，例如 `dataSnapshotMonth: "nearly"` ）
minUnitsGrowthRate / maxUnitsGrowthRate	number	月度销量增长率（%）
minBsr / maxBsr	integer	主品类BSR排名范围
minBsrGrowthRate / maxBsrGrowthRate	number	BSR增长率（%）
minBsrGrowthCount / maxBsrGrowthCount	integer	BSR提升次数
minSubNodeBsrRank / maxSubNodeBsrRank	integer	子品类BSR排名（需设置filterSubNode = true）

Reviews & Ratings

评价与评分

Parameter	Type	Description
minRating / maxRating	number	Rating score range (0-5); 3.8-4.3 indicates product improvement opportunity
minRatings / maxRatings	integer	Number of ratings range (0-10000)
minRatingsGrowthCount / maxRatingsGrowthCount	integer	Monthly new ratings count
minListingQualityScore / maxListingQualityScore	number	Listing quality score range

参数	类型	描述
minRating / maxRating	number	评分范围（0-5）；3.8-4.3代表存在产品改进空间
minRatings / maxRatings	integer	评价数量范围（0-10000）
minRatingsGrowthCount / maxRatingsGrowthCount	integer	月度新增评价数量
minListingQualityScore / maxListingQualityScore	number	Listing质量得分范围

Product Attributes

商品属性

Parameter	Type	Description
minVariations / maxVariations	integer	Variation count range
minWeights / maxWeights	number	Weight range
weightUnit	string	Weight unit: g, kg, oz, lb (required if weight filters are used)
dimensionType	string	Package dimension type (marketplace-specific codes)
minSellers / maxSellers	integer	Number of sellers range

参数	类型	描述
minVariations / maxVariations	integer	变体数量范围
minWeights / maxWeights	number	重量范围
weightUnit	string	重量单位：g、kg、oz、lb（使用重量筛选时必填）
dimensionType	string	包装尺寸类型（站点专属代码）
minSellers / maxSellers	integer	卖家数量范围

Badges & Fulfillment

标识与配送方式

Parameter	Type	Description
badgeBestSeller	string	Best Seller badge: Y / N / empty (all)
badgeAmazonsChoice	string	Amazon's Choice badge: Y / N / empty (all)
badgeNewRelease	string	New Release badge: Y / N / empty (all)
fulfillment	string	Fulfillment type: AMZ, FBA, FBM (comma-separated for multiple)
showVariation	string	Show variations: Y / N (default N)

参数	类型	描述
badgeBestSeller	string	畅销标识：Y / N / 空值（全部）
badgeAmazonsChoice	string	Amazon's Choice标识：Y / N / 空值（全部）
badgeNewRelease	string	新品标识：Y / N / 空值（全部）
fulfillment	string	配送类型：AMZ、FBA、FBM（多个值用逗号分隔）
showVariation	string	是否显示变体：Y / N（默认N）

Seller & Brand

卖家与品牌

Parameter	Type	Description
sellerNation	string	Seller country code (e.g., US, CN, HK); comma-separated for multiple
includeSellers / excludeSellers	string	Include / exclude specific sellers
includeBrands / excludeBrands	string	Include / exclude specific brands

参数	类型	描述
sellerNation	string	卖家国家代码（例如US、CN、HK）；多个值用逗号分隔
includeSellers / excludeSellers	string	包含/排除特定卖家
includeBrands / excludeBrands	string	包含/排除特定品牌

Listing & Pagination

Listing与分页

Parameter	Type	Description	Default
hideUnlistedProduct	boolean	Hide delisted products	true
listedWithinLastMonths	integer	Listed within last N months (1, 3, 6, 12, or 24)	-
page	integer	Page number, starting from 1	1
size	integer	Results per page (10-100)	20

参数	类型	描述	默认值
hideUnlistedProduct	boolean	隐藏已下架商品	true
listedWithinLastMonths	integer	最近N个月内上架的商品（可选值：1、3、6、12或24）	-
page	integer	页码，从1开始	1
size	integer	每页结果数量（10-100）	20

Sorting

排序

Use the

order

object with two fields:

Field	Type	Description
field	string	Sort field: total_units, total_amount, bsr_rank, price, rating, reviews, profit, reviews_rate, available_date, questions, total_units_growth, total_amount_growth, reviews_increasement, bsr_rank_cv, bsr_rank_cr, amz_unit; use `""` when you intentionally omit a business sort key (per gateway schema)
desc	string	`"true"` for descending, `"false"` for ascending

Default sort:

total_units

descending.

使用

order

对象，包含两个字段：

字段	类型	描述
field	string	排序字段：total_units、total_amount、bsr_rank、price、rating、reviews、profit、reviews_rate、available_date、questions、total_units_growth、total_amount_growth、reviews_increasement、bsr_rank_cv、bsr_rank_cr、amz_unit；若有意省略业务排序键，可使用 `""` （遵循网关架构）
desc	string	`"true"` 表示降序， `"false"` 表示升序

默认排序：

total_units

降序。

Optional gateway / session fields

可选网关/会话字段

If the hosting environment supplies them, you may pass

chatId

uid

requestId

, and

teamId

as strings (see

references/api.md

). They are not required for ad-hoc script calls.

若托管环境提供以下字段，可传入

chatId

、

uid

、

requestId

和

teamId

字符串（详见

references/api.md

）。临时脚本调用无需这些字段。

API Usage

API使用方法

This tool calls the LinkFox tool gateway API. See

references/api.md

for calling conventions, request parameters, and response structure. You can also execute

scripts/sellersprite_product_search.py

directly to run queries.

本工具调用LinkFox工具网关API。调用规范、请求参数和响应结构详见

references/api.md

。您也可以直接执行

scripts/sellersprite_product_search.py

来运行查询。

Usage Examples

使用示例

1. Find high-sales products in a niche Search for products with keyword "yoga mat" in the US marketplace with monthly sales above 500 units, sorted by monthly sales descending.

json

{
  "keyword": "yoga mat",
  "marketplace": "US",
  "minUnits": 500,
  "order": {"field": "total_units", "desc": "true"}
}

2. Discover new product opportunities with low competition Find recently listed products (within 6 months) in the US with fewer than 50 ratings and monthly revenue above $5,000.

json

{
  "keyword": "desk organizer",
  "marketplace": "US",
  "listedWithinLastMonths": 6,
  "maxRatings": 50,
  "minRevenue": 5000,
  "order": {"field": "total_units", "desc": "true"}
}

3. Product improvement opportunity mining Find products with ratings between 3.8 and 4.3 (improvement sweet spot), monthly sales above 300, in a specific category.

json

{
  "keyword": "phone case",
  "marketplace": "US",
  "minRating": 3.8,
  "maxRating": 4.3,
  "minUnits": 300,
  "order": {"field": "total_units", "desc": "true"}
}

4. High-margin product screening Find products with gross margin above 40%, price between $15 and $50, at least 100 monthly sales.

json

{
  "marketplace": "US",
  "minProfit": 40,
  "minPrice": 15,
  "maxPrice": 50,
  "minUnits": 100,
  "order": {"field": "profit", "desc": "true"}
}

5. Seasonal year-over-year comparison Query last year's December snapshot data to compare with current data for seasonal product planning.

json

{
  "keyword": "christmas lights",
  "marketplace": "US",
  "dataSnapshotMonth": "202412",
  "minUnits": 200,
  "order": {"field": "total_units", "desc": "true"}
}

6. Chinese seller competitive landscape Find FBA-fulfilled products from Chinese sellers in a category with high monthly sales.

json

{
  "keyword": "bluetooth speaker",
  "marketplace": "US",
  "sellerNation": "CN",
  "fulfillment": "FBA",
  "minUnits": 200,
  "order": {"field": "total_units", "desc": "true"}
}

7. Best Seller & Amazon's Choice badge holders Find products carrying the Best Seller badge with strong sales performance.

json

{
  "keyword": "water bottle",
  "marketplace": "US",
  "badgeBestSeller": "Y",
  "order": {"field": "total_units", "desc": "true"}
}

8. Fast-growing products by sales growth rate Find products with monthly sales growth rate above 50%.

json

{
  "keyword": "standing desk",
  "marketplace": "US",
  "minUnitsGrowthRate": 50,
  "order": {"field": "total_units_growth", "desc": "true"}
}

1. 寻找细分品类高销量商品 在美国站点搜索关键词“yoga mat”，筛选月度销量500以上的商品，按月度销量降序排序。

json

{
  "keyword": "yoga mat",
  "marketplace": "US",
  "minUnits": 500,
  "order": {"field": "total_units", "desc": "true"}
}

2. 发掘低竞争新品机会 在美国站点寻找最近6个月内上架、评价数少于50且月度营收超过5000美元的商品。

json

{
  "keyword": "desk organizer",
  "marketplace": "US",
  "listedWithinLastMonths": 6,
  "maxRatings": 50,
  "minRevenue": 5000,
  "order": {"field": "total_units", "desc": "true"}
}

3. 挖掘产品改进机会 寻找评分在3.8-4.3之间（改进黄金区间）、月度销量300以上的特定品类商品。

json

{
  "keyword": "phone case",
  "marketplace": "US",
  "minRating": 3.8,
  "maxRating": 4.3,
  "minUnits": 300,
  "order": {"field": "total_units", "desc": "true"}
}

4. 筛选高毛利率商品 寻找毛利率超过40%、价格在15-50美元之间、月度销量至少100的商品。

json

{
  "marketplace": "US",
  "minProfit": 40,
  "minPrice": 15,
  "maxPrice": 50,
  "minUnits": 100,
  "order": {"field": "profit", "desc": "true"}
}

5. 季节性同比对比 查询去年12月的快照数据，与当前数据对比以进行季节性产品规划。

json

{
  "keyword": "christmas lights",
  "marketplace": "US",
  "dataSnapshotMonth": "202412",
  "minUnits": 200,
  "order": {"field": "total_units", "desc": "true"}
}

6. 中国卖家竞争格局分析 寻找美国站点内由中国卖家运营、采用FBA配送且月度销量较高的品类商品。

json

{
  "keyword": "bluetooth speaker",
  "marketplace": "US",
  "sellerNation": "CN",
  "fulfillment": "FBA",
  "minUnits": 200,
  "order": {"field": "total_units", "desc": "true"}
}

7. 畅销标识与Amazon's Choice标识商品 寻找带有畅销标识且销售表现强劲的商品。

json

{
  "keyword": "water bottle",
  "marketplace": "US",
  "badgeBestSeller": "Y",
  "order": {"field": "total_units", "desc": "true"}
}

8. 销量高增长商品 寻找月度销量增长率超过50%的商品。

json

{
  "keyword": "standing desk",
  "marketplace": "US",
  "minUnitsGrowthRate": 50,
  "order": {"field": "total_units_growth", "desc": "true"}
}

Display Rules

展示规则

Present data clearly: Show query results in well-structured tables. Key columns to prioritize: ASIN, title, price, monthly sales, monthly revenue, BSR rank, rating, ratings count, gross margin, fulfillment type
BSR clarification: When showing BSR data, remind users that lower values mean better rankings
Gross margin note: Gross margin values are percentages. Remind users this is an estimate based on price minus FBA fees and estimated costs
Pagination awareness: When the total count exceeds the returned page size, inform the user of the total result count and suggest adjusting page or size parameters to see more results
Snapshot labeling: When displaying historical snapshot data, clearly label the data period (e.g., "Data from December 2024 snapshot") to avoid confusion with real-time data
Error handling: When a query fails, explain the reason based on the
```
message
```
field and suggest adjusting query criteria
Weight unit reminder: When the user provides weight filters without specifying a unit, ask them to confirm the weight unit (g, kg, oz, or lb) before proceeding
Keyword translation: When the user provides keywords in a language different from the target marketplace, translate the keyword to the appropriate language and note the translation

清晰呈现数据：使用结构规整的表格展示查询结果。优先展示关键列：ASIN、标题、价格、月度销量、月度营收、BSR排名、评分、评价数量、毛利率、配送类型
BSR说明：展示BSR数据时，提醒用户数值越低排名越好
毛利率备注：毛利率为百分比数值。提醒用户这是基于价格减去FBA费用和预估成本得出的估算值
分页提示：当总结果数超过当前页显示数量时，告知用户总结果数，并建议调整page或size参数查看更多结果
快照标注：展示历史快照数据时，明确标注数据周期（例如“数据来自2024年12月快照”），避免与实时数据混淆
错误处理：查询失败时，根据
```
message
```
字段说明原因，并建议调整查询条件
重量单位提醒：当用户设置重量筛选但未指定单位时，需先确认重量单位（g、kg、oz或lb）再继续
关键词翻译：当用户提供的关键词与目标站点语言不同时，将关键词转换为对应语言并标注翻译说明

Important Limitations

重要限制

Result cap: Each page returns a maximum of 100 records (size parameter max is 100)
Historical snapshots: Only past monthly snapshots are available; future dates are not supported
Weight unit required: If any weight filter is used, the
```
weightUnit
```
must also be provided
Subcategory BSR: The subcategory BSR rank filters only work when
```
filterSubNode
```
is set to
```
true
```
Listed time enum only: The
```
listedWithinLastMonths
```
parameter only accepts specific values: 1, 3, 6, 12, or 24
Child ASIN 30-day sales filters:
```
minAmzUnit
```
/
```
maxAmzUnit
```
apply only to last-30-day style queries (typically
```
dataSnapshotMonth: "nearly"
```
); do not rely on them for historical
```
yyyyMM
```
snapshots

结果上限：每页最多返回100条记录（size参数最大值为100）
历史快照：仅支持过往月度快照，不支持未来日期
重量单位必填：若使用任何重量筛选，必须同时提供
```
weightUnit
```
子品类BSR：子品类BSR排名筛选仅在
```
filterSubNode
```
设置为
```
true
```
时生效
上架时间仅支持枚举值：
```
listedWithinLastMonths
```
参数仅接受特定值：1、3、6、12或24
子ASIN 30天销量筛选：
```
minAmzUnit
```
/
```
maxAmzUnit
```
仅适用于最近30天数据查询（通常为
```
dataSnapshotMonth: "nearly"
```
）；历史
```
yyyyMM
```
快照不支持该筛选

User Expression & Scenario Quick Reference

用户表述与场景速查

Applicable -- Product-level data queries on Amazon:

User Says	Scenario
"Find products with high sales in XX category"	Niche product search
"Show me low-competition products", "new product opportunities"	Blue ocean product discovery
"Which products have high margins"	Profitability screening
"Products with rising sales", "trending products"	Growth trend detection
"What are Chinese sellers selling well"	Competitive landscape analysis
"Recently launched products doing well"	New product tracking
"Products with bad reviews but good sales"	Product improvement opportunities
"Compare this category with last year"	Seasonal / YoY analysis
"FBA products under $30 with 1000+ sales"	Multi-criteria product filtering
"Best sellers in XX category"	Badge-based product discovery

Not applicable -- Needs beyond product-level search data:

ABA search term / keyword analysis (use ABA Data Explorer instead)
Advertising / PPC campaign data
Product review text analysis
Listing copywriting or optimization
Supplier sourcing or manufacturing costs
Logistics and inventory planning

Boundary judgment: When users say "product research" or "market analysis", if it boils down to filtering Amazon products by sales, price, BSR, ratings, and other product attributes, then this skill applies. If they are asking about keyword search volume, search term rankings, or click/conversion share data, the ABA Data Explorer skill is more appropriate.

Feedback:

Auto-detect and report feedback via the Feedback API when any of the following apply:

The functionality or purpose described in this skill does not match actual behavior
The skill's results do not match the user's intent
The user expresses dissatisfaction or praise about this skill
Anything you believe could be improved

Call the feedback API as specified in

references/api.md

. Do not interrupt the user's flow.

For more high-quality, professional cross-border e-commerce skills, set LinkFox Skills.

适用场景 -- 亚马逊商品级数据查询：

用户表述	场景
“寻找XX品类高销量商品”	细分品类商品搜索
“展示低竞争商品”、“新品机会”	蓝海产品发掘
“哪些商品毛利率高”	盈利能力筛选
“销量增长的商品”、“趋势商品”	增长趋势检测
“中国卖家哪些商品卖得好”	竞争格局分析
“近期上架的热销商品”	新品追踪
“销量好但评价差的商品”	产品改进机会挖掘
“对比今年与去年的XX品类”	季节性/同比分析
“30美元以下、销量1000+的FBA商品”	多条件商品筛选
“XX品类的畅销商品”	基于标识的商品发掘

不适用场景 -- 超出商品级搜索数据的需求：

ABA搜索词/关键词分析（请使用ABA Data Explorer）
广告/PPC活动数据
商品评价文本分析
Listing文案撰写或优化
供应商采购或制造成本
物流与库存规划

边界判断：当用户提到“产品调研”或“市场分析”时，如果核心需求是通过销量、价格、BSR、评分等商品属性筛选亚马逊商品，则适用本技能。如果用户询问的是关键词搜索量、搜索词排名或点击/转化占比数据，则更适合使用ABA Data Explorer技能。

反馈：

当出现以下情况时，自动通过反馈API检测并上报：

本技能描述的功能或用途与实际行为不符
技能结果与用户意图不匹配
用户表达对本技能的不满或赞赏
任何您认为可以改进的内容

按照

references/api.md

中的说明调用反馈API，请勿打断用户流程。

如需更多优质专业的跨境电商技能，请访问LinkFox Skills。