linkfox-sellersprite-competitor

Name: linkfox-sellersprite-competitor
Author: linkfox-ai

github.com/linkfox-ai营销与增长113170 次安装2 周前更新

代码仓库

关于 linkfox-sellersprite-competitor

面向 Amazon 卖家的竞品查询 Skill，使用 SellerSprite 数据按 ASIN、关键词、卖家、品牌或类目检索商品。覆盖 12 个市场，并提供当前及历史月度指标。

主要功能

01按 ASIN、关键词、卖家、品牌或类目搜索
02覆盖 12 个 Amazon 市场
03月销量、营收和 BSR 指标
04当前及历史数据快照
05商品变体与增长数据

适用场景

01查找关键词下的主要竞品
02对比品牌或卖家表现
03比较不同快照的季节性表现
04查看商品变体和增长情况

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/linkfox-ai/linkfox-skills --skill linkfox-sellersprite-competitor

安装后在 Claude Code 中输入/linkfox-sellersprite-competitor确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/

api.md

scripts/

response_io.py

sellersprite_competitor_lookup.py

详细介绍

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 用法

此工具调用 LinkFox 工具网关 API。调用约定、请求参数和响应结构请参阅 references/api.md。你也可以直接运行 scripts/sellersprite_competitor_lookup.py 执行查询。

使用示例

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"
}

适用场景：查看某个产品系列中所有变体级别的数据。

显示规则

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

重要限制

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

用户表达与场景速查

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

用户表达	场景
"Find competitors for this ASIN"	基于 ASIN 查找竞品
"Top sellers for wireless earbuds"	基于关键词发现产品
"What is this seller selling"	卖家产品组合分析
"Show me products in Electronics category"	基于类目浏览
"Monthly sales for these ASINs"	特定产品的销量估算
"New products gaining traction"	增长趋势检测
"Compare products across brands"	品牌基准对比
"How was this niche last December"	历史快照分析
"Best sellers with high ratings"	多指标筛选
"FBA vs FBM in this category"	配送类型分析

不适用 —— 超出竞品产品数据的需求：

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

反馈：

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

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

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

处理大型响应

为避免 Agent 上下文溢出，请将响应保存到磁盘，并仅提取所需字段：

python scripts/response_io.py run --script scripts/sellersprite_competitor_lookup.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # or --path "<JMESPath>"

将 --out-dir 指定在任何 git 工作树之外（例如，Unix 上的 /tmp/...，Windows 上的 %TEMP%/...）。持久化的响应可能包含个人身份信息、定价或与身份验证相关的敏感数据——请勿提交这些文件。文件不会自动删除；任务完成后请清理。

run 会将完整响应写入文件，并仅输出架构预览和文件路径。read 可筛选特定字段；使用 --limit/--offset 分段读取，使用 --format json|jsonl|csv|table 指定输出格式。

建议采用此模式的情况——根据响应特征自行判断，例如：

每条记录的字段很多，或包含不需要的字段
批量 / 分页结果（每次调用返回多个条目）
长文本字段（描述、评论、HTML、时间序列）
响应会在后续步骤中重复使用，而非立即处理

对于小型且只使用一次的响应，直接调用主脚本即可。

⚠️ 预览是截断后的架构和样本，并非完整数据。任何字段级判断都必须通过 read 从持久化文件中读取。

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

支持 Markdown

登录后评论

基本信息

作者: linkfox-ai
仓库: linkfox-ai/linkfox-skills
分类: 营销与增长
安装次数: 170
GitHub Stars: 113

报告问题