Amazon 广告离线 HTML 报告 Skill

它能做什么

GGRN 原始来源中的 Skill 本名是 amazon-ads-analyzer；本目录条目按其离线报表用途命名。它把卖家提供的 Amazon 广告导出整理成可复核、自包含的 HTML 报告。工作流将原始观察行、计算指标、假设和置信度说明分开呈现，适合离线复核 ACOS、TACOS、ROAS、CTR、CVR、CPC、CPM 和盈亏平衡 ACOS，再受控分享报表。它不会登录 Amazon，不会获取卖家 Ads Console 或 Business Reports，不会改 bid、启动广告活动或发布内容。

适用场景

当报表已经在本地，需要形成可重复的周报或月报、财务交接、调整前后比较或可分享的决策材料时使用。它有意覆盖账户或活动层面的证据和单位经济，而不是短流程的搜索词 CSV PPC 诊断。需要获取当前报表时，先使用 Amazon Ads Report Downloader；已有搜索词 CSV 时，使用 Amazon PPC Analyzer 做诊断，再用本 Skill 生成离线产物。

输入

输入可以是 Amazon XLSX 或 CSV 导出、截图或粘贴的指标。记录站点或 marketplace、Seller 或 Vendor 类型、报表名称、日期范围及时区、货币、campaign/SKU/ASIN 范围、目标、目标 ACOS、售价、COGS、FBA 或履约成本、佣金、退款或退货以及总销售额。把每个值标成观察值、推导值或假设值。截图和粘贴内容需要人工抄录并核对。

输出

来源工作流命名了两个本地产物：report-data.json 用于规范化数据，AMAZON-ADS-REPORT.html 用于生成自包含视图。合格的报告应包含公式输入、ACOS/TACOS/ROAS、效率指标、盈亏平衡 ACOS、日期与站点范围、置信度标签，以及分母缺失说明。HTML 可以离线打开；分享前应删除账号 ID、ASIN、活动名称和其他敏感信息。本目录条目没有生成这些文件。

运行示例

仅作演示，未运行。 以下脱敏数值是为演示算术而虚构的，不是 Amazon 导出、API 响应或实际执行记录：

seller_ads:
  marketplace: US
  period: 2026-08-01/2026-08-31
  impressions: 500000
  clicks: 10000
  orders: 400
  ad_sales_usd: 10000
  spend_usd: 2000
  total_sales_usd: 20000
unit_economics:
  price_usd: 40
  cogs_usd: 12
  fulfillment_usd: 7
  referral_fee_usd: 6
market_report_context:
  source: hypothetical market-side report context
  keyword: insulated bottle
  estimated_searches: 120000
  sponsored_traffic_share: 0.08

按这些假设，ACOS 为 2,000 / 10,000 = 20%，ROAS 为 10,000 / 2,000 = 5.0，TACOS 为 2,000 / 20,000 = 10%。CTR 为 10,000 / 500,000 = 2%，CVR 为 400 / 10,000 = 4%，CPC 为 $2,000 / 10,000 = $0.20，CPM 为 $2,000 / 500,000 * 1,000 = $4.00。盈亏平衡 ACOS 为 ($40 - $12 - $7 - $6) / $40 = 37.5%。市场报告上下文仍是独立注释，不能证明卖家表现，也不能填补卖家字段。这里没有生成 report-data.json、HTML 文件或市场 API 响应。

来源记录了下面的命令；此处仅引用，复核时未执行：

python scripts/build_report.py --data report-data.json --out AMAZON-ADS-REPORT.html

支持的 Agent 与安装方式

固定来源列出 Claude Code、Codex、Cursor、Windsurf、Gemini 和 Goose。2026-09-15 复核的证据包括不可变的 SKILL.md、对应的 commit、MIT LICENSE 和 skills.sh 目录条目。LICENSE 还包含 Amazon 非隶属及商标说明。安装方式是先审阅固定来源，再按作者 README 手动操作。本条目是 source-reviewed，不是 install-tested，不提供安装命令。

账号、API 和权限要求

离线路径需要本地文件系统读写和 shell 执行权限，以运行来源记录的报表脚本。本条目不要求 Amazon 账号或 API Key。若操作员从已登录的卖家账号取得导出文件，认证发生在 Skill 之外。任何 Ecommerce Data API 调用都有独立的账号和凭证要求，必须单独批准。

限制与人工确认边界

只有日期范围、货币、站点、归因窗口和统计范围一致时，比例才有意义。ACOS 是广告花费除以广告归因销售额，TACOS 是广告花费除以总销售额，盈亏平衡 ACOS 取决于纳入的变动成本、退款、税费和折扣。Seller 与 Vendor 报表字段可能不同，延迟或缺少分母也会改变结论。截图和粘贴值不会自动校验。置信度是可追溯性标签，不是统计证明，也不是安全验证。分享前人工复核计算并脱敏，不要仅凭 HTML 断言必然盈利或授权改 bid。

与 Ecommerce Data API 组合使用

在单独批准时，amazon.keywords.research 可补充关键词需求、增长、竞争、转化或 PPC 背景；amazon.traffic.sources 可补充流量来源构成；amazon.keywords.traffic-stats 可补充 ASIN 的聚合流量关键词统计。调用这些补充接口前，先查看 关键词研究文档 和流量来源文档 的 canonical 说明；如需这一步可选的实时市场背景，可创建 Ecommerce Data API Key，离线报表本身不需要该 Key。这些是市场侧上下文接口，不会读取卖家的私有广告控制台、卖家广告报表或 Business Reports。应把 API 响应时间、站点和来源与卖家导出并列记录，不能把市场估算当成实际广告表现。