Jungle Scout — 根据 ASIN 反查关键词#

This skill queries keywords associated with given ASINs via the Jungle Scout data source, returning keyword search volume, competition metrics, PPC bids, ranking positions, and relevancy scores across 10 Amazon marketplaces. It supports up to 10 ASINs per call.

Core Concepts#

Jungle Scout ASIN 反查关键词工具通过输入竞品或目标 ASIN，获取这些 ASIN 在亚马逊搜索结果中出现的所有关键词及详细指标。卖家可以利用此工具进行：

• 竞品关键词分析：查看竞品在哪些关键词下获得自然/广告排名
• 关键词拓展：从已知 ASIN 反向挖掘高潜力关键词
• 广告投放参考：获取关键词的 PPC 出价（精确/广泛匹配）和 SP 品牌广告出价
• 竞争格局评估：通过 Ease of Ranking Score 和竞品排名数据判断关键词竞争难度
• 流量结构解析：了解 ASIN 的流量来自哪些关键词，各关键词的搜索量和排名如何

数据维度：每条记录代表一个关键词，包含搜索量、趋势、排名、竞价、竞争度等完整指标。

Data Fields#

Output Fields#

FieldAPI NameDescriptionExample关键词name搜索关键词yoga mat站点country市场代码us精确搜索量monthlySearchVolumeExact月精确匹配搜索量85420广泛搜索量monthlySearchVolumeBroad月广泛匹配搜索量125000月趋势monthlyTrend月环比趋势（%）15.5季度趋势quarterlyTrend季度趋势（%）8.2主类目dominantCategory关键词主要类目Sports & Outdoors相关度relevancyScore关键词与 ASIN 的相关度（0-100）92排名难度easeOfRankingScore排名容易程度（0-100，越高越容易）45自然排名organicRankASIN 的自然搜索排名5广告排名sponsoredRankASIN 的广告排名3综合排名overallRank综合排名位置4自然结果数organicProductCount自然搜索结果中的商品总数2000广告结果数sponsoredProductCount广告位商品总数48PPC精确出价ppcBidExact精确匹配 PPC 建议出价（USD）1.25PPC广泛出价ppcBidBroad广泛匹配 PPC 建议出价（USD）0.95SP品牌广告出价spBrandAdBidSP 品牌广告建议出价（USD）2.10推荐促销数recommendedPromotions推荐促销量5主力ASINprimaryAsin该关键词下排名最高的 ASINB0XXXXXXXX自然相对位置relativeOrganicPosition查询 ASIN 的自然排名相对位置0.12广告相对位置relativeSponsoredPosition查询 ASIN 的广告排名相对位置0.08自然排名ASIN数organicRankingAsinsCount有自然排名的查询 ASIN 数量3广告排名ASIN数sponsoredRankingAsinsCount有广告排名的查询 ASIN 数量2竞品平均自然排名avgCompetitorOrganicRank查询 ASIN 的平均自然排名12.5竞品平均广告排名avgCompetitorSponsoredRank查询 ASIN 的平均广告排名8.3变体最低自然排名variationLowestOrganicRank变体中最佳自然排名3变体最低广告排名variationLowestSponsoredRank变体中最佳广告排名2竞品自然排名详情competitorOrganicRank各 ASIN 的自然排名数组[{asin, organicRank}]竞品广告排名详情competitorSponsoredRank各 ASIN 的广告排名数组[{asin, sponsoredRank}]更新时间updatedAt数据最后更新时间2026-04-10消耗TokencostToken本次调用消耗的 token 数10

Supported Marketplaces#

us (United States), uk (United Kingdom), de (Germany), in (India), ca (Canada), fr (France), it (Italy), es (Spain), mx (Mexico), jp (Japan)

Default marketplace is us. Use us when the user doesn't specify a marketplace.

调用方式#

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

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

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

How to Build Queries#

Required parameters: marketplace and asins. All other parameters are optional filters for narrowing results.

Principles for Building API Calls#

1. 站点映射：用户说"美国站"→ us，"日本站"→ jp，"德国站"→ de；未指定时默认 us
2. ASIN 格式：标准 10 位亚马逊 ASIN（以 B0 开头），以数组传入，最多 10 个
3. 搜索量筛选：用户说"搜索量大于1万"→ minMonthlySearchVolumeExact: 10000；"搜索量1000到5000"→ min: 1000, max: 5000
4. 排序选择：默认按精确搜索量降序（ -monthly_search_volume_exact）；用户要求"按相关度排序"→ sort: -relevancy_score
5. 结果数量：用户说"给我前50个"→ needCount: 50；未指定时可根据场景适当设置（如 30-100）
6. 变体包含：用户关注变体流量时设 includeVariants: true

