Back to Details

linkfox-jiimore-page-asins-by-asin

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Jiimore Niche Competitor by ASIN

Jiimore Niche Competitor by ASIN

This skill guides you on how to query and filter Amazon competing products in the same niche segments as a reference ASIN, helping Amazon sellers discover potential competitors and evaluate opportunities using metrics such as click conversion rate, composite conversion rate, click volume, sales volume, reviews, price, FBA fees, and gross profit margin.
本技能将指导您如何查询和筛选与参考ASIN处于同一细分市场（Niche）的亚马逊竞品，帮助亚马逊卖家通过点击转化率、综合转化率、点击量、销量、评论、价格、FBA费用、毛利率等指标发现潜在竞品并评估商机。

Core Concepts

核心概念

Given a reference ASIN, the tool mines competing ASINs that share the same niche segments on Amazon and returns a paginated list with rich metrics: click conversion rate, composite conversion rate, click counts (7-day/30-day/90-day), sales volume, pricing, FBA fees, gross profit margin, customer rating, and 90-day trend data. Data is available for US, JP, and DE marketplaces only.
ASIN is required: Every query must include a reference 
asin
. The tool finds products that share the same niche segments as this ASIN and returns them with detailed metrics.
Percentage fields: Several parameters use a 0-1 decimal range representing 0%-100%. When displaying these values to users, convert them to percentages (e.g., 0.15 -> 15%).
Date format: Launch date parameters use the format 
yyyyMMdd000000
(e.g., 
20240101000000
for January 1, 2024).
给定一个参考ASIN，该工具会挖掘亚马逊上与该ASIN处于同一细分市场的竞品ASIN，并返回包含丰富指标的分页列表：点击转化率、综合转化率、点击量（7天/30天/90天）、销量、定价、FBA费用、毛利率、客户评分以及90天趋势数据。数据仅支持美国（US）、**日本（JP）和德国（DE）**站点。
必须提供ASIN：每次查询都必须包含一个参考
asin
。工具会找到与该ASIN处于同一细分市场的产品，并返回详细指标。
百分比字段：部分参数使用0-1的小数范围表示0%-100%。向用户展示这些值时，需转换为百分比（例如：0.15 -> 15%）。
日期格式：上架日期参数使用
yyyyMMdd000000
格式（例如：2024年1月1日对应
20240101000000
）。

Parameter Guide

参数指南

Required

必填参数

ParameterTypeDescription
asinstringReference ASIN to find competing products for (max 1000 chars)
参数类型描述
asinstring用于查找竞品的参考ASIN（最多1000字符）

Marketplace & Pagination

站点与分页参数

ParameterTypeDefaultDescription
countryCodestringUSCountry code: US, JP, DE
pageinteger1Page number (starts from 1)
pageSizeinteger50Results per page (10-100)
sortFieldstringpurchasedClicksT360Field to sort by (see Sorting Options below)
sortTypestringdescSort direction: 
desc
or 
asc
参数类型默认值描述
countryCodestringUS站点代码：US、JP、DE
pageinteger1页码（从1开始）
pageSizeinteger50每页结果数（10-100）
sortFieldstringpurchasedClicksT360排序字段（见下方排序选项）
sortTypestringdesc排序方向：
desc
（降序）或
asc
（升序）

Filter Parameters (all optional, min/max ranges)

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

