linkfox-sellersprite-competitor

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

SellerSprite Competitor Lookup

This skill guides you on how to query and analyze Amazon competitor product data, helping Amazon sellers discover competing products, benchmark performance, and extract actionable competitive intelligence.

本技能将指导您如何查询和分析亚马逊竞品数据，帮助亚马逊卖家发现竞品、对标绩效并提取可落地的竞争情报。

Core Concepts

核心概念

The SellerSprite Competitor Lookup tool provides comprehensive Amazon product data across 12 marketplaces. It allows querying products by ASIN, keyword, seller name, brand, or category, and returns detailed metrics including monthly sales volume, revenue, BSR ranking, pricing, ratings, and growth trends.

Data snapshots: The tool supports both real-time data (last 30 days) and historical monthly snapshots. Use

nearly

(default) for current data or a

yyyyMM

format (e.g.,

) for historical snapshots. Historical snapshots capture all active listings for that month, enabling year-over-year and seasonal comparisons.

Category hierarchy: Amazon category names support multi-level paths separated by colons (

). For example,

Electronics:Computers & Accessories:Monitors

. Convert user-provided category descriptions into the proper colon-separated format.

SellerSprite竞品查询工具可提供覆盖12个亚马逊站点的全面商品数据。支持通过ASIN、关键词、卖家名称、品牌或品类查询商品，并返回包含月销量、营收、BSR排名、定价、评分和增长趋势在内的详细指标。

数据快照：工具支持实时数据（最近30天）和历史月度快照。使用

nearly

（默认值）获取当前数据，或使用

yyyyMM

格式（例如

）获取历史快照。历史快照会记录当月所有活跃Listing，支持同比和季节性对比。

品类层级：亚马逊品类名称支持用冒号（:

）分隔的多级路径。例如

Electronics:Computers & Accessories:Monitors

。需将用户提供的品类描述转换为正确的冒号分隔格式。

Supported Marketplaces

支持的站点

US (United States), UK (United Kingdom), DE (Germany), FR (France), JP (Japan), CA (Canada), IT (Italy), ES (Spain), MX (Mexico), AU (Australia), TR (Turkey), IN (India)

Default marketplace is US. Use US when the user does not specify a marketplace.

US（美国）、UK（英国）、DE（德国）、FR（法国）、JP（日本）、CA（加拿大）、IT（意大利）、ES（西班牙）、MX（墨西哥）、AU（澳大利亚）、TR（土耳其）、IN（印度）

默认站点为US。用户未指定站点时，使用US站点。

Parameter Guide

参数指南

Search Filters

搜索筛选条件

Parameter	Description	Example
marketplace	Amazon marketplace code	`US` , `UK` , `DE` , `JP`
keyword	Search keyword (translate to the marketplace language)	`wireless earbuds`
asinList	One or more ASINs, comma-separated (max 40)	`B072MQ5BRX,B08N5WRWNW`
sellerName	Seller name to filter by	`Anker Direct`
brand	Brand name to filter by	`Anker`
nodeLabel	Amazon category name (colon-separated levels)	`Electronics:Headphones`
nodeIdPath	Amazon category ID path	`172282`
matchType	Keyword match mode: 1 = phrase, 2 = fuzzy, 3 = exact (default 1)	`1`
showVariation	Show product variations: `Y` or `N` (default `N` )	`N`
dataSnapshotMonth	Data snapshot month ( `nearly` for real-time, or `yyyyMM` )	`nearly`

参数	说明	示例
marketplace	亚马逊站点代码	`US` , `UK` , `DE` , `JP`
keyword	搜索关键词（需转换为对应站点语言）	`wireless earbuds`
asinList	一个或多个ASIN，逗号分隔（最多40个）	`B072MQ5BRX,B08N5WRWNW`
sellerName	筛选卖家名称	`Anker Direct`
brand	筛选品牌名称	`Anker`
nodeLabel	亚马逊品类名称（冒号分隔层级）	`Electronics:Headphones`
nodeIdPath	亚马逊品类ID路径	`172282`
matchType	关键词匹配模式：1=短语匹配，2=模糊匹配，3=精确匹配（默认1）	`1`
showVariation	是否显示商品变体： `Y` 或 `N` （默认 `N` ）	`N`
dataSnapshotMonth	数据快照月份（ `nearly` 表示实时数据，或 `yyyyMM` 格式）	`nearly`

