linkfox-amazon-opportunity-search-by-metrics — Claude Code skill
linkfox-amazon-opportunity-search-by-metrics is a Claude Code skill that screens Amazon US niches by business metrics, including growth, competition, pricing, and buyer demographics.
MIT 243 installs ★ 125 updated 2026-11-11
npx skills add linkfox-ai/linkfox-skills --skill linkfox-amazon-opportunity-search-by-metrics -a claude-codeWhat linkfox-amazon-opportunity-search-by-metrics does
Compatible with Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. It performs reverse screening across LinkFox's historical snapshot database. Instead of researching a known search term, you supply market requirements, and the skill returns matching keywords. Tracked attributes span around 37 data points, including annual search volume growth, brand count changes, price bracket shares, and top complaint topics.
Execution runs through direct API calls or the helper script python scripts/amazon_opportunity_screener.py '<JSON>'. Responses are saved locally under linkfox/<YYYY-MM-DD>/<session>/data/ and cached for 24 hours to prevent repeated credit charges for identical parameters.
Coverage is restricted strictly to Amazon US and uses historical report snapshots. It cannot evaluate specific ASINs or track live keyword ranks. Calls fail without a valid LINKFOX_AGENT_API_KEY or LINKFOXAGENT_API_KEY, and every API request consumes billable platform credits.
What it helps with
- identify high-growth Amazon US niches with low brand saturation
- locate product categories where reviews frequently cite sizing or quality issues
- filter marketplace segments dominated by high-income consumer groups
- uncover Q4 seasonal opportunities with search volume spikes above 100000
Example prompts for the agent
- Find low-competition Amazon US niches where brand count is 20 or fewer and search growth exceeds 100 percent
- Screen for categories where entry-level price share is over 70 percent and mid-tier share is under 5 percent
- List niches where negative reviews focus heavily on size with peak search volume in November and December
How to install linkfox-amazon-opportunity-search-by-metrics
1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-amazon-opportunity-search-by-metrics -a claude-code2Manually: put the files in place
~/.claude/skills/linkfox-amazon-opportunity-search-by-metrics/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/linkfox-amazon-opportunity-search-by-metrics/
1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-amazon-opportunity-search-by-metrics -a codex2Manually: put the files in place
.agents/skills/linkfox-amazon-opportunity-search-by-metrics/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-amazon-opportunity-search-by-metrics -a cursor2Manually: put the files in place
.cursor/skills/linkfox-amazon-opportunity-search-by-metrics/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install linkfox-ai/linkfox-skills skills/linkfox-amazon-opportunity-search-by-metrics2Manually: put the files in place
.github/skills/linkfox-amazon-opportunity-search-by-metrics/SKILL.md1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-amazon-opportunity-search-by-metrics -a gemini-cli2Platform CLI
gemini skills install https://github.com/linkfox-ai/linkfox-skills --path skills/linkfox-amazon-opportunity-search-by-metricsManually: put the files in place
.devin/skills/linkfox-amazon-opportunity-search-by-metrics/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-amazon-opportunity-search-by-metrics -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about linkfox-amazon-opportunity-search-by-metrics
How to install linkfox-amazon-opportunity-search-by-metrics in Claude Code?
Run npx skills add linkfox-ai/linkfox-skills --skill linkfox-amazon-opportunity-search-by-metrics -a claude-code.
What does linkfox-amazon-opportunity-search-by-metrics do?
It translates business criteria into keyword candidates using historical metrics from Amazon US market insight reports.
Does this tool support live ASIN tracking or non-US markets?
No. The dataset is limited to historical snapshots of the United States marketplace and operates strictly at the niche keyword level.
Source text
SKILL.md · MIT
---
name: linkfox-amazon-opportunity-search-by-metrics
description: 基于历史商业洞察报告的指标数据池,按市场规模与增长、竞争密度与集中度、价格档位、人群画像、产品特征和评论卖点或痛点,反向筛选美国亚马逊赛道与关键词。适用于低竞争、新人友好、品牌分散、定价机会、季节性和人群画像选品;用户用业务条件描述希望寻找的赛道时即可使用。不适用于单关键词完整商业洞察报告、ASIN 级商品或销量研究、实时排名与搜索词挖掘,以及美国以外的市场。
---
# 亚马逊商业指标反向选品
## 适用范围
### 适用
将用户的业务筛选条件转成赛道候选,从历史报告沉淀的指标池中发现符合条件的关键词。
**场景速查**
| 用户表达 | 查询场景 |
|----------|----------|
| 找低竞争、新人友好、品牌少的赛道 | 品牌密度与新品评论门槛。 |
| 品牌正在退出、老玩家撤退的市场 | 品牌数同比下降。 |
| 找快速增长、同比翻倍的蓝海赛道 | 搜索需求增长与品牌涌入速度。 |
| 低价占主导但中档稀缺,或找高端机会 | 价格档位份额与定价区间。 |
| 面向女性、男性、高收入消费者的市场 | 性别主导与收入画像。 |
| 面向家长、学生、退休人群、健身人群 | 生命阶段标签。 |
| 尺寸、质量、耐用性投诉强烈的赛道 | 差评主题与占比。 |
| 买家重舒适或性价比的赛道 | 好评主题与占比。 |
| 跟踪某品牌覆盖的赛道 | 头部品牌匹配。 |
| 找第四季度旺季或 Prime Day 窗口机会 | 峰值月份与峰值搜索量。 |
### 边界
已有一个关键词并希望生成完整的多维 AI 报告时,使用 `linkfox-amazon-opportunity-report`。
需要赛道内的具体 ASIN、卖家、竞品或销量估算时,转交 `linkfox-amazon-search`、`linkfox-keepa-product-search` 或相应 SellerSprite / Sorftime 商品工具;实时关键词排名和搜索词挖掘转交 ABA / SIF 工具。
## 前置条件
**先明确用户的筛选意图**:提取市场、增长、竞争、价格、人群、产品特征或评论主题要求;参数取值及接口适用限制见 `references/api.md`。
## 查询流程
1. 判断需求是否为“按业务条件发现赛道”,记录用户明确提出的条件,不静默增加无关筛选;用户只要求增长时,不额外限定价格。
2. 将业务意图映射为最小可用筛选集,映射示例、初筛返回数量和标签匹配约定见 `references/api.md`。较复杂的需求先选择 2–4 个核心条件,优先组合互补信号。
3. 展示本次筛选条件,按下方算力规则提醒消耗后执行一次检索。优先复用相同参数已取得的结果,按接口参考判断响应。
4. 用对照表呈现候选。结果为空或过少时,建议删除或放宽最严格的条件,而非增加条件或重新让用户描述全部需求;继续检索前说明额外消耗,不自动连续试探。
5. 用户需要跨赛道分组统计时,优先对已保存的数据在本地计算;确需扩大候选范围时,按成本约束调整检索范围。需要完整赛道报告或 ASIN 研究时,按适用边界转交。
## 执行方式
- **直接调用接口**:接口端点、完整参数、响应和错误码见 `references/api.md`。
- **脚本调用(推荐)**:`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>` 为脚本运行时的工作目录,`<session>` 优先取环境变量 `SESSION_ID`,用于聚合同一任务的数据。禁止写入 `/tmp`,当前目录不可写时应报错。
- 响应体不超过 8 KB:保存后,将完整 JSON 打印到标准输出。
- 响应体超过 8 KB:保存后,标准输出仅展示摘要,包括顶层字段、常见计数(如 `total`、`costToken`)、最大列表字段的长度和前 3 条样本。
- 添加 `--inline` 可强制全量打印到标准输出,同时仍保存文件。
先通过摘要判断数据是否足够。需要具体字段时,优先使用 `jq` 或 `ConvertFrom-Json` 从保存的 JSON 文件按需提取,避免将整份响应载入上下文。
## 执行规则
### 算力消耗预估
按动态规则计费:消耗算力 = 1.5 × (N ≤ 25 ? 5 : 5 + ceil((N - 25) / 5))。N 是接口实际返回的数据条数,ceil 表示向上取整。接口成功且 N ≤ 25 时(包括 N = 0 的空结果),消耗 7.5 算力,对应 15000 token;超过 25 条后,每增加 5 条(不足 5 条按 5 条计)增加 1.5 算力。
本服务按倍数动态计算,可能一次性消耗大量算力;必须提醒用户,并由用户决定是否继续。
**声明**:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。
用户会因算力消耗而支付费用。需要高频调用或用户对消耗量预期不足时,提醒用户,并由用户决定是否继续。
### 解决认证和算力问题
出现以下情况时,按 `references/onboarding.md` 的指引处理:
- 未配置接口密钥:`LINKFOX_AGENT_API_KEY` 和 `LINKFOXAGENT_API_KEY` 均为空。
- 响应状态码为 `401` 或 `402`。
- 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。
### 约束与建议
- **理解数据粒度**:每条记录是一个 `(marketplace, keyword)` 赛道快照,包含约 37 项市场、竞争、价格、人群、产品特征和评论指标,不是单个 ASIN。
- **区分正向与反向分析**:本技能用业务条件发现关键词;完整报告技能用已有关键词生成分析。数据池随新报告逐步更新,不代表持续更新的实时市场。
- **理解互补信号**:同时观察品牌集中度与产品集中度,可识别“品牌分散但产品集中”的情况,作为品牌延伸研究的信号。
- **只展示数据**:用表格展示赛道名称 / 关键词、市场规模、增长、品牌数、价格区间与关键标签,不附加主观商业建议;缺失字段如实标明。
- **回显筛选条件**:例如“当前筛选:品牌数 ≤ 20 且搜索量同比 ≥ 100%”,方便用户调整。
- **注明快照性质**:记录反映采集时的情况;结果陈旧或与用户外部信息冲突时,明确说明时间快照,不将它当成实时数据。
- **处理空结果与错误**:空结果先建议放宽最严格条件;失败时依据 `msg` 或 `errmsg` 说明原因,参数全空时建议补充条件。接口业务判断和错误码见 `references/api.md`。
- **区分本地文件与数据仓库**:服务返回用于前端展示,未存入智能查询数据仓库,不能交给 `@智能数据查询` 做二次聚合;脚本保存的 JSON 可在本地计算。
## 使用示例
### 按关键词反查赛道
```json
{"keyword": "whoop band", "limit": 25}
```
### 新人友好、低竞争赛道
```json
{"nicheBrandCountLte": 20, "featureNewAvgReviewCountAtLeastLte": 500, "limit": 25}
```
### 高增长且品牌尚未大量涌入
```json
{"nicheSearchVolumeYoyChangePctAtLeastGte": 100, "nicheBrandCountYoyChangePctAtLeastLte": 30, "limit": 25}
```
### 低价占主导、中档稀缺
```json
{"priceEntryClickSharePctAtLeastGte": 70, "priceMidClickSharePctAtLeastLte": 5, "limit": 25}
```
### 尺寸投诉强烈的痛点赛道
```json
{"reviewNegativeTop1Topic": "size", "reviewNegativeTop1PctAtLeastGte": 70, "limit": 25}
```
### 高收入女性主导且高端份额较高
```json
{"demoGenderDominant": "female", "demoPrimaryIncomeTier": "high", "priceHighClickSharePctAtLeastGte": 25, "limit": 25}
```
### 第四季度末旺季且峰值月搜索量较高
```json
{"nichePeakMonthGte": 11, "nichePeakMonthLte": 12, "nichePeakSearchVolumeAtLeastGte": 100000, "limit": 25}
```
### 跟踪指定品牌覆盖的赛道
```json
{"featureTopBrandsContains": "WHOOP", "limit": 50}
```
## 使用反馈
当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 `references/api.md#Feedback` 的指引反馈,不要打断用户当前流程。
---
更多优质、专业的跨境电商技能,请访问 [LinkFox Skill](https://skill.linkfox.com/)。
© linkfox-ai · MIT · linkfox-ai/linkfox-skills