linkfox-jiimore-niche-by-asin

Jiimore 按 ASIN 查找细分市场竞品

本技能将指导你如何查询和筛选与参考 ASIN 属于同一细分市场的 Amazon 竞品，帮助 Amazon 卖家发现潜在竞品，并通过点击转化率、综合转化率、点击量、销量、评论数、价格、FBA 费用和毛利率等指标评估机会。

核心概念

给定一个参考 ASIN，该工具会在 Amazon 上挖掘属于同一细分市场的竞品 ASIN，并以分页列表形式返回丰富的指标：点击转化率、综合转化率、点击次数（7 天／30 天／90 天）、销量、价格、FBA 费用、毛利率、客户评分和 90 天趋势数据。数据仅适用于 US、JP 和 DE 站点。

必须提供 ASIN：每次查询都必须包含参考 asin。该工具会查找与此 ASIN 属于同一细分市场的产品，并返回这些产品的详细指标。

百分比字段：部分参数使用 0–1 的小数表示 0%–100%。向用户显示这些值时，请将其转换为百分比（例如，0.15 → 15%）。

日期格式：上架日期参数采用 yyyyMMdd000000 格式（例如，2024 年 1 月 1 日对应 20240101000000）。

参数指南

必填参数

参数	类型	描述
asin	string	要查找竞品的参考 ASIN（最多 1000 个字符）

站点与分页

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

筛选参数（均为可选，使用最小值／最大值范围）

价格与 FBA：

参数	类型	描述
priceMin / priceMax	number	产品价格范围
fbaFeeMin / fbaFeeMax	number	FBA 费用范围
grossProfitMarginMin / grossProfitMarginMax	number	毛利率范围

评论与评分：

参数	类型	描述
totalReviewsMin / totalReviewsMax	integer	评论总数范围
customerRatingMin / customerRatingMax	number	客户评分范围（0.0–5.0）

点击数据（7 天）：

参数	类型	描述
clickCountT7Min / clickCountT7Max	integer	每周点击次数范围
clickCountGrowthT7Min / clickCountGrowthT7Max	number	每周点击增长率（0–1）
clickConversionRateMin / clickConversionRateMax	number	点击转化率（0–1）

点击数据（30 天）：

参数	类型	描述
clickCountT30Min / clickCountT30Max	integer	每月点击次数范围
clickCountGrowthT30Min / clickCountGrowthT30Max	number	每月点击增长率（0–1）

综合转化率：

参数	类型	描述
clickConversionRateCompositeMin / clickConversionRateCompositeMax	number	综合点击转化率（0–1）

销量与上架日期：

参数	类型	描述
salesVolumeT360Min / salesVolumeT360Max	integer	360 天销量范围
launchDateMin / launchDateMax	string	上架日期范围（格式：yyyyMMdd000000）

细分市场与卖家：

参数	类型	描述
nicheCountMin / nicheCountMax	integer	产品所属的细分市场数量
sellerCountry	string	卖家所在国家／地区代码，多个代码以逗号分隔（例如，"CN,US"）

排序选项

值	含义
purchasedClicksT360	360 天购买点击量（默认）
totalReviews	评论总数
price	价格
launchDate	上架日期
clickCountT30	30 天点击量
clickCountT90	90 天点击量
clickCountT7	7 天点击量
clickConversionRate	点击转化率
clickConversionRateComposite	综合点击转化率
customerRating	客户评分
clickCountGrowthT7	周点击增长率
clickCountGrowthT30	月点击增长率
currentPrice	当前价格
fbaFee	FBA 佣金
shippingFee	FBA 运费
gpm	毛利率

API 用法

此工具会调用 LinkFox 工具网关 API。有关调用约定、请求参数和响应结构，请参阅 references/api.md。你也可以直接运行 scripts/jiimore_page_asins_by_asin.py 执行查询。

用法示例

1. 按 ASIN 基本查询竞品 查找美国市场中与指定 ASIN 竞争的产品：

{
  "asin": "B0GC4RPX79",
  "countryCode": "US",
  "sortField": "purchasedClicksT360",
  "sortType": "desc"
}

2. 高转化率竞品 查找综合转化率高于 15% 的竞品：

{
  "asin": "B0GC4RPX79",
  "countryCode": "US",
  "clickConversionRateCompositeMin": 0.15,
  "sortField": "clickConversionRateComposite",
  "sortType": "desc"
}

3. 新品机会 查找近期上架（3 个月内）且点击量增长较高的竞品：

{
  "asin": "B0GC4RPX79",
  "countryCode": "US",
  "launchDateMin": "20240101000000",
  "clickCountGrowthT7Min": 0.1,
  "sortField": "clickCountGrowthT7",
  "sortType": "desc"
}

4. 按价格范围筛选竞品 查找价格在 $20 至 $50 之间且毛利率较高的竞品：

{
  "asin": "B0GC4RPX79",
  "countryCode": "US",
  "priceMin": 20,
  "priceMax": 50,
  "grossProfitMarginMin": 0.3,
  "sortField": "gpm",
  "sortType": "desc"
}

5. 高点击量、低评论数的竞品（潜在薄弱点） 查找月点击量超过 2000、但评论数少于 100 的竞品：

