卖家精灵-查竞品
基本信息
- 业务工具名:
/sellersprite/competitor-lookup
- 所属分组:卖家精灵 · 亚马逊选品
- 功能说明:支持按亚马逊站点、多个asin、关键词、卖家名称来 查询 亚马逊的商品。
- 关键词:卖家精灵, 查竞品, 竞品分析, ASIN反查, 销量趋势, 流量来源, 竞品工具
何时使用
当用户意图与“卖家精灵-查竞品”匹配,或需要以下能力时使用本工具:支持按亚马逊站点、多个asin、关键词、卖家名称来 查询 亚马逊的商品。
调用前应先确认所有必填参数。涉及站点、国家、日期、语言、ASIN、SKU、图片或 URL 时,应使用用户提供的信息,不要擅自虚构真实业务标识。
输入参数
| 字段 |
类型 |
必填 |
约束/默认值 |
说明 |
uid |
string |
否 |
最长 1000 |
用户id |
page |
integer |
否 |
默认 1 |
页码,从1开始 |
size |
integer |
否 |
默认 50;最小 10 |
每页条数,返回10-100条数据 |
brand |
string |
否 |
最长 1000 |
品牌 |
order |
object |
否 |
|
|
chatId |
string |
否 |
最长 1000 |
对话id |
teamId |
string |
否 |
最长 1000 |
团队id |
keyword |
string |
否 |
最长 1000 |
关键字;请尽量翻译为对应国家的语言,比如美国用英语关键词,德国用德语关键词等等 |
asinList |
string |
否 |
格式 ^[A-Z0-9]+(,[A-Z0-9]+){0,39}$;示例:B072MQ5BRX,B08N5WRWNW |
asin,多个asin使用英文逗号分隔,最多40个 |
matchType |
integer |
否 |
默认 1;示例:1, 2, 3 |
匹配方式,1词组匹配 2模糊匹配 3精准匹配;默认1 |
nodeLabel |
string |
否 |
最长 1000 |
亚马逊类目名称 |
requestId |
string |
否 |
最长 1000 |
推送id |
nodeIdPath |
string |
否 |
最长 1000 |
亚马逊类目id |
sellerName |
string |
否 |
最长 1000 |
卖家名称 |
marketplace |
string |
否 |
默认 "US";最长 1000;示例:US, UK, DE, FR, JP, CA, IT, ES |
市场 |
showVariation |
string |
否 |
默认 "N";最长 1000;示例:Y, N |
是否查询变体 |
dataSnapshotMonth |
string |
否 |
默认 "nearly";最长 1000;示例:nearly, 202412, 202501 |
亚马逊商品数据快照年月。指定查询特定历史时间点的商品数据快照,每个快照包含该月份所有在售商品的完整数据。格式:yyyyMM(如202412表示2024年12月所有在售商品的数据快照)。默认值 'nearly' 表示查询最近30天的实时数据。注意:数据快照是对特定月份亚马逊市场上所有在售商品的完整记录,用于历史分析和同期对比。仅支持查询已存在的历史快照,不支持未来日期。建议季节性分析时查询去年同期快照进行对比 |
嵌套输入结构:order
| 字段 |
类型 |
必填 |
约束/默认值 |
说明 |
desc |
string |
是 |
默认 "true";最长 1000 |
true为降序 false为升序 |
field |
string |
是 |
默认 "total_units";最长 1000;示例:total_units, total_amount, bsr_rank, price, rating, reviews, profit, reviews_rate |
排序字段 |
MCP 调用示例
向以下地址发起 HTTP POST:
https://mcp-tool-gateway.linkfox.com/mcp/any-tool
请求体:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "/sellersprite/competitor-lookup",
"arguments": {
"page": 1
}
}
}
示例值仅用于展示请求结构。实际调用时必须替换为用户的真实查询条件。
输出字段
| 字段 |
类型 |
必填 |
约束/默认值 |
说明 |
type |
string |
否 |
|
渲染的样式 |
total |
integer |
否 |
|
总行数 |
columns |
array<object> |
否 |
|
渲染的列 |
message |
string |
否 |
|
执行消息 |
products |
array<object> |
否 |
|
竞品列表 |
costToken |
integer |
否 |
|
消耗token |
nodeLabel |
string |
否 |
|
nodeLabel |
sourceType |
string |
否 |
|
来源类型:amazon |
嵌套输出结构:products
| 字段 |
类型 |
必填 |
约束/默认值 |
说明 |
bsr |
integer |
否 |
|
BSR 排名 |
fba |
number |
否 |
|
fba运费 |
sku |
string |
否 |
|
sku |
asin |
string |
否 |
|
asin |
badge |
object |
否 |
|
|
brand |
string |
否 |
|
品牌 |
bsrId |
string |
否 |
|
BSR id |
price |
number |
否 |
|
价格 |
title |
string |
否 |
|
商品标题 |
nodeId |
integer |
否 |
|
节点id |
parent |
string |
否 |
|
父体ASIN |
profit |
number |
否 |
|
利润率 |
rating |
number |
否 |
|
评分 |
weight |
string |
否 |
|
重量 |
keyword |
string |
否 |
|
对应筛选的关键词,如果有值,则表示这批数据是通过 这个关键词 keyword 搜索出来的 |
ratings |
integer |
否 |
|
评分数 |
badgeEbc |
string |
否 |
|
A+页面(Y/N) |
brandUrl |
string |
否 |
|
品牌URL |
currency |
string |
否 |
|
币种 |
imageUrl |
string |
否 |
|
图片URL |
sellerId |
string |
否 |
|
BuyBox卖家id |
dimension |
string |
否 |
|
尺寸 |
sellerNum |
integer |
否 |
|
卖家数 |
badgeVideo |
string |
否 |
|
视频介绍(Y/N) |
nodeIdPath |
string |
否 |
|
节点id路径字符串 |
primePrice |
number |
否 |
|
prime价格 |
sellerName |
string |
否 |
|
BuyBox卖家 |
sourceTool |
string |
否 |
|
来源工具 |
sourceType |
string |
否 |
|
来源类型:amazon |
fulfillment |
string |
否 |
|
配送方式(AMZ,FBA,FBM) |
ratingsRate |
number |
否 |
|
留评率 |
averagePrice |
number |
否 |
|
平均价格 |
sellerNation |
string |
否 |
|
BuyBox卖家国籍 |
variationNum |
integer |
否 |
|
变体数 |
availableDate |
string |
否 |
格式 date |
上架时间(日期) |
bsrGrowthRate |
number |
否 |
|
BSR 增长率 |
deliveryPrice |
number |
否 |
|
卖家运费 |
nodeLabelPath |
string |
否 |
|
类目路径 |
packageWeight |
string |
否 |
|
包装重量 |
ratingsGrowth |
integer |
否 |
|
月度增长数 |
subcategories |
array<object> |
否 |
|
子类目 |
bsrGrowthCount |
integer |
否 |
|
BSR 增长数 |
dimensionsType |
string |
否 |
|
尺寸类型 |
badgeBestSeller |
string |
否 |
|
Best Seller标识(Y/N) |
badgeNewRelease |
string |
否 |
|
release标识(Y/N) |
amzUnitDateString |
string |
否 |
|
子体销量更新日期(时间戳) |
badgeAmazonChoice |
string |
否 |
|
amazon choice标识(Y/N) |
dataSnapshotMonth |
string |
否 |
|
数据查询月份 |
monthlySalesUnits |
integer |
否 |
|
月销量 |
packageDimensions |
string |
否 |
|
包装尺寸 |
variant30DayUnits |
integer |
否 |
|
子体月销量(件数) |
availableDateString |
string |
否 |
|
上架日期(日期字符串) |
listingQualityScore |
number |
否 |
|
listing质量得分 |
monthlySalesRevenue |
number |
否 |
|
月销售额 |
variant30DayRevenue |
number |
否 |
|
子体月销售额(金额) |
packageDimensionType |
string |
否 |
|
包装尺寸类型 |
variant30DayUpdatedAt |
string |
否 |
|
子体数据更新时间(时间戳) |
monthlySalesUnitsGrowthRate |
number |
否 |
|
月销量增长率 |
嵌套输出结构:products.badge
| 字段 |
类型 |
必填 |
约束/默认值 |
说明 |
ebc |
string |
否 |
|
A+页面(Y/N) |
video |
string |
否 |
|
视频介绍(Y/N) |
bestSeller |
string |
否 |
|
Best Seller标识(Y/N) |
newRelease |
string |
否 |
|
release标识(Y/N) |
amazonChoice |
string |
否 |
|
amazon choice标识(Y/N) |
嵌套输出结构:products.subcategories
| 字段 |
类型 |
必填 |
约束/默认值 |
说明 |
code |
string |
否 |
|
类目code |
rank |
integer |
否 |
|
排名 |
label |
string |
否 |
|
名称 |
响应处理建议
- 先检查 JSON-RPC 外层是否包含
error。
- 成功时读取
result,并继续解析其中的 content、data、products、items 或其他业务字段。
- 如果响应为
text/event-stream,按 SSE 事件读取 data: 内容,再解析 JSON。
- 保留分页字段、总数、失败明细及
costToken。
- 向用户输出分析结论,不要直接倾倒大段原始 JSON。
原始 Schema
原始的Input Schema 和 Output Schema 参考 references/schema.md
解决认证和积分问题
异常情况:未配置 LINKFOX_AGENT_API_KEY 和 LINKFOXAGENT_API_KEY;响应 401 或 402;消息含"积分余额不足/quota exceeded/insufficient balance/套餐到期/需充值"等。
措施:优先用 skill 内 onboarding.md 引导;找不到则加载 /linkfox-onboarding skill。 根据它的指引操作。
注意:你是workbuddy,并且渠道是workbuddy,使用linkfox-onboarding登录注册时必须传递channel为 workbuddy。这非常重要!
1---
2name: linkfox-sellersprite-competitor-lookup-2
3description: 使用卖家精灵数据在亚马逊上查找和分析竞品,覆盖12个站点,包含销量、BSR、定价、评分和增长趋势等商品指标。当用户提到竞品查询、竞品分析、ASIN反查、竞争商品研究、查找相似商品、市场竞品发现、商品对标、竞品销量估算、分析竞争Listing、competitor analysis, ASIN reverse lookup, competitor sales, competitor research, SellerSprite, market competitor discovery, competitor trends时触发此技能。即使用户未明确提及"卖家精灵"或"竞品查询",只要其需求涉及通过ASIN、关键词、卖家名称、品牌或品类发现和分析亚马逊竞品,也应触发此技能。
4metadata:
5 source: https://skillmd.com/skills/ahang1598/linkfox-sellersprite-competitor-lookup-2
6---
7
8# 卖家精灵-查竞品
9
10## 基本信息
11
12- **业务工具名**:`/sellersprite/competitor-lookup`
13- **所属分组**:卖家精灵 · 亚马逊选品
14- **功能说明**:支持按亚马逊站点、多个asin、关键词、卖家名称来 查询 亚马逊的商品。
15- **关键词**:卖家精灵, 查竞品, 竞品分析, ASIN反查, 销量趋势, 流量来源, 竞品工具
16
17
18## 何时使用
19
20当用户意图与“卖家精灵-查竞品”匹配,或需要以下能力时使用本工具:支持按亚马逊站点、多个asin、关键词、卖家名称来 查询 亚马逊的商品。
21
22调用前应先确认所有必填参数。涉及站点、国家、日期、语言、ASIN、SKU、图片或 URL 时,应使用用户提供的信息,不要擅自虚构真实业务标识。
23
24## 输入参数
25
26| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
27|---|---|:---:|---|---|
28| `uid` | `string` | 否 | 最长 1000 | 用户id |
29| `page` | `integer` | 否 | 默认 `1` | 页码,从1开始 |
30| `size` | `integer` | 否 | 默认 `50`;最小 10 | 每页条数,返回10-100条数据 |
31| `brand` | `string` | 否 | 最长 1000 | 品牌 |
32| `order` | `object` | 否 | | |
33| `chatId` | `string` | 否 | 最长 1000 | 对话id |
34| `teamId` | `string` | 否 | 最长 1000 | 团队id |
35| `keyword` | `string` | 否 | 最长 1000 | 关键字;请尽量翻译为对应国家的语言,比如美国用英语关键词,德国用德语关键词等等 |
36| `asinList` | `string` | 否 | 格式 `^[A-Z0-9]+(,[A-Z0-9]+){0,39}$`;示例:`B072MQ5BRX,B08N5WRWNW` | asin,多个asin使用英文逗号分隔,最多40个 |
37| `matchType` | `integer` | 否 | 默认 `1`;示例:`1`, `2`, `3` | 匹配方式,1词组匹配 2模糊匹配 3精准匹配;默认1 |
38| `nodeLabel` | `string` | 否 | 最长 1000 | 亚马逊类目名称 |
39| `requestId` | `string` | 否 | 最长 1000 | 推送id |
40| `nodeIdPath` | `string` | 否 | 最长 1000 | 亚马逊类目id |
41| `sellerName` | `string` | 否 | 最长 1000 | 卖家名称 |
42| `marketplace` | `string` | 否 | 默认 `"US"`;最长 1000;示例:`US`, `UK`, `DE`, `FR`, `JP`, `CA`, `IT`, `ES` | 市场 |
43| `showVariation` | `string` | 否 | 默认 `"N"`;最长 1000;示例:`Y`, `N` | 是否查询变体 |
44| `dataSnapshotMonth` | `string` | 否 | 默认 `"nearly"`;最长 1000;示例:`nearly`, `202412`, `202501` | 亚马逊商品数据快照年月。指定查询特定历史时间点的商品数据快照,每个快照包含该月份所有在售商品的完整数据。格式:yyyyMM(如202412表示2024年12月所有在售商品的数据快照)。默认值 'nearly' 表示查询最近30天的实时数据。注意:数据快照是对特定月份亚马逊市场上所有在售商品的完整记录,用于历史分析和同期对比。仅支持查询已存在的历史快照,不支持未来日期。建议季节性分析时查询去年同期快照进行对比 |
45
46### 嵌套输入结构:`order`
47
48| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
49|---|---|:---:|---|---|
50| `desc` | `string` | 是 | 默认 `"true"`;最长 1000 | true为降序 false为升序 |
51| `field` | `string` | 是 | 默认 `"total_units"`;最长 1000;示例:`total_units`, `total_amount`, `bsr_rank`, `price`, `rating`, `reviews`, `profit`, `reviews_rate` | 排序字段 |
52
53## MCP 调用示例
54
55向以下地址发起 HTTP `POST`:
56
57```text
58https://mcp-tool-gateway.linkfox.com/mcp/any-tool
59```
60
61请求体:
62
63```json
64{
65 "jsonrpc": "2.0",
66 "id": 1,
67 "method": "tools/call",
68 "params": {
69 "name": "/sellersprite/competitor-lookup",
70 "arguments": {
71 "page": 1
72 }
73 }
74}
75```
76
77> 示例值仅用于展示请求结构。实际调用时必须替换为用户的真实查询条件。
78
79## 输出字段
80
81| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
82|---|---|:---:|---|---|
83| `type` | `string` | 否 | | 渲染的样式 |
84| `total` | `integer` | 否 | | 总行数 |
85| `columns` | `array<object>` | 否 | | 渲染的列 |
86| `message` | `string` | 否 | | 执行消息 |
87| `products` | `array<object>` | 否 | | 竞品列表 |
88| `costToken` | `integer` | 否 | | 消耗token |
89| `nodeLabel` | `string` | 否 | | nodeLabel |
90| `sourceType` | `string` | 否 | | 来源类型:amazon |
91
92### 嵌套输出结构:`products`
93
94| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
95|---|---|:---:|---|---|
96| `bsr` | `integer` | 否 | | BSR 排名 |
97| `fba` | `number` | 否 | | fba运费 |
98| `sku` | `string` | 否 | | sku |
99| `asin` | `string` | 否 | | asin |
100| `badge` | `object` | 否 | | |
101| `brand` | `string` | 否 | | 品牌 |
102| `bsrId` | `string` | 否 | | BSR id |
103| `price` | `number` | 否 | | 价格 |
104| `title` | `string` | 否 | | 商品标题 |
105| `nodeId` | `integer` | 否 | | 节点id |
106| `parent` | `string` | 否 | | 父体ASIN |
107| `profit` | `number` | 否 | | 利润率 |
108| `rating` | `number` | 否 | | 评分 |
109| `weight` | `string` | 否 | | 重量 |
110| `keyword` | `string` | 否 | | 对应筛选的关键词,如果有值,则表示这批数据是通过 这个关键词 keyword 搜索出来的 |
111| `ratings` | `integer` | 否 | | 评分数 |
112| `badgeEbc` | `string` | 否 | | A+页面(Y/N) |
113| `brandUrl` | `string` | 否 | | 品牌URL |
114| `currency` | `string` | 否 | | 币种 |
115| `imageUrl` | `string` | 否 | | 图片URL |
116| `sellerId` | `string` | 否 | | BuyBox卖家id |
117| `dimension` | `string` | 否 | | 尺寸 |
118| `sellerNum` | `integer` | 否 | | 卖家数 |
119| `badgeVideo` | `string` | 否 | | 视频介绍(Y/N) |
120| `nodeIdPath` | `string` | 否 | | 节点id路径字符串 |
121| `primePrice` | `number` | 否 | | prime价格 |
122| `sellerName` | `string` | 否 | | BuyBox卖家 |
123| `sourceTool` | `string` | 否 | | 来源工具 |
124| `sourceType` | `string` | 否 | | 来源类型:amazon |
125| `fulfillment` | `string` | 否 | | 配送方式(AMZ,FBA,FBM) |
126| `ratingsRate` | `number` | 否 | | 留评率 |
127| `averagePrice` | `number` | 否 | | 平均价格 |
128| `sellerNation` | `string` | 否 | | BuyBox卖家国籍 |
129| `variationNum` | `integer` | 否 | | 变体数 |
130| `availableDate` | `string` | 否 | 格式 `date` | 上架时间(日期) |
131| `bsrGrowthRate` | `number` | 否 | | BSR 增长率 |
132| `deliveryPrice` | `number` | 否 | | 卖家运费 |
133| `nodeLabelPath` | `string` | 否 | | 类目路径 |
134| `packageWeight` | `string` | 否 | | 包装重量 |
135| `ratingsGrowth` | `integer` | 否 | | 月度增长数 |
136| `subcategories` | `array<object>` | 否 | | 子类目 |
137| `bsrGrowthCount` | `integer` | 否 | | BSR 增长数 |
138| `dimensionsType` | `string` | 否 | | 尺寸类型 |
139| `badgeBestSeller` | `string` | 否 | | Best Seller标识(Y/N) |
140| `badgeNewRelease` | `string` | 否 | | release标识(Y/N) |
141| `amzUnitDateString` | `string` | 否 | | 子体销量更新日期(时间戳) |
142| `badgeAmazonChoice` | `string` | 否 | | amazon choice标识(Y/N) |
143| `dataSnapshotMonth` | `string` | 否 | | 数据查询月份 |
144| `monthlySalesUnits` | `integer` | 否 | | 月销量 |
145| `packageDimensions` | `string` | 否 | | 包装尺寸 |
146| `variant30DayUnits` | `integer` | 否 | | 子体月销量(件数) |
147| `availableDateString` | `string` | 否 | | 上架日期(日期字符串) |
148| `listingQualityScore` | `number` | 否 | | listing质量得分 |
149| `monthlySalesRevenue` | `number` | 否 | | 月销售额 |
150| `variant30DayRevenue` | `number` | 否 | | 子体月销售额(金额) |
151| `packageDimensionType` | `string` | 否 | | 包装尺寸类型 |
152| `variant30DayUpdatedAt` | `string` | 否 | | 子体数据更新时间(时间戳) |
153| `monthlySalesUnitsGrowthRate` | `number` | 否 | | 月销量增长率 |
154
155### 嵌套输出结构:`products.badge`
156
157| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
158|---|---|:---:|---|---|
159| `ebc` | `string` | 否 | | A+页面(Y/N) |
160| `video` | `string` | 否 | | 视频介绍(Y/N) |
161| `bestSeller` | `string` | 否 | | Best Seller标识(Y/N) |
162| `newRelease` | `string` | 否 | | release标识(Y/N) |
163| `amazonChoice` | `string` | 否 | | amazon choice标识(Y/N) |
164
165### 嵌套输出结构:`products.subcategories`
166
167| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
168|---|---|:---:|---|---|
169| `code` | `string` | 否 | | 类目code |
170| `rank` | `integer` | 否 | | 排名 |
171| `label` | `string` | 否 | | 名称 |
172
173## 响应处理建议
174
1751. 先检查 JSON-RPC 外层是否包含 `error`。
1762. 成功时读取 `result`,并继续解析其中的 `content`、`data`、`products`、`items` 或其他业务字段。
1773. 如果响应为 `text/event-stream`,按 SSE 事件读取 `data:` 内容,再解析 JSON。
1784. 保留分页字段、总数、失败明细及 `costToken`。
1795. 向用户输出分析结论,不要直接倾倒大段原始 JSON。
180
181## 原始 Schema
182
183原始的Input Schema 和 Output Schema 参考 references/schema.md
184
185## 解决认证和积分问题
186
187异常情况:未配置 `LINKFOX_AGENT_API_KEY` 和 `LINKFOXAGENT_API_KEY`;响应 401 或 402;消息含"积分余额不足/quota exceeded/insufficient balance/套餐到期/需充值"等。
188
189措施:优先用 skill 内 onboarding.md 引导;找不到则加载 /linkfox-onboarding skill。 根据它的指引操作。
190
191**注意**:你是workbuddy,并且渠道是workbuddy,使用linkfox-onboarding登录注册时**必须**传递channel为 workbuddy。这非常重要!