seller-sprite-listing-generator

# 卖家精灵 Listing 生成器 v2.0

## 核心边界

只使用卖家精灵 MCP 返回的数据做市场验证、关键词流量验证、竞品分析和相似度检测。禁止编造市场数据、禁止直接改写或复用竞品句式。

用户提供的产品基础信息可以作为我方产品事实来源；但关键词搜索量、CPC、SPR、类目均价、竞品评论、BSR、差评痛点等市场数据必须来自卖家精灵 MCP。

如果卖家精灵 MCP 工具不可用，或关键字段没有返回，可联网进行补充，不得捏造数据，数据必须真实准确。

## 密钥管理

不要把卖家精灵 API Key、MCP Token、账号密码或 Cookie 写入脚本、代码、SKILL.md、输出报告或对话回复。

如需配置凭证，只读取运行环境中已有的环境变量，或让用户按 `references/env.md` 复制 `.env.example` 到本机私有 `.env` 后再由 MCP 服务读取。`.env.example` 只能保存占位符，不得保存真实密钥。

如果 MCP 调用因认证失败或环境变量缺失而失败，停止并提示用户检查 `.env` 或 MCP 服务配置；不要要求用户在聊天中直接粘贴完整 API Key。

## 输入模式

支持三种模式：

- 模式 1：竞品 ASIN 批量输入，最多20个 ASIN。
- 模式 2：类目核心关键词输入，1 个核心类目词。
- 模式 3：产品基础信息输入，包括产品名称、核心卖点、目标类目；可选目标站点、目标语言、价格带、材质/尺寸/规格、适用人群/场景、禁用词、品牌名、已有差异化方案。

如果用户没有指定站点，默认 `US`。如果没有指定语言，默认英语 `en`。如果用户指定日语、德语等小语种，先用卖家精灵 MCP 验证该站点/语言可用关键词，再生成本地化 Listing；不要把英文关键词机械直译后当作有流量词。

类目关键词模式和产品基础信息模式必须先通过卖家精灵 MCP 找出 3-5 个头部或高相关竞品 ASIN，再进入固定采集流程；这一步只用于获得竞品样本、类目背景和关键词候选，不得直接生成文案。

## MCP 工具发现

执行前先发现可用 MCP 工具。优先匹配名称或描述包含以下能力的卖家精灵/SellerSprite 工具：

- ASIN 详情：标题、五点、描述、参数、售价、BSR、变体、类目路径、图片/视频卖点描述。
- 流量词反查：自然流量词、广告流量词、月搜索量、搜索量趋势（如有）、CPC、SPR、流量占比、站点/语言。
- 评论分析：TOP10 差评痛点、好评偏好、QA 高频顾虑。
- 关键词挖掘/类目调研：蓝海长尾词、行业均价、行业竞品评论均值、类目大盘。
- 文案相似度检测：候选 Listing 与头部 3 个竞品的重复度。

如果工具命名与上方不完全一致，以返回字段是否满足能力为准。记录每次 MCP 调用的输入、核心返回字段和缺失字段。

## 固定采集流程

按顺序调用卖家精灵 MCP：

1. 样本获取：ASIN 模式直接使用用户 ASIN；关键词/产品基础信息模式先用目标类目和产品词找 3-5 个相关 ASIN。
2. ASIN 详情：获取竞品标题、五点、描述、产品参数、售价、BSR、变体、类目路径。
3. 流量词反查：分离自然流量词和广告流量词，保留每个词的月搜索量、搜索量趋势（12个月，如 MCP 返回）、CPC、SPR、流量占比。
4. 评论分析：提取 TOP10 差评痛点、用户好评偏好、QA 高频顾虑。
5. 关键词挖掘/类目调研：获取类目蓝海长尾词、行业均价、行业竞品评论均值、类目平均 SPR。
6. 站点/语言交叉验证：用目标站点和语言复核核心词、二级词、长尾词的流量有效性；多语言输出时，每种语言分别验证。

不要跳步。若某一步失败，先重试或换同等卖家精灵 MCP 能力工具；仍失败则停止并列出缺失数据。

## 数据清洗

合并多 ASIN 数据后执行：

1. 剔除低流量词：按站点自适应阈值剔除月搜索量不达标的词。
   - US/UK: < 500
   - DE: < 300
   - JP/FR/ES/IT: < 200