{
  "asin": "B0GC4RPX79",
  "countryCode": "US",
  "clickCountT30Min": 2000,
  "totalReviewsMax": 100,
  "sortField": "clickCountT30",
  "sortType": "desc"
}

6. 日本市场竞品分析 按评分排序，分析日本市场中的竞品：

{
  "asin": "B0GC4RPX79",
  "countryCode": "JP",
  "sortField": "customerRating",
  "sortType": "desc"
}

7. 同一细分市场中的中国卖家 按卖家所在国家（中国）筛选销量较高的竞品：

{
  "asin": "B0GC4RPX79",
  "countryCode": "US",
  "sellerCountry": "CN",
  "salesVolumeT360Min": 1000,
  "sortField": "purchasedClicksT360",
  "sortType": "desc"
}

显示规则

1. 清晰呈现数据：使用结构清晰的表格展示查询结果。为便于阅读，将小数比率转换为百分比（例如，0.25 -> 25%）。
2. 突出关键指标：始终将 ASIN、产品标题、价格、客户评分、点击转化率（综合）、点击量、评论总数和毛利率作为主要列展示。
3. 展示细分市场背景：存在 niches 字段时，展示排名靠前的细分市场标题和需求分数，以说明产品所处的市场细分。
4. 趋势可视化：存在 trends 数据时，概述点击量、价格等关键指标在 90 天内的趋势方向（上升／下降／稳定）。
5. 分页提示：当 total 超过当前页面大小时，告知用户结果总数，并建议按需获取后续页面。
6. 错误处理：查询失败时，根据响应消息说明原因，并建议调整筛选条件（例如，扩大范围或检查 ASIN）。
7. 不提供主观建议：客观呈现数据，不主动添加未经请求的业务建议。仅在用户明确要求时提供解读。

重要限制

• 支持的商城：仅支持 US、JP 和 DE。其他商城代码将被拒绝。
• 必须提供 ASIN：每次查询都必须包含参考 ASIN。缺少 ASIN 时，API 不会返回结果。
• 结果上限：每页最多 100 条结果。
• 百分比值：所有比率／占比参数的取值范围为 0-1，而非 0-100。构造筛选条件时请确保使用正确的值。
• 日期格式：上架日期参数必须采用 yyyyMMdd000000 格式。

用户表达与场景速查

适用——根据参考 ASIN 查找竞品：

用户说法	场景
"查找 ASIN B0GC4RPX79 的竞品"	直接查找竞品
"有哪些产品与这个 ASIN 竞争"	同细分市场竞品探索
"展示同一细分市场中的类似产品"	发现细分市场竞品
"我产品的高转化竞品"	基于转化率筛选竞品
"在我的细分市场中竞争的新产品"	识别新进入者
"哪些中国卖家与这个 ASIN 竞争"	基于卖家来源筛选
"查找像我这样的低评论数、高点击量产品"	机会缺口分析
"ASIN XX 的竞品定价分析"	以价格为重点的竞品分析

不适用——需求超出基于 ASIN 的同细分市场竞品发现范围：

• 关键词级细分市场分析（请改用 Jiimore Niche Info by Keyword）
• 单个 ASIN 的收入或利润估算
• ABA 搜索词数据／关键词研究
• 广告活动管理或竞价优化
• 产品评论分析或商品信息优化
• 供应商采购或物流规划

边界判断：当用户提到“竞品分析”或“类似产品”时，如果其意图是查找与特定 ASIN 属于同一细分市场的竞争产品，则此技能适用。如果他们需要关键词级市场细分数据，请引导他们使用 Jiimore Niche Info by Keyword。如果他们需要单个 ASIN 的详细产品数据，请引导他们使用 Amazon Product Detail。

反馈：

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

1. 此技能所述功能或用途与实际行为不符
2. 此技能的结果与用户意图不符
3. 用户对这项技能表达不满或赞赏
4. 你认为任何方面有改进空间

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

处理大型响应

为避免 Agent 上下文溢出，请将响应保存到磁盘，并仅提取所需字段：

python scripts/response_io.py run --script scripts/jiimore_page_asins_by_asin.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # or --path "<JMESPath>"

请将 --out-dir 指定到任何 Git 工作树之外的位置（例如，在 Unix 上使用 /tmp/...，在 Windows 上使用 %TEMP%/...）。持久化的响应可能包含 PII、定价信息或敏感的身份验证数据——请勿提交这些文件。文件不会自动删除；任务完成后请清理。

run 会将完整响应写入文件，并仅输出架构预览和文件路径。read 会提取指定字段；使用 --limit/--offset 进行切片，使用 --format json|jsonl|csv|table 指定输出格式。

何时优先使用此模式——请根据响应特征自行判断，例如：

• 每条记录字段较多，或包含你不需要的字段
• 批量／分页结果（每次调用返回多个项目）
• 长文本字段（描述、评论、HTML、时间序列）
• 后续步骤会重复使用输出，而不是立即使用

对于较小且只使用一次的响应，直接调用主脚本即可。

⚠️ 预览仅包含截断的架构和样例，并非完整数据。任何字段级决策都必须通过 read 从持久化文件中读取。

---

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