linkfox-junglescout-keyword-share-of-voice

Jungle Scout — 关键词市场份额

此技能通过 Jungle Scout 数据源查询 Amazon 关键词的市场份额（SOV）数据，返回搜索结果前 3 页的品牌曝光度分布，以及 10 个 Amazon 市场的搜索量、PPC 竞价估算和顶级 ASIN 点击量／转化指标。

核心概念

市场份额衡量的是某个品牌在给定关键词的搜索结果版面中占据了多少位置。Jungle Scout 会分析 Amazon 搜索结果的前 3 页，并从三个维度计算各品牌的曝光度：

• 自然 SOV：品牌在自然（非赞助）搜索结果排名中的曝光度
• 赞助 SOV：品牌在赞助／广告版位中的曝光度
• 综合 SOV：合并自然搜索结果和赞助结果后的品牌整体曝光度

每个维度都有两种计算方法：

• 基础 SOV：简单的商品数量比率——某品牌的商品数量 ÷ 3 页中的商品总数
• 加权 SOV：根据排名位置调整的比率，对排名靠前的位置赋予更高权重，并考虑 Amazon's Choice 标识等因素；这是更有意义的竞争分析指标

该工具还会返回：

• 30 天精确搜索量：过去 30 天的预估搜索总量
• PPC 竞价中位数：该关键词的建议竞价中位数，可用于估算广告成本
• TOP3 ASIN 点击量和转化数据：按点击量排名的前 3 个 ASIN，以及点击量、转化量和转化率

数据字段

brands（品牌 SOV 明细）

字段	API 名称	说明	示例
品牌名称	brand	搜索结果中显示的品牌名称	Anker
自然商品	organicProducts	前 3 页中的自然商品数量	5
赞助商品	sponsoredProducts	赞助商品数量	3
综合商品	combinedProducts	商品总数（自然商品 + 赞助商品）	8
自然基础 SOV	organicBasicSov	自然搜索的简单比率（0–1）	0.083
自然加权 SOV	organicWeightedSov	自然搜索的位置加权比率（0–1）	0.112
赞助基础 SOV	sponsoredBasicSov	赞助结果的简单比率（0–1）	0.15
赞助加权 SOV	sponsoredWeightedSov	赞助结果的位置加权比率（0–1）	0.18
综合基础 SOV	combinedBasicSov	综合简单比率（0–1）	0.133
综合加权 SOV	combinedWeightedSov	综合位置加权比率（0–1）	0.152
自然平均排名	organicAveragePosition	自然搜索结果中的平均排名位置	12.4
赞助平均排名	sponsoredAveragePosition	赞助搜索结果中的平均排名位置	5.0
综合平均排名	combinedAveragePosition	所有搜索结果中的平均排名位置	9.5
自然商品平均价格	organicAveragePrice	自然商品的平均价格	29.99
赞助商品平均价格	sponsoredAveragePrice	赞助商品的平均价格	25.99
综合商品平均价格	combinedAveragePrice	所有商品的平均价格	28.49

topAsins（点击量和转化量排名前 3 的 ASIN）

字段	API 名称	说明	示例
ASIN	asin	Amazon 标准识别号	B09V3KXJPB
商品名称	name	商品标题	Anker Portable Charger...
品牌	brand	商品品牌	Anker
点击量	clicks	点击次数（30 天周期）	15200
转化量	conversions	转化次数（30 天周期）	4560
转化率	conversionRate	转化率（0–1）	0.30

顶层摘要字段

字段	API 名称	描述	示例
ID	id	资源标识符	—
类型	type	固定值	share_of_voice
30 天搜索量	estimated30DaySearchVolume	30 天内的精确搜索量	125000
PPC 出价中位数	exactSuggestedBidMedian	建议 PPC 出价的中位数（USD）	1.25
产品数量	productCount	前 3 页中的产品总数	60
更新时间	updatedAt	数据新鲜度时间戳	2026-04-10T00:00:00
Top ASIN 起始日期	topAsinsModelStartDate	点击/转化数据窗口的起始日期	2026-03-11
Top ASIN 结束日期	topAsinsModelEndDate	点击/转化数据窗口的结束日期	2026-04-10
成本 Token	costToken	此次调用消耗的 Token	1

支持的站点

us（美国）、uk（英国）、de（德国）、in（印度）、ca（加拿大）、fr（法国）、it（意大利）、es（西班牙）、mx（墨西哥）、jp（日本）

默认站点为 us。用户未指定站点时，使用 us。

调用方式

• API 端点：POST /tool-jungle-scout/keywords/share-of-voice（完整参数/响应/错误码见 references/api.md）
• Python 脚本：python scripts/junglescout_keyword_sov.py '<JSON 参数>' [--inline]
• 成本约束：本工具会消耗算力；同一会话中，同一参数组合默认只调用一次，脚本带有 24h 本地缓存。失败/空结果不得自动更换关键词、翻页或更改邮编连续试探；需要继续检索时，先向用户说明会产生额外消耗。

输出策略（脚本默认行为）：

• 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-junglescout-keyword-share-of-voice-<timestamp>.json（<cwd> 为脚本执行时的工作目录，在 Claude Code 中即当前项目目录；<session> 取自环境变量 SESSION_ID，按用户任务自动聚合；禁止写入 /tmp，当前目录不可写时则报错）
• 响应体 ≤ 8 KB：落盘后将完整 JSON 打印到 stdout
• 响应体 > 8 KB：落盘后，stdout 仅输出摘要（顶层字段、常见计数如 total/costToken、最大列表字段的长度及前 3 条样本）
• 添加 --inline 可强制将完整内容打印到 stdout（同时落盘）

