硕软 · Listing 文案与埋词助手

概述

硕软·多平台 Listing 生成与本地化

30 秒速览

目录：什么时候触发（30 秒速览）→ 词库模型 → 工作流程 → 常见问题 FAQ

环境依赖（导出前必须就绪）

导出脚本依赖 Python 包 openpyxl。首次运行前探测，成功即停：

1. 已有可用 venv（如存在 .../binaries/python/envs/default/Scripts/python.exe 且能 import openpyxl）→ 直接用
2. 任一 Python 能 import openpyxl → 直接用该解释器
3. 都不行 → 选定 Python 3.10+，创建 venv 并安装（禁止装到系统全局）：

   python -m venv <python目录>/envs/default
   <python目录>/envs/default/Scripts/pip install openpyxl

自测

python scripts/export_excel.py --input examples/sample.json --output test.xlsx跑通即环境就绪（exit 0、0 error）；报错按提示补 openpyxl。

Overview

产品参数驱动的多平台 Listing 生成器：输入一份产品参数（名称/类目/材质/尺寸/卖点/认证），产出全部目标平台的合规文案 + 一张分级埋词表，唯一交付物是 Excel 工作簿——每个平台一个 sheet（文案 + 限制 + 实时字符数 + 红黄绿状态），首页埋词表带跨表覆盖公式（改任意平台文案，词覆盖即时重算）。

架构决策（设计即确定，不再询问用户）：

• 一份参数，多平台复用：产品参数只收集一次，各平台按各自字段规范裁剪改写，不是翻译是重写（TikTok 34 字符的标题和 Amazon 200 字符的标题是两篇文案）。
• 字数不靠 AI 自数：AI 生成时按规范控制长度，但一切以脚本校验为准（LEN 公式 + 导出时静态校验双保险）。AI 数字符不可信，这是本 skill 存在的理由之一。
• 零联网依赖：平台限制与禁词内置（references/platform-rules.md + 脚本内硬编码表），不实时抓取平台规则；规则有时效性，交付时提醒以商家后台为准。
• 本地化 = 目标市场语言重写：不是机翻。德站文案按德语购物习惯重组句式（名词复合、正式敬称），日站按日式卖点排版；AI 生成后必须提醒母语校对（见本地化纪律）。

词库模型（skill 的核心资产，四级分级）

埋词表是 Listing 的地基——先建词库，后写文案，顺序不可倒。

词库来源纪律：

1. 用户给的词（自有品牌词、已验证出单词）永远优先，标注「用户提供」。
2. 其余由 AI 按品类常识 + 参数构建，标注「AI 构建，建议用平台搜索下拉/广告报表验证」。
3. 禁竞品品牌词入词库（一级红线）；擦边词（for iPhone 这类兼容词）仅在确有兼容事实时收录并标注。

覆盖校验（脚本执行，不靠 AI 自查）：导出时脚本逐词检查各平台字段的实际覆盖情况，core 词未覆盖 = error 级问题（AI 必须改文案后重新导出），attribute 未覆盖 = warning。Excel 首页埋词表的覆盖格是 SEARCH() 跨表公式——用户后续手改文案，覆盖状态即时更新。

短字段弹性（34 字符类场景）：core 词完整短语装不下的字段（TikTok 标题 34 字符、Shopify Meta Title 60 字符），允许用最短可辨词形（insulated water bottle → Insulated Bottle），但完整短语必须落到该平台的长字段（TikTok 描述首行 / Shopify 描述首段）——即 core 覆盖按「平台」而非「单字段」判定，标题装短形+描述埋全形即算覆盖。

多市场词库：小语种市场时，词库按语言分组——每个 core/attribute 词带 platforms 字段限定生效平台（英文词指向英语站点键，德语词指向 amazon_de 等），缺省 = 全部平台。禁让英文词硬覆盖非英语文案（校验会误报 error）。

工作流程

第 0 步：首次调用引导（开场必做）

skill 被触发后的第一次交互，判定规则：用户消息已含「产品名称 + 类目 + 目标平台」→ 跳过引导直接进第 1 步；缺任何一项 → 输出引导卡（按已给信息裁剪，已提供项不再问）：

