Jungle Scout — 根据关键词扩展关键词信息（Keyword by Keyword）
用途
本技能通过 Jungle Scout 数据源，从一个种子关键词扩展出相关关键词列表，并提供搜索量、趋势、PPC 竞价、排名难度等竞争指标，覆盖 10 个亚马逊站点。主要应用场景包括：
- 关键词拓展/发现：输入核心词，获取相关关键词，扩充 listing 关键词库
- 长尾词挖掘：通过 minWordCount 筛选 3 词及以上的长尾关键词，发现低竞争高转化机会
- PPC 竞价研究：查看精确/广泛匹配 PPC 出价和品牌广告出价，规划广告预算
- 竞争度评估：通过 easeOfRankingScore 和 organicProductCount 判断关键词排名难度
- 趋势分析：查看月度趋势和季度趋势百分比变化，识别增长型关键词
主要能力与输出字段
输出列表字段（keywordInfoList）包括：
- 关键词 name，例如 yoga mat thick
- 站点 country，例如 us
- 精确搜索量 monthlySearchVolumeExact（月均精确匹配搜索量，示例 45000）
- 广泛搜索量 monthlySearchVolumeBroad（月均广泛匹配搜索量，示例 120000）
- 月度趋势 monthlyTrend（环比月度搜索量变化百分比，示例 15.3）
- 季度趋势 quarterlyTrend（环比季度搜索量变化百分比，示例 -5.2）
- 主类目 dominantCategory（搜索结果中占比最高的品类，示例 Sports & Outdoors）
- 相关性评分 relevancyScore（与种子词的相关性评分，示例 856）
- 排名难度 easeOfRankingScore（排名容易度评分，越高越容易，示例 3）
- 自然商品数 organicProductCount（示例 342）
- 广告商品数 sponsoredProductCount（示例 28）
- PPC 精确出价 ppcBidExact（美元，示例 1.25）
- PPC 广泛出价 ppcBidBroad（美元，示例 0.89）
- 品牌广告出价 spBrandAdBid（Sponsored Brand 广告建议出价，美元，示例 2.50）
- 推荐促销 recommendedPromotions（示例 150）
- 消耗 Token costToken
支持的站点
覆盖 10 个亚马逊站点：us（默认）、uk、de、in、ca、fr、it、es、mx、jp。对应为 Amazon.com、Amazon.co.uk、Amazon.de、Amazon.in、Amazon.ca、Amazon.fr、Amazon.it、Amazon.es、Amazon.com.mx、Amazon.co.jp。用户未指定站点时使用 us。
使用方式
- API 端点：POST /tool-jungle-scout/keywords/by-keyword（完整参数/响应/错误码见 references/api.md）
- Python 脚本：python scripts/junglescout_keyword_by_keyword.py '<JSON 参数>' [--inline]
成本约束：本工具会消耗算力；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败或空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。
输出策略（脚本默认行为）：
- 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-junglescout-keyword-by-keyword-<timestamp>.json（<cwd> 为脚本执行时的工作目录；<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、searchTerms（单个种子关键词字符串）。
- 站点映射："美国站"→ us，"日本站"→ jp，"德国站"→ de；未指定时默认 us
- 种子关键词：原样传入用户提供的关键词（英文小写为佳），仅支持单个关键词
- 结果数量：默认返回数量有限，若用户需要更多结果，设置 needCount
- 排序选择：默认按精确搜索量降序（-monthly_search_volume_exact），根据用户意图切换排序字段
- 筛选过滤：充分利用 min/max 参数缩小结果范围
常见查询场景示例：
- 扩展种子关键词：{"marketplace": "us", "searchTerms": "yoga mat"}
- 挖掘长尾关键词（3+ 词）：{"marketplace": "us", "searchTerms": "yoga mat", "minWordCount": 3, "needCount": 50}
- 低竞争关键词发现：{"marketplace": "us", "searchTerms": "yoga mat", "maxOrganicProductCount": 200, "minMonthlySearchVolumeExact": 1000, "sort": "-ease_of_ranking_score"}
- 高搜索量关键词筛选：{"marketplace": "us", "searchTerms": "yoga mat", "minMonthlySearchVolumeExact": 10000, "sort": "-monthly_search_volume_exact", "needCount": 30}
- PPC 竞价研究：{"marketplace": "us", "searchTerms": "yoga mat", "minMonthlySearchVolumeExact": 500, "sort": "ppc_bid_broad", "needCount": 30}
- 德国站广泛搜索量关键词：{"marketplace": "de", "searchTerms": "yogamatte", "minMonthlySearchVolumeBroad": 5000, "sort": "-monthly_search_volume_broad"}
展示规则
- 表格优先：以表格展示关键词列表，核心列包括关键词、精确搜索量、广泛搜索量、月度趋势、PPC 精确出价、排名难度
- 按需裁剪列：PPC 研究场景侧重出价列，拓词场景侧重搜索量和趋势
- 趋势标注：月度趋势和季度趋势为正值标注上升↑，负值标注下降↓
- 排名难度解读：easeOfRankingScore 1-3 为困难，4-6 为中等，7-10 为容易
- 数据洞察：在表格后提供简要总结
- 错误处理：查询失败时根据错误响应解释原因并建议调整参数
适用场景
用户表达适用的场景包括："帮我拓展这个关键词"（种子词扩展）、"这个词有哪些相关关键词"（相关词挖掘）、"找一些长尾词"（长尾关键词筛选，minWordCount ≥ 3）、"竞争度低的词有哪些"（排名难度 + 商品数量筛选）、"这个词的 PPC 出价多少"（PPC 竞价数据查询）、"搜索量大的相关词"（高搜索量关键词筛选）、"德国站有什么相关词"（非美国站关键词拓展）、"帮我做关键词调研"（综合关键词研究）。
不适用的场景：关键词历史搜索量趋势（需 keyword-history 工具）、ABA 搜索词排名（需 ABA 工具）、商品搜索或 listing 分析、非亚马逊平台的关键词数据、ASIN 反查关键词。
边界判断：当用户说"关键词""拓词""关键词研究"，且意图是把种子关键词扩展为带指标的相关关键词列表时，适用本技能；若想查看单个关键词的历史搜索量随时间的变化趋势，应改用 keyword-history 技能。
限制
- 单次单关键词：searchTerms 仅接受一个种子关键词，多关键词需拆分多次调用
- 数据周期：搜索量为月均估算值，非实时数据
- 站点限制：仅覆盖 10 个亚马逊站点，不含澳大利亚、荷兰等
- 排序字段固定：仅支持预定义的排序字段，不支持自定义组合排序
算力消耗规则
按动态规则计费：消耗算力 = 实际查询页数 × 63.75。本技能的服务按倍数动态计算，可能一次性消耗大量算力，必须提醒用户，由用户决定是否继续。
反馈
当以下情况出现时，通过 Feedback API 自动检测并上报：本技能描述的功能或目的与实际行为不符、结果与用户意图不符、用户表达不满或赞扬、认为可改进之处。按 references/api.md 中的说明调用反馈 API，不要打断用户流程。