Common Query Scenarios#

1. 查看竞品 ASIN 的核心流量词

json

{
  "marketplace": "us",
  "asins": ["B0XXXXXXXX"],
  "needCount": 50,
  "sort": "-monthly_search_volume_exact"
}

2. 多个 ASIN 的共同关键词（竞品对比）

json

{
  "marketplace": "us",
  "asins": ["B0XXXXXXXX", "B0YYYYYYYY", "B0ZZZZZZZZ"],
  "needCount": 100,
  "sort": "-relevancy_score"
}

3. 筛选高搜索量低竞争关键词

json

{
  "marketplace": "us",
  "asins": ["B0XXXXXXXX"],
  "minMonthlySearchVolumeExact": 5000,
  "maxOrganicProductCount": 500,
  "needCount": 50,
  "sort": "-ease_of_ranking_score"
}

4. 查找长尾关键词（多词组合）

json

{
  "marketplace": "us",
  "asins": ["B0XXXXXXXX"],
  "minWordCount": 3,
  "minMonthlySearchVolumeExact": 500,
  "needCount": 80,
  "sort": "-monthly_search_volume_exact"
}

5. 日本站竞品广告关键词分析

json

{
  "marketplace": "jp",
  "asins": ["B0XXXXXXXX"],
  "needCount": 50,
  "sort": "-ppc_bid_exact"
}

6. 包含变体的全量关键词挖掘

json

{
  "marketplace": "de",
  "asins": ["B0XXXXXXXX"],
  "includeVariants": true,
  "needCount": 200,
  "sort": "-monthly_search_volume_exact"
}

Display Rules#

1. 表格展示为主：以表格形式展示关键词列表，核心列包括：关键词、精确搜索量、自然排名、广告排名、相关度、PPC 出价
2. 按需精简列：根据用户意图选择展示列。竞品分析侧重排名和搜索量；广告分析侧重 PPC 出价和广告排名
3. 排名高亮：对自然排名前 10 和广告排名前 5 的关键词做标注，帮助用户快速识别核心流量词
4. 趋势标注：月/季度趋势为正时标注增长，为负时标注下降
5. 竞品对比：当输入多个 ASIN 时，展示各 ASIN 在关键词下的排名对比
6. Error handling: When a query fails, explain the reason based on the error response and suggest adjusting parameters

Important Limitations#

• ASIN 数量上限：单次查询最多 10 个 ASIN
• 数据时效性：数据定期更新， updatedAt 字段标注最后更新时间
• 搜索量类型：同时提供精确匹配和广泛匹配两种搜索量
• 必填参数： marketplace 和 asins 缺一不可
• 排名数据：排名为该 ASIN 在对应关键词搜索结果中的位置，非实时数据

User Expression & Scenario Quick Reference#

Applicable - 通过 ASIN 反查和拓展关键词：

User SaysScenario"这个ASIN有哪些流量词"单个 ASIN 关键词反查"竞品用了哪些关键词"竞品关键词分析"帮我对比这几个ASIN的关键词"多 ASIN 关键词对比"这个产品搜什么词能搜到"ASIN 反向搜索词查询"找一些搜索量大竞争小的词"高搜索量低竞争关键词筛选"这个ASIN的广告词有哪些"ASIN 广告关键词分析"帮我拓展一下关键词"基于 ASIN 的关键词拓展

Not applicable - 超出 ASIN 反查关键词范围：

• 关键词搜索量历史趋势（需要关键词历史搜索量工具）
• ABA 搜索词排名（需要 ABA 工具）
• 商品销量估算、listing 优化建议
• 关键词广告投放执行（仅提供竞价参考数据）
• 非亚马逊平台的关键词数据

Boundary judgment: When users say "关键词", "流量词", or "搜索词", if they provide specific ASINs and want to know what keywords those ASINs rank for, this skill applies. If they want to search keywords by text or check historical search volume trends, other skills are more suitable.

算力消耗规则#

按动态规则计费：消耗算力 = 实际查询页数 × 63.75。

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

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, visit LinkFox Skills.