Price & FBA:
ParameterTypeDescription
priceMin / priceMaxnumberProduct price range
fbaFeeMin / fbaFeeMaxnumberFBA commission range
grossProfitMarginMin / grossProfitMarginMaxnumberGross profit margin range
Reviews & Ratings:
ParameterTypeDescription
totalReviewsMin / totalReviewsMaxintegerTotal review count range
customerRatingMin / customerRatingMaxnumberCustomer rating range (0.0-5.0)
Click Data (7-day):
ParameterTypeDescription
clickCountT7Min / clickCountT7MaxintegerWeekly click count range
clickCountGrowthT7Min / clickCountGrowthT7MaxnumberWeekly click growth rate (0-1)
clickConversionRateMin / clickConversionRateMaxnumberClick conversion rate (0-1)
Click Data (30-day):
ParameterTypeDescription
clickCountT30Min / clickCountT30MaxintegerMonthly click count range
clickCountGrowthT30Min / clickCountGrowthT30MaxnumberMonthly click growth rate (0-1)
Composite Conversion:
ParameterTypeDescription
clickConversionRateCompositeMin / clickConversionRateCompositeMaxnumberComposite click conversion rate (0-1)
Sales & Launch Date:
ParameterTypeDescription
salesVolumeT360Min / salesVolumeT360Maxinteger360-day sales volume range
launchDateMin / launchDateMaxstringLaunch date range (format: yyyyMMdd000000)
Niche & Seller:
ParameterTypeDescription
nicheCountMin / nicheCountMaxintegerNumber of niches the product belongs to
sellerCountrystringSeller country code(s), comma-separated (e.g., "CN,US")
价格与FBA相关:
参数类型描述
priceMin / priceMaxnumber产品价格范围
fbaFeeMin / fbaFeeMaxnumberFBA佣金范围
grossProfitMarginMin / grossProfitMarginMaxnumber毛利率范围
评论与评分:
参数类型描述
totalReviewsMin / totalReviewsMaxinteger总评论数范围
customerRatingMin / customerRatingMaxnumber客户评分范围（0.0-5.0）
点击数据（7天）:
参数类型描述
clickCountT7Min / clickCountT7Maxinteger周点击量范围
clickCountGrowthT7Min / clickCountGrowthT7Maxnumber周点击增长率（0-1）
clickConversionRateMin / clickConversionRateMaxnumber点击转化率（0-1）
点击数据（30天）:
参数类型描述
clickCountT30Min / clickCountT30Maxinteger月点击量范围
clickCountGrowthT30Min / clickCountGrowthT30Maxnumber月点击增长率（0-1）
综合转化率:
参数类型描述
clickConversionRateCompositeMin / clickConversionRateCompositeMaxnumber综合点击转化率（0-1）
销量与上架日期:
参数类型描述
salesVolumeT360Min / salesVolumeT360Maxinteger360天销量范围
launchDateMin / launchDateMaxstring上架日期范围（格式：yyyyMMdd000000）
细分市场与卖家:
参数类型描述
nicheCountMin / nicheCountMaxinteger产品所属细分市场数量范围
sellerCountrystring卖家国家代码，多个用逗号分隔（例如："CN,US"）

Sorting Options

排序选项

ValueMeaning
purchasedClicksT360360-day purchased clicks (default)
totalReviewsTotal reviews
pricePrice
launchDateLaunch date
clickCountT3030-day click count
clickCountT9090-day click count
clickCountT77-day click count
clickConversionRateClick conversion rate
clickConversionRateCompositeComposite click conversion rate
customerRatingCustomer rating
clickCountGrowthT7Weekly click growth rate
clickCountGrowthT30Monthly click growth rate
currentPriceCurrent price
fbaFeeFBA commission
shippingFeeFBA shipping fee
gpmGross profit margin
值含义
purchasedClicksT360360天付费点击量（默认）
totalReviews总评论数
price价格
launchDate上架日期
clickCountT3030天点击量
clickCountT9090天点击量
clickCountT77天点击量
clickConversionRate点击转化率
clickConversionRateComposite综合点击转化率
customerRating客户评分
clickCountGrowthT7周点击增长率
clickCountGrowthT30月点击增长率
currentPrice当前价格
fbaFeeFBA佣金
shippingFeeFBA运费
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 进入上下文。
  • API 端点：
    POST /jiimore/pageAsinsByAsin
    （完整参数/响应/错误码见 
    references/api.md
    ）
  • Python 脚本：
    python scripts/jiimore_page_asins_by_asin.py '<JSON 参数>' [--inline]
  • 成本约束：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带有24小时本地缓存。失败/空结果不得自动更换关键词、翻页或修改邮编连续试探；需要继续检索时，需先向用户说明会产生额外消耗。
