linkfox-sellersprite-traffic-keyword

name	linkfox-sellersprite-traffic-keyword
description	使用卖家精灵流量词反查能力，按ASIN查询关键词流量来源、流量占比类型、转化类型、自然位与广告位等指标，支持历史月份与多维排序。当用户提到ASIN反查流量词、流量关键词列表、关键词流量结构、自然词/广告词分析、关键词转化类型、SellerSprite traffic keyword、Amazon traffic keywords、reverse ASIN keywords时触发此技能。即使用户未明确提及"卖家精灵"，只要需求是围绕某个ASIN查看其关键词流量来源与词列表，也应触发此技能。

卖家精灵-关键词反查(流量词列表)

基本信息

• 业务工具名：/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

嵌套输出结构：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	否		词

响应处理建议

1. 先检查 JSON-RPC 外层是否包含 error。
2. 成功时读取 result，并继续解析其中的 content、data、products、items 或其他业务字段。
3. 如果响应为 text/event-stream，按 SSE 事件读取 data: 内容，再解析 JSON。
4. 保留分页字段、总数、失败明细及 costToken。
5. 向用户输出分析结论，不要直接倾倒大段原始 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。这非常重要！