Pagination & Sorting

分页与排序

Parameter	Description	Example
page	Page number, starting from 1	`1`
size	Results per page, 10-100 (default 50)	`50`
order.field	Sort field (see sort options below)	`total_units`
order.desc	Sort direction: `true` = descending, `false` = ascending	`true`

参数	说明	示例
page	页码，从1开始	`1`
size	每页结果数量，10-100（默认50）	`50`
order.field	排序字段（见下方排序选项）	`total_units`
order.desc	排序方向： `true` =降序， `false` =升序	`true`

Sort Field Options

排序字段选项

Field	Description
total_units	Monthly sales units
total_amount	Monthly sales revenue
bsr_rank	BSR ranking
price	Price
rating	Rating score
reviews	Number of reviews
profit	Gross margin
reviews_rate	Review rate
available_date	Listing date
questions	Q&A count
total_units_growth	Monthly sales unit growth rate
total_amount_growth	Monthly revenue growth rate
reviews_increasement	Monthly new reviews
bsr_rank_cv	7-day BSR growth count
bsr_rank_cr	7-day BSR growth rate
amz_unit	Variant sales units

字段	说明
total_units	月销量
total_amount	月销售额
bsr_rank	BSR排名
price	商品价格
rating	评分
reviews	评论数量
profit	毛利率
reviews_rate	评论率
available_date	Listing上架日期
questions	Q&A数量
total_units_growth	月销量增长率
total_amount_growth	月销售额增长率
reviews_increasement	月度新增评论数
bsr_rank_cv	7天BSR变化值
bsr_rank_cr	7天BSR变化率
amz_unit	变体销量

Key Response Fields

核心响应字段

Field	Description
asin	Product ASIN
title	Product title
price	Current price
monthlySalesUnits	Monthly sales volume
monthlySalesRevenue	Monthly sales revenue
bsr	BSR ranking
bsrGrowthRate	BSR growth rate
bsrGrowthCount	BSR growth count
rating	Rating score
ratings	Number of ratings
ratingsGrowth	Monthly new ratings
ratingsRate	Review rate
brand	Brand name
sellerName	BuyBox seller
sellerNation	BuyBox seller nationality
fulfillment	Fulfillment type (AMZ/FBA/FBM)
availableDateString	Listing date
profit	Gross margin
nodeLabelPath	Category path
imageUrl	Product image URL
monthlySalesUnitsGrowthRate	Monthly sales growth rate
listingQualityScore	Listing quality score
variationNum	Number of variations
parent	Parent ASIN
badgeBestSeller	Best Seller badge (Y/N)
badgeAmazonChoice	Amazon's Choice badge (Y/N)
badgeEbc	A+ Content (Y/N)
badgeVideo	Video present (Y/N)

字段	说明
asin	商品ASIN
title	商品标题
price	当前价格
monthlySalesUnits	月销量
monthlySalesRevenue	月销售额
bsr	BSR排名
bsrGrowthRate	BSR变化率
bsrGrowthCount	BSR变化值
rating	评分
ratings	评分数量
ratingsGrowth	月度新增评分数
ratingsRate	评论率
brand	品牌名称
sellerName	BuyBox卖家
sellerNation	BuyBox卖家国籍
fulfillment	配送类型（AMZ/FBA/FBM）
availableDateString	上架日期
profit	毛利率
nodeLabelPath	品类路径
imageUrl	商品图片URL
monthlySalesUnitsGrowthRate	月销量增长率
listingQualityScore	Listing质量得分
variationNum	变体数量
parent	父ASIN
badgeBestSeller	畅销标识（Y/N）
badgeAmazonChoice	Amazon's Choice标识（Y/N）
badgeEbc	A+内容标识（Y/N）
badgeVideo	视频标识（Y/N）

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_competitor_lookup.py

