linkfox-amazon-opportunity-search-by-metrics

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Amazon Opportunity Screener by Metrics

基于指标的Amazon商机筛选工具

This skill guides you on how to reverse-search Amazon niches and keywords from a metrics pool aggregated from historical opportunity reports, helping sellers turn vague selection ideas (low competition, growing demand, blue ocean, pain-point opportunity, etc.) into concrete niche candidates.

本技能指导您如何从历史商机报告聚合的指标池中反向搜索Amazon细分赛道（niche）与关键词，帮助卖家将模糊的选品思路（低竞争、需求增长、蓝海、痛点商机等）转化为具体的细分赛道候选。

Core Concepts

核心概念

This tool exposes a queryable pool of niche-level metrics (~37 fields per record) distilled from past Amazon opportunity reports. Instead of generating a fresh report (forward analysis), it lets you reverse-filter the existing pool by 30+ business dimensions and returns matching

(marketplace, keyword)

records ranked by collection time (most recent first).

Records are at the niche / keyword level, not ASIN level. Each record represents a niche snapshot — its market size, growth, competition, price tiers, demographics, top features, and review themes.

Forward vs. reverse: Use

linkfox-amazon-opportunity-report

when the user has a keyword and wants a comprehensive AI report. Use this skill when the user has business criteria (filters) and wants to discover which keywords / niches fit.

本工具提供一个可查询的细分赛道级指标池（每条记录约37个字段），这些指标提炼自过往的Amazon商机报告。与生成新报告（正向分析）不同，它允许您通过30+个商业维度对现有指标池进行反向筛选，并返回匹配的

(marketplace, keyword)

记录，按数据采集时间排序（最新优先）。

记录处于细分赛道/关键词层级，而非ASIN层级。每条记录代表一个细分赛道快照——包含其市场规模、增长情况、竞争态势、价格档位、人群画像、核心功能及评论主题。

正向分析vs反向筛选：当用户已有明确关键词并需要全面AI报告时，使用

linkfox-amazon-opportunity-report

；当用户有商业筛选条件并希望找到符合条件的关键词/细分赛道时，使用本技能。

Filter Dimensions

筛选维度

Filters are grouped into six business dimensions. All filter parameters are optional, but at least one of
keyword
/
nicheName
or any metric filter must be provided — fully empty calls are rejected.

Dimension	Example Parameters	Typical User Intent
Market size & growth	`nicheRevenue360dMinUsdAtLeastGte` , `nichePeakSearchVolumeAtLeastGte` , `nicheSearchVolumeYoyChangePctAtLeastGte` , `nichePeakMonthGte/Lte`	"Big enough market", "fast-growing", "Q4 seasonal"
Competition density	`nicheBrandCountLte` , `nicheBrandCountYoyChangePctAtLeastLte` , `nicheTop5ProductClickSharePctAtLeastLte` , `featureTop5BrandSharePctAtLeastLte`	"Newcomer-friendly", "brands fragmented", "no oligopoly", "brands exiting"
Price & tier	`priceMinUsdGte` , `priceMaxUsdLte` , `priceSweetSpotMinUsdGte/Lte` , `priceEntryClickSharePctAtLeastGte` , `priceMidClickSharePctAtLeastLte` , `priceHighClickSharePctAtLeastGte`	"Affordable focus", "premium-friendly", "mid-tier blue ocean"
Demographics	`demoPrimaryAgeMinGte` , `demoPrimaryAgeMaxLte` , `demoGenderDominant` , `demoPrimaryIncomeTier` , `demoLifeStageTagsContains`	"Female-driven", "high-income", "parents", "fitness enthusiasts"
Product features	`featureNewAvgReviewCountAtLeastLte` , `featureEstablishedAvgReviewCountAtLeastLte` , `featureEmergingTrendTagsContains` , `featureUncommonFeatureTagsContains` , `searchTopCategory1Label`	"New-product entry barrier low", "emerging trend", "uncommon feature edge", "set/kit niches"
Review insights	`reviewPositiveTop1Topic` , `reviewPositiveTop1PctAtLeastGte/Lte` , `reviewNegativeTop1Topic` , `reviewNegativeTop1PctAtLeastGte/Lte` , `reviewNegativeTop2Topic` , `reviewStrategicInsightTagsContains`	"Pain-point niche", "comfort-driven sellers", "size-issue opportunity"

See

references/api.md

for the full parameter list, types, value ranges, and response field map.

