linkfox-jiimore-get-niche-review-from-keyword

LinkFox Jiimore Niche Review from Keyword 是一个亚马逊细分市场评论分析与消费者情感洞察技能，由 Jiimore 提供数据支持，用于从细分市场内的商品评论中挖掘消费者情感、痛点和真实需求信号。

用途方面，该技能面向亚马逊卖家的选品与市场研究场景。给定一个关键词，系统会识别出相关的细分市场，并聚合、分类该细分市场内各商品的客户评论，提取评论主题，将其归类为正面或负面，并展示每个主题被提及的频率。这有助于卖家了解客户喜爱什么、对什么感到不满，以及产品改进机会在哪里。

主要能力包括：

评论主题提取与情感分类。每条评论条目被归类为 positive（正面）或 negative（负面），反映该评论主题的整体情感倾向。
提及百分比。percentOfMentions 值采用 0-1 区间（代表 0%-100%），表示某一主题在细分市场全部评论中出现的频率，百分比越高说明讨论该主题的客户越多。
细分市场筛选。提供大量筛选参数，涵盖商品与品牌指标（商品数、品牌数、平均价格）、销售与搜索量（7 天销量、7 天搜索量、7 天点击数）、转化与点击率（0-1 区间）、市场集中度（Top5 品牌点击份额、Top5 商品点击份额、SP 广告占比）、品牌与卖家年龄（当前、90 天、360 天）、新品与退货指标（180 天发布成功率、新品占比、360 天退货率）以及广告 CPC 等。所有筛选参数均采用最小值/最大值区间模式，百分比类字段使用 0-1 尺度。
排序。支持按销量、搜索量、搜索量增长、点击转化率、搜索转化率、点击数、需求分、平均/最高/最低价格、商品数、品牌数、Top5 品牌与商品点击份额、90 天各项指标、360 天退货率、180 天新品发布与成功发布指标、发布成功率、ACOS、50% 自然订单下的利润率等字段排序，方向可选 desc 或 asc。
分页。page 从 1 开始，pageSize 默认 50（范围 10-100）。

支持的市场站点为美国（US）、日本（JP）、德国（DE），默认 US。keyword 为必填参数（最长 1000 字符），且必须使用目标站点的语言（US 用英语、DE 用德语、JP 用日语）。

使用方式：

API 端点：POST /jiimore/getNicheReviewFromKeyword（完整参数、响应与错误码见 references/api.md）。
Python 脚本：python scripts/jiimore_get_niche_review.py '<JSON 参数>' [--inline]。
成本约束：本工具会消耗算力（每次消耗 9 算力），同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败或空结果时不得自动更换关键词、翻页或修改邮编连续试探；需要继续检索时应先向用户说明会产生额外消耗。用户会因算力消耗支付费用，高频调用或用户对算力消耗预期不足时，应提醒用户并由用户决定是否继续。
输出策略：脚本始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-jiimore-get-niche-review-from-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 进入上下文。
认证与算力问题：当出现未配置 API Key（环境变量 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY 未配置）、响应 401 或 402 状态码、响应提示算力或余额不足（如"算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"等类似含义）时，采用 references/onboarding.md 引导解决问题。

使用示例（来自资料）：

基础查询：{"keyword": "yoga mat", "countryCode": "US"}
高搜索量筛选：{"keyword": "wireless earbuds", "countryCode": "US", "searchVolumeT7Min": 10000}
低竞争细分市场：{"keyword": "pet bed", "countryCode": "US", "top5BrandsClickShareMax": 0.3}
日本站：{"keyword": "wireless earbuds", "countryCode": "JP"}
按需求分排序：{"keyword": "kitchen organizer", "sortField": "demand", "sortType": "desc"}
按新品成功率筛选：{"keyword": "phone case", "launchRateT180Min": 0.2}
低退货率：{"keyword": "water bottle", "returnRateT360Max": 0.05}

展示规则方面：应以清晰表格呈现评论主题，包括细分市场名称、评论类型（正面/负面）、主题、提及百分比和评论示例；将 0-1 尺度值转换为百分比显示（如 0.15 -> 15%）；展示结果时按正面与负面分组或明确标注，便于用户快速识别机会与痛点；在客观展示数据的同时，将高提及比例的负面评论标为潜在产品改进机会，高提及比例的正面评论标为可在listing中强调的特性；结果较多时优先展示最相关数据并提醒分页选项；查询失败时说明原因并建议调整关键词或筛选条件；若用户提供的关键词与目标站点语言不符，提醒使用站点母语（US 英语、DE 德语、JP 日语）。

适用场景：用户询问"XX 的客户怎么说"（细分市场评论主题查询）、"XX 的客户痛点"（负面评论分析）、"买家喜欢 XX 的哪些特性"（正面评论分析）、"XX 细分市场的评论情感"（完整情感拆解）、"XX 的消费者需求洞察"（从评论提取需求信号）、"XX 产品的常见抱怨"（负面主题挖掘）、"XX 产品为什么受欢迎"（正面主题挖掘）、"细分市场评论分析"（一般性细分评论探索）。

限制与不适用场景：

本工具工作在细分市场/市场层面，不适用于单个 ASIN 的评论分析。
不适用于不结合评论背景的关键词搜索量趋势分析（应使用 ABA 数据工具）。
不适用于商品 listing 优化或文案撰写。
不适用于广告策略与 PPC 管理。
不适用于销量估算或收入预测。边界判断：当用户说"市场调研"或"产品机会"时，若意图聚焦于了解细分市场内的消费者情感、评论主题和痛点，则适用本技能；若询问搜索量趋势、定价策略或不含评论背景的销售数据，则不适用。

技能介绍