linkfox-sif-asin-keywords

使用 SIF 数据反查亚马逊 ASIN 的流量关键词,查看自然与广告排名、搜索量、流量占比、曝光得分、ABA TOP3 点击集中度和点击到购买转化率,支持按周、月或最近时间窗分析及多商品对比。适用于竞品关键词反查、主要流量来源、广告词、精准长尾词、出单词、新进词及搜索量同比变化研究,无需明确提及 SIF。不适用于脱离 ASIN 的泛关键词研究、类目趋势、评论、Listing 文案、销量营收估算或广

SKILL.md

GitHub

SIF ASIN 流量关键词分析

适用范围

适用

围绕指定亚马逊商品反查带来流量的关键词,查看商品在各词下的自然与 SP 广告排名、搜索需求、流量结构和转化表现。用户希望对比多个商品时,分别查询并合并展示。

场景速查

用户表达 查询场景
这个 ASIN 靠哪些词获取流量、自然排名如何 反查流量关键词与自然排名。
竞品在哪些词上投放广告、哪些词有 Amazon's Choice 广告词及 AC 推荐词查询。
找精准长尾词、出单词或转化流失词 结合流量特征和转化标记筛选。
看上个月新进的 SP 流量词 周期内新增关键词研究。
搜索量同比上涨的词有哪些 关键词搜索需求变化筛选。
这个词的 TOP3 点击集中度与转化率是多少 区分头部点击集中程度和点击到购买转化。
对比这些 ASIN 在某周或某月的关键词表现 统一站点和时间范围后逐个查询。

前置条件

确定待查 ASIN、目标站点与分析时间范围。筛选、排序、站点覆盖和时间窗约定见 references/api.md。 脱离指定 ASIN 的关键词研究、商品评论与文案、销量营收估算和广告活动管理不属于本技能范围。

查询流程

  1. 确认商品、站点和统计范围;未指定站点或时间时采用接口默认值,构造请求时明确目标站点。按 references/api.md 核对时间与筛选约定。
  2. 根据问题选择关键词筛选、自然或广告流量条件、转化标记和排序。关键词尽量使用目标站点语言;查看最佳排名时使用升序,查看高搜索量时使用降序。
  3. 查询前说明算力消耗,优先复用同一参数的已有结果。多个 ASIN 分别请求,保持对比口径一致。
  4. 按接口参考先判断公共响应状态,再判断 SIF 业务状态。失败或空结果时解释返回原因,后续查询遵守成本约束。
  5. 用表格展示结果、站点、时间范围和本次返回数量。需要更多页时先说明额外消耗,再按用户需求继续;不得自行连续翻页试探。

执行方式

  • 直接调用接口:接口端点、完整参数、响应和错误码见 references/api.md。
  • 脚本调用(推荐):python scripts/sif_asin_keywords.py '<JSON 参数>' [--inline]。
  • 成本约束:每次接口请求消耗 9 算力。同一会话、同一参数组合默认只调用一次,脚本提供 24 小时本地缓存。失败或空结果时,不得自动更换关键词、翻页或修改邮编连续试探;需要继续检索时,先向用户说明额外消耗。

输出策略

  • 始终保存完整响应,目标路径为 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-sif-asin-keywords-<timestamp>.json。<cwd> 为脚本运行时的工作目录,<session> 优先取环境变量 SESSION_ID,用于聚合同一任务的数据。禁止写入 /tmp,当前目录不可写时应报错。
  • 响应体不超过 8 KB:保存后,将完整 JSON 打印到标准输出。
  • 响应体超过 8 KB:保存后,标准输出仅展示摘要,包括顶层字段、常见计数(如 total、costToken)、最大列表字段的长度和前 3 条样本。
  • 添加 --inline 可强制全量打印到标准输出,同时仍保存文件。

先通过摘要判断数据是否足够。需要具体字段时,优先使用 jq 或 ConvertFrom-Json 从保存的 JSON 文件按需提取,避免将整份响应载入上下文。

执行规则

算力消耗预估

9 算力 / 次

声明:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。

