linkfox-sif-asin-summary

SIF ASIN 摘要

本技能将指导你查询和分析 ASIN 级流量来源数据，帮助 Amazon 卖家了解任意商品在多个渠道中的曝光和流量结构。

核心概念

SIF（Search Intelligence Framework）ASIN 摘要全面拆解了 ASIN 在 Amazon 上的流量来源。它展示了商品总曝光量在自然搜索、Sponsored Products 广告、品牌广告、视频广告、Amazon's Choice、编辑推荐和高评分推荐之间的分布。这对于竞品分析和流量策略优化至关重要。

曝光分数：综合指标，反映商品在给定渠道的所有关键词中的整体可见度。分数越高，曝光度越大。曝光占比字段显示各渠道曝光量占总曝光量的百分比（具体取值范围因字段而异，可能为 01 或 0100）。

流量关键词数：用户通过其发现商品的关键词总数，并按渠道（自然搜索、SP 广告、品牌广告、视频广告等）细分。

数据字段

字段名后缀：*Prev = 上一周期的值；*In / *Out = 本周期新增 / 流失的关键词（用于周期对比）。 | 字段 | API 名称 | 描述 | |-------|----------|-------------| | ASIN | asin | 亚马逊标准识别码 | | 产品标题 | productTitle | Amazon 上的完整产品标题 | | 产品类别 | productCategory | Amazon 上的产品类别 | | 产品价格 | productPrice | 当前商品标价 | | 产品图片 URL | productImageUrl | 主产品图片链接 | | 产品特性 | productFeatures | 项目符号列出的产品特性 | | 客户评分数 | customerRatingCount | 客户评分总数 | | 产品星级评分 | productStarRating | 产品星级评分（0–5） | | 产品评分 | productRatingScore | 产品评分（0–5，如 Amazon 所示） | | 是否为变体产品 | isVariantProduct | ASIN 是否为变体（例如，不同颜色/尺寸） | | 近期月销量区间 | recentMonthlySalesBucket | 上月销量区间（例如 "300+"、"1,000+"）——仅在 keywordSummary 路径中填充 | | 是否在监控中 | isMonitored | ASIN 是否在监控列表中 | | 监控开始时间 | monitoringStartTime | 将 ASIN 添加到监控的时间 | | 数据周期开始日期 | dataPeriodStartDate | 返回数据周期的开始日期（yyyy-MM-dd） | | 总曝光分数 | totalExposureScore | 所有渠道的综合曝光分数 | | 上期总曝光分数 | totalExposureScorePrev | 上一周期的总曝光分数 | | 总流量关键词数 | totalTrafficKeywordCount | 所有渠道的关键词总数 | | 总关键词新增 / 流失 / 上期 | totalTrafficKeywordCountIn / Out / Prev | 新增 / 流失 / 上一周期对应数量 | | 自然搜索曝光分数 | naturalSearchExposureScore | 来自自然搜索的曝光分数 | | 自然搜索曝光占比 | naturalSearchExposureRatio | 自然搜索占总曝光的比例 | | 上期自然搜索曝光分数 | naturalSearchExposureScorePrev | 上一周期的自然搜索曝光分数 | | 自然搜索关键词数 | naturalSearchKeywordCount | 在自然搜索结果中发现的关键词数 | | 自然关键词新增 / 流失 / 上期 | naturalSearchKeywordCountIn / Out / Prev | 新增 / 流失 / 上一周期对应数量 | | SP 广告曝光分数 | sponsoredProductsExposureScore | 来自 Sponsored Products 广告的曝光分数 | | SP 广告曝光占比 | sponsoredProductsExposureRatio | SP 广告占总曝光的比例 | | 上期 SP 广告曝光分数 | sponsoredProductsExposureScorePrev | 上一周期的 SP 曝光分数 | | SP 广告关键词数 | sponsoredProductsKeywordCount | 展示了 SP 广告的关键词数 | | 品牌广告曝光分数 | brandAdExposureScore | 来自品牌广告的曝光分数 | | 品牌广告曝光占比 | brandAdExposureRatio | 品牌广告占总曝光的比例 | | 上期品牌广告曝光分数 | brandAdExposureScorePrev | 上一周期的品牌广告曝光分数 | | 品牌广告关键词数 | brandAdKeywordCount | 品牌广告关键词总数 | | 顶部品牌广告关键词数 | topBrandAdKeywordCount | 页面顶部品牌广告中的关键词数 | | 底部品牌广告关键词数 | bottomBrandAdKeywordCount | 页面底部品牌广告中的关键词数 | | 视频广告曝光分数 | videoAdExposureScore | 来自视频广告的曝光分数 | | 视频广告曝光占比 | videoAdExposureRatio | 视频广告占总曝光的比例 | | 上期视频广告曝光分数 | videoAdExposureScorePrev | 上一周期的视频广告曝光分数 | | 视频广告关键词数 | videoAdKeywordCount | 展示了视频广告的关键词数 | | Amazon's Choice 曝光分数 | amazonsChoiceExposureScore | 来自 AC 标识的曝光分数 | | Amazon's Choice 曝光占比 | amazonsChoiceExposureRatio | AC 占总曝光的比例 | | 上期 Amazon's Choice 曝光分数 | amazonsChoiceExposureScorePrev | 上一周期的 AC 曝光分数 | | Amazon's Choice 关键词数 | amazonsChoiceKeywordCount | 带有 AC 标识的关键词数 | | AC 关键词新增 / 流失 | amazonsChoiceKeywordCountIn / Out | 本周期新增 / 流失的 AC 关键词 | | 编辑推荐曝光分数 | editorialRecommendationsExposureScore | 来自编辑推荐的曝光 | | 编辑推荐曝光占比 | editorialRecommendationsExposureRatio | ER 占总曝光的比例 | | 编辑推荐关键词数 | editorialRecommendationsKeywordCount | 展示了 ER 推荐的关键词数 | | 高评分曝光分数 | topRatedExposureScore | 来自高评分推荐的曝光 | | 高评分曝光占比 | topRatedExposureRatio | TR 占总曝光的比例 | | 高评分关键词数 | topRatedKeywordCount | 展示了 TR 推荐的关键词数 | | 经常一起购买关键词数 | frequentlyBoughtKeywordCount | 经常一起购买推荐中的关键词数 | | 推荐位曝光分数 | recommendPositionExposureScore | 推荐位曝光分数总计 | | 推荐广告曝光分数 | recommendAdExposureScore | 推荐位曝光中的广告部分 | | 非广告推荐曝光分数 | recommendNonadExposureScore | 推荐位曝光中的非广告部分 | | 非 AC 推荐曝光分数 | nonAcRecommendExposureScore | 不含 AC 广告位的推荐位曝光 | | 推荐关键词数 | recommendKeywordCount | 推荐位关键词总数 | | 推荐广告关键词数 | recommendAdKeywordCount | 推荐关键词中的广告部分 | | 非广告推荐关键词数 | recommendNonadKeywordCount | 推荐关键词中的非广告部分 | | PPC 流量来源 | ppcTrafficSources | 付费广告类型列表（SP、顶部品牌广告、底部品牌广告、视频广告） | | 自然搜索流量来源 | naturalSearchTrafficSources | 自然搜索类型标记 | | Amazon 推荐来源 | amazonRecommendationSources | 推荐类型（Best Seller、AC、ER、TR、TRFOB 等） | | 促销优惠来源 | promotionalDealSources | 当前有效的促销活动（优惠券、限时优惠、30 天内最低价等） |