筛选条件分为六大商业维度。所有筛选参数均为可选，但必须至少提供
keyword
/
nicheName
或任意一项指标筛选条件——完全空请求会被拒绝。

维度	示例参数	典型用户需求
市场规模与增长	`nicheRevenue360dMinUsdAtLeastGte` , `nichePeakSearchVolumeAtLeastGte` , `nicheSearchVolumeYoyChangePctAtLeastGte` , `nichePeakMonthGte/Lte`	"足够大的市场", "快速增长", "第四季度季节性"
竞争密度	`nicheBrandCountLte` , `nicheBrandCountYoyChangePctAtLeastLte` , `nicheTop5ProductClickSharePctAtLeastLte` , `featureTop5BrandSharePctAtLeastLte`	"新人友好", "品牌分散", "无寡头垄断", "品牌退出"
价格与档位	`priceMinUsdGte` , `priceMaxUsdLte` , `priceSweetSpotMinUsdGte/Lte` , `priceEntryClickSharePctAtLeastGte` , `priceMidClickSharePctAtLeastLte` , `priceHighClickSharePctAtLeastGte`	"主打性价比", "适合高端市场", "中端蓝海"
人群画像	`demoPrimaryAgeMinGte` , `demoPrimaryAgeMaxLte` , `demoGenderDominant` , `demoPrimaryIncomeTier` , `demoLifeStageTagsContains`	"女性主导", "高收入人群", "父母群体", "健身爱好者"
产品功能	`featureNewAvgReviewCountAtLeastLte` , `featureEstablishedAvgReviewCountAtLeastLte` , `featureEmergingTrendTagsContains` , `featureUncommonFeatureTagsContains` , `searchTopCategory1Label`	"新品准入门槛低", "新兴趋势", "差异化功能优势", "套装类赛道"
评论洞察	`reviewPositiveTop1Topic` , `reviewPositiveTop1PctAtLeastGte/Lte` , `reviewNegativeTop1Topic` , `reviewNegativeTop1PctAtLeastGte/Lte` , `reviewNegativeTop2Topic` , `reviewStrategicInsightTagsContains`	"痛点赛道", "主打舒适型卖家", "尺寸问题商机"

完整参数列表、类型、取值范围及响应字段映射请参考

references/api.md

。

Supported Marketplaces

支持的站点

Currently only US (United States) is supported. Always set

amazonDomain

US

(or omit). If a user requests other marketplaces, inform them this tool currently only covers the US market.

目前仅支持**美国（US）**站点。请始终将

amazonDomain

设置为

US

（或省略）。若用户请求其他站点，告知其本工具当前仅覆盖美国市场。

调用方式

API 端点：

POST /amazon/opportunity/searchByMetrics

（完整参数/响应/错误码见

references/api.md

）

Python 脚本：

python scripts/amazon_opportunity_screener.py '<JSON 参数>' [--inline]

成本约束：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。

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

始终将完整响应写入
```
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-amazon-opportunity-search-by-metrics-<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 /amazon/opportunity/searchByMetrics

（完整参数/响应/错误码见

references/api.md

）

Python 脚本：

python scripts/amazon_opportunity_screener.py '<JSON 参数>' [--inline]

成本约束：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本自带24小时本地缓存。失败/空结果不得自动更换关键词、翻页或修改邮编连续试探；需要继续检索时需先向用户说明会产生额外消耗。

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

始终将完整响应写入
```
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-amazon-opportunity-search-by-metrics-<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 引导解决问题：

发生以下异常情况时，采用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/套餐到期/需充值/请充值"，或类似含义的内容。

How to Build Queries

如何构建查询

The user expresses business intent in natural language; you map it to the smallest viable set of filters. Principles:

Convert intent into specific bounds: "low competition" →
```
nicheBrandCountLte: 20
```
; "fast-growing" →
```
nicheSearchVolumeYoyChangePctAtLeastGte: 100
```
(≥100% YoY); "newcomer-friendly" →
```
featureNewAvgReviewCountAtLeastLte: 500
```
.
Start narrow, then loosen: First call usually with 2–4 strong filters and
```
limit=25
```
. If the result set is empty or too small, drop or widen the most aggressive filter rather than adding new ones.
Pair complementary signals: Brand-level + product-level concentration (
```
featureTop5BrandSharePctAtLeastLte
```
+
```
nicheTop5ProductClickSharePctAtLeastGte
```
) reveals "brands fragmented but products concentrated" — a brand-extension entry signal.
Snake_case fragments for tag fields:
```
featureEmergingTrendTagsContains
```
,
```
demoLifeStageTagsContains
```
,
```
reviewNegativeTop1Topic
```
, etc. accept snake_case word fragments and use LIKE matching. Pass a root word (
```
size
```
,
```
parent
```
,
```
cordless
```
) to cover normalized variants.
Faithful to user intent: Don't silently add filters the user didn't ask for. If they only said "growing", just filter on growth — don't also constrain price unless they mentioned it.