2. 剔除高竞争词：剔除 SPR > 类目平均 SPR × 2 的关键词（如果 MCP 未返回类目平均 SPR，则使用 SPR > 60 作为兜底阈值）。
3. 去重，保留最高搜索量、最低 SPR、最高流量占比的代表记录。
4. 拆分自然流量词和广告流量词；自然词优先用于标题、五点、描述，广告词优先用于广告建议。
5. 从差评、QA、好评偏好中锁定 TOP3 用户痛点（按频次排序）。
6. 将用户产品基础信息与竞品痛点交叉匹配，只保留真实可交付的差异化卖点。
7. 关键词相关性验证（新增）：对核心大词和二级精准词，通过 MCP 或搜索结果验证该词与本品类的相关度。如果搜索该词的前 10 个 ASIN 中，超过 5 个与本品类不同，该词降一级使用（核心→二级，二级→长尾）。

## 关键词四层分层与埋词优先级模型

### 分层规则（品类自适应）

先计算 **品类搜索量天花板** = MCP 返回的所有关键词中最高月搜索量。

| 层级 | 默认阈值 | 品类自适应规则 |
|------|---------|--------------|
| 🔴 核心大词（1-2个） | 月搜索 ≥ 10,000 | 如果品类最高搜索量 < 10,000，取 Top 2 搜索量词作为核心大词 |
| 🟡 二级精准词（3-5个） | 3,000 ≤ 月搜索 < 10,000 | 如果品类最高搜索量 < 5,000，阈值调整为 1,500 |
| 🟢 蓝海长尾词（20-30个） | 500 ≤ 月搜索 < 3,000 | 站点自适应下限（US/UK 500, DE 300, JP/FR/ES/IT 200） |
| ⚪ 补充词（不限） | 月搜索 < 500 | 同义词、变体词、拼写变体、场景词 |

### 二级词的替换策略（修复 v1 的 60% 强制替换）

~~保留 40%，60% 替换为同义/近义表达~~ **[v2 已修复]**

**v2 规则**：二级精准词保留所有经 MCP 验证的高搜索量词。仅当满足以下条件时才考虑替换：
- MCP 返回该词的同义词/近义词
- 同义词的月搜索量 ≥ 原始词月搜索量的 50%
- 同义词确实未被头部竞品覆盖

**禁止**无依据替换已验证搜索量的二级词。

### 埋词优先级判定公式

```
埋词优先级 = (月搜索量标准化 × 0.40) + (相关度 × 0.35) + (SPR倒数标准化 × 0.15) + (CPC性价比 × 0.10)
```

其中：
- **月搜索量标准化** = 该词月搜索量 / 品类最高月搜索量 × 100
- **相关度**：搜索结果前 10 ASIN 中与本品类一致的比例 × 100（通过步骤 7 相关性验证得到）
- **SPR 倒数标准化** = (1 - 该词 SPR / 类目最高 SPR) × 100（SPR 越低越好）
- **CPC 性价比** = (1 - 该词 CPC / 类目最高 CPC) × 100（CPC 越低越好）

| 优先级得分 | 埋入位置 |
|-----------|---------|
| ≥ 80 分 | 🔴 Title |
| 50–79 分 | 🟡 Bullet Points |
| 30–49 分 | 🟢 Description |
| < 30 分 | ⚪ Search Terms |

如果 MCP 返回的可用词不足，输出中明确标注"卖家精灵 MCP 可用词不足"，并只使用已返回词；禁止补造搜索量、SPR 或词库规模。

## 搜索量趋势标注

如果 MCP 流量词反查返回了搜索量趋势数据（过去 3-12 个月），在关键词词库中标注趋势方向：

- ↑ 上升（过去 3 个月增长 > 15%）
- → 持平（波动在 ±15% 以内）
- ↓ 下降（下降 > 15%）

趋势标注影响决策：
- ↓ 下降的核心大词慎重放入 Title 第一位，考虑用 ↑ 上升词替换
- ↑ 上升的蓝海长尾词可提升到二级层

## 站点与语言合规

生成前读取 `references/amazon-compliance-rules.md` 和 `references/amazon-compliance-rules.json`，按目标站点、目标语言、类目风险等级套用字符限制、敏感词、标题 SEO、五点、Search Terms 和类目提示。

基线要求：

- 文案必须满足目标站点字符限制，字符合规率 100%。
- 标题必须包含目标站点/语言下已由 MCP 验证的核心关键词，表达自然，避免关键词堆砌。
- 标题禁止不允许的装饰字符；同一实义词在标题中不得重复超过 2 次。
- 五点必须正好 5 条；每条以大写字母开头，覆盖独立卖点，无重复卖点。
- 自动检测并规避敏感词、违规表达、品牌词、绝对化承诺、医疗功效承诺。
- Search Terms 使用后台剩余词，去重，避免重复标题/五点完整短语。

