Jungle Scout — 关键词市场份额 Share of Voice

本技能通过 Jungle Scout 数据源查询 Amazon 关键词的市场份额（Share of Voice，SOV）数据，返回品牌在搜索结果前 3 页中的可见度分布，并附带搜索量、PPC 出价预估，以及覆盖 10 个 Amazon 市场的 TOP ASIN 点击与转化指标。

核心概念

市场份额（Share of Voice）衡量的是：**某一关键词下，某品牌在搜索结果中所占据的“版面空间”比例**。Jungle Scout 分析 Amazon 搜索结果的前 3 页，并从以下三个维度计算各品牌的曝光占比：

• 自然流量 SOV（Organic SOV）：来自自然（非推广）搜索结果位置的品牌可见度
• 推广流量 SOV（Sponsored SOV）：来自推广/广告位的品牌可见度
• 综合 SOV（Combined SOV）：融合自然与推广结果的整体品牌可见度

每个维度均提供两种计算方式：

• 基础 SOV（Basic SOV）：简单产品数量占比 —— 品牌产品数 ÷ 前 3 页总产品数
• 加权 SOV（Weighted SOV）：按排名位置加权的占比，顶部位置权重更高，并纳入 Amazon’s Choice 等标识因素；该指标更适用于竞争分析

本工具还返回以下信息：

• 30 天精准搜索量（30-day exact search volume）：过去 30 天内该关键词的总预估搜索次数
• PPC 出价中位数（PPC bid median）：该关键词建议出价的中位数值，可用于广告成本估算
• TOP3 ASIN 点击与转化数据（TOP3 ASIN click & conversion data）：按点击量排序的前 3 个 ASIN，包含点击量、转化量及转化率

数据字段

brands（品牌 SOV 拆解）

topAsins（TOP 3 ASIN 点击与转化）

顶层汇总字段（Top-Level Summary Fields）

支持的市场

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 '' [--inline]
• 成本约束：本工具会消耗积分；同一会话中相同参数组合默认仅调用一次，脚本自带 24 小时本地缓存。失败或空结果不得自动更换关键词、翻页或修改邮编进行连续试探；如需继续检索，须先向用户说明将产生额外积分消耗。

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

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

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

解决认证和积分问题

发生以下异常情况时，采用以下措施处理：

异常情况

• 未配置 API Key：环境变量既未配置 LINKFOX_AGENT_API_KEY，也未配置 LINKFOXAGENT_API_KEY。
• 响应状态码为 401 或 402
• 响应提示积分或余额不足：消息中包含“积分余额不足”、“计费不足”、“余额不足”、“quota exceeded”、“insufficient balance”、“套餐到期”、“需充值”、“请充值”等任一表述，或含义相近的内容。

措施

• 优先调用 skill 内置的 onboarding.md 引导用户解决问题。
• 若未找到 onboarding.md 文件，则加载 /linkfox-onboarding 这个 skill，并依据其引导流程处理。如该 skill 尚未安装，请先安装：
  • 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装该 skill。如需用户授权方可下载，须主动询问并获得授权，你不可自行放弃下载。
• 兜底措施：仅当上述两种方式经全力尝试均不可行时，才提示用户参考 https://skill.linkfox.com/linkfoxskills/guide.htm 获取 API Key，或前往 https://os.linkfox.com/ 补充积分。

如何构建查询请求

仅需两个参数：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. TOP ASINs 区块：单独展示 TOP 3 ASIN 表格，含点击量、转化量及转化率
5. 竞争格局总结：数据展示完毕后，提供简明的竞争格局总结：该关键词是否由少数品牌主导，或呈现碎片化特征；同时指出自然流量与推广流量之间是否存在显著差距
6. 错误处理：当查询失败时，应基于错误响应解释失败原因，并建议调整参数

重要限制

• 覆盖范围：仅分析 Amazon 搜索结果的前 3 页（通常约 48–60 个商品）
• 单关键词限制：每次 API 调用仅支持一个关键词；多关键词对比需分别调用
• SOV 为快照数据：数据反映的是某一时点的爬取结果，不构成历史趋势
• 不提供历史 SOV：本工具不支持 SOV 随时间变化的追踪；如需搜索量趋势分析，请使用 keyword history 工具

用户表达与场景速查表

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

不适用场景 —— 超出关键词 Share of Voice 范围的情形：

• 历史搜索量趋势（请使用 keyword history 工具）
• 关键词推荐或关键词挖掘（请使用 ABA 或 keyword explorer 工具）
• 单品销量预估或评论分析
• Listing 优化或文案撰写建议
• 非 Amazon 平台数据

边界判断：当用户提及“竞争分析”、“品牌分析”或“市场格局”时，若其意图是了解特定关键词下哪些品牌占据了搜索结果页（即 share of voice / 品牌分布），则本 skill 适用；若其目标是获取单品销量数据、利润率或历史趋势，则本 skill 不适用。

积分消耗规则

消耗 63.75 积分。

用户将因积分消耗而支付费用。请充分评估：当需高频调用本技能，或用户对积分消耗预期不足时，务必提前提醒用户，并由用户自主决定是否继续。

反馈机制（Feedback）：

当出现以下任一情形时，自动检测并调用 Feedback API 上报：

1. 本 skill 描述的功能或用途与实际行为不符
2. 本 skill 返回结果与用户真实意图不符
3. 用户明确表达了对本 skill 的不满或赞赏
4. 你认为任何可改进之处

请严格按 references/api.md 中定义的方式调用 Feedback API。不得中断用户当前操作流程。

更多高质量、专业的跨境电商技能，请访问 LinkFox Skills。