用户会因算力消耗而支付费用。需要高频调用或用户对消耗量预期不足时,提醒用户,并由用户决定是否继续。

解决认证和算力问题

出现以下情况时,按 references/onboarding.md 的指引处理:

  • 未配置接口密钥:LINKFOX_AGENT_API_KEY 和 LINKFOXAGENT_API_KEY 均为空。
  • 响应状态码为 401 或 402。
  • 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。

约束与建议

  • 理解流量数据:本技能说明哪些关键词为指定商品带来流量,及其自然排名、SP 排名、曝光得分和流量来源。用清晰表格展示真实数据,不附加主观经营建议。
  • 排名方向:数值越小,位置越靠前;排名 1 为首位。“排名提升”对应数值减小,“排名下降”对应数值增大。搜索热度排名也以数值越小表示越热门。
  • 百分比展示:trafficShare、naturalTrafficShare、paidTrafficShare、clickConcentrationShare 乘以 100 后展示为百分比,例如 0.05 展示为 5%。前者是关键词对该 ASIN 的流量贡献,自然与付费占比是曝光得分占比,不混为同一指标。
  • 区分集中度与转化率:clickConcentrationShare 是 ABA TOP3 点击集中度,衡量点击是否集中于头部 ASIN;clickToPurchaseConversionRate 才是关键词层面的点击到购买转化率。两者分列标注。
  • 区分曝光得分:自然、SP 常规、SB 品牌、SBV 视频和 SP 推荐位得分及明细分别展示,不把得分当作实际流量次数,也不重复叠加品牌广告与视频广告。
  • 明确统计周期:展示周期计数或比较数据时注明范围;按响应中的 periodEndDate、abaCreateDateWeek 核对周数据,不能把周搜索量、月热度排名和月搜索量排序口径混用。
  • 翻译标记与位置:将流量特征、转化标记和展示位置数组转换为易读中文标签,保留必要的原值以便核对;对应关系见 references/api.md 的字段表。例如 isMainKw、isAccurateKw 展示为“主要流量词、精准流量词”,natural、sp 展示为“自然搜索位、SP 广告位”。
  • 说明返回范围:展示本次实际返回数量;total 不是已确认的全量结果数。响应确有更多页信息时说明可继续获取,不凭本页数量编造剩余页数或全量总数。
  • 解释失败与空结果:根据 msg 或 errmsg 解释原因并给出核对站点、时间或筛选条件的建议,不自动改参重试。
  • 按需提取数据:默认摘要不足时,从落盘文件抽取所需字段;需要完整标准输出时使用 --inline。CLI 选项、缓存与落盘约定见 references/api.md。

使用示例

查看美国站商品的全部流量关键词

{"asin":"B0XXXXXXXX","country":"US"}

仅查看自然流量词

{"asin":"B0XXXXXXXX","country":"US","conditions":"nfPosition"}

筛选包含 charger 的词,按搜索量升序排列

{"asin":"B0XXXXXXXX","country":"US","keyword":"charger","sortBy":"estSearchesNum","desc":false}

查看出单词及转化优质词

{"asin":"B0XXXXXXXX","country":"US","conditions":"isPurchaseKw,isQualityKw"}

查看日本站 SP 广告词,按广告排名升序排列

{"asin":"B0XXXXXXXX","country":"JP","conditions":"isSpAd","sortBy":"adLastRank","desc":false}

查看转化平稳的精准长尾词

{"asin":"B0XXXXXXXX","country":"US","conditions":"isAccurateTailKw,isStableKw"}

查看 2026 年 4 月新进的 SP 常规流量词

{"asin":"B0XXXXXXXX","country":"US","timePieceType":"month","timePieceValue":"2026-04","conditions":"spKeywordCnt.in"}

查看搜索量同比增长的词,按搜索量降序排列

{"asin":"B0XXXXXXXX","country":"US","conditions":"isSearchVolUpKw","sortBy":"estSearchesNum","desc":true}

使用反馈

当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 references/api.md#Feedback 的指引反馈,不要打断用户当前流程。


更多优质、专业的跨境电商技能,请访问 LinkFox Skill。