linkfox-jiimore-get-niche-info-by-keyword

Jiimore 按关键词查询细分市场信息

此技能将指导你如何按关键词查询和分析 Amazon 细分市场数据，帮助 Amazon 卖家评估细分市场的竞争强度、品牌成熟度、定价结构和入场机会。

调用方式

• API 端点：POST /jiimore/getNicheInfoByKeyword（完整参数、响应和错误码见 references/api.md）
• Python 脚本：python scripts/jiimore_get_niche_info_by_keyword.py '<JSON 参数>' [--inline]
• 成本约束：本工具会消耗算力；同一会话中，相同参数组合默认只调用一次，脚本带有 24h 本地缓存。失败或结果为空时，不得自动更换关键词、翻页或更改邮编连续尝试；如需继续检索，请先向用户说明会产生额外消耗。

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

• 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-jiimore-get-niche-info-by-keyword-<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 加载到上下文中。

解决认证和算力问题

发生以下异常情况时，使用 references/onboarding.md 引导解决问题：

异常情况

• 未配置 API Key：未配置环境变量 LINKFOX_AGENT_API_KEY，也未配置 LINKFOXAGENT_API_KEY。
• 响应状态码为 401 或 402
• 响应提示算力或余额不足：消息中包含“算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值”，或含义相近的内容。

核心概念

细分市场（子市场细分）是 Amazon 上围绕共同关键词主题归类的一组产品。此工具为每个细分市场提供丰富的分析维度，包括搜索量、销量、点击率、品牌数量、头部品牌集中度、新品发布成功率、CPC 估算值和综合需求评分。支持 US、JP 和 DE 站点的数据。

关键词为必填项：每次查询都必须包含 keyword。关键词应使用目标站点的语言（例如，美国站使用英语，日本站使用日语，德国站使用德语）。如果用户提供的关键词使用了其他语言，请在调用 API 前将其翻译为目标站点的语言。

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

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

参数指南

必填项

参数	类型	描述
keyword	string	搜索关键词（最多 1000 个字符）。请翻译为目标站点的语言。

站点与分页

参数	类型	默认值	描述
countryCode	string	US	国家代码：US、JP、DE
page	integer	1	页码（从 1 开始）
pageSize	integer	50	每页结果数（10-100）
sortField	string	unitsSoldT7	排序字段（见下方排序选项）
sortType	string	desc	排序方向：desc 或 asc

筛选参数（均为可选项，支持最小值/最大值范围）

产品与定价：

参数	类型	描述
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）
newProductRateT180	number	180 天新品比例下限（0-1）
returnRateT360Min / returnRateT360Max	number	360 天退货率（0-1）

排序选项

值	含义
unitsSoldT7	每周售出件数
searchVolumeT7	每周搜索量
demand	需求评分
avgPrice	平均价格
maximumPrice	最高价格
minimumPrice	最低价格
productCount	产品数量
searchConversionRateT7	每周搜索转化率
clickConversionRateT7	每周点击转化率
searchVolumeGrowthT7	搜索量增长率
clickCountT7	每周点击次数
clickCountT90	90 天点击次数
brandCount	品牌数量
top5BrandsClickShare	点击量排名前 5 的品牌所占份额
top5ProductsClickShare	点击量排名前 5 的产品所占份额
newProductsLaunchedT180	180 天内推出的新品数量
successfulLaunchesT180	180 天内成功推出的新品数量
launchRateT180	180 天新品成功率
returnRateT360	年退货率
clickConversionRateT90	90 天点击转化率
searchConversionRateT90	90 天搜索转化率
searchVolumeT90	90 天搜索量
unitsSoldT90	90 天售出件数
unitsSoldGrowthT90	90 天销量增长率
searchVolumeGrowthT90	90 天搜索量增长率
acos	广告销售成本
profitRate50	自然销量占比为 50% 时的利润率

使用示例

1. 按关键词进行基础细分市场探索 查询美国市场中与 “wireless earbuds” 相关的细分市场，并按周销量排序：

{
  "keyword": "wireless earbuds",
  "countryCode": "US",
  "sortField": "unitsSoldT7",
  "sortType": "desc"
}

2. 发现低竞争细分市场 查找 “yoga mat” 的细分市场，要求排名前 5 的品牌点击份额低于 50%，且品牌数量超过 20：