支持的站点

共支持 13 个站点：US（美国）、UK（英国）、DE（德国）、CA（加拿大）、JP（日本）、FR（法国）、ES（西班牙）、IT（意大利）、MX（墨西哥）、AU（澳大利亚）、AE（阿联酋）、BR（巴西）、SA（沙特阿拉伯）。

默认站点为 US。用户未指定站点时使用 US。此列表之外的代码会被 API 模式拒绝。

调用方式

• API 端点：POST /sif/asinSummary（完整参数/响应/错误码见 references/api.md）
• Python 脚本：python scripts/sif_asin_summary.py '<JSON 参数>' [--inline]
• 成本约束：本工具会消耗算力；同一会话、同一参数组合默认只调用一次，脚本带有 24h 本地缓存。失败或结果为空时，不得自动更换关键词、翻页或修改邮编连续试探；需要继续检索时，先向用户说明会产生额外消耗。

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

• 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-sif-asin-summary-<timestamp>.json（<cwd> 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；<session> 取自环境变量 SESSION_ID，按用户任务自动聚合；禁止写入 /tmp，当前目录不可写时则报错）
• 响应体 ≤ 8 KB：写入文件后，将完整 JSON 打印到 stdout
• 响应体 > 8 KB：写入文件后，stdout 仅输出摘要（顶层字段、常见计数，如 total/costToken、最大列表字段的长度和前 3 条样本）
• 加上 --inline 可强制将完整内容打印到 stdout（同样会写入文件）