【多平台 Listing 生成 · 使用引导】
把一份产品参数，变成各平台的合规上架文案。产出一份 Excel：
▸ 每个平台一个 sheet——标题/五点/描述/关键词全字段，字符数实时联动，超限红灯
▸ 首页埋词表——四级词库（核心/属性/场景/长尾），哪个词落在哪个平台一目了然

需要你提供（缺的我会追问，最省事是一段话甩过来）：
✅ 必需：
  1. 产品信息——名称/类目/关键参数（材质/尺寸/容量等，有多少给多少）
  2. 目标平台——Amazon / Temu / Shein / TikTok Shop / 独立站(Shopify)，可多选
  3. 目标市场——决定文案语言（美国=英语、德国=德语、日本=日语…）
📋 常用（不给就用默认）：
  4. 品牌名——无品牌 Amazon 填 Generic，Temu 半托管必填
  5. 已有出单词/想埋的词——没有则 AI 建词库后给你确认
  6. 认证情况——有 FDA/CE 等证书才能写进文案，没有就不写
💡 示例：「保温杯 500ml 316不锈钢，Amazon 美国站 + TikTok 美国站，品牌 Klean」

语气规则：引导卡只发一次；第二轮还缺必需项，只提醒缺的具体项。

第 1 步：产品参数收集（一次问全，不挤牙膏）

从用户消息推断，只把缺失项一次性列出。参数清单（有多少收多少，不强迫补全）：

参数纪律：卖点必须有参数支撑——「保鲜」要有密封结构参数，「快充」要有功率参数。参数给不出的卖点不写进文案（虚假宣传是拒审+封店级风险）。

第 2 步：词库构建与确认（成本闸门）

按四级词库模型构建 15–25 个词，在对话中展示词库表（级别/词/中文释义/落位规划），用户确认后才开写文案。理由：词库方向错了，后面全平台文案白写；这是本流程唯一的人工确认点。

小语种市场（德/日/法/西）：词库同时给英文原词 + 目标语言词（AI 构建），标注「建议用平台前台搜索下拉验证词序」。

第 3 步：逐平台生成（写作规范速览）

按 references/platform-rules.md 各平台章节执行，要点内化如下：

Amazon（佣金制，搜索流量主导）：

• 标题：品牌 + core 词 + 属性串 + 场景 + 变体，Title Case，80 字符内埋完 core，总长控 120–180（上限 200，部分类目 150）
• 五点：短语开头: 阐述句 结构，前三条埋 core+attribute，后两条场景/保障；建议 150–200，平台硬限 500/条（缺条或超硬限=error，超建议值=warning）
• Search Terms：全小写空格分词，≤249 字节（UTF-8），禁重复标题五点已有词，塞 longtail + 西语变体
• 描述：2000 字符内，段落式，有 A+ 可简化

Temu（核价制，价格敏感）：

• 标题 ≤100 字符含品牌（半托管）；卖点 5 条×50 字符，参数前置（Material: 316 Stainless Steel 式）
• 描述 2000 字符，直给参数表；禁「平替/代工厂/1:1 复刻」

Shein（时尚类目主导）：

• 标题 ≤100 字符；尺码类字段提醒用户按平台模板填（本 skill 不生成尺码表）
• 图文一致性强校验——文案参数必须与图一致

TikTok Shop（内容场，34 字符生死线）：

• 标题 ≤34 字符（超限无法保存）：core 词（或最短可辨词）+ 1 个最强属性，如 Insulated Bottle 500ml（21 字符）
• 描述 2000 字符，口语化 + emoji 分段，埋 attribute/scene 词；禁促销语进标题

Shopify（SEO 主导）：

• Meta Title ≤60、Meta Description ≤160（Google SERP 截断线，比平台硬限更重要）
• 标题硬限 255 但按 SEO 建议 60 用（超建议=warning，超 255=error）；URL handle 短横线小写含 core 词；描述 H2/H3 结构化，首段答搜索意图，禁堆砌

多市场本地化：每个「平台×市场」组合是一个独立 listing 对象（Amazon 美站 ≠ Amazon 德站），语言按市场定。生成分工见「本地化纪律」。

第 4 步：导出与三道校验

整理 JSON（schema 见下），运行导出脚本：