用户用自然语言表达商业需求；您需要将其映射为最小可行筛选条件集。原则：

将需求转化为具体阈值："低竞争" →
```
nicheBrandCountLte: 20
```
；"快速增长" →
```
nicheSearchVolumeYoyChangePctAtLeastGte: 100
```
（同比增长≥100%）；"新人友好" →
```
featureNewAvgReviewCountAtLeastLte: 500
```
。
先窄后宽：首次调用通常使用2-4个强筛选条件并设置
```
limit=25
```
。若结果集为空或过少，应放宽最严格的筛选条件，而非添加新条件。
组合互补信号：品牌层级+产品层级集中度筛选（
```
featureTop5BrandSharePctAtLeastLte
```
+
```
nicheTop5ProductClickSharePctAtLeastGte
```
）可发现"品牌分散但产品集中"的情况——这是品牌拓展的入场信号。
标签字段使用蛇形命名片段：
```
featureEmergingTrendTagsContains
```
、
```
demoLifeStageTagsContains
```
、
```
reviewNegativeTop1Topic
```
等参数接受蛇形命名的词汇片段，并使用模糊匹配。传入词根（如
```
size
```
、
```
parent
```
、
```
cordless
```
）即可覆盖标准化变体。
忠实于用户需求：不要静默添加用户未提及的筛选条件。若用户仅说"增长"，只需筛选增长指标——除非用户提到价格，否则不要同时限制价格。

Common Scenarios

常见场景

1. Niche reverse-lookup by keyword

json

{"keyword": "whoop band", "limit": 25}

2. Newcomer-friendly low-competition niches

json

{"nicheBrandCountLte": 20, "featureNewAvgReviewCountAtLeastLte": 500, "limit": 25}

3. High-growth blue ocean (≥100% YoY, brands not yet flooding in)

json

{"nicheSearchVolumeYoyChangePctAtLeastGte": 100, "nicheBrandCountYoyChangePctAtLeastLte": 30, "limit": 25}

4. Mid-tier price gap (low-price dominates, mid-tier scarce)

json

{"priceEntryClickSharePctAtLeastGte": 70, "priceMidClickSharePctAtLeastLte": 5, "limit": 25}

5. Pain-point entry — strong size complaints

json

{"reviewNegativeTop1Topic": "size", "reviewNegativeTop1PctAtLeastGte": 70, "limit": 25}

6. Premium-friendly female-driven niches

json

{"demoGenderDominant": "female", "demoPrimaryIncomeTier": "high", "priceHighClickSharePctAtLeastGte": 25, "limit": 25}

7. Q4 seasonal niches with ≥100k peak search

json

{"nichePeakMonthGte": 11, "nichePeakMonthLte": 12, "nichePeakSearchVolumeAtLeastGte": 100000, "limit": 25}

8. Track niches around a known competitor brand

json

{"featureTopBrandsContains": "WHOOP", "limit": 50}

1. 通过关键词反向查找细分赛道

json

{"keyword": "whoop band", "limit": 25}

2. 新人友好的低竞争细分赛道

json

{"nicheBrandCountLte": 20, "featureNewAvgReviewCountAtLeastLte": 500, "limit": 25}

3. 高增长蓝海（同比≥100%，品牌尚未大量涌入）

json

{"nicheSearchVolumeYoyChangePctAtLeastGte": 100, "nicheBrandCountYoyChangePctAtLeastLte": 30, "limit": 25}

4. 中端价格缺口（低价主导，中端稀缺）

json

{"priceEntryClickSharePctAtLeastGte": 70, "priceMidClickSharePctAtLeastLte": 5, "limit": 25}

5. 痛点切入——强烈的尺寸投诉

json

{"reviewNegativeTop1Topic": "size", "reviewNegativeTop1PctAtLeastGte": 70, "limit": 25}