读取数据建议：先查看摘要，判断是否足够；需要具体字段时，优先使用 jq 或 ConvertFrom-Json 从保存的 json 文件中按需提取，避免将整份 JSON 加载到上下文中。

解决认证和算力问题

发生以下异常情况时，使用 references/onboarding.md 引导解决问题：

异常情况

• 未配置 API Key：未配置环境变量 LINKFOX_AGENT_API_KEY，也未配置 LINKFOXAGENT_API_KEY。
• 响应状态码为 401 或 402
• 响应提示算力或余额不足：消息包含“算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值”，或表达类似含义的内容。

参数指南

searchValue（必填）

一个或多个以逗号分隔的 ASIN 代码。每次请求最多 10 个 ASIN。

• 单个 ASIN：B0XXXXXXXX
• 多个 ASIN：B0XXXXXXXX,B0YYYYYYYY,B0ZZZZZZZZ

country（可选）

站点代码。默认值为 US。所有有效代码见“支持的站点”部分。

时间范围（可选）

• last7d（布尔值，默认 true）：使用最近 7 天的数据。设为 false 时，API 使用 startDate/endDate 定义时间范围。
• startDate（字符串，yyyy-MM-dd）：自定义时间范围的开始日期。仅在 last7d=false 时生效；省略时使用系统最新的 ABA 周。
• endDate（字符串，yyyy-MM-dd）：与 startDate 配对的结束日期。

conditions（可选）

以逗号分隔的流量渠道筛选条件。仅返回至少有一个所列渠道流量的 ASIN 汇总行。有效值：

• nf — 自然搜索
• sp — SP 广告
• sb — SB 常规广告
• sbv — 视频广告（SBV）
• ad — 任意广告流量
• acAd — SP 推荐
• totalPeriod.in — 本周期新进入的流量关键词

sortBy（可选）

排序字段。留空则使用系统默认值。有效值：

totalKeywordNum（关键词总数）、naturalKeywordNum（自然关键词数）、brandKeywordNum（品牌广告关键词数）、vedioKeywordNum（视频广告关键词数）、acKeywordNum（AC 关键词数）、erKeywordNum（ER 关键词数）、trKeywordNum（TR 关键词数）、sumScore（全部关键词总曝光量）、totalNfScore（全部自然曝光量）、totalSpSocre（全部 SP 曝光量；注意拼写）、totalBrandScore（全部品牌广告曝光量）、totalVedioScore（全部视频广告曝光量）、totalAcScore（全部 AC 曝光量）、totalTrScore（全部 TR 曝光量）、totalErScore（全部 ER 曝光量）。

分页

• pageNum：页码，默认值为 1
• pageSize：每页结果数，最小值为 10，最大值为 10000，默认值为 10000

排序

• desc：为 true 时按降序排序（默认），为 false 时按升序排序

使用示例

1. 单个 ASIN 流量拆解

“显示 B09V3KXJPB 在美国站点的流量来源”

查询时设置 searchValue = "B09V3KXJPB"，country = "US"。

2. 多个 ASIN 竞品对比

“比较 B09V3KXJPB 和 B0BN1K7WJP 在 Amazon 美国站的流量结构”

查询时设置 searchValue = "B09V3KXJPB,B0BN1K7WJP"，country = "US"。

3. 指定站点查询

“分析 B07XJ8C8F5 在 Amazon 日本站的流量来源”

查询时设置 searchValue = "B07XJ8C8F5"，country = "JP"。

4. 自然流量与广告流量分析

“B09V3KXJPB 的曝光中，自然搜索和广告分别占多少比例？”

查询该 ASIN，然后对比 naturalSearchExposureRatio 与 sponsoredProductsExposureRatio、brandAdExposureRatio 和 videoAdExposureRatio。

5. 深入分析广告渠道

“B0BN1K7WJP 通过 SP、品牌广告和视频广告投放了多少个关键词？”

查询该 ASIN，并展示 sponsoredProductsKeywordCount、brandAdKeywordCount、topBrandAdKeywordCount、bottomBrandAdKeywordCount 和 videoAdKeywordCount。

6. 不同时期对比

“与上周相比，该 ASIN 的关键词总数有何变化？”

查询该 ASIN，并展示 totalTrafficKeywordCount（当前）、totalTrafficKeywordCountPrev（上一时期）、totalTrafficKeywordCountIn（本期新增）和 totalTrafficKeywordCountOut（本期退出）。自然搜索相关数据也使用 naturalSearchKeywordCount* 系列字段进行同样的对比。

