用途
本技能用于查询亚马逊关键词的 Share of Voice（品牌声量占比，简称 SOV）数据。它通过 Jungle Scout 数据源，分析某个关键词在亚马逊搜索结果前 3 页中的品牌曝光分布，帮助判断该关键词由哪些品牌主导、竞争是否激烈、广告位被谁占据，以及头部 ASIN 的点击转化表现。
主要能力
品牌声量占比（SOV）
Jungle Scout 分析亚马逊搜索结果前 3 页，从三个维度计算每个品牌的曝光占比：
- 自然 SOV（Organic SOV）：来自自然（非广告）搜索结果的品牌曝光
- 广告 SOV（Sponsored SOV）：来自广告位的品牌曝光
- 综合 SOV（Combined SOV）：自然与广告合并后的整体曝光
每个维度提供两种算法：
- 基础 SOV（Basic SOV）：简单产品数量比，即某品牌产品数 ÷ 前 3 页产品总数
- 加权 SOV（Weighted SOV）：按排名位置加权，靠前位置权重更高，并考虑 Amazon's Choice 等因素，更适合竞争分析
其他返回数据
- 30 天精确搜索量：过去 30 天的预估搜索总量
- PPC 竞价中位数：该关键词的建议出价中位数，可用于广告成本估算
- TOP3 ASIN 点击与转化数据：按点击量排序的前 3 个 ASIN，含点击量、转化量与转化率
品牌维度字段
每个品牌返回：品牌名、自然产品数、广告产品数、综合产品数、自然基础 SOV、自然加权 SOV、广告基础 SOV、广告加权 SOV、综合基础 SOV、综合加权 SOV、自然平均排名、广告平均排名、综合平均排名、自然平均价格、广告平均价格、综合平均价格。
TOP3 ASIN 字段
ASIN、产品名称、品牌、点击量（30 天窗口）、转化量（30 天窗口）、转化率（0–1）。
顶层汇总字段
ID、类型（固定为 share_of_voice）、30 天搜索量、PPC 竞价中位数、产品总数、数据更新时间、TOP ASIN 数据窗口起止日期、本次调用消耗的算力 Token。
支持站点
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]
查询构建
仅需两个参数：marketplace 与 keyword。
- 站点映射："美国站" → us，"日本站" → jp，"德国站" → de；未指定时默认 us
- 关键词：按用户原词传入（建议小写英文）
- 每次调用分析一个关键词；多关键词对比需分别调用
调用示例
品牌主导度检查：
{ "marketplace": "us", "keyword": "portable charger" }
关注 combinedWeightedSov，判断哪些品牌主导搜索结果页。
PPC 竞争分析：
{ "marketplace": "us", "keyword": "wireless earbuds" }
对比 exactSuggestedBidMedian 与搜索量评估成本效率，查看 sponsoredWeightedSov 了解竞品广告投入程度。
TOP ASIN 转化效率：
{ "marketplace": "de", "keyword": "kopfhörer kabellos" }
查看 topAsins 数组，判断高点击产品是否转化良好。高点击 + 低转化率可能意味着机会。
识别市场空白：
{ "marketplace": "jp", "keyword": "ヨガマット" }
若没有单一品牌的 combinedWeightedSov 超过 0.15，说明该关键词较为分散，可能更易进入。结合搜索量评估市场规模。
对比自然与广告存在感：
{ "marketplace": "uk", "keyword": "running shoes" }
某品牌 sponsoredWeightedSov 高但 organicWeightedSov 低，说明其高度依赖广告，可据此制定竞争策略。
成本约束
本工具会消耗算力；同一会话同一参数组合默认只调用一次，脚本带 24 小时本地缓存。失败或空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。
输出策略（脚本默认行为）
- 始终将完整响应写入 <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/套餐到期/需充值/请充值"或类似含义的内容
展示规则
- 品牌表：按 combinedWeightedSov 降序展示，突出前 5 个品牌
- SOV 以百分比展示（乘以 100），如 0.152 → 15.2%
- 表格前展示关键词的 30 天搜索量与 PPC 竞价中位数作为背景
- TOP3 ASIN 单独成表，含点击量、转化量、转化率
- 数据后提供简要竞争格局总结：该关键词是被少数品牌主导还是分散，并指出自然与广告存在感的差距
- 查询失败时，根据错误响应说明原因并建议调整参数
适用场景
适用于亚马逊搜索结果上的品牌市场份额与竞争分析：
- "这个词谁占的份额最大"——品牌主导度分析
- "这个关键词竞争激不激烈"——竞争格局评估
- "广告位都被谁占了"——广告 SOV 分析
- "有没有品牌垄断这个词"——垄断检测
- "这个词的 PPC 出价大概多少"——PPC 出价估算
- "搜索结果里哪些品牌排前面"——品牌曝光排名
- "这个词的转化率高不高"——TOP ASIN 转化分析
边界判断：当用户说"竞争分析""品牌分析"或"市场格局"，若意图是了解某个具体关键词的搜索结果页由哪些品牌占据（声量占比/品牌分布），则适用本技能；若想要产品级销售数据、利润率或历史趋势，则不适用。
限制
- 覆盖范围：仅分析亚马逊搜索结果前 3 页（通常约 48–60 个产品）
- 单关键词：每次 API 调用仅分析一个关键词，多关键词对比需分别调用
- SOV 为快照：数据反映某一时点的抓取结果，非历史趋势
- 无历史 SOV：本工具不提供 SOV 随时间的变化；搜索量趋势请使用关键词历史工具
- 不适用于：历史搜索量趋势（用关键词历史工具）、关键词建议/挖掘（用 ABA 或关键词探索工具）、产品级销量估算或评论分析、Listing 优化或文案建议、非亚马逊平台数据
算力消耗
消耗 64 算力。用户会因算力消耗而支付费用。当需要高频调用本技能，或用户对算力消耗量预期不足时，务必提醒用户，由用户决定是否继续。
反馈
当出现以下情况时，通过 Feedback API 自动检测并报告反馈（不打断用户流程）：本技能描述的功能或目的与实际行为不符；技能结果与用户意图不符；用户对本技能表达不满或赞扬；任何可改进之处。具体调用方式见 references/api.md。