linkfox-sellersprite-competitor-lookup

SellerSprite 竞品查询

本技能将指导你如何查询和分析 Amazon 竞品商品数据，帮助 Amazon 卖家发现竞品、对标业绩并提取可执行的竞争情报。

核心概念

SellerSprite 竞品查询工具提供覆盖 12 个站点的全面 Amazon 商品数据。你可以按 ASIN、关键词、卖家名称、品牌或类目查询商品，并获取月销量、收入、BSR 排名、价格、评分和增长趋势等详细指标。

数据快照：该工具支持实时数据（最近 30 天）和历史月度快照。使用 nearly（默认值）查询当前数据，或使用 yyyyMM 格式（例如 202501）查询历史快照。历史快照包含该月所有在售商品，可用于同比和季节性对比。

类目层级：Amazon 类目名称支持使用冒号（:）分隔的多级路径。例如：Electronics:Computers & Accessories:Monitors。请将用户提供的类目描述转换为正确的冒号分隔格式。

支持的站点

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

默认站点为 US。如果用户未指定站点，请使用 US。

参数指南

搜索筛选条件

参数	描述	示例
marketplace	Amazon 站点代码	US、UK、DE、JP
keyword	搜索关键词（翻译为站点对应的语言）	wireless earbuds
asinList	一个或多个 ASIN，以逗号分隔（最多 40 个）	B072MQ5BRX,B08N5WRWNW
sellerName	用于筛选的卖家名称	Anker Direct
brand	品牌名称	Anker
nodeLabel	Amazon 类目名称（以冒号分隔层级）	Electronics:Headphones
nodeIdPath	Amazon 类目 ID 路径	172282
matchType	关键词匹配模式：1 = 短语，2 = 模糊，3 = 精确（默认值为 1）	1
showVariation	显示商品变体：Y 或 N（默认值为 N）	N
dataSnapshotMonth	数据快照月份（实时数据用 nearly，或使用 yyyyMM）	nearly

分页与排序

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

排序字段选项

字段	描述
total_units	月销量
total_amount	月销售额
bsr_rank	BSR 排名
price	价格
rating	评分
reviews	评论数
profit	毛利率
reviews_rate	评论率
available_date	上架日期
questions	问答数
total_units_growth	月销量增长率
total_amount_growth	月销售额增长率
reviews_increasement	月新增评论数
bsr_rank_cv	7 天 BSR 增长次数
bsr_rank_cr	7 天 BSR 增长率
amz_unit	变体销量

关键响应字段

字段	描述
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	商品信息质量评分
variationNum	变体数量
parent	父 ASIN
badgeBestSeller	Best Seller 徽章（Y/N）
badgeAmazonChoice	Amazon's Choice 徽章（Y/N）
badgeEbc	A+ Content（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 进入上下文。

解决认证和算力问题

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

异常情况

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

使用示例

1. 按 ASIN 查找竞争对手

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

使用场景：按 ASIN 分析特定竞品。

2. 按关键词搜索竞争对手

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

使用场景：查找某个关键词的热销商品，并按月销量排序。

3. 按品牌和类目筛选

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

使用场景：分析某个品牌在某个类目中的商品系列。

4. 按卖家名称查找商品

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

使用场景：查看某个卖家的所有商品，并按 BSR 排序。

5. 历史快照对比

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

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

6. 查看商品变体

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

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

展示规则

1. 清晰呈现数据：以格式规范的表格展示查询结果。包含 ASIN、标题、价格、月销量、BSR、评分和品牌等关键指标。除非用户要求，否则不要提供主观的商业建议。
2. 关键词语言：按关键词搜索时，始终将关键词翻译成目标市场语言（例如，美国／英国用英语，德国用德语，日本用日语）。如果用户提供的关键词语言不正确，请提醒用户。
3. BSR 说明：展示 BSR 数据时，请提醒用户，BSR 数值越低，销售表现越好。
4. 增长指标：展示增长率时，请说明正值代表改善还是下降（BSR 增长计数为正表示 BSR 上升，也就是排名变差）。
5. 分页提示：当结果总数超过当前返回页的记录数时，请告知用户结果总数，并询问是否要获取后续页面。
6. 徽章标注：如果商品带有徽章（Best Seller、Amazon's Choice、A+ Content、Video），请在结果中突出显示，因为这些是重要的竞争信号。
7. 错误处理：查询失败时，根据 message 字段说明原因，并建议调整查询参数。
8. 快照指南：用户想进行季节性或趋势分析时，主动建议使用历史快照（例如去年同月）进行比较。

重要限制

• 结果上限：每页返回 10-100 条记录（由 size 控制）。更大的结果集请使用分页。
• ASIN 上限：通过 asinList 一次最多可查询 40 个 ASIN。
• 历史快照：只能查询已有的月度快照；不支持未来日期。
• 关键词语言：为获得最佳结果，关键词应与市场语言一致。

用户表达与场景速查

适用——Amazon 竞品商品数据查询：

用户说法	场景
“查找这个 ASIN 的竞品”	基于 ASIN 查询竞品
“无线耳机畅销商品”	基于关键词发现商品
“这个卖家在卖什么”	卖家商品组合分析
“显示 Electronics 类目中的商品”	按类目浏览
“这些 ASIN 的月销量”	估算指定商品的销量
“正在走红的新商品”	检测增长趋势
“比较不同品牌的商品”	品牌对标
“去年 12 月这个细分市场表现如何”	历史快照分析
“高评分的畅销商品”	多指标筛选
“这个类目中的 FBA 与 FBM”	配送类型分析

不适用——超出竞品商品数据范围：

• ABA 搜索词数据或关键词排名（请改用 ABA Data Explorer）
• 广告／PPC 活动管理
• 商品评论内容或情感分析
• 商品详情页文案撰写或优化建议
• 供应商寻源或制造成本
• 账户健康状况或政策合规

算力消耗规则

消耗 15 算力。

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

反馈：

当符合以下任一情况时，通过 Feedback API 自动检测并提交反馈：

1. 此技能所描述的功能或用途与实际行为不符
2. 此技能的结果与用户意图不符
3. 用户表达对本技能的不满或赞赏
4. 你认为有任何可以改进之处

请按照 references/api.md 中的说明调用反馈 API。不要打断用户的操作流程。

---

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