对小语种：

- 英语为主；支持用户指定日语、德语、法语、西语、意大利语等。
- 先生成目标语言版本，再回查是否包含目标站点已验证关键词。
- 不要逐词直译竞品文案；用目标语言原生电商表达重写。
- 输出多语言 Listing 时，每个语言单独给标题、五点、描述、Search Terms 和合规自检。

## Listing 生成规则

### 标题（Title）

默认美国站建议 120-170 字符；如目标站点/类目规则更严，以规则库为准。结构固定：

```
[B] + [A] + [C] + [D] + [E] + [F]
```

其中：
- **B = Brand**（品牌名，注册品牌强制前置）
- **A = 核心大词1**（月搜索量最高、相关度最高、趋势 ↑ 优先）
- **C = 核心大词2 或 核心属性词**（如 "14K Gold Plated" / "Layered Set 3 Piece"）
- **D = 二级精准词**（1-2 个高搜索量场景/属性词）
- **E = 差评解决差异化卖点**（从竞品 TOP3 差评中提炼的升级点】
- **F = 适用人群/场景 + 产品规格**

要求：

- 差异化卖点前置于产品属性之前。
- 语序完全区别于竞品标题。
- 不复制竞品任何连续短语（连续 3 个实义词以上视为复制）。
- 不使用品牌词（自己的除外）、极限词、侵权词。
- 核心大词必须出现在前 80 字符内（确保手机端可见）。

### 五点描述（Bullet Points）

生成 5 条 Bullet Points，每条角色固定，句式和竞品完全错开：

| Bullet | 角色 | 开头标签建议 | 埋词要求 |
|--------|------|-------------|---------|
| **BP1** | 痛点直击 + 差异化升级方案 | `[BENEFIT]-ORIENTED HEADER` | 埋 1 个二级精准词 |
| **BP2** | 核心功能优势 + 使用便捷性 | `[FUNCTION]-ORIENTED HEADER` | 埋核心大词 |
| **BP3** | 硬参数对标 + 材质/用料优势 | `[QUALITY]-ORIENTED HEADER` | 埋属性长尾词 |
| **BP4** | 全场景使用 + 礼物/情感共鸣 | `[SCENE]-ORIENTED HEADER` | 埋场景长尾词 |
| **BP5** | 售后保障 + 下单顾虑打消 | `[TRUST]-ORIENTED HEADER` | 埋剩余长尾词 |

每条以大写字母开头。禁止照搬竞品卖点顺序、段落逻辑和营销套话。单个关键词全文（Title+Bullets+Desc）出现不超过 3 次。每条 Bullet 的 ALL-CAPS 开头（3-5 词）必须是**用户可感知的收益**，不是产品特征描述。

### 产品描述（Description）— v2 大幅扩展

按 **AIDA+ 信任堆栈** 框架写短句移动端排版：

```
段落 1 — ATTENTION（场景钩子，1-2句）
  → 用一句话描绘用户使用产品的理想场景
  → 埋 1 个场景长尾词
  → 目标：让用户在 2 秒内产生 "This is for me"

段落 2 — PROBLEM AMPLIFICATION（痛点共鸣，1-2句）
  → 描述用户用竞品时的不满/困扰
  → 引出差评中 TOP1 痛点
  → 目标：让用户觉得 "Yes, that's exactly my problem"

段落 3 — SOLUTION（我方差异化解决方案，2-3句）
  → 针对痛点，展示我方的具体升级方案
  → 埋入核心大词
  → 目标：让用户觉得 "This solves it"

段落 4-6 — FEATURES → BENEFITS 展开（共3-4短句）
  → 每个 Feature 必须紧跟 1 个 Benefit
  → 使用━━━分隔线或 <br> 增强可读性
  → 埋入 3-5 个蓝海长尾词
  → 目标：让用户逐条确认 "I need this"

段落 7 — WHAT'S INCLUDED（包装清单，1-2句）
  → 清晰列出用户会收到什么
  → 埋 1 个属性长尾词

段落 8 — TRUST & CTA（信任与行动号召，1-2句）
  → 售后承诺（不要说 "100% guarantee"，改用具体描述）
  → 埋 1 个情感/信任长尾词
  → 以行动号召结尾
```

**硬规则**：
- 总字符数 ≤ 2000
- 使用 `<br>` 或 `━━━` 分隔段落
- 不要逐字复制 Bullet Points，而是展开详解
- 所有文案必须以**移动端第一屏可见**为标准（约 300 字符内给出核心信息）
- 避免大段模板化文案，每个段落不超过 3 句