directly to run queries.

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

references/api.md

。您也可以直接执行

scripts/sellersprite_competitor_lookup.py

来运行查询。

Usage Examples

使用示例

1. Look up competitors by ASIN

json

{
  "marketplace": "US",
  "asinList": "B072MQ5BRX,B08N5WRWNW"
}

Use case: Analyze specific competing products by their ASINs.

2. Search competitors by keyword

json

{
  "marketplace": "US",
  "keyword": "wireless earbuds",
  "matchType": 1,
  "order": {"field": "total_units", "desc": "true"},
  "size": 20
}

Use case: Discover top-selling products for a keyword, sorted by monthly sales.

3. Filter by brand and category

json

{
  "marketplace": "US",
  "brand": "Anker",
  "nodeLabel": "Electronics:Headphones",
  "order": {"field": "total_amount", "desc": "true"}
}

Use case: Analyze a specific brand's product lineup within a category.

4. Find products by seller name

json

{
  "marketplace": "DE",
  "sellerName": "Anker Direct",
  "order": {"field": "bsr_rank", "desc": "false"}
}

Use case: View all products from a particular seller sorted by BSR.

5. Historical snapshot comparison

json

{
  "marketplace": "US",
  "keyword": "space heater",
  "dataSnapshotMonth": "202412",
  "order": {"field": "total_units", "desc": "true"},
  "size": 20
}

Use case: Analyze seasonal product performance using historical data snapshots.

6. Show product variations

json

{
  "marketplace": "JP",
  "asinList": "B0XXXXXXXXX",
  "showVariation": "Y"
}

Use case: Examine all variation-level data for a product family.

1. 通过ASIN查询竞品

json

{
  "marketplace": "US",
  "asinList": "B072MQ5BRX,B08N5WRWNW"
}

适用场景：通过ASIN分析特定竞品。

2. 通过关键词搜索竞品

json

{
  "marketplace": "US",
  "keyword": "wireless earbuds",
  "matchType": 1,
  "order": {"field": "total_units", "desc": "true"},
  "size": 20
}

适用场景：发现某关键词下的畅销商品，按月销量排序。

3. 按品牌和品类筛选

json

{
  "marketplace": "US",
  "brand": "Anker",
  "nodeLabel": "Electronics:Headphones",
  "order": {"field": "total_amount", "desc": "true"}
}

适用场景：分析特定品牌在某品类下的商品矩阵。

4. 通过卖家名称查找商品

json

{
  "marketplace": "DE",
  "sellerName": "Anker Direct",
  "order": {"field": "bsr_rank", "desc": "false"}
}

适用场景：查看特定卖家的所有商品，按BSR升序排序。

5. 历史快照对比

json

{
  "marketplace": "US",
  "keyword": "space heater",
  "dataSnapshotMonth": "202412",
  "order": {"field": "total_units", "desc": "true"},
  "size": 20
}

适用场景：使用历史数据快照分析季节性商品表现。

6. 显示商品变体

json

{
  "marketplace": "JP",
  "asinList": "B0XXXXXXXXX",
  "showVariation": "Y"
}

适用场景：查看某商品系列的所有变体数据。

Display Rules

展示规则