读取数据的建议：先查看摘要，判断其是否足够；需要具体字段时，优先使用 jq 或 ConvertFrom-Json 从保存的 json 文件中按需提取，避免整份 JSON 进入上下文。

解决认证和算力问题

发生以下异常情况时，按照 references/onboarding.md 中的指引解决问题：

异常情况

• 未配置 API Key：环境变量未配置 LINKFOX_AGENT_API_KEY，也未配置 LINKFOXAGENT_API_KEY。
• 响应状态码为 401 或 402
• 响应提示算力或余额不足：消息包含“算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值”，或类似含义的内容。

如何构建查询

只需要两个参数：marketplace 和 keyword。

构建 API 调用的原则

1. 站点映射：“美国站” → us，“日本站” → jp，“德国站” → de；未指定时默认使用 us
2. 关键词：原样传入用户的关键词（优先使用小写英文）
3. 每次调用一个关键词：每个请求分析一个关键词；比较多个关键词时，需分别调用

常见查询场景

1. 品牌主导地位检查——谁占据了这个关键词？

{
  "marketplace": "us",
  "keyword": "portable charger"
}

重点关注 combinedWeightedSov，查看哪些品牌主导了搜索结果页。

2. PPC 竞争分析——这个关键词值得竞价吗？

{
  "marketplace": "us",
  "keyword": "wireless earbuds"
}

比较 exactSuggestedBidMedian 与关键词的搜索量，评估成本效益。查看 sponsoredWeightedSov，了解竞争对手在广告上的投入力度。

3. Top ASIN 的转化效率

{
  "marketplace": "de",
  "keyword": "kopfhörer kabellos"
}

检查 topAsins 数组，查看点击量最高的产品是否有良好的转化表现。高点击量 + 低转化率可能意味着机会。

4. 识别市场空缺——是否存在未被充分服务的位置？

{
  "marketplace": "jp",
  "keyword": "ヨガマット"
}

如果没有任何单一品牌的 combinedWeightedSov 高于 0.15，则该关键词较为分散，可能更容易进入。结合搜索量评估市场规模。

5. 比较自然流量与赞助流量的占比

{
  "marketplace": "uk",
  "keyword": "running shoes"
}

sponsoredWeightedSov 高但 organicWeightedSov 低的品牌严重依赖广告；这有助于制定竞争策略。

展示规则

1. 品牌表格：按 combinedWeightedSov 降序展示品牌表格；突出显示排名前 5 的品牌，便于快速了解
2. 以百分比显示 SOV：将 SOV 值显示为百分比（乘以 100），例如，0.152 → 15.2%
3. 上下文标题：在表格前显示该关键词 30 天搜索量（estimated30DaySearchVolume）和 PPC 出价中位数（exactSuggestedBidMedian），作为参考
4. 热门 ASIN 部分：单独展示 TOP 3 ASIN 表格，包含点击次数、转化次数和转化率
5. 竞争情况总结：数据之后，简要总结竞争格局：该关键词是由少数品牌主导还是较为分散，并指出自然排名和赞助排名之间是否存在明显差距
6. 错误处理：查询失败时，根据错误响应说明原因，并建议调整参数

重要限制

• 覆盖范围：仅分析 Amazon 搜索结果的前 3 页（通常约 48–60 个商品）
• 单个关键词：每次 API 调用只能查询一个关键词；比较多个关键词需要分别调用
• SOV 是快照：数据反映某个时间点的抓取结果，而非历史趋势
• 无历史 SOV：此工具不提供 SOV 随时间的变化；如需了解搜索量趋势，请使用关键词历史工具

用户表达与场景快速参考

适用 — Amazon 搜索结果中的品牌市场份额和竞争分析：

用户说	场景
“这个词谁占的份额最大”	品牌主导地位分析
“这个关键词竞争激不激烈”	竞争格局评估
“广告位都被谁占了”	赞助 SOV 分析
“有没有品牌垄断这个词”	垄断检测
“这个词的 PPC 出价大概多少”	PPC 出价估算
“搜索结果里哪些品牌排前面”	品牌曝光度排名
“这个词的转化率高不高”	热门 ASIN 转化分析

不适用 — 超出关键词声量份额范围的场景：

• 历史搜索量趋势（使用关键词历史工具）
• 关键词建议／关键词挖掘（使用 ABA 或关键词探索工具）
• 商品级销售额估算或评论分析
• 商品详情页优化或文案建议
• 非 Amazon 平台数据

适用边界：当用户提到“竞争分析”“品牌分析”或“市场格局”时，如果其意图是了解哪些品牌占据特定关键词的搜索结果页面（声量份额／品牌分布），则适用此技能。如果用户想要商品级销售数据、利润率或历史趋势，则不适用。

算力消耗规则

消耗 64 算力。

用户会因算力消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对算力消耗量预期不足时，务必提醒用户，由用户决定是否继续。

反馈：

在以下任一情况发生时，通过 Feedback API 自动检测并报告反馈：

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

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

---

如需了解更多优质、专业的跨境电商技能，请访问 LinkFox Skills。