linkfox-sif-asin-keywords
使用 SIF 数据反查亚马逊 ASIN 的流量关键词,查看自然与广告排名、搜索量、流量占比、曝光得分、ABA TOP3 点击集中度和点击到购买转化率,支持按周、月或最近时间窗分析及多商品对比。适用于竞品关键词反查、主要流量来源、广告词、精准长尾词、出单词、新进词及搜索量同比变化研究,无需明确提及 SIF。不适用于脱离 ASIN 的泛关键词研究、类目趋势、评论、Listing 文案、销量营收估算或广
SKILL.mdskills/linkfox-sif-asin-keywords/SKILL.md
GitHubSIF ASIN 流量关键词分析
适用范围
适用
围绕指定亚马逊商品反查带来流量的关键词,查看商品在各词下的自然与 SP 广告排名、搜索需求、流量结构和转化表现。用户希望对比多个商品时,分别查询并合并展示。
场景速查
| 用户表达 | 查询场景 |
|---|---|
| 这个 ASIN 靠哪些词获取流量、自然排名如何 | 反查流量关键词与自然排名。 |
| 竞品在哪些词上投放广告、哪些词有 Amazon's Choice | 广告词及 AC 推荐词查询。 |
| 找精准长尾词、出单词或转化流失词 | 结合流量特征和转化标记筛选。 |
| 看上个月新进的 SP 流量词 | 周期内新增关键词研究。 |
| 搜索量同比上涨的词有哪些 | 关键词搜索需求变化筛选。 |
| 这个词的 TOP3 点击集中度与转化率是多少 | 区分头部点击集中程度和点击到购买转化。 |
| 对比这些 ASIN 在某周或某月的关键词表现 | 统一站点和时间范围后逐个查询。 |
前置条件
确定待查 ASIN、目标站点与分析时间范围。筛选、排序、站点覆盖和时间窗约定见 references/api.md。
脱离指定 ASIN 的关键词研究、商品评论与文案、销量营收估算和广告活动管理不属于本技能范围。
查询流程
- 确认商品、站点和统计范围;未指定站点或时间时采用接口默认值,构造请求时明确目标站点。按
references/api.md核对时间与筛选约定。 - 根据问题选择关键词筛选、自然或广告流量条件、转化标记和排序。关键词尽量使用目标站点语言;查看最佳排名时使用升序,查看高搜索量时使用降序。
- 查询前说明算力消耗,优先复用同一参数的已有结果。多个 ASIN 分别请求,保持对比口径一致。
- 按接口参考先判断公共响应状态,再判断 SIF 业务状态。失败或空结果时解释返回原因,后续查询遵守成本约束。
- 用表格展示结果、站点、时间范围和本次返回数量。需要更多页时先说明额外消耗,再按用户需求继续;不得自行连续翻页试探。
执行方式
- 直接调用接口:接口端点、完整参数、响应和错误码见
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。