用途
本技能用于查询并分析极目数据(Jiimore)的亚马逊细分市场洞察,帮助亚马逊卖家深入了解特定细分市场的竞争、定价、评论与增长趋势。适用于对某个已知细分市场 ID 进行市场调研、竞争分析、定价情报、搜索与需求分析、新品上架跟踪、评论分析、库存健康分析以及综合细分市场评估等场景。
主要能力
该工具一次检索一个细分市场的综合市场情报,覆盖以下维度:
- 市场概览:细分市场标题、需求评分、商品数、品牌数、卖家数
- 定价:平均价格、最低价格、最高价格
- 搜索与转化:周/季度搜索量、搜索量增长、搜索转化率、点击转化率、销量
- 竞争集中度:Top5 / Top20 商品与品牌点击份额(当前、90 天、360 天快照)
- 新品上架:新品上架数、90 天 / 180 天 / 360 天窗口内的成功上架数
- 库存健康:平均断货率随时间变化
- 卖家成熟度:平均品牌年龄、平均卖家年龄
- 评论洞察:平均评论评分、平均评论数、正面与负面客户评论洞察
- 广告:ACOS(广告成本销售比)、赞助商品占比
- 盈利能力:利润率 > 50% 的 SKU 占比、盈亏平衡比例、退货率
支持的市场:US(美国)、JP(日本)、DE(德国),默认 US。
使用方式
调用方式有两种:
- API 端点:POST /jiimore/getNicheInfo(完整参数、响应与错误码见 references/api.md)
- Python 脚本:python scripts/jiimore_get_niche_info.py '<JSON 参数>' [--inline]
参数说明:
- nicheId(必填,字符串):要查询的细分市场 ID,最大 1000 字符,每次请求仅一个 ID。
- countryCode(可选,字符串):市场代码,允许值 US、JP、DE,默认 US。仅当用户明确提到日本或德国时才指定其他值。
使用示例:
- 美国市场查询:nicheId: "12345678",countryCode: "US"
- 日本市场查询:nicheId: "87654321",countryCode: "JP"
- 德国市场查询:nicheId: "11223344",countryCode: "DE"
输出策略(脚本默认行为):
- 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-jiimore-get-niche-info-<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 进入上下文。
成本约束:本工具会消耗算力;同一会话同一参数组合默认只调用一次,脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探;需要继续检索时先向用户说明会产生额外消耗。
认证与算力问题:发生以下异常情况时,采用 references/onboarding.md 引导解决:
- 未配置 API Key:环境变量未配置 LINKFOX_AGENT_API_KEY,也未配置 LINKFOXAGENT_API_KEY
- 响应 401 或 402 状态码
- 响应提示算力或余额不足:消息含"算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值",或类似含义的内容
适用场景
适用于针对特定亚马逊细分市场的查询,例如:
- "查询这个细分市场"、"niche ID 信息"——基础细分市场查询
- "这个细分市场竞争如何"、"品牌集中度"——竞争分析
- "这个细分市场平均价格是多少"——定价情报
- "这个细分市场搜索量"、"需求趋势"——搜索与需求分析
- "上架了多少新品"、"上架成功率"——新品上架跟踪
- "这个细分市场评论评分"、"买家反馈洞察"——评论分析
- "断货率"、"库存健康"——库存分析
- "这个细分市场是否值得进入"、"细分市场机会"——综合细分市场评估
不适用场景:
- 按关键词或类目搜索细分市场(本工具需要已知的细分市场 ID)
- 单个 ASIN 级别的商品分析
- ABA 搜索词数据(应使用 ABA Data Explorer)
- 广告活动管理或 PPC 优化
- Listing 文案撰写或评论管理
限制
- 单次仅支持一个细分市场 ID,不支持批量查询。
- 仅支持 US、JP、DE 三个市场。
- 必须由用户提供细分市场 ID;本工具无法按关键词或类目搜索细分市场。
- 每次调用消耗 9 算力,用户会因算力消耗而支付费用。当需要高频调用本技能,或用户对算力消耗量预期不足时,务必提醒用户,由用户决定是否继续。
展示规则
- 清晰呈现数据:以结构良好的表格或分组区块展示查询结果,除非特别要求,不提供主观商业建议。
- 趋势对比:当响应包含当前、90 天前和 360 天前的数据点时,并排展示,便于用户发现趋势。
- 百分比格式:将份额和比率值显示为百分比(例如 0.35 显示为 35.0%)。
- 评论洞察:如果存在正面/负面客户评论洞察,以项目符号列出。
- 图片展示:如果存在 referenceAsinImageUrl,展示或链接到细分市场参考图片。
- 错误处理:查询失败时,根据响应解释原因,并建议检查细分市场 ID 或国家代码。
反馈
在以下任一情况发生时,通过 Feedback API 自动检测并报告反馈:
- 本技能描述的功能或目的与实际行为不符
- 技能结果与用户意图不符
- 用户对本技能表达不满或赞扬
- 任何你认为可以改进的地方
按 references/api.md 中的说明调用反馈 API,不要打断用户流程。