用途
该技能用于查询和分析亚马逊 ASIN 级别的流量来源数据，帮助卖家了解任意商品在多个渠道上的曝光与流量结构。它基于 SIF（搜索情报框架）提供 ASIN 流量来源的完整拆解，揭示商品总曝光如何分布在自然搜索、SP 广告、品牌广告、视频广告、Amazon's Choice、编辑推荐和 Top Rated 推荐等渠道，适用于竞品分析和流量策略优化。
主要能力
- 流量来源拆解：展示自然搜索、SP 广告、品牌广告、视频广告、Amazon's Choice、编辑推荐、Top Rated 等渠道的曝光得分与曝光占比。
- 关键词数量统计：按渠道统计商品被发现的流量关键词总数，包括自然搜索、SP 广告、品牌广告、视频广告等。
- 周期对比：提供本期、上期以及新进（In）、退出（Out）关键词的对比数据，字段名后缀 *Prev 表示上期值，*In / *Out 表示本期新进/退出关键词。
- 推荐位与促销来源：包含推荐位曝光得分（广告/非广告部分）、频繁购买关键词数量，以及 PPC 流量来源、自然搜索流量来源、亚马逊推荐来源、促销活动来源等列表字段。
- 商品元数据：返回 ASIN、商品标题、类目、价格、主图链接、卖点、评分数量、星级、是否为变体、是否被监控、监控开始时间、数据周期起始日期等。
- 多 ASIN 对比：单次最多查询 10 个 ASIN，支持竞品流量结构并排比较。
使用方式
- API 端点：POST /sif/asinSummary（完整参数、响应与错误码见 references/api.md）。
- Python 脚本：python scripts/sif_asin_summary.py '<JSON 参数>' [--inline]。
- 核心参数：
- searchValue（必填）：一个或多个 ASIN，逗号分隔，单次最多 10 个。
- country（可选）：站点代码，默认 US。
- 时间窗口（可选）：last7d（布尔，默认 true）使用最近 7 天；设为 false 时通过 startDate/endDate 自定义窗口。
- conditions（可选）：按流量渠道过滤，可选值包括 nf（自然搜索）、sp（SP 广告）、sb（SB 常规）、sbv（视频广告 SBV）、ad（任意广告流量）、acAd（SP 推荐）、totalPeriod.in（本期新进流量词）。
- sortBy（可选）：排序字段，如 totalKeywordNum、naturalKeywordNum、brandKeywordNum、vedioKeywordNum、acKeywordNum、erKeywordNum、trKeywordNum、sumScore、totalNfScore、totalSpSocre、totalBrandScore、totalVedioScore、totalAcScore、totalTrScore、totalErScore。
- 分页：pageNum（默认 1）、pageSize（最小 10，最大 10000，默认 10000）。
- 排序方向：desc（默认 true 降序）。
- 输出策略：脚本始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-sif-asin-summary-<timestamp>.json；响应体 ≤ 8 KB 时打印完整 JSON，> 8 KB 时仅输出摘要；加 --inline 可强制全量打印。建议先用摘要判断，再用 jq 或 ConvertFrom-Json 从保存文件按需抽取字段。
- 成本约束：本工具消耗 9 算力，同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存；失败或空结果不得自动换关键词、翻页或改邮编连续试探，需继续检索时应先向用户说明会产生额外消耗。
- 认证与算力：未配置 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY、响应 401/402、或提示算力/余额不足时，按 references/onboarding.md 引导解决。
适用场景
- 查询单个 ASIN 的流量来源构成。
- 分析商品自然搜索曝光情况。
- 判断竞品是否投放大量广告（SP/品牌/视频广告曝光）。
- 多 ASIN 竞品流量结构对比。
- 检查商品是否拥有 Amazon's Choice、编辑推荐、Top Rated 等推荐位。
- 识别 ASIN 使用的广告渠道（PPC 流量来源）。
- 统计 ASIN 覆盖的流量关键词数量。
- 判断商品依赖付费流量还是自然流量。
- 对比关键词相较上期的变化（新进/退出/上期）。
- 按自定义日期范围拉取数据。
- 对一批 ASIN 按 SP 曝光等字段排序。
限制
- 单次请求最多查询 10 个 ASIN。
- 每页最多返回 10000 条结果。
- 仅支持 13 个站点：US、UK、DE、CA、JP、FR、ES、IT、MX、AU、AE、BR、SA；IN / NL / SE / PL / TR / SG 已不再可用。
- 默认窗口为最近 7 天；查询其他窗口需设置 last7d=false 并传入 startDate/endDate。
- 曝光得分为相对指标，适合跨渠道、跨 ASIN 比较，并非绝对流量数值。
- 不适用于：任意多周历史趋势曲线（本工具仅提供本期与上期）、ASIN 的关键词级搜索量或排名数据、销量估算或收入分析、Listing 优化或文案撰写、广告竞价或预算建议。
- 若 isVariantProduct 为 true，说明该 ASIN 是变体，用户可能还需查看父 ASIN 以获得完整情况。
支持站点
13 个站点：US（美国）、UK（英国）、DE（德国）、CA（加拿大）、JP（日本）、FR（法国）、ES（西班牙）、IT（意大利）、MX（墨西哥）、AU（澳大利亚）、AE（阿联酋）、BR（巴西）、SA（沙特阿拉伯）。默认站点为 US，用户未指定时使用 US。