linkfox-jiimore-get-niche-info-by-asin

按 ASIN 查询 Jiimore 利基市场信息

本技能将指导你如何根据参考 ASIN 查询和分析 Amazon 利基市场数据，帮助 Amazon 卖家评估细分市场的竞争强度、品牌成熟度、定价结构和入场机会。

调用方式

• API 端点：POST /jiimore/getNicheInfoByAsin（完整参数/响应/错误码见 references/api.md）
• Python 脚本：python scripts/jiimore_get_niche_info_by_asin.py '<JSON 参数>' [--inline]
• 成本约束：本工具会消耗算力；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换 ASIN、改国家或放宽筛选连续试探；需要继续检索时先向用户说明会产生额外消耗。

输出策略（脚本默认行为）：

• 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-jiimore-get-niche-info-by-asin-<timestamp>.json（<cwd> 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；<session> 取自环境变量 SESSION_ID，按用户任务自动聚合；禁止写入 /tmp，当前目录不可写则报错）
• 响应体 ≤ 8 KB：落盘后将完整 JSON 打印到 stdout
• 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 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/套餐到期/需充值/请充值”，或含义相近的内容。

核心概念

利基市场（细分市场）是 Amazon 上具有共同关键词主题的一组产品。给定参考 ASIN 后，此工具会查找该 ASIN 所属的利基市场细分，并返回每个细分市场的丰富分析维度，包括搜索量、销量、点击率、品牌数量、头部品牌集中度、新品发布成功率、CPC 估算值和综合需求评分。数据适用于 US、JP 和 DE 站点。

必须提供 ASIN：每次查询都必须包含 asin。此工具会查找与该 ASIN 关联的利基市场细分，并返回详细指标。当用户已有特定产品（ASIN）并希望了解其参与竞争的市场细分时，请使用此工具，而不是使用由关键词驱动的利基市场发现工具。

百分比字段：部分参数和响应字段采用 0–1 的小数范围表示 0%–100%。向用户展示这些值时，请将其转换为百分比（例如，0.35 → 35%）。

需求评分：demand 字段是分配给每个利基市场的综合机会评分。数值越高，表示市场需求潜力越大。

参数指南

必填参数

参数	类型	说明
asin	string	参考产品 ASIN。此工具会查找与该 ASIN 关联的利基市场细分。

站点与数量

参数	类型	默认值	说明
countryCode	string	US	国家代码：US、JP、DE
count	integer	10	要返回的利基市场细分数量

筛选参数（均为可选，包含最小值/最大值范围）

产品与定价：

参数	类型	说明
productCountMin / productCountMax	integer	产品数量范围
avgPriceMin / avgPriceMax	number	平均价格范围

搜索与销量（7 天）：

参数	类型	说明
searchVolumeT7Min / searchVolumeT7Max	integer	每周搜索量范围
unitsSoldT7Min / unitsSoldT7Max	integer	每周售出件数范围
clickCountT7Min / clickCountT7Max	integer	每周点击次数范围
clickConversionRateT7Min / clickConversionRateT7Max	number	每周点击转化率（0-1）

品牌指标：

参数	类型	说明
brandCountMin / brandCountMax	integer	细分市场中的品牌数量
top5BrandsClickShareMin / top5BrandsClickShareMax	number	前 5 个品牌的点击份额（0-1）
avgBrandAgeMin / avgBrandAgeMax	number	品牌平均存续时间（当前）
avgBrandAgeQoqMin / avgBrandAgeQoqMax	number	品牌平均存续时间（90 天）
avgBrandAgeYoyMin / avgBrandAgeYoyMax	number	品牌平均存续时间（360 天）

卖家指标：

参数	类型	说明
avgSellingPartnerAgeMin / avgSellingPartnerAgeMax	number	卖家平均存续时间（当前）
avgSellingPartnerAgeQoqMin / avgSellingPartnerAgeQoqMax	number	卖家平均存续时间（90 天）
avgSellingPartnerAgeYoyMin / avgSellingPartnerAgeYoyMax	number	卖家平均存续时间（360 天）

竞争与广告：

参数	类型	说明
top5ProductsClickShareMin / top5ProductsClickShareMax	number	前 5 个产品的点击份额（0-1）
sponsoredProductsPercentageMin / sponsoredProductsPercentageMax	number	SP 广告占比（0-1）
cpcMediumMin / cpcMediumMax	number	CPC 中位数范围

新品与退货：

参数	类型	说明
launchRateT180Min / launchRateT180Max	number	180 天新品成功率（0-1）
returnRateT360Min / returnRateT360Max	number	360 天退货率（0-1）

使用示例

1. 按 ASIN 进行基础细分市场探索 查找美国市场中与 ASIN B0D9NWVC6Z 相关的细分市场：

{
  "asin": "B0D9NWVC6Z",
  "countryCode": "US",
  "count": 10
}

2. 按 ASIN 筛选低竞争细分市场 查找某个 ASIN 对应的细分市场，其中前 5 个品牌的点击份额低于 50%，且品牌数量超过 20：