### Search Terms（后台搜索词）

输出后台 Search Terms；模板默认 5 行，但若目标站点后台只接受单个 Generic Keyword 字段，仍可分 5 行展示给用户，并标注合并后需满足规则库 byte/字符限制。

- 使用剩余长尾词、同义词（已验证搜索量的）、变体词、属性词、场景词、拼写变体。
- 去重，不放品牌词（自己的除外），不放标点堆砌，不重复标题已有完整短语。
- 不重复已在 Title/Bullets/Description 中完整出现的短语。
- 不用逗号分隔，用小写字母和空格。
- 每行保持可复制粘贴的纯关键词串。

### A+ Content / 品牌故事（v2 新增）

如果用户为品牌注册卖家，生成 A+ 内容模块建议。如果用户未品牌注册，标注"A+ Content 需要品牌注册，以下为规划供注册后使用"，不跳过。

| 模块 | 内容要求 | 关键词埋入 |
|------|---------|-----------|
| **品牌故事/Logo** | 50-100 词品牌叙事，突出差异化定位 | 品牌名 + 品类词 |
| **标准对比图**（左右对比） | 我方 vs 竞品 3 个维度对比（基于差评痛点） | 二级精准词 |
| **卖点模块 1** | 核心差异化功能 + 图文 | 核心大词 |
| **卖点模块 2** | 材质/质量升级 + 图文 | 属性长尾词 |
| **卖点模块 3** | 使用场景 + 真人使用图 | 场景长尾词 |
| **规格表** | 标准尺寸/材质/颜色表格 | 属性词自然嵌入 |

### 图文视频拍摄指令

不抓取图片/视频源文件。仅根据 MCP 返回的竞品视觉卖点、页面描述和 Listing 信息生成设计/拍摄指令：

- 主图角度、构图、道具、留白、差异化展示重点。
- 副图整套布局，包括痛点对比、参数图、场景图、包装图、使用步骤图、售后保障图。
- 30 秒视频脚本，必须包含前 3 秒钩子、痛点演示、升级方案演示、场景使用、结尾 CTA。

视觉策略必须规避与竞品主图、副图、视频构图高度重合。

## 合规自检

生成后必须执行：

1. 调用卖家精灵 MCP 文案相似度/重复度能力，检查与头部 3 个竞品 Listing 全文重复度 ≤ 15%。超标则全局重写并复测。
2. 用规则库排查极限词、侵权词、品牌违规词、医疗/功效绝对化承诺、站点敏感词。
3. 核对关键词布局：
   - 核心词覆盖：Title ✓
   - 二级词覆盖：Bullets ✓（每条至少 1 个）
   - 蓝海长尾词覆盖：Description ✓（至少 3 个）
   - 补充词覆盖：Search Terms ✓
   - 输出**关键词覆盖率矩阵表**（见输出模板），标注每个词在 Title/Bullets/Description 中的状态
4. 核对差异化卖点：每个核心卖点必须对应竞品差评、QA 顾虑或用户提供的真实卖点。
5. 运行 `scripts/validate_listing_output.py --marketplace <站点> --language <语言> <最终Markdown>` 做机械格式和合规基线检查；脚本不能替代 MCP 相似度检测。
6. [v2 新增] 核对 Title 核心大词是否出现在前 80 字符内（手机端可见性检查）。
7. [v2 新增] 核对 Description 前 300 字符是否包含核心信息和至少 1 个关键词（移动端首屏检查）。

## 输出模板

最终回答必须使用 `references/output-template.md` 的固定模块，不可删减模块。

[v2 新增] 在模板的「最终合规自检」模块中增加**关键词覆盖率矩阵表**：

| 层级 | 关键词 | 月搜索量 | Title | BP1 | BP2 | BP3 | BP4 | BP5 | Desc | S.Terms | 状态 |
|------|--------|:------:|:-----:|:---:|:---:|:---:|:---:|:---:|:----:|:-------:|:----:|
| 核心 | xxx | x | ✅ | — | ✅ | — | — | ✅ | ✅ | — | 🟢 |
| 二级 | xxx | x | — | ✅ | — | — | — | — | ✅ | — | 🟢 |
| ... | ... | ... | ... | ... | ... | ... | ... | ... | ... | ... | ... |

覆盖率汇总：核心词 X/Y | 二级词 X/Y | 长尾词 X/Y | 总计 X/Y (XX%)

若数据不足，仍保留完整模块，在对应位置写"卖家精灵 MCP 未返回该字段"，不要编造。