7. 自定义日期范围

“2026-03-08 至 2026-03-14 期间 B0XXX 的流量结构”

searchValue: "B0XXX", country: "US", last7d: false, startDate: "2026-03-08", endDate: "2026-03-14"

8. 按流量渠道筛选并按 SP 曝光排序

“我的 10 款产品中，正在投放 SP 的 ASIN，按 SP 曝光排序列出”

searchValue: "B0A,B0B,...,B0J", conditions: "sp", sortBy: "totalSpSocre", desc: true

展示规则

1. 清晰展示数据：将查询结果整理为结构清晰的表格；按逻辑分组展示产品元数据、本期得分、关键词数量和环比对比列，便于阅读
2. 百分比格式：展示曝光率时，将其格式化为百分比（例如，将 0.45 显示为 45.0%），以便理解
3. 流量结构摘要：用户查询单个 ASIN 时，主动概括流量结构（例如，“65% 自然流量、25% SP 广告、10% 品牌广告”），便于快速了解
4. 时期标注：展示 *In / *Out / *Prev 字段时，务必明确标注时期（例如，“与前 7 天相比”；或注明解析后的 startDate ~ endDate 日期范围）。不要在未注明对比时间范围的情况下展示时期对比数据。
5. 竞品对比布局：查询多个 ASIN 时，使用并排对比表格，让差异一目了然
6. 错误处理：查询失败时，根据 msg 字段说明原因，并建议检查 ASIN 是否有效或站点选择是否正确
7. 变体提示：如果 isVariantProduct 为 true，请注明该 ASIN 是变体，并提示用户也可以查看父 ASIN，以获取完整信息。

重要限制

• 每次请求的 ASIN 上限：单次调用最多可查询 10 个 ASIN
• 每页结果数量上限：每页最多 10000 条结果
• 站点覆盖范围：仅支持 13 个站点 — IN / NL / SE / PL / TR / SG 已不再提供
• 快照与时间范围：默认时间范围为最近 7 天（last7d=true）。如需查询其他时间范围，请设置 last7d=false 并传入 startDate/endDate
• 曝光得分为相对值：得分适用于跨渠道和跨 ASIN 对比，但不代表绝对流量

用户表达与场景速查

适用 —— Amazon ASIN 的流量来源和曝光分析：

用户说	场景
“这个 ASIN 的流量来自哪里？”	流量来源明细
“这个产品有多少自然流量？”	自然搜索曝光分析
“这个竞品投放了很多广告吗？”	SP／品牌／视频广告曝光检查
“比较这些 ASIN 的流量结构”	多 ASIN 竞品对比
“这个产品有 Amazon's Choice 吗？”	AC／ER／TR 推荐检查
“这个 ASIN 使用了哪些广告渠道？”	PPC 流量来源识别
“这个 ASIN 排名的关键词有多少个？”	流量关键词数量分析
“这个产品依赖付费流量还是自然流量？”	自然流量与付费流量拆分
“与上周相比，关键词有哪些变化？”	周期对比（In／Out／Prev）
“这个 ASIN 新增了多少个自然关键词？”	新增关键词数量（naturalSearchKeywordCountIn）
“提取特定日期范围的数据”	通过 startDate／endDate 设置自定义时间范围
“按 SP 曝光量对 10 个 ASIN 排名”	对一批 ASIN 使用 sortBy=totalSpSocre 排序

不适用 —— 超出 ASIN 流量来源数据范围的需求：

• 任意多周的历史趋势曲线（此工具仅提供当前周期和上一周期的数据；长期趋势请使用 ABA 数据）
• ASIN 的关键词级搜索量或排名数据（请改用 ABA 数据或 ASIN 关键词工具）
• 销售估算或收入分析
• Listing 优化或文案撰写
• 广告竞价或预算建议

算力消耗规则

消耗 9 算力。

用户会因算力消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对算力消耗量预期不足时，务必提醒用户，由用户决定是否继续。

反馈：

出现以下任一情况时，通过 Feedback API 自动检测并提交反馈：

1. 此技能中描述的功能或用途与实际行为不符
2. 技能结果与用户意图不符
3. 用户表达了对该技能的不满或赞赏
4. 任何你认为可以改进的地方

请按 references/api.md 中的说明调用反馈 API。不要打断用户的流程。

---

如需获取更多优质、专业的跨境电商技能，请访问 LinkFox Skills。