输出策略（脚本默认行为）：
  • 始终将完整响应写入 
    <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：落盘后标准输出仅打印摘要（顶层字段、常见计数如
    total
    /
    costToken
    、最大列表字段的长度 + 前3条样本）
  • 添加
    --inline
    参数可强制将全量内容打印到标准输出（同样会落盘）
读数据建议：先查看摘要判断是否足够；需要具体字段时，优先使用
jq
或
ConvertFrom-Json
从保存的JSON文件中按需抽取，避免整份JSON进入上下文。

解决认证和积分问题

解决认证和积分问题

发生以下异常情况时，采用 references/onboarding.md 引导解决问题：
发生以下异常情况时，按照
references/onboarding.md
中的指引解决：

异常情况

异常情况

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

Usage Examples

使用示例

1. Basic competitor lookup by ASIN Find competing products for a reference ASIN in the US market:
json
{
  "asin": "B0GC4RPX79",
  "countryCode": "US",
  "sortField": "purchasedClicksT360",
  "sortType": "desc"
}
2. High-conversion competitors Find competitors with composite conversion rate above 15%:
json
{
  "asin": "B0GC4RPX79",
  "countryCode": "US",
  "clickConversionRateCompositeMin": 0.15,
  "sortField": "clickConversionRateComposite",
  "sortType": "desc"
}
3. New product opportunities Find recently launched competitors (within 3 months) with high click growth:
json
{
  "asin": "B0GC4RPX79",
  "countryCode": "US",
  "launchDateMin": "20240101000000",
  "clickCountGrowthT7Min": 0.1,
  "sortField": "clickCountGrowthT7",
  "sortType": "desc"
}
4. Price-range filtered competitors Find competitors priced between $20 and $50 with good gross margins:
json
{
  "asin": "B0GC4RPX79",
  "countryCode": "US",
  "priceMin": 20,
  "priceMax": 50,
  "grossProfitMarginMin": 0.3,
  "sortField": "gpm",
  "sortType": "desc"
}
5. High-click low-review competitors (potential weak spots) Find competitors with monthly clicks above 2000 but fewer than 100 reviews:
json
{
  "asin": "B0GC4RPX79",
  "countryCode": "US",
  "clickCountT30Min": 2000,
  "totalReviewsMax": 100,
  "sortField": "clickCountT30",
  "sortType": "desc"
}
6. Japanese market competitor analysis Explore competitors in the Japanese market sorted by rating:
json
{
  "asin": "B0GC4RPX79",
  "countryCode": "JP",
  "sortField": "customerRating",
  "sortType": "desc"
}
7. Chinese sellers in the same niche Filter competitors by seller country (China) with high sales volume:
json
{
  "asin": "B0GC4RPX79",
  "countryCode": "US",
  "sellerCountry": "CN",
  "salesVolumeT360Min": 1000,
  "sortField": "purchasedClicksT360",
  "sortType": "desc"
}
1. 基于ASIN的基础竞品查询 查找美国站点中与参考ASIN竞争的产品：
json
{
  "asin": "B0GC4RPX79",
  "countryCode": "US",
  "sortField": "purchasedClicksT360",
  "sortType": "desc"
}
2. 高转化率竞品 查找综合转化率高于15%的竞品：
json
{
  "asin": "B0GC4RPX79",
  "countryCode": "US",
  "clickConversionRateCompositeMin": 0.15,
  "sortField": "clickConversionRateComposite",
  "sortType": "desc"
}
3. 新品商机 查找最近3个月上架且点击量增长较高的竞品：
json
{
  "asin": "B0GC4RPX79",
  "countryCode": "US",
  "launchDateMin": "20240101000000",
  "clickCountGrowthT7Min": 0.1,
  "sortField": "clickCountGrowthT7",
  "sortType": "desc"
}
4. 价格区间筛选的竞品 查找价格在20-50美元之间且毛利率较高的竞品：
json
{
  "asin": "B0GC4RPX79",
  "countryCode": "US",
  "priceMin": 20,
  "priceMax": 50,
  "grossProfitMarginMin": 0.3,
  "sortField": "gpm",
  "sortType": "desc"
}
5. 高点击低评论竞品（潜在薄弱点） 查找月点击量超过2000但评论数少于100的竞品：
json
{
  "asin": "B0GC4RPX79",
  "countryCode": "US",
  "clickCountT30Min": 2000,
  "totalReviewsMax": 100,
  "sortField": "clickCountT30",
  "sortType": "desc"
}
6. 日本站点竞品分析 按评分排序查看日本站点的竞品：
json
{
  "asin": "B0GC4RPX79",
  "countryCode": "JP",
  "sortField": "customerRating",
  "sortType": "desc"
}
7. 同一细分市场的中国卖家竞品 筛选卖家为中国且销量较高的竞品：
json
{
  "asin": "B0GC4RPX79",
  "countryCode": "US",
  "sellerCountry": "CN",
  "salesVolumeT360Min": 1000,
  "sortField": "purchasedClicksT360",
  "sortType": "desc"
}

