linkfox-sellersprite-competitor-lookup

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

SellerSprite Competitor Lookup

SellerSprite 竞品查询工具

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	问答数量
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	Listing上架日期
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 端点：

POST /sellersprite/competitor-lookup

（完整参数/响应/错误码见

references/api.md

）

Python 脚本：

python scripts/sellersprite_competitor_lookup.py '<JSON 参数>' [--inline]

成本约束：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。

输出策略（脚本默认行为）：

始终将完整响应写入
```
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-sellersprite-competitor-lookup-<timestamp>.json
```
（
```
<cwd>
```
为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；
```
<session>
```
取自环境变量
```
SESSION_ID
```
，按用户任务自动聚合；禁止写入 /tmp，当前目录不可写则报错）
响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout
响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如
```
total
```
/
```
costToken
```
、最大列表字段的长度 + 前 3 条样本）
加
```
--inline
```
强制全量打印到 stdout（同样落盘）

读数据建议：先看摘要判断是否足够；需要具体字段时优先用

jq

或

ConvertFrom-Json

从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。

API 端点：
```
POST /sellersprite/competitor-lookup
```
（完整参数/响应/错误码详见
```
references/api.md
```
）

Python 脚本：

python scripts/sellersprite_competitor_lookup.py '<JSON 参数>' [--inline]

成本约束：本工具会消耗积分；同一会话内同一参数组合默认仅调用一次，脚本带有24小时本地缓存。失败/空结果不得自动更换关键词、翻页或修改邮编连续试探；如需继续检索，需先向用户说明会产生额外消耗。

输出策略（脚本默认行为）：

始终将完整响应写入
```
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-sellersprite-competitor-lookup-<timestamp>.json
```
（
```
<cwd>
```
为脚本执行时的工作目录，在Claude Code中即当前项目目录；
```
<session>
```
取自环境变量
```
SESSION_ID
```
，按用户任务自动聚合；禁止写入/tmp目录，若当前目录不可写则报错）
响应体 ≤ 8 KB：落盘后将完整JSON打印至stdout
响应体 > 8 KB：落盘后仅在stdout输出摘要（顶层字段、常见计数如
```
total
```
/
```
costToken
```
、最大列表字段的长度+前3条样本）
添加
```
--inline
```
参数可强制将全量内容打印至stdout（同样会落盘）

读数据建议：先查看摘要判断是否满足需求；如需具体字段，优先使用

jq

或

ConvertFrom-Json

从保存的JSON文件中按需抽取，避免整份JSON进入上下文。

解决认证和积分问题

发生以下异常情况时，采用 references/onboarding.md 引导解决问题：

发生以下异常情况时，按照

references/onboarding.md

中的指引解决问题：

异常情况

未配置API Key：环境变量未配置
```
LINKFOX_AGENT_API_KEY
```
，也未配置
```
LINKFOXAGENT_API_KEY
```
。
响应401或402状态码
响应提示积分或余额不足：消息含"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"，或类似含义的内容。

未配置API Key：环境变量未配置
```
LINKFOX_AGENT_API_KEY
```
，也未配置
```
LINKFOXAGENT_API_KEY
```
。
响应401或402状态码
响应提示积分或余额不足：消息包含“积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值”或类似含义的内容。

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、评分、品牌等核心指标。除非用户主动询问，否则不提供主观商业建议。
关键词语言适配：通过关键词搜索时，需将关键词转换为目标站点的语言（例如：US/UK站点用英文，DE站点用德文，JP站点用日文）。若用户提供的关键词语言不符，需提醒用户。
BSR说明：展示BSR数据时，需提醒用户BSR数值越低，代表销售表现越强。
增长指标说明：展示增长率时，需明确正值代表的含义（例如：BSR增长值为正意味着BSR排名上升，即销售表现变差）。
分页提示：当结果总条数超过当前返回的每页数量时，需告知用户总条数，并提供获取更多页面的选项。
标识高亮：若商品带有畅销标识（Best Seller）、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

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

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

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

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

积分消耗规则

消耗 15 积分。

用户会因积分消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对积分消耗量预期不足时，务必提醒用户，由用户决定是否继续。

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.

消耗 15 积分。

用户会因积分消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对积分消耗量预期不足时，务必提醒用户，由用户决定是否继续。

反馈机制：

出现以下任意情况时，通过Feedback API自动检测并提交反馈：

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

请按照

references/api.md

中的说明调用反馈API，不要中断用户的流程。

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