Present data clearly: Show query results in well-formatted tables. Include key metrics such as ASIN, title, price, monthly sales, BSR, rating, and brand. Do not provide subjective business advice unless the user asks for it.
Keyword language: When searching by keyword, always translate the keyword to the target marketplace language (e.g., English for US/UK, German for DE, Japanese for JP). Remind the user of this if they provide keywords in the wrong language.
BSR clarification: When displaying BSR data, remind users that a lower BSR value indicates stronger sales performance.
Growth metrics: When showing growth rates, clarify whether positive values mean improvement or decline (positive BSR growth count means BSR increased, which means worsened ranking).
Pagination notice: When the total result count exceeds the returned page size, inform the user of the total count and offer to fetch additional pages.
Badge highlights: When products carry badges (Best Seller, Amazon's Choice, A+ Content, Video), highlight these in the results as they are important competitive signals.
Error handling: When a query fails, explain the reason based on the
```
message
```
field and suggest adjusting query parameters.
Snapshot guidance: When users want to do seasonal or trend analysis, proactively suggest using historical snapshots (e.g., last year's same month) for comparison.

清晰呈现数据：将查询结果以格式规范的表格展示，包含ASIN、标题、价格、月销量、BSR、评分和品牌等核心指标。除非用户主动询问，否则不提供主观商业建议。
关键词语言适配：通过关键词搜索时，需将关键词转换为目标站点的语言（例如美英站点用英文，德国站点用德文，日本站点用日文）。若用户提供的关键词语言不符，需提醒用户。
BSR说明：展示BSR数据时，需提醒用户BSR数值越低，销售表现越强。
增长指标说明：展示增长率时，需明确正值代表的变化（例如BSR变化值为正表示BSR上升，即排名下降）。
分页提示：当总结果数超过返回的页面容量时，需告知用户总数量并提供获取更多页面的选项。
标识高亮：若商品带有畅销标识、Amazon's Choice标识、A+内容或视频，需在结果中高亮显示，因为这些是重要的竞争信号。
错误处理：查询失败时，需根据
```
message
```
字段说明原因，并建议调整查询参数。
快照引导：当用户需要进行季节性或趋势分析时，主动建议使用历史快照（例如去年同期）进行对比。

Important Limitations

重要限制

Result cap: Each page returns 10-100 records (controlled by
```
size
```
). Use pagination for larger result sets.
ASIN limit: A maximum of 40 ASINs can be queried at once via
```
asinList
```
.
Historical snapshots: Only existing monthly snapshots can be queried; future dates are not supported.
Keyword language: Keywords should match the marketplace language for best results.

结果上限：每页返回10-100条记录（由
```
size
```
参数控制）。如需获取更多结果，请使用分页功能。
ASIN数量限制：通过
```
asinList
```
一次最多可查询40个ASIN。
历史快照限制：仅可查询已存在的月度快照，不支持未来日期。
关键词语言要求：关键词需匹配站点语言以获得最佳结果。

User Expression & Scenario Quick Reference

用户表述与场景速查

Applicable -- Amazon competitor product data queries:

User Says	Scenario
"Find competitors for this ASIN"	ASIN-based competitor lookup
"Top sellers for wireless earbuds"	Keyword-based product discovery
"What is this seller selling"	Seller product portfolio analysis
"Show me products in Electronics category"	Category-based browsing
"Monthly sales for these ASINs"	Sales estimation for specific products
"New products gaining traction"	Growth trend detection
"Compare products across brands"	Brand benchmarking
"How was this niche last December"	Historical snapshot analysis
"Best sellers with high ratings"	Multi-metric filtering
"FBA vs FBM in this category"	Fulfillment type analysis

Not applicable -- Needs beyond competitor product data:

ABA search term data or keyword ranking (use ABA Data Explorer instead)
Advertising / PPC campaign management
Product reviews content or sentiment analysis
Listing copywriting or optimization suggestions
Supplier sourcing or manufacturing costs
Account health or policy compliance

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.

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

用户表述	场景
"帮我查这个ASIN的竞品"	基于ASIN的竞品查询
"wireless earbuds的畅销商品"	基于关键词的商品发现
"这个卖家在卖什么"	卖家商品矩阵分析
"展示Electronics品类的商品"	基于品类的浏览
"这些ASIN的月销量是多少"	特定商品销量估算
"正在崛起的新品"	增长趋势检测
"跨品牌商品对比"	品牌对标分析
"去年12月这个细分品类表现如何"	历史快照分析
"高评分的畅销商品"	多指标筛选
"这个品类里FBA和FBM的对比"	配送类型分析

不适用场景 -- 超出竞品数据范畴的需求：

ABA搜索词数据或关键词排名（请使用ABA Data Explorer）
广告/PPC活动管理
商品评论内容或情感分析
Listing文案撰写或优化建议
供应商采购或制造成本
账号健康或政策合规

反馈机制：

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

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

请按照

references/api.md

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

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