product-video-prompt

Product Video Prompt Generator (Pseudo-UGC Default)

把 Shopify 商品链接变成一个伪 UGC 英文视频 prompt，目标模型：Seedance（字节跳动文生视频），发布平台：海外 TikTok / Instagram Reels。

两种输出模式

模式	何时使用	风格特征
Pseudo-UGC（默认）	用户没特别要求 / 提到 UGC / TikTok / Reels / 达人 / "真实感"	第一人称 POV，对镜头讲述，手持感，生活化场景，真实质感
Brand Mode（可选）	用户明确说"品牌视频"、"高级感"、"brand"、"commercial"、"广告大片"	电影感镜头、精致场景、第三人称叙事、品牌调性

默认走 Pseudo-UGC。只有当用户明确要求品牌感时才切 Brand Mode。

两种模式的前 4 步（数据抓取、看图分析、亮点提炼、参考图选择）完全一样，区别只在 Step 5 生成 prompt 时的模板。

---

Workflow

Step 1: 获取商品数据

从用户提供的 Shopify 商品链接获取数据：

1. 提取域名和 handle：https://example.com/products/cool-shoe → example.com + cool-shoe
2. 优先 products.json：请求 https://{domain}/products/{handle}.json，成功即解析 JSON
3. Fallback：web_fetch 商品页 URL，从 HTML 提取

必需字段：title、description、images（所有 URL）、variants、price、tags、product_type、vendor。

视频资源（重要）：很多 Shopify 商品页面带有官方产品视频，通常嵌在图片 gallery 里，格式是 .mp4 文件。获取视频 URL 的方式：

• products.json 不返回视频——必须用 web_fetch 拿商品页 HTML
• 在 HTML 里搜索 cdn/shop/videos/ 或 .mp4 关键字
• 典型 URL 模式：https://{domain}/cdn/shop/videos/c/vp/{hash}/{hash}.HD-1080p-*.mp4

找到的视频要作为重要资产记录下来——它在 Step 5 生成 prompt 时可以作为 [MOTION REFERENCE] 提供给 Seedance（图生视频模式，或直接作为动作参考说明）。这对有复杂机械动作的产品（开合、折叠、变形）特别有用——参考视频比任何文字描述都准确。

如果没找到视频，记录为 "No official product video available"，不影响流程继续。

Step 2: 看图（+ 看视频）分析 — 提取硬信息

看 3-5 张关键图，必须提取：

硬信息（给全局约束用）：

• 确切颜色（"哑光黑"而不是"黑色"）
• 材质（仿皮革/网布/橡胶/金属/磨砂塑料等）
• Logo 信息（位置、颜色、内容）
• 结构部件（几条拉链、几个扣子、是否对称）
• 关键图形元素（条纹/人字纹/图案，具体位置）

叙事信息：

• 产品品类（鞋类 / 服饰 / 3C / 美妆 / 家居 / 食品 / 运动 / 包袋配饰）
• 可动部件
• 目标人群画像（年龄、性别、生活方式、兴趣）
• 使用场景

如果有产品视频，额外提取（用文字描述视频内容，不要求真的能播放视频）：

• 视频里产品如何被操作（动作顺序、节奏、方向）
• 关键变形过程的分解（比如"0-2s 拉链从 A 拉到 B"）
• 手 / 脚 / 产品的相对位置和进入画面的角度
• 操作的快慢节奏（是一气呵成还是分步停顿）

这些信息在 Step 5 写 [MOTION REFERENCE] 块时直接用，避免让模型"凭空想象"动作过程。

Step 3: 提炼商品亮点

3-5 个核心卖点。每个包含：

• 亮点名称（简短）
• 一句话描述（突出差异化）
• 英文短 tagline（后续可能变叠字或台词碎片，不超过 8 英文字）

优先级：功能性 > 视觉/设计 > 情感/场景。

Step 4: 选择 UGC 人设（仅 Pseudo-UGC 模式）