卖家精灵-关键词反查(流量词列表)
基本信息
- 业务工具名:
/sellersprite/traffic/keyword
- 所属分组:卖家精灵 · 亚马逊选品
- 功能说明:根据一个或多个ASIN,反查该商品在亚马逊上的所有流量关键词,包括自然搜索词、SP广告词、AC推荐词、品牌推荐词、视频推荐词等多种流量词类型。
- 关键词:卖家精灵, 关键词, 流量词, 反查
何时使用
当用户意图与“卖家精灵-关键词反查(流量词列表)”匹配,或需要以下能力时使用本工具:根据一个或多个ASIN,反查该商品在亚马逊上的所有流量关键词,包括自然搜索词、SP广告词、AC推荐词、品牌推荐词、视频推荐词等多种流量词类型。
调用前应先确认所有必填参数。涉及站点、国家、日期、语言、ASIN、SKU、图片或 URL 时,应使用用户提供的信息,不要擅自虚构真实业务标识。
输入参数
| 字段 |
类型 |
必填 |
约束/默认值 |
说明 |
asin |
string |
是 |
最长 1000;示例:B07Z82895W |
ASIN |
page |
integer |
否 |
默认 1 |
当前页,默认1 |
size |
integer |
否 |
默认 50;最小 1;最大 100 |
每页条数,默认50,最大100,最多查2000条 |
month |
string |
否 |
格式 ^(19|20)\d{2}(0[1-9]|1[0-2])$;示例:202308 |
历史月份,不传默认最近30天,格式 yyyyMM |
badges |
string |
否 |
最长 1000;示例:naturalSearching, amazonChoice, editorialRecommendations, fourStar, highlyRated, sponsorBrand, sponsorVideo, ads |
流量词类型(badges),多个值用英文逗号分隔。可选枚举:naturalSearching-自然搜索词;amazonChoice-AC推荐词;editorialRecommendations-ER推荐词;fourStar-四星推荐词;highlyRated-HR推荐词;sponsorBrand-品牌推荐词;sponsorVideo-视频推荐词;ads-SP广告词 |
keyword |
string |
否 |
最长 1000 |
关键词筛选 |
orderDesc |
boolean |
否 |
默认 false |
排序是否倒序,默认 false |
orderField |
string |
否 |
默认 "rankPosition";最长 1000;示例:rankPosition, adPosition, createdTime, searchesRank, searches, purchases, purchaseRate, products |
排序字段(order.field),默认 rankPosition。可选:rankPosition-自然排名;adPosition-广告排名;createdTime-创建时间;searchesRank-搜索量周排名;searches-月搜索量;purchases-月购买量;purchaseRate-购买率;products-商品数;supplyDemandRatio-供需比;latest1daysAds-广告竞品数;bid-PPC竞价;trafficPercentage-流量占比 |
marketplace |
string |
是 |
默认 "US";最长 1000;示例:US, JP, UK, DE, FR, IT, ES, CA |
市场(marketplace)。可选:US-美国站-USD($);JP-日本站-JPY(¥);UK-英国站-GBP(£);DE-德国站-EUR(€);FR-法国站-EUR(€);IT-意大利站-EUR(€);ES-西班牙站-EUR(€);CA-加拿大站-C$($);IN-印度站-INR(₹) |
trafficKeywordTypes |
string |
否 |
最长 1000;示例:primary, precise, preciseLongTail |
流量占比类型(trafficKeywordTypes),多个值用英文逗号分隔。可选枚举:primary-主要流量词;precise-精准流量词;preciseLongTail-转化流失词 |
conversionKeywordTypes |
string |
否 |
最长 1000;示例:excellent, stable, lost, invalid |
流量转化类型(conversionKeywordTypes),多个值用英文逗号分隔。可选枚举:excellent-转化优质词;stable-转化平稳词;lost-转化流失词;invalid-无效曝光词 |
MCP 调用示例
向以下地址发起 HTTP POST:
https://mcp-tool-gateway.linkfox.com/mcp/any-tool
请求体:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "/sellersprite/traffic/keyword",
"arguments": {
"marketplace": "US",
"asin": "B07Z82895W",
"page": 1
}
}
}
示例值仅用于展示请求结构。实际调用时必须替换为用户的真实查询条件。
输出字段
| 字段 |
类型 |
必填 |
约束/默认值 |
说明 |
asin |
string |
否 |
|
ASIN |
data |
array<object> |
否 |
|
流量词列表(对应第三方 data.items) |
type |
string |
否 |
|
渲染的样式 |
total |
integer |
否 |
|
总条数 |
columns |
array<object> |
否 |
|
渲染的列 |
costToken |
integer |
否 |
|
消耗token |
marketplace |
string |
否 |
|
市场编码 |
summaryList |
array<object> |
否 |
|
高频词总结列表 |
嵌套输出结构:data
| 字段 |
类型 |
必填 |
约束/默认值 |
说明 |
bid |
number |
否 |
|
PPC竞价 |
sprt |
number |
否 |
|
SP相关比率 |
stats |
array<object> |
否 |
|
高频词 |
badges |
array<any> |
否 |
|
曝光位置(流量词类型) |
bidMax |
number |
否 |
|
PPC竞价上限 |
bidMin |
number |
否 |
|
PPC竞价下限 |
clicks |
integer |
否 |
|
点击量 |
adRatio |
number |
否 |
|
流量分布-广告占比 |
keyword |
string |
否 |
|
关键词 |
products |
integer |
否 |
|
商品数 |
searches |
integer |
否 |
|
月搜索量 |
keywordCn |
string |
否 |
|
关键词中文翻译 |
purchases |
integer |
否 |
|
月购买量 |
adPosition |
object |
否 |
|
|
impressions |
integer |
否 |
|
展示量 |
updatedTime |
integer |
否 |
|
更新时间 |
naturalRatio |
number |
否 |
|
流量分布-自然占比 |
purchaseRate |
number |
否 |
|
购买率 |
rankPosition |
object |
否 |
|
|
searchesRank |
integer |
否 |
|
周搜索量排名 |
titleDensity |
number |
否 |
|
标题密度 |
latest1daysAds |
integer |
否 |
|
最近1天广告竞品数 |
latest7daysAds |
integer |
否 |
|
最近7天广告竞品数 |
latest30daysAds |
integer |
否 |
|
最近30天广告竞品数 |
top3ClickingRate |
number |
否 |
|
Top3点击率 |
monopolyClickRate |
number |
否 |
|
垄断点击率 |
supplyDemandRatio |
number |
否 |
|
供需比 |
trafficPercentage |
number |
否 |
|
流量占比 |
searchesRankTimeTo |
integer |
否 |
|
周搜索量排名时间范围止 |
top3ConversionRate |
number |
否 |
|
Top3转化率 |
trafficKeywordType |
string |
否 |
|
流量占比类型 |
searchesRankTimeFrom |
integer |
否 |
|
周搜索量排名时间范围起 |
conversionKeywordType |
string |
否 |
|
流量转化类型 |
calculatedWeeklySearches |
number |
否 |
|
预估周曝光量 |
嵌套输出结构:data.stats
| 字段 |
类型 |
必填 |
约束/默认值 |
说明 |
total |
integer |
否 |
|
总条数 |
keywords |
string |
否 |
|
词 |
adPosition |
object |
否 |
|
|
rankPosition |
object |
否 |
|
|
嵌套输出结构:data.stats.adPosition
| 字段 |
类型 |
必填 |
约束/默认值 |
说明 |
page |
integer |
否 |
|
第几页 |
index |
integer |
否 |
|
当前页排第几 |
pageSize |
integer |
否 |
|
每页多少条数据 |
position |
integer |
否 |
|
总结果中排第几 |
updatedTime |
integer |
否 |
|
排名时间 |
嵌套输出结构:data.stats.rankPosition
| 字段 |
类型 |
必填 |
约束/默认值 |
说明 |
page |
integer |
否 |
|
第几页 |
index |
integer |
否 |
|
当前页排第几 |
pageSize |
integer |
否 |
|
每页多少条数据 |
position |
integer |
否 |
|
总结果中排第几 |
updatedTime |
integer |
否 |
|
排名时间 |
嵌套输出结构:data.adPosition
| 字段 |
类型 |
必填 |
约束/默认值 |
说明 |
page |
integer |
否 |
|
第几页 |
index |
integer |
否 |
|
当前页排第几 |
pageSize |
integer |
否 |
|
每页多少条数据 |
position |
integer |
否 |
|
总结果中排第几 |
updatedTime |
integer |
否 |
|
排名时间 |
嵌套输出结构:data.rankPosition
| 字段 |
类型 |
必填 |
约束/默认值 |
说明 |
page |
integer |
否 |
|
第几页 |
index |
integer |
否 |
|
当前页排第几 |
pageSize |
integer |
否 |
|
每页多少条数据 |
position |
integer |
否 |
|
总结果中排第几 |
updatedTime |
integer |
否 |
|
排名时间 |
嵌套输出结构:summaryList
| 字段 |
类型 |
必填 |
约束/默认值 |
说明 |
total |
integer |
否 |
|
总次数 |
keywords |
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-traffic-keyword-2
3description: 使用卖家精灵流量词反查能力,按ASIN查询关键词流量来源、流量占比类型、转化类型、自然位与广告位等指标,支持历史月份与多维排序。当用户提到ASIN反查流量词、流量关键词列表、关键词流量结构、自然词/广告词分析、关键词转化类型、SellerSprite traffic keyword、Amazon traffic keywords、reverse ASIN keywords时触发此技能。即使用户未明确提及"卖家精灵",只要需求是围绕某个ASIN查看其关键词流量来源与词列表,也应触发此技能。
4metadata:
5 source: https://skillmd.com/skills/ahang1598/linkfox-sellersprite-traffic-keyword-2
6---
7
8# 卖家精灵-关键词反查(流量词列表)
9
10## 基本信息
11
12- **业务工具名**:`/sellersprite/traffic/keyword`
13- **所属分组**:卖家精灵 · 亚马逊选品
14- **功能说明**:根据一个或多个ASIN,反查该商品在亚马逊上的所有流量关键词,包括自然搜索词、SP广告词、AC推荐词、品牌推荐词、视频推荐词等多种流量词类型。
15- **关键词**:卖家精灵, 关键词, 流量词, 反查
16
17
18## 何时使用
19
20当用户意图与“卖家精灵-关键词反查(流量词列表)”匹配,或需要以下能力时使用本工具:根据一个或多个ASIN,反查该商品在亚马逊上的所有流量关键词,包括自然搜索词、SP广告词、AC推荐词、品牌推荐词、视频推荐词等多种流量词类型。
21
22调用前应先确认所有必填参数。涉及站点、国家、日期、语言、ASIN、SKU、图片或 URL 时,应使用用户提供的信息,不要擅自虚构真实业务标识。
23
24## 输入参数
25
26| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
27|---|---|:---:|---|---|
28| `asin` | `string` | 是 | 最长 1000;示例:`B07Z82895W` | ASIN |
29| `page` | `integer` | 否 | 默认 `1` | 当前页,默认1 |
30| `size` | `integer` | 否 | 默认 `50`;最小 1;最大 100 | 每页条数,默认50,最大100,最多查2000条 |
31| `month` | `string` | 否 | 格式 `^(19\|20)\d{2}(0[1-9]\|1[0-2])$`;示例:`202308` | 历史月份,不传默认最近30天,格式 yyyyMM |
32| `badges` | `string` | 否 | 最长 1000;示例:`naturalSearching`, `amazonChoice`, `editorialRecommendations`, `fourStar`, `highlyRated`, `sponsorBrand`, `sponsorVideo`, `ads` | 流量词类型(badges),多个值用英文逗号分隔。可选枚举:naturalSearching-自然搜索词;amazonChoice-AC推荐词;editorialRecommendations-ER推荐词;fourStar-四星推荐词;highlyRated-HR推荐词;sponsorBrand-品牌推荐词;sponsorVideo-视频推荐词;ads-SP广告词 |
33| `keyword` | `string` | 否 | 最长 1000 | 关键词筛选 |
34| `orderDesc` | `boolean` | 否 | 默认 `false` | 排序是否倒序,默认 false |
35| `orderField` | `string` | 否 | 默认 `"rankPosition"`;最长 1000;示例:`rankPosition`, `adPosition`, `createdTime`, `searchesRank`, `searches`, `purchases`, `purchaseRate`, `products` | 排序字段(order.field),默认 rankPosition。可选:rankPosition-自然排名;adPosition-广告排名;createdTime-创建时间;searchesRank-搜索量周排名;searches-月搜索量;purchases-月购买量;purchaseRate-购买率;products-商品数;supplyDemandRatio-供需比;latest1daysAds-广告竞品数;bid-PPC竞价;trafficPercentage-流量占比 |
36| `marketplace` | `string` | 是 | 默认 `"US"`;最长 1000;示例:`US`, `JP`, `UK`, `DE`, `FR`, `IT`, `ES`, `CA` | 市场(marketplace)。可选:US-美国站-USD($);JP-日本站-JPY(¥);UK-英国站-GBP(£);DE-德国站-EUR(€);FR-法国站-EUR(€);IT-意大利站-EUR(€);ES-西班牙站-EUR(€);CA-加拿大站-C$($);IN-印度站-INR(₹) |
37| `trafficKeywordTypes` | `string` | 否 | 最长 1000;示例:`primary`, `precise`, `preciseLongTail` | 流量占比类型(trafficKeywordTypes),多个值用英文逗号分隔。可选枚举:primary-主要流量词;precise-精准流量词;preciseLongTail-转化流失词 |
38| `conversionKeywordTypes` | `string` | 否 | 最长 1000;示例:`excellent`, `stable`, `lost`, `invalid` | 流量转化类型(conversionKeywordTypes),多个值用英文逗号分隔。可选枚举:excellent-转化优质词;stable-转化平稳词;lost-转化流失词;invalid-无效曝光词 |
39
40
41## MCP 调用示例
42
43向以下地址发起 HTTP `POST`:
44
45```text
46https://mcp-tool-gateway.linkfox.com/mcp/any-tool
47```
48
49请求体:
50
51```json
52{
53 "jsonrpc": "2.0",
54 "id": 1,
55 "method": "tools/call",
56 "params": {
57 "name": "/sellersprite/traffic/keyword",
58 "arguments": {
59 "marketplace": "US",
60 "asin": "B07Z82895W",
61 "page": 1
62 }
63 }
64}
65```
66
67> 示例值仅用于展示请求结构。实际调用时必须替换为用户的真实查询条件。
68
69## 输出字段
70
71| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
72|---|---|:---:|---|---|
73| `asin` | `string` | 否 | | ASIN |
74| `data` | `array<object>` | 否 | | 流量词列表(对应第三方 data.items) |
75| `type` | `string` | 否 | | 渲染的样式 |
76| `total` | `integer` | 否 | | 总条数 |
77| `columns` | `array<object>` | 否 | | 渲染的列 |
78| `costToken` | `integer` | 否 | | 消耗token |
79| `marketplace` | `string` | 否 | | 市场编码 |
80| `summaryList` | `array<object>` | 否 | | 高频词总结列表 |
81
82### 嵌套输出结构:`data`
83
84| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
85|---|---|:---:|---|---|
86| `bid` | `number` | 否 | | PPC竞价 |
87| `sprt` | `number` | 否 | | SP相关比率 |
88| `stats` | `array<object>` | 否 | | 高频词 |
89| `badges` | `array<any>` | 否 | | 曝光位置(流量词类型) |
90| `bidMax` | `number` | 否 | | PPC竞价上限 |
91| `bidMin` | `number` | 否 | | PPC竞价下限 |
92| `clicks` | `integer` | 否 | | 点击量 |
93| `adRatio` | `number` | 否 | | 流量分布-广告占比 |
94| `keyword` | `string` | 否 | | 关键词 |
95| `products` | `integer` | 否 | | 商品数 |
96| `searches` | `integer` | 否 | | 月搜索量 |
97| `keywordCn` | `string` | 否 | | 关键词中文翻译 |
98| `purchases` | `integer` | 否 | | 月购买量 |
99| `adPosition` | `object` | 否 | | |
100| `impressions` | `integer` | 否 | | 展示量 |
101| `updatedTime` | `integer` | 否 | | 更新时间 |
102| `naturalRatio` | `number` | 否 | | 流量分布-自然占比 |
103| `purchaseRate` | `number` | 否 | | 购买率 |
104| `rankPosition` | `object` | 否 | | |
105| `searchesRank` | `integer` | 否 | | 周搜索量排名 |
106| `titleDensity` | `number` | 否 | | 标题密度 |
107| `latest1daysAds` | `integer` | 否 | | 最近1天广告竞品数 |
108| `latest7daysAds` | `integer` | 否 | | 最近7天广告竞品数 |
109| `latest30daysAds` | `integer` | 否 | | 最近30天广告竞品数 |
110| `top3ClickingRate` | `number` | 否 | | Top3点击率 |
111| `monopolyClickRate` | `number` | 否 | | 垄断点击率 |
112| `supplyDemandRatio` | `number` | 否 | | 供需比 |
113| `trafficPercentage` | `number` | 否 | | 流量占比 |
114| `searchesRankTimeTo` | `integer` | 否 | | 周搜索量排名时间范围止 |
115| `top3ConversionRate` | `number` | 否 | | Top3转化率 |
116| `trafficKeywordType` | `string` | 否 | | 流量占比类型 |
117| `searchesRankTimeFrom` | `integer` | 否 | | 周搜索量排名时间范围起 |
118| `conversionKeywordType` | `string` | 否 | | 流量转化类型 |
119| `calculatedWeeklySearches` | `number` | 否 | | 预估周曝光量 |
120
121### 嵌套输出结构:`data.stats`
122
123| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
124|---|---|:---:|---|---|
125| `total` | `integer` | 否 | | 总条数 |
126| `keywords` | `string` | 否 | | 词 |
127| `adPosition` | `object` | 否 | | |
128| `rankPosition` | `object` | 否 | | |
129
130### 嵌套输出结构:`data.stats.adPosition`
131
132| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
133|---|---|:---:|---|---|
134| `page` | `integer` | 否 | | 第几页 |
135| `index` | `integer` | 否 | | 当前页排第几 |
136| `pageSize` | `integer` | 否 | | 每页多少条数据 |
137| `position` | `integer` | 否 | | 总结果中排第几 |
138| `updatedTime` | `integer` | 否 | | 排名时间 |
139
140### 嵌套输出结构:`data.stats.rankPosition`
141
142| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
143|---|---|:---:|---|---|
144| `page` | `integer` | 否 | | 第几页 |
145| `index` | `integer` | 否 | | 当前页排第几 |
146| `pageSize` | `integer` | 否 | | 每页多少条数据 |
147| `position` | `integer` | 否 | | 总结果中排第几 |
148| `updatedTime` | `integer` | 否 | | 排名时间 |
149
150### 嵌套输出结构:`data.adPosition`
151
152| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
153|---|---|:---:|---|---|
154| `page` | `integer` | 否 | | 第几页 |
155| `index` | `integer` | 否 | | 当前页排第几 |
156| `pageSize` | `integer` | 否 | | 每页多少条数据 |
157| `position` | `integer` | 否 | | 总结果中排第几 |
158| `updatedTime` | `integer` | 否 | | 排名时间 |
159
160### 嵌套输出结构:`data.rankPosition`
161
162| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
163|---|---|:---:|---|---|
164| `page` | `integer` | 否 | | 第几页 |
165| `index` | `integer` | 否 | | 当前页排第几 |
166| `pageSize` | `integer` | 否 | | 每页多少条数据 |
167| `position` | `integer` | 否 | | 总结果中排第几 |
168| `updatedTime` | `integer` | 否 | | 排名时间 |
169
170### 嵌套输出结构:`summaryList`
171
172| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
173|---|---|:---:|---|---|
174| `total` | `integer` | 否 | | 总次数 |
175| `keywords` | `string` | 否 | | 词 |
176
177## 响应处理建议
178
1791. 先检查 JSON-RPC 外层是否包含 `error`。
1802. 成功时读取 `result`,并继续解析其中的 `content`、`data`、`products`、`items` 或其他业务字段。
1813. 如果响应为 `text/event-stream`,按 SSE 事件读取 `data:` 内容,再解析 JSON。
1824. 保留分页字段、总数、失败明细及 `costToken`。
1835. 向用户输出分析结论,不要直接倾倒大段原始 JSON。
184
185## 原始 Schema
186
187原始的Input Schema 和 Output Schema 参考 references/schema.md
188
189## 解决认证和积分问题
190
191异常情况:未配置 `LINKFOX_AGENT_API_KEY` 和 `LINKFOXAGENT_API_KEY`;响应 401 或 402;消息含"积分余额不足/quota exceeded/insufficient balance/套餐到期/需充值"等。
192
193措施:优先用 skill 内 onboarding.md 引导;找不到则加载 /linkfox-onboarding skill。 根据它的指引操作。
194
195**注意**:你是workbuddy,并且渠道是workbuddy,使用linkfox-onboarding登录注册时**必须**传递channel为 workbuddy。这非常重要!