linkfox-sif-asin-summary

使用 SIF(搜索情报框架)分析亚马逊 ASIN 的流量来源与曝光分布,覆盖自然搜索、SP 广告、品牌广告、视频广告、推荐位和促销来源,以及本期、上期、新进和退出流量词对比。适用于单品流量拆解、自然与付费曝光占比、广告渠道识别和多商品竞品对比,无需用户明确提及 SIF。不适用于长期历史趋势、关键词级搜索量或排名查询、销量营收估算、Listing 文案优化及广告出价或预算建议。

SKILL.md

GitHub

SIF ASIN 流量来源分析

适用范围

适用

分析亚马逊商品的流量结构、曝光渠道与跨周期变化,帮助卖家研究竞品和流量策略。

场景速查

用户表达 查询场景
这个 ASIN 的流量从哪里来 拆解自然搜索、广告及推荐位曝光。
自然曝光占多少,是否依赖广告 对比自然搜索和 SP、品牌、视频广告的曝光占比。
竞品广告投得多吗,用了哪些渠道 查看广告曝光、PPC 来源与各渠道流量词数。
SP、品牌、视频广告各覆盖多少词 对比 SP、品牌广告总词数、顶部/底部品牌广告词数及视频广告词数。
这些 ASIN 的流量结构有什么差别 多商品并列表格对比。
有没有 Amazon's Choice 或编辑推荐曝光 查看 AC、ER、Top Rated、高频购买和其他推荐位数据。
商品有哪些促销或秒杀流量来源 查看响应中的促销活动标记。
这个商品有多少流量词 展示总词数及自然、广告、推荐渠道分布。
与上期相比流量词怎样变化,新进自然词有多少 对比本期、上期、新进和退出数量。
看指定日期的流量,或按 SP 曝光比较商品 自定义周期、渠道筛选与批量排序。

边界

本技能提供本期与上期汇总,不用于任意多周历史趋势曲线;长期趋势和关键词级搜索量、排名需使用 ABA 或 ASIN 关键词数据源。销量与营收分析、Listing 优化或文案撰写、广告出价与预算建议不属于本技能范围。

前置条件

先确定查询目标:取得用户要研究的 ASIN,确认站点及所需对比周期。完整参数约定、站点覆盖、筛选排序及使用限制见 接口说明。

查询与分析流程

  1. 明确任务是单品流量拆解、竞品比较、自然与付费对比、广告渠道分析还是周期变化;按接口说明准备 ASIN、站点、周期及必要的筛选排序。
  2. 检查是否已有同参数缓存或已保存结果;需要请求时调用脚本,保留完整响应文件,不为失败或空结果自动追加调用。
  3. 按接口说明分别判断网关响应和 SIF 业务结果。失败时依据返回消息解释原因,提示核对 ASIN 与站点;认证或算力问题按“解决认证和算力问题”指引处理。
  4. 从保存的数据中提取产品信息、各渠道曝光与流量词数;按任务展示单品结构、多个 ASIN 的差异或本期与上期变化,注明数据周期与变体情况。

执行方式

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

输出策略

  • 始终保存完整响应,目标路径为 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-sif-asin-summary-<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。
  • 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。

约束与建议

  • 理解指标口径:曝光分数是商品在各关键词、各渠道可见度的综合相对指标,越高表示曝光越强,可用于跨渠道和跨 ASIN 比较,不能等同于绝对流量、访问量或销量。流量关键词数表示商品被发现的关键词数量,可按自然、SP、品牌、视频及推荐渠道拆解。
  • 区分渠道:SIF 覆盖自然搜索、Sponsored Products、品牌与视频广告、Amazon's Choice、Editorial Recommendations 和 Top Rated;另有推荐位广告/非广告、非 AC 推荐、高频购买和促销活动来源。按实际返回展示,不补造缺失渠道。
  • 清晰展示数据:用表格分别展示商品元信息、本期曝光分数、关键词数和跨周期数据。单 ASIN 主动概括流量结构;多个 ASIN 使用并列表格。
  • 百分比口径:曝光占比按百分比展示,例如已确认是比例值的 0.45 展示为 45.0%。原数据可能使用 0~1 或 0~100 的口径,应核对返回字段的实际单位,不能把已是百分数的值再次乘以 100;单位不明时保留原值并说明。
  • 标明周期:*Prev 表示上期,*In / *Out 表示本期相对上期新进/退出的流量词数。每次展示这些值或计算变化,都标明本期与比较窗口,例如前一个七天周期或实际起止日期,不展示未注明周期的增减值。
  • 自然与付费比较:对比自然搜索与 SP、品牌、视频广告曝光占比;广告深查时展示 SP、品牌总词数、顶部与底部品牌广告词数和视频广告词数。推荐位指标按其含义单独说明,避免与其他渠道重复加总。
  • 变体意识:商品为变体时注明这一点,可建议用户进一步核对父 ASIN 以了解完整情况;父体与变体相关字段以接口实际返回为准。
  • 按需读大结果:先读摘要,按需从已保存文件提取明细并说明返回范围;分页和数据覆盖限制见接口说明,后续查询仍遵守成本约束。

使用示例

单 ASIN 流量拆解或自然与付费占比

{"searchValue":"B09V3KXJPB","country":"US"}

展示自然搜索、SP、品牌、视频及推荐位的可用指标,并概括流量结构。

多 ASIN 竞品对比

{"searchValue":"B09V3KXJPB,B0BN1K7WJP","country":"US"}

使用并列表格展示各商品的渠道曝光、流量词数及广告覆盖差异。

日本站流量分析

{"searchValue":"B07XJ8C8F5","country":"JP"}

本期与上期流量词变化

查询指定 ASIN 后,展示总流量词与自然搜索流量词的本期、上期、新进、退出数量,标明比较周期。

指定日期区间并筛选广告流量

{"searchValue":"B09V3KXJPB","country":"US","last7d":false,"startDate":"2026-03-08","endDate":"2026-03-14","conditions":"ad","sortBy":"totalSpSocre"}

按 SP 曝光比较一组商品

{"searchValue":"B09V3KXJPB,B0BN1K7WJP","country":"US","conditions":"sp","sortBy":"totalSpSocre","desc":true}

使用反馈

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


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