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

linkfox-sif-asin-keywords

营销与增长

查看项目

更新于 10-15 09:06

技能介绍

用途

本技能用于查询和分析特定亚马逊 ASIN 的流量关键词，帮助卖家了解哪些关键词为某个商品带来流量，以及该商品在每个关键词下的排名情况。这是反查 ASIN 关键词的常用工具。

主要能力

针对每个关键词，可获取以下数据：

  • 关键词及其本地化翻译
  • 自然排名（productNaturalRank）与广告排名（productAdRank）
  • 周搜索量（weeklySearchVolume）与关键词热度排名（keywordPopularityRank）
  • 该关键词下的搜索结果商品总数
  • 流量占比（trafficShare）、自然流量占比（naturalTrafficShare）、付费流量占比（paidTrafficShare）
  • 自然流量得分、SP 广告得分、品牌广告（SB）得分、视频广告（SBV）得分、SP 推荐位得分及其明细
  • ABA TOP3 点击集中度（clickConcentrationShare，注意这不是转化率）
  • 关键词级点击转化率（clickToPurchaseConversionRate）
  • 展示位置类型（natural、ac、sp、top、bottom、er、vedio、tr、trfob）
  • 流量特征标记（isMainKw、isAccurateKw、isAccurateAboveKw、isAccurateTailKw）
  • 转化表现标记（isPurchaseKw、isQualityKw、isStableKw、isLossKw、isInvalidKw）
  • 最近自然排名时间、最近广告排名时间、周期结束日期、更新时间

顶层响应字段还包括：是否为父 ASIN、是否有变体、最新 ABA 周参考日期。

使用方式

调用方式有两种：

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

必填参数：

  • asin（字符串，必填）：要查询的亚马逊 ASIN，每次仅支持一个。

可选参数：

  • country（字符串，默认 US）：站点代码，支持 US、UK、DE、CA、JP、FR、ES、IT、MX、AU、AE、BR、SA 共 13 个站点。
  • keyword（字符串）：按包含该文本的关键词过滤结果，建议使用目标站点语言。
  • timePieceType（字符串，默认 latelyDay）：时间窗类型，可选 latelyDay（最近 N 天）、month（指定月份）、week（指定周）。
  • timePieceValue（字符串，默认 7）：与 timePieceType 配对的值。latelyDay 仅支持 7 或 30；month 格式为 YYYY-MM；week 为该周起始日期 YYYY-MM-DD。
  • conditions（字符串）：逗号分隔的条件过滤，包括标记类过滤（如 nfPosition、isSpAd、isBrandAd、isVedioAd、isAC、isAccurateKw、isAccurateTailKw、isPurchaseKw、isQualityKw、isStableKw、isLossKw、isInvalidKw、isMultiVariantKw、isSearchVolUpKw、isSearchVolDownKw）和周期计数类过滤（如 totalPeriod.in、nfKeywordCnt.total/in、adKeywordCnt.total/in、allSpKeywordCnt.total/in、spKeywordCnt.total/in、recSpKeywordCnt.total/in、allSbKeywordCnt.total/in、sbKeywordCnt.total/in、sbvKeywordCnt.total/in）。
  • sortBy（字符串）：排序字段，可选 lastRank（自然排名）、adLastRank（广告排名）、updateTime（更新时间）、searchesRank（搜索热度排名）、estSearchesNum（月搜索量）。
  • desc（布尔，默认 true）：是否降序，设为 false 为升序。
  • pageNum（整数，默认 1）：页码。
  • pageSize（整数，默认 100，范围 10-100）：每页结果数。

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

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

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

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

适用场景

  • 反查某个 ASIN 的自然流量关键词
  • 查看某商品的自然排名与广告排名
  • 分析某商品在哪些关键词上投放广告
  • 挖掘高转化关键词、精准长尾关键词
  • 识别主要流量来源关键词
  • 诊断转化流失关键词
  • 发现带 Amazon's Choice 标记的关键词
  • 查询某月新增的 SP 流量关键词
  • 筛选搜索量同比上涨的关键词
  • 查看关键词的 ABA TOP3 点击集中度与点击转化率

限制

  • 每次请求仅支持单个 ASIN；如需对比多个 ASIN，需分别查询。
  • 每页最多 100 条结果。
  • timePieceType=latelyDay 仅支持 7 或 30，不支持任意 N 天窗口。
  • 站点仅覆盖 13 个市场，IN、NL、SE、PL、TR、SG 已不再提供。
  • keyword 过滤建议使用目标站点语言。
  • 排名数值越小表示位置越靠前；排名提升意味着数值减小，排名下降意味着数值增大。
  • clickConcentrationShare 衡量点击在头部 ASIN 的集中程度，不是转化率，需与 clickToPurchaseConversionRate 区分。
  • 展示流量占比类字段时应乘以 100 以百分比显示。
  • 本技能不适用于：不绑定特定 ASIN 的广泛关键词研究、商品评论与 listing 文案、销量与营收分析、广告活动管理（竞价、预算）、无特定 ASIN 的类目级关键词趋势。

算力消耗

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