1688 直播口播稿生成器
Overview
把 1688 商品详情页（一个或多个链接）转化为可直接用于直播带货的口播稿，并为每一个商品输出一份独立的 Word 文档。
每份口播稿默认包含以下必备模块：
- 开场钩子（3 秒留人）
- 产品 FAB 介绍（Feature 属性 / Advantage 优势 / Benefit 利益，表格化）
- 价格优势（对比市场价、起批量门槛、利润空间）
- 使用场景
- 顾客常见提问（FAQ，含质量/发货/退换/尺寸/材质/起批量等高频异议）
- 逼单促单话术
- 结尾 CTA（关注 + 下单引导）
- 主播备注（加粗提示，便于临场看稿）
支持批量：用户一次发送 N 个链接，就产出 N 份互不干扰的 .docx。
When to use
- 用户粘贴
https://detail.1688.com/offer/xxxxxxxxxx.html之类的 1688 商品链接。 - 用户表述包含：口播稿、直播稿、带货稿、直播话术、直播脚本、主播稿、卖点话术。
- 用户一次给多个链接并要求"每个都生成一份"。
- 用户要求把商品资料整理成可念的直播文案。
不触发：纯图片生成、非 1688 的电商链接（淘宝/拼多多详情页可尝试但需调整抓取提示）、与直播无关的文档写作。
Workflow
Step 1 — 收集并归一化链接
- 从用户消息中解析出所有形如
detail.1688.com/offer/...的 URL。 - 统计数量
N，按顺序编号01, 02, …，告知用户"识别到 N 个商品，将分别生成 N 份口播稿"。 - 若未识别到任何链接，直接询问用户要处理的 1688 商品链接。
Step 2 — 逐个抓取商品数据
对每个链接执行：
- 优先用 WebFetch（最省 token）。使用如下抓取提示（按需微调）：
抓取提示（按需微调）：Extract all product information for a live-streaming sales script: exact title, price (starting price and price range if any), MOQ (minimum order quantity), material, brand, sizes/specs, all color/style variants, weight, key features/functions, applicable scenarios, packaging, ship-from location, and any sales/rating hints. Return a concise structured list in Chinese.
-
若 WebFetch 返回内容过薄或明显是 JS 渲染页面（如只拿到标题和无关说明），改用
agent-browser技能打开链接、截取商品属性区与详情区文字，再提取上述字段。 -
记录字段到内存，准备进入写作。缺失字段（如价格未显示）时，在稿中标注"价格以店铺实时为准"，不要编造精确数字。
抓取字段建议清单（用于填充稿件的 meta 信息框）：
标题 / 价格 / 起批量 / 材质 / 品牌 / 规格尺寸 / 颜色款式 / 重量 / 发货地。
Step 3 — 撰写口播稿内容
- 加载
references/script-template.md作为结构与话术范本。 - 加载
references/faq-bank.md作为常见顾客提问的素材库，按商品类目挑选 5–8 条最贴合的 Q&A。 - 严格按模板的八个模块撰写，FAB 必须写成"属性→优势→利益"三栏逻辑，避免只罗列参数。
- 价格优势要给出"对比逻辑"（如：同款零售价 X，这里批发价 Y，单件利润 Z），即便具体数字缺失也要给出话术框架。
- 口播风格：口语化、有节奏、能直接念；适当加入"家人们""姐妹们""工厂直供"等直播间常用语气（可按用户偏好调整）。
Step 4 — 渲染为独立 Word 文档
对每个商品，将撰写好的内容整理成一份 JSON（结构见下），调用脚本生成 .docx：
python "SKILL_DIR/scripts/generate_script_docx.py" 商品.json 商品.docx
SKILL_DIR为本技能目录（运行时通过技能上下文获取绝对路径）。- 脚本会自动安装
python-docx（若当前 Python 缺失），使用任意 Python 3 解释器即可。 - 每个商品对应一个 JSON 与一个 .docx，文件命名：
01_小熊帆布包.docx、02_行李箱.docx（序号 + 商品核心词，去掉非法文件名字符）。 - 所有 .docx 统一保存到当前工作区的结果目录（如
./直播口播稿/），便于一次性交付。
JSON 结构（脚本输入）：
{
"index": 1,
"title": "新款小熊帆布包女学生便携上班小号手拎便当包",
"url": "https://detail.1688.com/offer/841897402953.html",
"meta": {
"price": "¥1.44 起",
"moq": "2 件",
"material": "帆布",
"brand": "向槐",
"specs": "27*22*8cm / 32*34*10cm",
"colors": "摆动作熊、三只笑脸熊、可爱小狗…",
"ship_from": "浙江"
},
"sections": {
"开场钩子": "……",
"产品FAB": [
{"feature": "加厚帆布", "advantage": "耐磨不起球", "benefit": "天天用也不显旧，性价比拉满"},
{"feature": "磁吸锁扣", "advantage": "一秒开合", "benefit": "单手拿取，通勤更顺手"}
],
"价格优势": "……",
"使用场景": "……",
"顾客常见提问": [
{"q": "这个包能装下 iPad 吗？", "a": "……"},
{"q": "起批量是多少？一件能发吗？", "a": "……"}
],
"逼单促单": "……",
"结尾CTA": "……",
"主播备注": "念到价格时停顿看镜头；FAB 三栏可逐条指商品展示。"
}
}
注：meta、主播备注、顾客常见提问 等字段若某商品不适用可省略；脚本对缺失字段做了兜底，不会报错。
Step 5 — 交付
- 全部生成后，用
present_files一次性展示所有 .docx 供用户下载/预览。 - 附带一句总览：共 N 个商品，分别是什么，命名规则，以及若需调整语气/类目可继续说。
Output conventions
- 一份商品 = 一份 .docx，互不合并。
- 文件名：
{两位序号}_{商品核心词}.docx。 - 文档内：标题居中大号；meta 信息以表格置顶；FAB 为三栏表格；FAQ 为"问（加粗）+ 答"块；主播备注用浅色底纹块突出。
- 中文排版：正文字号 11，标题 14–16，行距 1.5，段前段后留白。
Edge cases
- 价格/起批量未显示：话术中写"价格以店铺实时活动价为准"，并给出利润空间的话术框架，绝不虚构精确数字。
- 多款式多 SKU：在 meta 的"颜色款式/规格尺寸"中列要点，FAB 聚焦主推款，FAQ 补充"能不能混批/指定款式"。
- 抓取失败：WebFetch 不行就换 agent-browser，仍失败则告知用户该链接无法解析并跳过，继续处理其余链接。
- 用户要改风格：语气、长度、是否含主播备注都可在生成前或生成后按用户反馈调整，再重跑脚本。
Resources
scripts/generate_script_docx.py— 把上述 JSON 渲染为排版好的独立 .docx。references/script-template.md— 八模块口播稿结构与话术范本（撰写时对照）。references/faq-bank.md— 按类目归档的高频顾客提问与应答素材库。