6. 适合高端市场的女性主导赛道

json

{"demoGenderDominant": "female", "demoPrimaryIncomeTier": "high", "priceHighClickSharePctAtLeastGte": 25, "limit": 25}

7. 第四季度季节性赛道（峰值搜索量≥10万）

json

{"nichePeakMonthGte": 11, "nichePeakMonthLte": 12, "nichePeakSearchVolumeAtLeastGte": 100000, "limit": 25}

8. 追踪竞品品牌相关的所有赛道

json

{"featureTopBrandsContains": "WHOOP", "limit": 50}

Display Rules

展示规则

Present data only: Render the returned niches as a clean comparison table — niche name / keyword, market size, growth, brand count, price range, key tags. No subjective business advice.
Surface the active filters: Echo the filter set you used so the user can adjust ("当前筛选：品牌数 ≤ 20 且搜索量同比 ≥ 100%").
Time-snapshot reminder: Records reflect data at collection time and are not continuously updated. Mention this when results look stale or contradict a user's external knowledge.
Empty / few-result handling: If
```
data
```
is empty or very short, suggest widening the most aggressive filter rather than re-asking the user from scratch.
Error handling: When a query fails, explain the reason based on the
```
msg
```
field (most often the "fully empty parameters" guard) and suggest adding at least one filter.
No secondary aggregation: The results power frontend rendering and are not stored, so they cannot be fed into
```
@智能数据查询
```
(intelligent data query) for further aggregation. If users ask for grouped statistics across niches, do the calculation locally or pull a wider
```
limit
```
first.

仅展示数据：将返回的细分赛道整理为清晰的对比表格——包含赛道名称/关键词、市场规模、增长情况、品牌数量、价格区间、核心标签。不提供主观商业建议。
显示当前筛选条件：回显使用的筛选条件，方便用户调整（例如："当前筛选：品牌数 ≤ 20 且搜索量同比 ≥ 100%"）。
提示数据快照属性：记录反映的是数据采集时的状态，并非实时更新。当结果看起来过时或与用户外部认知矛盾时，需提及这一点。
空结果/少结果处理：若
```
data
```
为空或数量极少，建议放宽最严格的筛选条件，而非从头询问用户。
错误处理：查询失败时，根据
```
msg
```
字段解释原因（最常见的是"完全空参数"拦截），并建议至少添加一项筛选条件。
不支持二次聚合：结果用于前端渲染，不会存储，因此无法导入
```
@智能数据查询
```
进行进一步聚合。若用户要求对赛道进行分组统计，需本地计算或先扩大
```
limit
```
取值。

Important Limitations

重要限制

US only: Currently only supports the United States marketplace (
```
amazonDomain
```
=
```
US
```
).
No pagination: There is no
```
page
```
parameter. Increase
```
limit
```
(max 200) to widen the candidate pool; results are sorted by collection time (newest first).
At least one filter required: Calls with no
```
keyword
```
/
```
nicheName
```
and no metric filter are rejected.
Snapshot data: Records are aggregated from historical opportunity reports; new reports refresh the pool over time, but individual records are not real-time.
Niche-level granularity: The output is niche / keyword level, not ASIN level. To dig into specific products inside a niche, hand off to
```
linkfox-amazon-search
```
,
```
linkfox-keepa-product-search
```
, etc.

仅支持美国站点：目前仅支持美国市场（
```
amazonDomain
```
=
```
US
```
）。
无分页功能：没有
```
page
```
参数。可增大
```
limit
```
（最大200）来扩大候选池；结果按采集时间排序（最新优先）。
至少需要一项筛选条件：未提供
```
keyword
```
/
```
nicheName
```
且无指标筛选条件的请求会被拒绝。
快照数据：记录聚合自历史商机报告；新报告会定期更新指标池，但单条记录并非实时数据。
细分赛道层级粒度：输出为细分赛道/关键词层级，而非ASIN层级。如需深入挖掘赛道内的具体产品，可转用
```
linkfox-amazon-search
```
、
```
linkfox-keepa-product-search
```
等工具。

User Expression & Scenario Quick Reference

用户表达与场景速查

Applicable — Niche-level reverse selection on the US Amazon market:

