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

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

• 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-jiimore-page-asins-by-asin-<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/套餐到期/需充值/请充值”，或类似含义的内容。

使用示例

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。

算力消耗规则

消耗 9 算力。

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

反馈：

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

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

请按照 references/api.md 中的说明调用反馈 API。请勿打断用户的操作流程。

---

如需了解更多优质、专业的跨境电商技能，请访问 LinkFox Skills。