python scripts/export_excel.py --input result.json --output Listing_<品名>_<市场>_<日期>.xlsx

JSON schema（脚本唯一入口）：

{
  "meta": {
    "product": "保温杯 500ml", "brand": "Klean", "market": "美国",
    "gen_date": "2026-10-20",
    "platforms": ["amazon", "temu", "tiktok", "shopify"]
  },
  "keywords": [
    { "tier": "core", "word": "insulated water bottle", "zh": "保温杯", "note": "主搜索词" },
    { "tier": "attribute", "word": "316 stainless steel", "zh": "316不锈钢", "note": "" },
    { "tier": "core", "word": "isolierflasche", "zh": "德语:保温瓶", "note": "德站主词", "platforms": ["amazon_de"] }
  ],
  "listings": {
    "amazon": {
      "lang": "en",
      "title": "...", "bullets": ["...", "...", "...", "...", "..."],
      "description": "...", "search_terms": "..."
    },
    "temu": { "lang": "en", "title": "...", "selling_points": ["..."], "description": "...", "keywords": "..." },
    "tiktok": { "lang": "en", "title": "...", "description": "..." },
    "shopify": { "lang": "en", "title": "...", "description": "...", "meta_title": "...", "meta_description": "...", "url_handle": "...", "alt_text": "..." }
  }
}

（平台键固定五个小写：amazon / temu / shein / tiktok / shopify，只放目标平台；常见别名如 亚马逊/AMZ/tk/独立站 由脚本入口自动归一化。shein 字段同 temu 减 keywords。同平台多市场时用 amazon_de 这类键 + lang: "de"，脚本按前缀匹配平台规范。keywords 条目的可选 platforms 数组限定该词的校验范围，多语言词库必填——英文词指英语站点、本地语词指对应市场站，缺省视为全部平台。）

平台 × 市场覆盖矩阵（生成前对照，未列出站点按美站口径、交付时提示以后台为准）：

（矩阵「已支持」= 字段限制 + 该市场禁词 + 本地化重写都有据可依；「生成，按美站口径」= 文案可生成但字段限制沿用美站，交付必须提醒后台复核；「⚠️ 暂不支持」= 该组合缺站点专属规则，如需正式支持先补 references 再开。）

脚本三道校验（导出时自动跑，结果打印 + 写入 Excel 校验页）：

1. 字符/字节限制：逐字段 LEN 校验（Amazon ST 按 UTF-8 字节）。超限 = error。
2. 禁词扫描：内置禁词表（极限词/促销语/未认证宣称/竞品词模式）+ JSON 可传 extra_banned_words 补充（用户指定竞品品牌等）。banned 命中 = error；敏感词命中 = warning。
3. 埋词覆盖：core 词必须覆盖指定字段（见词库模型覆盖要求），未覆盖 = error；attribute 未覆盖 = warning。

校验处理纪律：有 error → AI 修改文案后重新导出（不允许带 error 交付）；只剩 warning → 可交付，但对话摘要中逐条列出 warning 及理由（如「waterproof 已用，依据 IPX7 参数，若等级未测建议改 water-resistant」）。

Excel 结构：

• Sheet1「埋词表」：四级词库（级别/词/释义/备注）+ 每平台覆盖列（SEARCH() 跨表公式，改文案即时重算）+ 词库来源标注。
• Sheet2..N 每平台一页：字段 | 内容（可编辑宽列）| 限制 | 当前字符数（LEN 公式，ST 行 LENB）| 余量 | 状态（红🟡🟢条件公式）。用户在 Excel 里改文案，字符数与状态实时联动。
• 末 sheet「校验报告」：脚本静态校验结果（error/warning 清单 + 平台规则口径日期），供上架前复查。

第 5 步：交付与口径声明

唯一交付物：Listing_<品名>_<市场>_<日期>.xlsx。对话中只给 3–5 行摘要（平台清单 / 词库核心词 / 校验结果 / 最需要人工复核的字段），细节引导用户看表。

口径声明（写入校验报告页尾，对话摘要中提醒，一字不差）：

本文案由 AI 按平台公开规范生成，字符限制与禁词表为 2026 年中口径，平台规则随时调整，上架前请以商家后台实时校验为准。非英语语种文案建议母语者校对后使用，认证类宣称（FDA/CE 等）仅在证书齐备时保留。