User Says	Scenario
"Low-competition niches", "newcomer-friendly", "brand-light"	Brand-density filter
"Brands are exiting", "old players retreating"	Negative brand-count YoY
"Fast-growing niche", "trending up", "≥100% YoY"	Search-volume YoY filter
"Mid-tier blue ocean", "low-price dominates but mid is scarce"	Price-tier share gap
"Premium-friendly", "high-income consumers"	Income tier + high-tier share
"Female / male / mixed market"	Gender dominance filter
"Parents / students / retirees / fitness enthusiasts"	Life-stage tag
"Strong size / quality / durability pain point"	Negative review topic + share
"Comfort-driven", "value-driven sellers"	Positive review topic + share
"Track all niches around brand X"	`featureTopBrandsContains`
"Q4 seasonal niches", "Prime Day window"	Peak month + peak volume

Not applicable — Use other tools instead:

Need a comprehensive AI report on one keyword →
```
linkfox-amazon-opportunity-report
```
ASIN-level competitor research, sales estimation → SellerSprite / Keepa / Sorftime tools
Real-time keyword ranking, search-term mining → ABA / SIF tools
Marketplaces other than US → not yet supported by this tool
Want to run group-by aggregation over niches via
```
@智能数据查询
```
→ unsupported (data is not warehoused)

Boundary judgment: When users describe selection criteria in business language and want matching candidate niches, this skill applies. When they hand you a specific keyword and want the full multi-dimensional analysis, use

linkfox-amazon-opportunity-report

. When they want to drill into ASINs / sellers within a niche, hand off to product-search tools.

适用场景 —— 美国Amazon市场的细分赛道反向选品：

用户表述	对应场景
"低竞争赛道"、"新人友好"、"品牌少"	品牌密度筛选
"品牌退出"、"老玩家撤退"	品牌数量同比负增长
"快速增长赛道"、"趋势上升"、"同比≥100%"	搜索量同比筛选
"中端蓝海"、"低价主导但中端稀缺"	价格档位份额缺口
"适合高端市场"、"高收入消费者"	收入层级+高端档位份额
"女性/男性/混合市场"	性别主导筛选
"父母/学生/退休人员/健身爱好者"	人生阶段标签
"强烈的尺寸/质量/耐用性痛点"	负面评论主题+占比
"主打舒适"、"性价比导向卖家"	正面评论主题+占比
"追踪品牌X相关的所有赛道"	`featureTopBrandsContains`
"第四季度季节性赛道"、"Prime Day窗口期"	峰值月份+峰值搜索量

不适用场景 —— 使用其他工具：

需要针对单个关键词的全面AI报告 →
```
linkfox-amazon-opportunity-report
```
ASIN层级竞品调研、销量预估 → SellerSprite / Keepa / Sorftime工具
实时关键词排名、搜索词挖掘 → ABA / SIF工具
美国以外的站点 → 本工具暂不支持
希望通过
```
@智能数据查询
```
对赛道进行分组聚合 → 不支持（数据未入库）

边界判断：当用户用商业语言描述选品条件并希望找到匹配的候选赛道时，适用本技能；当用户提供具体关键词并需要多维度全面分析时，使用

linkfox-amazon-opportunity-report

；当用户希望深入挖掘赛道内的ASIN/卖家时，转用产品搜索工具。

积分消耗规则

按动态规则计费：消耗积分 = 1.5 × (N ≤ 25 ? 5 : 5 + ceil((N - 25) / 5))。N 是接口实际返回的数据条数；即使 N = 0，只要接口成功也按 15000 计费。

重要：本技能的服务按倍数动态计算，可能一次性消耗大量积分，必须提醒用户，由用户决定是否继续。

Feedback:

Auto-detect and report feedback via the Feedback API when any of the following apply:

The functionality or purpose described in this skill does not match actual behavior
The skill's results do not match the user's intent
The user expresses dissatisfaction or praise about this skill
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, visit LinkFox Skills.

按动态规则计费：消耗积分 = 1.5 × (N ≤ 25 ? 5 : 5 + ceil((N - 25) / 5))。N是接口实际返回的数据条数；即使N=0，只要接口调用成功也按15000积分计费。

重要：本技能的服务按倍数动态计算，可能一次性消耗大量积分，必须提醒用户，由用户决定是否继续。

反馈:

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

本技能描述的功能或用途与实际行为不符
技能结果与用户需求不匹配
用户表达对本技能的不满或赞赏
任何您认为可以改进的地方

请按照

references/api.md

中的说明调用反馈API，不要中断用户流程。

更多高质量专业跨境电商技能，请访问 LinkFox Skills.