Display Rules

展示规则

  1. Present data clearly: Show query results in well-structured tables. Convert decimal ratios to percentages for readability (e.g., 0.25 -> 25%).
  2. Highlight key metrics: Always surface the ASIN, product title, price, customer rating, click conversion rate (composite), click counts, total reviews, and gross profit margin as primary columns.
  3. Show niche context: When the 
    niches
    field is present, display the top niche titles and demand scores to give context about which market segments the product competes in.
  4. Trends visualization: When 
    trends
    data is available, summarize the 90-day trend direction (rising/falling/stable) for key metrics like clicks and pricing.
  5. Pagination guidance: When 
    total
    exceeds the current page size, inform the user of the total count and suggest fetching additional pages if needed.
  6. Error handling: When a query fails, explain the reason based on the response message and suggest adjusting filter criteria (e.g., broadening ranges or checking the ASIN).
  7. No subjective advice: Present data objectively without adding unsolicited business recommendations. Only provide interpretation when explicitly requested by the user.
  1. 清晰呈现数据：使用结构清晰的表格展示查询结果。将小数比例转换为百分比以提升可读性（例如：0.25 -> 25%）。
  2. 突出关键指标：始终将ASIN、产品标题、价格、客户评分、综合点击转化率、点击量、总评论数和毛利率作为核心列展示。
  3. 展示细分市场背景：当存在
    niches
    字段时，显示排名靠前的细分市场标题和需求评分，说明产品所处的竞争市场领域。
  4. 趋势可视化：当有
    trends
    数据时，总结点击量、价格等关键指标的90天趋势方向（上升/下降/稳定）。
  5. 分页指引：当
    total
    （总结果数）超过当前页大小时，告知用户总数量，并建议按需获取更多页面。
  6. 错误处理：查询失败时，根据响应消息解释原因，并建议调整筛选条件（例如：扩大范围或检查ASIN）。
  7. 不提供主观建议：客观呈现数据，不主动添加商业建议。仅在用户明确要求时提供解读。

Important Limitations

重要限制

  • Supported marketplaces: Only US, JP, and DE are available. Other marketplace codes will be rejected.
  • ASIN required: Every query must include a reference ASIN. The API will not return results without one.
  • Result cap: Maximum 100 results per page.
  • Percentage values: All rate/share parameters use 0-1 range, not 0-100. Ensure correct values when constructing filters.
  • Date format: Launch date parameters must use 
    yyyyMMdd000000
    format.
  • 支持的站点：仅支持US、JP和DE。其他站点代码会被拒绝。
  • 必须提供ASIN：每次查询都必须包含参考ASIN。无ASIN时API不会返回结果。
  • 结果上限：每页最多返回100条结果。
  • 百分比值：所有比率/份额参数使用0-1范围，而非0-100。构建筛选条件时需确保值正确。
  • 日期格式：上架日期参数必须使用
    yyyyMMdd000000
    格式。

