用途
本技能用于按关键词查询和分析亚马逊细分市场（niche）数据，帮助亚马逊卖家评估细分市场的竞争强度、品牌成熟度、价格结构与进入机会。细分市场指在亚马逊上共享同一关键词主题的商品分组。
主要能力
工具为每个细分市场返回丰富的分析维度，包括：搜索量、销量、点击率、品牌数量、头部品牌集中度、新品上架成功率、CPC 估算以及综合需求评分。数据覆盖美国（US）、日本（JP）、德国（DE）三个站点。
需求评分（demand）是分配给每个细分市场的综合机会评分，数值越高表示市场需求潜力越大。
使用方式
调用方式有两种：
- API 端点：POST /jiimore/getNicheInfoByKeyword（完整参数、响应与错误码见 references/api.md）
- Python 脚本：python scripts/jiimore_get_niche_info_by_keyword.py '<JSON 参数>' [--inline]
关键词为必填项，且应使用目标站点的语言（如美国站用英语、日本站用日语、德国站用德语）。若用户提供的关键词为其他语言，需先翻译为目标站点语言再调用。
主要参数包括：keyword（必填，最长 1000 字符）、countryCode（默认 US，可选 US/JP/DE）、page（默认 1）、pageSize（默认 50，范围 10-100）、sortField（默认 unitsSoldT7）、sortType（默认 desc）。此外还提供大量可选的范围过滤参数，涵盖商品与价格、搜索与销量（7 天）、品牌指标、卖家指标、竞争与广告、新品与退货等类别。
排序字段可选值包括：unitsSoldT7、searchVolumeT7、demand、avgPrice、maximumPrice、minimumPrice、productCount、searchConversionRateT7、clickConversionRateT7、searchVolumeGrowthT7、clickCountT7、clickCountT90、brandCount、top5BrandsClickShare、top5ProductsClickShare、newProductsLaunchedT180、successfulLaunchesT180、launchRateT180、returnRateT360、clickConversionRateT90、searchConversionRateT90、searchVolumeT90、unitsSoldT90、unitsSoldGrowthT90、searchVolumeGrowthT90、acos、profitRate50。
输出策略（脚本默认行为）：始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-jiimore-get-niche-info-by-keyword-<timestamp>.json；响应体 ≤ 8 KB 时落盘后把完整 JSON 打印到 stdout；响应体 > 8 KB 时落盘后 stdout 只输出摘要；加 --inline 可强制全量打印到 stdout（同样落盘）。建议先看摘要判断是否足够，需要具体字段时优先用 jq 或 ConvertFrom-Json 从保存的 json 文件按需抽取。
适用场景
适用于按关键词进行的细分市场层面分析，例如：细分市场机会评估、垄断程度与品牌集中度分析、蓝海细分市场发现、新品进入可行性评估、细分市场数据探索、需求驱动的细分市场排名、广告成本分析、转化优化细分市场筛选、品牌主导度评估等。
不适用于：单个 ASIN 表现或销量估算、搜索词排名趋势（应使用 ABA 数据工具）、广告活动管理或竞价优化、商品评论分析或 listing 优化、供应商采购或物流规划。
限制
- 支持的站点仅限 US、JP、DE，其他站点代码会被拒绝。
- 每次查询必须包含关键词，否则 API 不返回结果。
- 每页最多 100 条结果。
- 所有比率/占比参数使用 0-1 范围，而非 0-100。
- 本工具会消耗算力（消耗 9 算力），用户会因算力消耗而支付费用；高频调用或用户对消耗预期不足时需提醒用户。
- 同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存；失败或空结果不得自动换关键词、翻页或改邮编连续试探。
- 认证与算力问题（未配置 API Key、401/402 状态码、算力或余额不足等）需按 references/onboarding.md 引导解决。
展示规则
以结构化表格清晰呈现数据，将小数比率转换为百分比（如 0.25 -> 25%）；始终突出细分市场标题、需求评分、周搜索量、周销量、品牌数量、前 5 品牌点击份额等主要列；当存在 translationZh 字段且用户偏好中文时，与原始 nicheTitle 一并展示；当总数超过当前页大小时告知用户总数并建议获取更多页；查询失败时根据响应消息解释原因并建议调整过滤条件；存在 CPC 数据时展示低、中、高三档；客观呈现数据，不添加未经请求的商业建议。