{
  "keyword": "yoga mat",
  "countryCode": "US",
  "top5BrandsClickShareMax": 0.5,
  "brandCountMin": 20,
  "sortField": "demand",
  "sortType": "desc"
}

3. 高需求、高转化细分市场 查找 “phone case” 的细分市场，要求周搜索量超过 10000，且点击转化率超过 10%：

{
  "keyword": "phone case",
  "countryCode": "US",
  "searchVolumeT7Min": 10000,
  "clickConversionRateT7Min": 0.1,
  "sortField": "searchVolumeT7",
  "sortType": "desc"
}

4. 新品机会分析 查找 “LED light” 的细分市场，要求新品成功率较高（超过 20%），且退货率较低（低于 5%）：

{
  "keyword": "LED light",
  "countryCode": "US",
  "launchRateT180Min": 0.2,
  "returnRateT360Max": 0.05,
  "sortField": "launchRateT180",
  "sortType": "desc"
}

5. 日本市场细分市场研究 探索日本市场中与耳机相关的细分市场，并按需求评分排序：

{
  "keyword": "\u30d8\u30c3\u30c9\u30db\u30f3",
  "countryCode": "JP",
  "sortField": "demand",
  "sortType": "desc"
}

6. 特定价格区间的细分市场分析 查找 “backpack” 的细分市场，要求平均价格在 $20 到 $50 之间，且广告饱和度较低：

{
  "keyword": "backpack",
  "countryCode": "US",
  "avgPriceMin": 20,
  "avgPriceMax": 50,
  "sponsoredProductsPercentageMax": 0.3,
  "sortField": "unitsSoldT7",
  "sortType": "desc"
}

展示规则

1. 清晰呈现数据：将查询结果以结构清晰的表格展示。为便于阅读，将小数比例转换为百分比（例如，0.25 → 25%）。
2. 突出关键指标：始终将细分市场标题、需求评分、周搜索量、周销量、品牌数量以及排名前 5 的品牌点击份额列为主要字段。
3. 翻译细分市场标题：存在 translationZh 字段且用户偏好中文时，将其与原始 nicheTitle 一并展示。
4. 分页说明：当 total 超过当前页大小时，告知用户总条数，并建议按需获取后续页面。
5. 错误处理：查询失败时，根据响应消息说明原因，并建议调整筛选条件（例如，扩大范围或检查关键词）。
6. CPC 展示：存在 CPC 数据时，展示低、中、高三个档位，以完整呈现广告成本情况。
7. 不提供主观建议：客观呈现数据，不主动添加未经请求的商业建议。仅在用户明确要求时提供解读。

重要限制

• 支持的市场：仅支持 US、JP 和 DE。其他市场代码将被拒绝。
• 必须提供关键词：每次查询都必须包含关键词。API 不会在缺少关键词时返回结果。
• 结果上限：每页最多 100 条结果。
• 百分比值：所有比率／份额参数的取值范围为 0–1，而非 0–100。构造筛选条件时请确保使用正确的数值。

用户表达与场景速查

适用——按关键词进行细分市场层面的市场细分分析：

用户说	场景
“XX 市场是否有机会”	细分市场机会评估
“XX 关键词的竞争有多激烈”	垄断／品牌集中度
“查找 XX 的低竞争细分市场”	蓝海细分市场发现
“XX 的新品成功率是多少”	新进入者可行性
“展示 XX 的细分市场数据”	常规细分市场探索
“哪些 XX 细分市场需求旺盛”	需求驱动的细分市场排名
“XX 细分市场的 CPC／广告成本是多少”	广告成本分析
“查找 XX 的高转化细分市场”	转化率优化型细分市场
“XX 市场的品牌集中度”	品牌主导地位评估

不适用——需求超出细分市场层面的细分数据：

• 单个 ASIN 的表现或销量估算
• 搜索词排名趋势（请改用 ABA 数据工具）
• 广告活动管理或竞价优化
• 商品评论分析或商品信息优化
• 供应商寻源或物流规划

边界判断：当用户提到“市场研究”或“产品机会”时，如果其意图是评估关键词级市场细分的竞争格局和需求潜力，则适用此技能。如果用户需要 ASIN 级数据、搜索词排名趋势或全面的业务策略，请引导其使用相应工具。

算力消耗规则

消耗 9 算力。

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

反馈：

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

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

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

---

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