User Expression & Scenario Quick Reference

用户表达与场景速查

Applicable -- Finding competing products based on a reference ASIN:
User SaysScenario
"Find competitors for ASIN B0GC4RPX79"Direct competitor lookup
"What products compete with this ASIN"Same-niche competitor exploration
"Show me similar products in the same niche"Niche competitor discovery
"High-conversion competitors for my product"Conversion-based competitor filtering
"New products competing in my niche"New entrant identification
"Which Chinese sellers compete with this ASIN"Seller-origin based filtering
"Find low-review high-click products like mine"Opportunity gap analysis
"Competitor pricing analysis for ASIN XX"Price-focused competitor analysis
Not applicable -- Needs beyond ASIN-based same-niche competitor discovery:
  • Keyword-level niche market analysis (use Jiimore Niche Info by Keyword instead)
  • Individual ASIN revenue or profit estimation
  • ABA search term data / keyword research
  • Advertising campaign management or bid optimization
  • Product review analysis or listing optimization
  • Supplier sourcing or logistics planning
Boundary judgment: When users say "competitor analysis" or "similar products," if their intent focuses on finding products that compete in the same niche as a specific ASIN, this skill applies. If they want keyword-level market segment data, direct them to Jiimore Niche Info by Keyword. If they need detailed product data for a single ASIN, direct them to Amazon Product Detail.
适用场景 -- 基于参考ASIN查找竞品：
用户表述场景
"查找ASIN B0GC4RPX79的竞品"直接竞品查询
"哪些产品与该ASIN竞争"同一细分市场竞品探索
"展示同一细分市场的类似产品"细分市场竞品发现
"我的产品的高转化率竞品"基于转化率的竞品筛选
"我的细分市场中的新品"新进入者识别
"哪些中国卖家与该ASIN竞争"基于卖家来源的筛选
"查找与我的产品类似的低评论高点击产品"商机缺口分析
"ASIN XX的竞品定价分析"聚焦价格的竞品分析
不适用场景 -- 超出基于ASIN的同一细分市场竞品发现需求：
  • 关键词级细分市场分析（请使用Jiimore Niche Info by Keyword）
  • 单个ASIN的收入或利润估算
  • ABA搜索词数据/关键词研究
  • 广告活动管理或出价优化
  • 产品评论分析或Listing优化
  • 供应商采购或物流规划
边界判断：当用户提到“竞品分析”或“类似产品”时，如果其意图是查找与特定ASIN处于同一细分市场的产品，则适用本技能。如果需要关键词级市场细分数据，请引导至Jiimore Niche Info by Keyword。如果需要单个ASIN的详细产品数据，请引导至Amazon Product Detail。

积分消耗规则

积分消耗规则

消耗 9 积分。
用户会因积分消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对积分消耗量预期不足时，务必提醒用户，由用户决定是否继续。
Feedback:
Auto-detect and report feedback via the Feedback API when any of the following apply:
  1. The functionality or purpose described in this skill does not match actual behavior
  2. The skill's results do not match the user's intent
  3. The user expresses dissatisfaction or praise about this skill
  4. Anything you believe could be improved
Call the feedback API as specified in 
references/api.md
. Do not interrupt the user's flow.
For more high-quality, professional cross-border e-commerce skills, set LinkFox Skills.
消耗9积分。
用户会因积分消耗产生费用。请充分评估：当需要高频调用本技能，或用户对积分消耗量预期不足时，务必提醒用户，由用户决定是否继续。
反馈：
当出现以下任一情况时，通过Feedback API自动检测并提交反馈：
  1. 本技能描述的功能或用途与实际行为不符
  2. 技能结果与用户意图不符
  3. 用户表达了对本技能的不满或赞扬
  4. 任何您认为可以改进的地方
按照
references/api.md
中的说明调用反馈API，请勿中断用户流程。
如需更多高质量、专业的跨境电商技能，请访问LinkFox Skills。