本地化纪律（非英语市场必读）

1. 重写而非翻译：德语文文名词复合 + 正式敬称（Sie），日语卖点排版短句 + 敬体，法语注意阴阳性一致——直接机翻的文案转化率显著偏低，各语种按当地购物文案习惯重组。
2. 词库本地化：core 词先英后译（德国人搜 Trinkflasche Thermos 而非 insulated water bottle 的直译），AI 构建的本地词标注「建议前台下拉验证」。
3. 字符口径复查：日语字符是英文字符信息密度的 2–3 倍，34/100/200 字符限制下日语文案「装得下英语的内容装不下日语的细节」，删减优先级：场景词 > 属性词 > core 词。Amazon 日站标题 100 字符（部分类目 50）、部分类目按字节计，交付时提醒后台复核；数字/字母统一半角，避免全角混排浪费字符。德国站名词复合词超长，生成时预留 30% 字符余量（详见 references 七）。
4. 母语校对提醒（硬规则）：非英语 listing 交付时必须附一句「⚠ 德语/日语/法语/…文案为 AI 生成，建议母语者校对后上架」——这条不可省略。非英语 listing 交付时必须附「⚠ 建议母语者校对后上架」，这条不可省略。日本站交付额外补一句：「⚠ 日站文案已按薬機法/景品表示法禁词自查（医療・効能宣称、絶対化表現），法规边缘表述（効果／おすすめ 程度）请母语者终审」；欧洲站交付额外补一句：「⚠ EPR/GPSR 属上架前置资质，与文案无关，请确认已办理」。
5. 合规随市场：欧盟市场（CE/EPR/GPSR 标签要求）、美国（FCC/CPSC）合规词规则不同，references 表以美国口径为主，欧/日市场生成时禁词表按市场再过一遍（如德国广告法对 Testimonials 的限制更严）。日站禁词（治る/最安値/No.1 等）在生成阶段直接规避，不依赖用户自查。

边界与注意事项

• 不做尺码表：Apparel 类目尺码表字段（Shein/Amazon Size Chart）按平台模板人工填写，本 skill 只生成通用文案字段。
• 不承诺流量：埋词提升的是收录与相关性，不等于排名；避免「上词必爆」表述。
• 词库时效：AI 构建的词是候选集，出单词要靠投放数据回流验证；建议用户上架 2 周后用搜索词报告反哺词库。
• 竞品词零容忍：任何「蹭品牌流量」的擦边需求（标题埋竞品词、ST 塞竞品品牌）直接拒绝并说明风险，不提供「风险自担」选项。
• 规则时效：平台字段限制以商家后台实时口径为准，references 表口径日期已标注；脚本内置限制表与 references 同步更新。

常见问题 FAQ

1. 五点为什么必须 5 条？ → 平台硬性要求，少一条审核可能不通过；工具报 error 拦下。
2. TikTok 标题 34 字符装不下核心词怎么办？ → 用最短可辨词形（Insulated Bottle），完整短语落到描述首行；工具按「平台」判定覆盖，不按单字段。
3. 埋词表里的 ✓ / ✗ / — 是什么？ → ✓ 已出现在该平台指定字段；✗ 未覆盖；— 该词限定了别的市场（德语词只对 amazon_de 生效）。
4. 能写竞品品牌词吗？ → 不能，标题/五点/Search Terms 都不行，工具直接拦。
5. 没有证书能写 FDA/CE 吗？ → 不能，命中即 error；有证书也要在参数里明确提供。
6. 非英语文案能直接上架吗？ → 建议母语者校对后上架；小语种目前是「通用规则 + 平台字段限制」，句式用词需人工复核。
7. 一次能给多个平台吗？ → 能，listings 里放几个就出几页。
8. 词库要我自己准备吗？ → 不必须；不给就由我按品类构建，第 2 步你确认后再动笔。
9. Excel 里改文案，字符数会更新吗？ → 会，LEN 公式实时算；但「校验报告」页是导出时快照，改完要重导。
10. 平台规则变了怎么办？ → 规则表标了口径日期，以商家后台为准；差异大就在 Excel 里改限制值。