SIF-关键词流量来源
基本信息
- 业务工具名:
/sif/keywordSummary - 所属分组:SIF · 亚马逊流量与关键词
- 功能说明:支持关键词的流量结构分析,了解该词下自然搜索、SP广告及品牌广告的竞争格局。
- 关键词:SIF, 关键词流量, 流量结构, 搜索份额, 广告占比, 流量来源
何时使用
当用户意图与“SIF-关键词流量来源”匹配,或需要以下能力时使用本工具:支持关键词的流量结构分析,了解该词下自然搜索、SP广告及品牌广告的竞争格局。
调用前应先确认所有必填参数。涉及站点、国家、日期、语言、ASIN、SKU、图片或 URL 时,应使用用户提供的信息,不要擅自虚构真实业务标识。
输入参数
| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
|---|---|---|---|---|
desc |
boolean |
否 | 默认 true |
是否降序,默认传 true |
asins |
string |
否 | 最长 1000;示例:B01NBNDC1T, B01NBNDC1T,B09VLJJPL6 |
ASIN 过滤列表,多个用英文逗号分隔;不传则返回该关键词下所有 ASIN |
last7d |
boolean |
否 | 默认 true |
是否取最近7天数据,默认 true;传 false 时使用 startDate/endDate 区间 |
sortBy |
string |
否 | 格式受正则约束(见原始 Schema);示例:``, totalKeywordNum, naturalKeywordNum, brandKeywordNum, vedioKeywordNum, acKeywordNum, erKeywordNum, trKeywordNum |
排序字段 |
country |
string |
否 | 默认 "US";格式 US|UK|DE|CA|JP|FR|ES|IT|MX|AU|AE|BR|SA;示例:US, UK, DE, CA, JP, FR, ES, IT |
国家站点 |
endDate |
string |
否 | 最长 1000;示例:2026-04-11 |
结束日期 yyyy-MM-dd(与 startDate 配套) |
pageNum |
integer |
否 | 默认 1 |
页码 |
pageSize |
integer |
否 | 默认 100;最小 10;最大 100 |
每页数量,最小10,最大100,默认也是100 |
condition |
string |
否 | 格式受正则约束(见原始 Schema);示例:nfPosition, isSpAd, isVedioAd, isBrandAd, isPPCAd, isSearchRecommend, acAd, totalPeriod.in |
条件筛选,每次只能传一个 |
startDate |
string |
否 | 最长 1000;示例:2026-04-05 |
开始日期 yyyy-MM-dd(last7d=false 时生效,不填取系统最新整周) |
searchKeyword |
string |
是 | 最长 1000 | 搜索关键词,尽量翻译成对应国家站点的语言 |
MCP 调用示例
向以下地址发起 HTTP POST:
https://mcp-tool-gateway.linkfox.com/mcp/any-tool
请求体:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "/sif/keywordSummary",
"arguments": {
"searchKeyword": "wireless headphones",
"pageSize": 100
}
}
}
示例值仅用于展示请求结构。实际调用时必须替换为用户的真实查询条件。
输出字段
| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
|---|---|---|---|---|
msg |
string |
否 | 消息 | |
code |
string |
否 | 返回码 | |
data |
array<object> |
否 | 返回数据 | |
type |
string |
否 | 渲染的样式 | |
title |
string |
否 | 标题 | |
total |
integer |
否 | 本次实际返回的数据数量 | |
columns |
array<object> |
否 | 渲染的列 | |
costTime |
integer |
否 | 耗时 | |
costToken |
integer |
否 | 消耗token |
嵌套输出结构:data
| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
|---|---|---|---|---|
asin |
string |
否 | ASIN编码.亚马逊商品标准识别码(Amazon Standard Identification Number) | |
keyword |
string |
否 | 关键词 | |
productPrice |
number |
否 | 商品售价.当前亚马逊页面显示的商品价格 | |
productTitle |
string |
否 | 商品标题.亚马逊页面显示的完整商品标题 | |
productImageUrl |
string |
否 | 商品主图URL.商品在亚马逊页面上的主要展示图片链接 | |
isVariantProduct |
boolean |
否 | 是否为变体.true=该ASIN是父ASIN下的变体(如不同颜色、尺寸),false=独立ASIN或父ASIN | |
ppcTrafficSources |
array<any> |
否 | PPC付费广告流量来源标记.包含:sp广告(Sponsored Products)、头部品牌广告(Top Brand Ad)、底部品牌广告(Bottom Brand Ad)、视频广告(Video Ad) | |
productStarRating |
number |
否 | 商品星级(0-5 星) | |
productUpdateTime |
string |
否 | 产品更新时间.格式 yyyy-MM-dd HH:mm:ss | |
productRatingScore |
number |
否 | 商品评分 | |
totalExposureRatio |
number |
否 | 总流量份额 | |
totalExposureScore |
number |
否 | 总曝光分数.该商品在所有关键词下的曝光量综合评分,分数越高表示整体曝光量越大 | |
customerRatingCount |
integer |
否 | 客户评分总数.该商品在亚马逊上获得的客户评分总数 | |
dataPeriodStartDate |
string |
否 | 数据周期起始日期 (yyyy-MM-dd) | |
brandAdExposureRatio |
number |
否 | 品牌广告曝光占比.品牌广告曝光分数占总曝光分数的百分比 | |
brandAdExposureScore |
number |
否 | 品牌广告曝光总分.该商品在品牌广告位的曝光量综合评分 | |
videoAdExposureRatio |
number |
否 | 视频广告曝光占比.视频广告曝光分数占总曝光分数的百分比 | |
videoAdExposureScore |
number |
否 | 视频广告曝光总分.该商品在视频广告位的曝光量综合评分 | |
topRatedExposureRatio |
number |
否 | Top Rated推荐曝光占比.TR推荐曝光分数占总曝光分数的百分比 | |
topRatedExposureScore |
number |
否 | Top Rated推荐曝光总分.该商品在TR推荐位的曝光量综合评分 | |
promotionalDealSources |
array<any> |
否 | 促销活动流量来源标记.包含:优惠券(Coupon)、限时优惠(Limited Time Deal)、30天内最低价(Lowest Price in 30 Days)等 | |
recommendAdExposureRatio |
number |
否 | 推荐位广告流量份额 | |
recommendAdExposureScore |
number |
否 | 推荐位广告曝光分数 | |
keywordTotalExposureScore |
number |
否 | 关键词总得分 | |
amazonsChoiceExposureRatio |
number |
否 | Amazon's Choice曝光占比.AC推荐曝光分数占总曝光分数的百分比 | |
amazonsChoiceExposureScore |
number |
否 | Amazon's Choice曝光总分.该商品作为AC推荐商品的曝光量综合评分 | |
naturalSearchExposureRatio |
number |
否 | 自然搜索曝光占比.自然搜索曝光分数占总曝光分数的百分比,反映自然流量的比重 | |
naturalSearchExposureScore |
number |
否 | 自然搜索曝光总分.该商品在自然搜索结果位置的曝光量综合评分 | |
amazonRecommendationSources |
array<any> |
否 | 亚马逊推荐流量来源标记.包含:Best Seller榜单、Amazon's Choice推荐、编辑推荐(ER)、高评分推荐(TR)、高频购买推荐(TRFOB)等 | |
keywordBrandAdExposureScore |
number |
否 | 关键词品牌广告得分 | |
keywordNaturalExposureScore |
number |
否 | 关键词自然得分 | |
keywordVideoAdExposureScore |
number |
否 | 关键词视频广告得分 | |
naturalSearchTrafficSources |
array<any> |
否 | 自然搜索流量来源标记.如果该数组不为空,表示商品有自然搜索流量。数组内容标记具体的自然搜索类型 | |
recommendNonadExposureRatio |
number |
否 | 推荐位非广告流量份额 | |
recommendNonadExposureScore |
number |
否 | 推荐位非广告曝光分数 | |
keywordRecommendExposureScore |
number |
否 | 关键词推荐位得分 | |
recommendPositionExposureScore |
number |
否 | 推荐位曝光总分 | |
sponsoredProductsExposureRatio |
number |
否 | SP广告曝光占比.SP广告曝光分数占总曝光分数的百分比,反映付费广告流量的比重 | |
sponsoredProductsExposureScore |
number |
否 | SP广告曝光总分.该商品在SP广告位的曝光量综合评分 | |
keywordRecommendAdExposureScore |
number |
否 | 关键词推荐位广告得分 | |
comprehensiveNaturalExposureRatio |
number |
否 | 综合自然流量份额 | |
comprehensiveNaturalExposureScore |
number |
否 | 综合自然流量得分.自然搜索 + 推荐位非广告 | |
keywordAmazonsChoiceExposureScore |
number |
否 | 关键词Amazon's Choice得分 | |
keywordRecommendNonadExposureScore |
number |
否 | 关键词推荐位非广告得分 | |
editorialRecommendationsExposureRatio |
number |
否 | Editorial Recommendations曝光占比.ER推荐曝光分数占总曝光分数的百分比 | |
editorialRecommendationsExposureScore |
number |
否 | Editorial Recommendations曝光总分.该商品在编辑推荐位的曝光量综合评分 | |
keywordSponsoredProductsExposureScore |
number |
否 | 关键词SP广告得分 | |
keywordComprehensiveNaturalExposureScore |
number |
否 | 关键词综合自然得分.自然 + 推荐位非广告 |
响应处理建议
- 先检查 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。这非常重要!