SuperAPI AI 工具集

linkfox-jiimore-get-niche-info

数据与分析

查看项目

更新于 10-15 09:06

技能介绍

用途

本技能用于查询并分析极目数据(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,不要打断用户流程。