{
  "asin": "B0D9NWVC6Z",
  "countryCode": "US",
  "count": 20,
  "top5BrandsClickShareMax": 0.5,
  "brandCountMin": 20
}

3. 按 ASIN 查找高需求、高转化的细分市场 查找某个 ASIN 对应的细分市场，其中每周搜索量超过 10000，且点击转化率超过 10%：

{
  "asin": "B0D9NWVC6Z",
  "countryCode": "US",
  "searchVolumeT7Min": 10000,
  "clickConversionRateT7Min": 0.1
}

4. 按 ASIN 分析新品机会 查找某个 ASIN 对应的细分市场，其中新品成功率较高（超过 20%），且退货率较低（低于 5%）：

{
  "asin": "B0D9NWVC6Z",
  "countryCode": "US",
  "launchRateT180Min": 0.2,
  "returnRateT360Max": 0.05
}

5. 按 ASIN 研究日本市场细分领域 探索日本市场中与某个 ASIN 相关的细分市场：

{
  "asin": "B0D9NWVC6Z",
  "countryCode": "JP",
  "count": 10
}

6. 按 ASIN 分析特定价格区间的细分市场 查找某个 ASIN 对应的细分市场，其平均价格在 $20 到 $50 之间，且广告饱和度较低：

{
  "asin": "B0D9NWVC6Z",
  "countryCode": "US",
  "avgPriceMin": 20,
  "avgPriceMax": 50,
  "sponsoredProductsPercentageMax": 0.3
}

展示规则

1. 清晰呈现数据：使用结构良好的表格展示查询结果。为便于阅读，将小数比例转换为百分比（例如，0.25 → 25%）。
2. 突出关键指标：始终将细分市场标题、需求评分、每周搜索量、每周销量、品牌数量和排名前 5 的品牌点击份额作为主要列展示。
3. 翻译细分市场标题：如果存在 translationZh 字段，且用户偏好中文，则将其与原始 nicheTitle 一并展示。
4. 处理空结果：如果响应表示没有匹配的细分市场信息（errcode 10000），请说明没有细分市场符合筛选条件，并建议扩大范围或核实 ASIN。
5. 错误处理：查询失败时，根据响应消息说明原因，并建议调整筛选条件（例如扩大范围或检查 ASIN/国家）。
6. CPC 展示：如果存在 CPC 数据，请展示全部三个档位（低、中、高），以便完整了解广告成本。
7. 不提供主观建议：客观呈现数据，不添加用户未要求的业务建议。只有用户明确要求时才提供解读。

重要限制

• 支持的站点：仅支持 US、JP 和 DE。其他站点代码将被拒绝。
• 必须提供 ASIN：每次查询都必须包含 ASIN。没有 ASIN，API 不会返回结果。
• 不支持分页/排序：此端点通过 count（默认值为 10）返回固定数量的细分市场；不提供 page/pageSize/sort 参数。需要排序或更深层分页时，请使用基于关键词的细分市场技能。
• 百分比值：所有比率/份额参数的取值范围为 0-1，而非 0-100。构造筛选条件时请确保使用正确的值。

用户表达与场景速查

适用——基于参考 ASIN 的细分市场级市场细分分析：

用户表达	场景
“这个 ASIN 属于哪些细分市场？”	ASIN 到细分市场的映射
“分析 ASIN XXXXX 的市场”	ASIN 驱动的细分市场评估
“这个产品所在的细分市场竞争有多激烈？”	按 ASIN 分析垄断程度/品牌集中度
“为这个 ASIN 找竞争较低的细分市场”	蓝海细分市场筛选
“这个 ASIN 所在细分市场的新产品成功率是多少？”	新进入者可行性
“展示这个产品的细分市场数据”	按 ASIN 进行一般细分市场探索
“这个 ASIN 所在细分市场的 CPC/广告成本是多少？”	广告成本分析
“这个 ASIN 所在市场的品牌集中度如何？”	品牌主导程度评估

不适用——需求超出 ASIN 驱动的细分市场数据范围：

• 关键词驱动的细分市场发现（请改用基于关键词的细分市场技能）
• 单个 ASIN 的表现或销量估算
• 搜索词排名趋势（请改用 ABA 数据工具）
• 广告活动管理或竞价优化
• 产品评论分析或商品信息优化

边界判断：当用户持有特定 ASIN 并提到“市场调研”或“产品机会”时，如果其意图是评估该 ASIN 参与竞争的细分市场的竞争格局和需求潜力，则适用此技能。如果用户需要关键词驱动的发现、ASIN 级销量估算或全面的商业策略，请引导他们使用相应工具。

算力消耗规则

消耗 9 算力。

用户会因算力消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对算力消耗量预期不足时，务必提醒用户，由用户决定是否继续。

反馈：

在以下任一情况出现时，通过 Feedback API 自动检测并报告反馈：

1. 本技能描述的功能或用途与实际行为不符
2. 本技能的结果不符合用户意图
3. 用户表达了对本技能的不满或赞赏
4. 你认为有任何可以改进之处

请按照 references/api.md 中的说明调用反馈 API。不要中断用户的流程。

---

如需获取更多高质量、专业的跨境电商技能，请设置 LinkFox Skills。