# Sealeap Amazon Sqp Period Reconciliation

> 合并同一 Amazon Brand Analytics SQP 范围内不重叠的完整周期，重算查询份额与漏斗比率，并比较需求、曝光、点击及购买变化。用于月季度拼接、同比环比和销量下降归因；不直接平均百分比、不混合 Brand/ASIN 视图，也不把缺失查询记零。

- Skill: `xjli360/sealeap-amazon-sqp-period-reconciliation` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx get-skill add xjli360/sealeap-amazon-sqp-period-reconciliation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xjli360/sealeap-amazon-sqp-period-reconciliation/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: xjli360 (https://skillmd.com/u/xjli360)
- Updated: 2026-11-11
- Page: https://skillmd.com/skills/xjli360/sealeap-amazon-sqp-period-reconciliation

---


# SQP 跨期对账与流量诊断

## 输入范围

固定店铺、站点、Brand/ASIN 视图、唯一实体、查询原文、报告定义版本、时区、完整统计周期和报告生成/成熟时间。用户只给截图百分比时先说明不可重算，不能反推唯一计数。

## 工作流

1. 阅读 [官方基线](references/official-baseline.md)，按当前授权导出或已验证接口取得 SQP 原始计数。接口名称和报告存在不证明本账户可用。
2. 用 [输入契约](references/input-contract.md) 把列名映射到查询量及全市场/本实体曝光、点击、加购、购买计数。记录映射和导出来源，不靠列位置猜字段。
3. 用 scripts/reconcile_sqp.py 验证完整、相邻、不重叠的周期。周、月、季度可作为独立完整窗口使用，但不能把季度与其内月份相加，也不能按天数比例拆季度。
4. 一个目标分析仅合并一个视图、一个实体。父子 ASIN 不能去重后随意当品牌；多 ASIN 各带的市场分母不能跨 ASIN 重复求和。
5. 汇总原始计数，再计算份额与漏斗比率。百分比、中位价、query score 不直接相加或平均。缺少查询或指标时保留 null、覆盖率和已观测部分，不补零。
6. 基准与观察期各独立对账后比较：查询需求、实体曝光份额、实体点击/曝光、实体购买/点击。拆分品牌词与非品牌词，统一时间长度与成熟度；采购数不自动等于店铺总订单。
7. 将变化转为竞争解释与验证任务。查询市场量变化不能简单归因广告；不能从 SQP 总量减不同归因广告量声称算出了自然订单。

## 交付

周期覆盖图/清单、排除与缺口、原始计数合计、重新计算的份额、基准/观察差异、候选解释和下一步。无成熟数据时 HOLD。已观测小计必须与完整期间总量分开标识。

    python3 scripts/reconcile_sqp.py references/input.example.json

执行和误差处理见 [playbook](references/playbook.md)。

