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

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 的核心流量词

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

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

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

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

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

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

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

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

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

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

{
  "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 反查和拓展关键词：

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.