⚠️⚠️⚠️ 强制合规声明（MUST READ BEFORE EXECUTION）⚠️⚠️⚠️
你生成的 Excel 必须 100% 符合以下规格，不得有任何偏差：
硬性规格（违反任何一项 = 输出不合格）
# 规格项 要求 你必须做的 1 Sheet 数量 单 Sheet，名称 "Amazon Listing" 只能创建 1 个 Sheet 2 第1行 主标题行，合并A:F，深蓝底 #2E75B6，白字粗体14pt必须按此样式 3 第2行（可选） 署名行，如需添加则格式为 `出品方 角色描述 ，浅灰底#D9D9D9`，10pt居中4 列数 6列（A=模块, B=内容, C=关键词(A9/A10), D=场景词(COSMO/Alexa), E=中文翻译, F=规格校验） 不能是5列或4列或3列 5 模块数量 6个模块：Title(Item Name + Item Highlights) → Bullet Points×5 → Description×3段HTML → Search Terms(含备注行) → Validation Summary(16项) → 主图建议(7条) 缺一不可 6 Search Terms 备注行 Search Terms 数据行下方必须有备注行（字节数统计/排除词/新增长尾/合规检查） 不能省略 7 主图设计建议 第5个模块，7条建议（模块名+图片类型+视觉表达） 不能省略 8 Item Name 行高 80 必须设置 9 Item Highlights 行高 80 必须设置 10 颜色值 必须使用指定色值（深蓝 #2E75B6/中蓝#4472C4/浅蓝#D9E2F3/出品灰#D9D9D9/通过绿#C6EFCE）不得自选颜色 11 字符限制（v3.4.0） Item Name ≤75字符, Item Highlights ≤125字符, BP ≤500字符/条, Search Terms ≤250 bytes 脚本预检超标直接报错，不得生成不合规文件 12 F列规格校验（v3.4.0） F列字符数由脚本自动计算写入，禁止 AI 填入虚假值 脚本后校验会比对F列声明值与实际字符数，不一致直接报错 🚫 禁止行为
- ❌ 禁止 AI 自行编写 Excel 生成代码 — 必须调用
scripts/gen_listing_excel.py- ❌ 禁止猜测替代方案 — 如果无法保证以上任何一项，立即告知用户
- ❌ 禁止省略任何模块或行
- ✅ 署名行可选 — 用户明确要求时才添加，内容由用户指定，AI 不预设固定文本
- ❌ 禁止使用非指定的颜色值
- ❌ 禁止凭空编造关键词 — 关键词列(A9/A10)仅写来自第三方关键词工具 MCP 或用户提供的竞品关键词中实际出现的词，禁止 AI 联想补词
- ❌ 禁止在关键词列写入场景词 — 场景词属于 D 列(COSMO/Alexa)，C 列只放有数据来源的关键词
- ❌ 禁止在文案中写入认证信息 — CPC/DV/CE 等认证默认不写入 Listing 文案，除非用户明确要求
- ❌ 禁止竞品事实移植 — 竞品有的功能/材质/认证/年龄标注，不能直接迁移到用户产品上；所有卖点必须来自用户确认的产品事实
- ❌ 禁止BP无结构堆写 — 每条BP必须遵循 FBE 结构（Benefit Label → Feature → Benefit → Evidence），先说价值再说特点，最后用事实佐证
- ❌ 禁止填入虚假字符数（v3.4.0） — F列规格校验由脚本自动计算，AI 不得手写声明值；脚本会比对F列声明值与实际字符数，不一致直接报错
- ❌ 禁止生成超标文案（v3.4.0） — 写 Item Name/Highlights/BP/Search Terms 时必须控制字符数在限制内，脚本预检超标会直接报错不给生成
✅ 正确执行方式
Step 1: 收集完输入数据（SIF MCP 自动拆解或用户上传关键词列表），将 Listing 内容填入
scripts/gen_listing_excel.py的数据区Step 2: 执行脚本:
python scripts/gen_listing_excel.pyStep 2.5（v3.4.0新增）: 脚本先执行
pre_check_limits()预检字符数，超标直接报错不给生成。AI 必须修改文案到达标后才能继续Step 3: 脚本内置
validate_output()自动校验（含真实字符数计算 + F列声明值比对），不合格会直接报错Step 4: 将生成的 .xlsx 路径返回给用户
亚马逊 Listing 智能生成器 v3.2
基于亚马逊 A9 + A10 + COSMO + Alexa + Rufus 多算法优化的 Listing 生成工具。
核心能力
- 支持输入品牌 + 竞品 ASIN 列表，通过 SIF MCP 全自动拆解竞品数据
- 无 MCP 对接时，支持用户上传关键词列表文件
- 生成符合 2026 年 7 月标题新规的 Listing（Item Name ≤75字符 + Item Highlights ≤125字符）
- 自动校验合规黑名单，避免违规词
- 强制联网搜索近 6 个月亚马逊新规进行合规排查
- 以自然流量和链接权重为目标的最终审核优化
- 脚本强制校验：生成后自动验证格式合规性，不合规直接报错
多算法说明
| 算法 | 解决什么问题 | 核心逻辑 | 对应列 |
|---|---|---|---|
| A9/A10 | 「搜得到」 | 关键词匹配与权重分配 | C列：关键词 |
| COSMO | 「搜的人是不是对的人」 | 场景+意图理解，人群标签 | D列：场景词 |
| Alexa | 「语音搜得到」 | 口语化场景意图匹配 | D列：场景词 |
| Rufus | 「买不买你」 | 事实数据驱动，拒绝空洞描述 | B列：内容文案 |
2026 年 7 月标题新规适配
| 字段 | 上限 | 用途 |
|---|---|---|
| Item Name（商品名称） | ≤ 75 字符（含空格） | 品牌 + 核心关键词 + 关键属性 |
| Item Highlights（商品亮点） | ≤ 125 字符（含空格） | 材质/场景/人群/规格/差异化卖点 |
| 总额度 | 200 字符 | 两个字段均有搜索权重，纳入平台检索索引 |
⚠️ 2026年7月27日起，超长标题将由平台 AI 自动重写替换，品牌卖家有14天审核修改权限。
输入方式
方式一：SIF MCP 自动拆解（推荐）
用户输入：品牌 + 产品名 + 3-5 个竞品 ASIN
Agent 自动调用 SIF MCP 工具：
market_get_asin_profile— 批量查竞品基础信息market_get_asin_keyword_signals— 查竞品流量词信号market_get_keyword_demand— 查关键词需求量market_get_asin_aba_footprint— 查 ABA 搜索词market_discover_competitors— 竞品发现
方式二：用户上传关键词列表
无 SIF MCP 对接时，用户上传关键词列表文件（xlsx/csv/txt），Agent 基于用户提供的数据生成 Listing。
关键词埋入主框架
| 优先级 | 来源 | 规则 |
|---|---|---|
| P0 必须埋入 | 竞品流量占比 Top 10 | 流量占比 ≥5% → Item Name；1%-5% → BP 开头；<1% → Item Highlights 或 ST |
| P1 应该埋入 | ABA 周搜索量 Top 30 | 搜索量 ≥10,000/周 → Item Name + BP；1,000-10,000/周 → BP 为主 |
| P2 可选埋入 | 卖家主动提供的词 | 必须有数据来源才入 |
| P3 禁止 | AI 凭空补词 | 一律不允许 |
品牌词处理规则
竞品流量词中带品牌词开头的（如 lego advent calendar 2026）：
- 去掉品牌词部分，只保留非品牌词根（
advent calendar 2026） - 如果词根已存在于词表 → 去重，不重复入
- 如果是独立词根 → 正常埋入
认证信息规则
- 默认不写 CPC/DV/CE 等认证信息到 Item Name / Item Highlights / BP / ST
- 认证信息走后台属性填写
- 除非用户明确要求写入，才写入前端文案
输出内容
- Item Name (商品名称) - A9 优化，≤75字符
- Item Highlights (商品亮点) - A9 优化，≤125字符
- Bullet Points (五点描述) - Rufus + COSMO 驱动，强制 FBE 结构（Benefit Label → Feature → Benefit → Evidence）
- Description (产品描述) - 三段HTML结构（场景需求 → 产品优势 → 价值总结）
- Search Terms (后台搜索词) - 无重复、无竞品品牌
- Validation Summary (16项自动校验，含真实性质检)
- 主图设计建议 (7条)
导出格式标准（Excel）
文件命名规则
{Brand}_{Model}_{产品名}_Listing.xlsx 示例: TIMAVEX_JR070_Utensil_Holder_Listing.xlsx
Sheet 结构（单 Sheet: "Amazon Listing"）
完整行结构（约45行）
行 1 │ 主标题行 │ 合并A:F, #2E75B6深蓝底, 白字粗体14pt, 行高32 行 2 │ 【可选署名行】 │ 合并A:F, #D9D9D9浅灰底, 黑字10pt居中, 行高20（用户要求时添加） 行 3 │ 模块1标题 │ 合并A:F, #4472C4蓝底, 白字粗体11pt, 行高22 行 4 │ 表头 │ #D9E2F3浅蓝底, 黑字粗体10pt, 行高18 行 5 │ Item Name数据 │ 白底10pt, 行高80, 6列(A/B/C/D/E/F) 行 6 │ Item Highlights数据│ 白底10pt, 行高80, 6列(A/B/C/D/E/F) 行 7 │ 模块2标题 │ 同行3格式 行 8 │ 表头 │ 同行4格式 行 9-13 │ Bullet 1-5 │ 白底10pt, 行高110, 6列 行 14 │ 模块3标题 │ Description（三段HTML） 行 15 │ 表头 │ 同上 行 16-18 │ Description P1-P3 │ 白底10pt, 行高100, 6列 行 19 │ 模块4标题 │ Search Terms 行 20 │ 表头 │ 同上 行 21 │ Search Terms数据 │ 白底, 行高65 行 22 │ 备注行 │ #FFF2CC淡黄底, 斜体9pt灰色, 行高35 行 23 │ 模块5标题 │ Validation Summary 行 24 │ 表头 │ 同上 行 25-40 │ 校验汇总(16项) │ 绿底#C6EFCE=通过, 行高22 行 41 │ 模块6标题 │ 主图设计建议 行 42 │ 表头 │ 同上 行 43-49 │ 主图建议(7条) │ 白底, 行高45
【可选署名行】（第2行，用户决定）
格式: 合并A2:F2, #D9D9D9浅灰底, 10pt Calibri黑色, 居中, 细边框 行高: 20
说明: 署名行完全由用户决定是否添加，内容由用户指定。AI 仅在用户明确要求时才写入用户指定的内容。
列宽固定值
| A | B | C | D | E |
|---|---|---|---|---|
| 16 | 58 | 22 | 30 | 45 |
样式常量（供 gen_listing_excel.py 使用）
pythonC_MAIN_TITLE_BG = "2E75B6" # 深蓝 C_MAIN_TITLE_FT = "FFFFFF" # 白字 C_MODULE_BG = "4472C4" # 中蓝 C_HEADER_BG = "D9E2F3" # 浅蓝 C_HEADER_FT = "000000" # 黑字 C_BRAND_BG = "D9D9D9" # 可选署名行背景色（如用户添加） C_PASS_BG = "C6EFCE" # 校验通过行背景 C_PASS_FT = "276221" # 校验通过绿色字 C_BORDER = "B4C6E7" # 边框线色
质量标准
每个输出模块通过三重校验：
- ✅ A9 合规: 核心词在 Item Name 出现，五点覆盖长尾词
- ✅ COSMO 合规: 明确人群词 + 场景词
- ✅ Rufus 合规: 所有卖点有数据/事实支撑，无空洞形容词
- ✅ 合规黑名单: 未出现违禁词
- ✅ 格式合规: 脚本 validate_output() 自动校验 6模块 6列结构
- ✅ 中英同步: 英文内容修改时中文翻译必须同步，标点/句式不一致直接报错
- ✅ 真实性: 禁止竞品事实移植，所有卖点必须来自用户确认的产品事实
- ✅ FBE结构: 每条BP按 Benefit Label → Feature → Benefit → Evidence 逻辑组织
- ✅ Description: 三段HTML（场景-功能-价值），使用 Amazon 可用简单 HTML 标签
使用方式
直接告诉我你的产品是什么 + 3-5 个竞品 ASIN，我会全自动拆解竞品并生成 Listing。
示例:
"帮我生成 THKVESN BGL091 降临节日历的 Listing，竞品 ASIN：B0FBW9NQJT"
详细交互流程见 AGENTS.md，生成 Prompt 见 prompts/generate_listing.md。
导出工具依赖
- Python 3.x
- openpyxl 库 (
pip install openpyxl) - 导出脚本使用 UTF-8 编码，Windows 环境需注意路径处理
版本历史
| 版本 | 日期 | 变更 |
|---|---|---|
| 1.0.0 | 2026-04-27 | 初始版本 |
| 1.1.0 | 2026-04-29 | 添加可选署名行、Excel格式框架 |
| 2.0.0 | 2026-04-29 | 加强制合规声明 + 脚本校验 + 禁止AI自编代码 |
| 3.0.0 | 2026-08-17 | 标题新规适配(Item Name 75字符+Item Highlights 125字符) + SIF MCP全自动拆解 + 关键词埋入主框架 + 认证信息默认不写 + 强制联网合规排查 + 自然流量权重最终审核 |
| 3.1.0 | 2026-08-19 | Excel 列名全局统一(模块/内容/场景-关键词/中文翻译/规格校验) + 删除空白行 + 脚本结构写死 + validate_output 强化(13项校验/7条主图) |
| 3.2.0 | 2026-08-20 | 关键词/场景词分列(C=关键词A9/A10, D=场景词COSMO/Alexa) + 6列结构 + 新增Alexa算法 + 关键词列禁止AI联想 + 校验增加关键词非空检查 |
| 3.2.1 | 2026-08-20 | 新增中英同步校验(标点/句式不一致报错) + BP标点合规(无结尾.!?) + 中文翻译同步标点修正 + 校验增至11项 |
| 3.4.0 | 2026-08-21 | 真实字符校验: pre_check_limits() 写Excel前预检 + validate_output() F列声明值比对 + VALIDATION自动计算 + 禁止AI填假值 |
| 3.3.0 | 2026-08-20 | 新增Description模块(三段HTML) + BP强制FBE结构 + 真实性质检(竞品事实移植检测) + 竞品文案结构拆解 + 校验增至13项/Validation16项 |
