SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场linkfox-sif-keyword-overview

linkfox-sif-keyword-overview

营销与增长

查看项目

更新于 10-15 09:21

技能介绍

用途

本技能用于查询和分析亚马逊平台上关键词级别的竞争数据，帮助卖家评估特定关键词的市场竞争力与供需动态。适用于关键词竞争度检查、搜索结果商品数量查询、供需比分析、广告竞争评估、蓝海关键词判断、搜索热度估算、关键词热度排名、多市场对比等场景。

主要能力

该工具返回给定关键词在亚马逊上的竞争指标快照，包括：

  • 不同展示位置的竞品数量：自然搜索商品数、赞助商品广告（SP）数、品牌广告商品数、视频广告商品数、付费广告商品总数、Amazon's Choice 商品数、Top Rated 商品数、搜索推荐商品数、编辑推荐商品数、推荐位非广告商品数、推荐位广告商品数等。
  • 预估周搜索量（estimatedWeeklySearchVolume）。
  • 关键词热度排名（keywordPopularityRank）：该词在市场所有关键词中按月搜索量的排名，数值越小表示搜索热度越高（排名1为最热门）。用户说“排名提升”指数值减小，“排名下降”指数值增大。
  • 供需比（supplyDemandRatio）：搜索结果商品总数 / 月搜索量。数值越低表示竞争越小、机会越大，是识别蓝海关键词的关键指标。
  • 总搜索结果商品数（totalSearchResultProductCount）：该关键词下展示的全部商品（自然+广告+推荐）。
  • SIF 追踪曝光 ASIN 去重数（trackedAsinTotalCount）。
  • 市场关键词总数（totalMarketplaceKeywordCount）。
  • 数据周期起止日期（dataPeriodStartDate / dataPeriodEndDate，ABA 周）与数据更新时间（keywordDataUpdateTime）。

使用方式

调用方式有两种：

  1. API 端点：POST /sif/keywordOverview（完整参数、响应与错误码见 references/api.md）。
  2. Python 脚本：python scripts/sif_keyword_overview.py '<JSON 参数>' [--inline]

参数说明：

  • keyword（必填）：要分析的关键词，建议使用目标市场的本地语言，最大长度1000字符。
  • country（可选）：亚马逊市场代码，默认 US。支持 US、UK、DE、CA、JP、FR、ES、IT、MX、AU、AE、BR、SA 共13个市场。
  • last7d（可选，布尔，默认 true）：使用最近7天。设为 false 时使用 startDate/endDate。
  • startDate（可选，yyyy-MM-dd）：自定义窗口开始日期，last7d=false 时生效。
  • endDate（可选，yyyy-MM-dd）：与 startDate 配对的结束日期。

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

  • 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-sif-keyword-overview-<timestamp>.json（<cwd> 为脚本执行时的工作目录；<session> 取自环境变量 SESSION_ID；禁止写入 /tmp，当前目录不可写则报错）。
  • 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout。
  • 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 total/costToken、最大列表字段的长度 + 前 3 条样本）。
  • 加 --inline 强制全量打印到 stdout（同样落盘）。
  • 读数据建议：先看摘要判断是否足够；需要具体字段时优先用 jq 或 ConvertFrom-Json 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。

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

认证与算力问题：未配置 API Key（环境变量 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY）、响应401或402状态码、或提示算力/余额不足时，采用 references/onboarding.md 引导解决。

适用场景

  • 关键词竞争强度检查（“XX关键词竞争度如何”）。
  • 搜索结果商品数量查询（“XX有多少商品”）。
  • 供需比分析（“XX的供需比是多少”）。
  • 广告竞争评估（“XX有多少卖家在投广告”）。
  • 蓝海关键词判断（“XX关键词是不是蓝海”）。
  • 搜索热度估算（“XX关键词的搜索量”）。
  • 关键词热度排名（“XX关键词在亚马逊有多热门”）。
  • 多市场对比（“比较不同市场的竞争度”）。
  • SIF 追踪 ASIN 数量查询（“该关键词下有多少 SIF 追踪的 ASIN”）。
  • 指定周竞争度查询（通过 startDate/endDate 自定义日期范围）。

限制

  • 每次请求仅查询一个关键词；多关键词对比需分别调用。
  • API 通常每个关键词返回一条数据记录（total 通常为1）。
  • 市场覆盖：13个亚马逊市场；IN / NL / SE / PL / TR / SG 已不再支持。查询市场中未找到的关键词将返回空结果。
  • 时间窗口：默认最近7天；自定义 ABA 周范围需传 last7d=false 加 startDate/endDate。
  • 关键词语言：为获得最佳准确性，关键词应使用目标市场的本地语言。
  • 不适用于：关键词历史排名趋势（应使用 ABA Data Explorer）、按 ASIN 的点击份额与转化份额（应使用 ABA Data Explorer）、广告竞价策略与 PPC 优化、商品评论与 listing 优化、ASIN 级别销量估算、周/月维度的详细关键词搜索趋势分析。

算力消耗

消耗9算力。用户会因算力消耗而支付费用。当需要高频调用本技能，或用户对算力消耗量预期不足时，务必提醒用户，由用户决定是否继续。