定位:在《报告生产配方库 v1.0》之上,补一层「可直接调用」的统一提示词体系,并把素材/视频做成可反复调用的服务。
关系:配方库管「报告长什么样」,本文件管「怎么把报告要出来、怎么把视频用起来」。 章节模板、矩阵规范、配色与检查清单不重复写,直接引用配方库(下文用配方库 §8.1这类编号指向)。
数据红线:只使用有米有数(mcp_youshu-mcp_*与@skill:youclaw);禁止 appgrowing、蝉妈妈、飞瓜等任何其他来源。外部行情/气候/政策只能作为「外部变量」单独成章,逐条标来源与时间。
版本:v2.0 | 2026-11-18 | 标记说明:【升级】 = 相对配方库 v1.0 新增;【引用】 = 不重复,直接看配方库。
阅读提示:表格可左右滑动查看完整列;目录可展开 / 收起。
| 起手式 | 你发什么 | 什么时候用 | 产物 |
|---|---|---|---|
| A 全量 | 总控提示词(第 3 章) | 新报告、要求高、要一次到位 | 完整报告 + 素材库 |
| B 标准 | 总控 + 一条子指令 R1–R6(第 4 章) | 日常工作,最推荐 | 完整报告 |
| C 快速 | 只发一条子指令 | 小报告、补做、试跑 | 简化报告(子指令内含默认值) |
| D 追加 | 报告完成后发「模块指令」(第 2/5 章) | 补视频拆解、补话术、补画面 | 在原报告上增章/换章 |
按总控做一份 R1《{品类} · 人群×卖点竞争策略矩阵》,近30天,覆盖{品牌A/B/C},要矩阵抽屉和素材链接,做完 pagepub 发布。| 编号 | 工具 | 拿到什么 | 必填参数 | 硬约束 |
|---|---|---|---|---|
| M1 | searchBrands | 品牌候选 ID/名称/别名 | keyword, page | 同名需二次判定 |
| M2 | filterOptions | 品类/素材类型/时长/比例/人群/推广类型等 id | 无 | 整任务只取一次,复用 |
| M3 | searchMaterials | 素材清单 + 曝光/互动/质量分/关联广告/商品/达人 ID | startDate, endDate, page, order | 单页 1–200;跨度 ≤180 天;最早 730 天 |
| M4 | creativeAsr | 视频口播/旁白文本 | materialIds | ≤100 个/次;无效 ID 不返回 |
| M5 | creativeAIAnalysisData | 画面/台词提取的卖点标签 | materialIds | ≤100 个/次;只给 sellPoint |
| M6 | materialCreativeList | 素材关联广告(文案/平台/起止/天数/广告 ID) | materialId, startDate, endDate, sort, page | 跨度 ≤90 天;最早 180 天 |
| M7 | 控制台链接(非工具) | 原片回看 | 完整素材 ID | console.youshu.youcloud.com/material/{ID}/overview |
| M8 | searchKols / kolBaseInfo | 达人 UID/昵称/粉丝/关联店铺 | media=20, keyword / ccUid | 同名必须核对粉丝与店铺 |
| M9 | productSalesRanking | 抖店商品销量榜 | 时间、排序 | 用于 SPU/主推品口径 |
| M10 | getMcpChunk | 大结果分块 | cursor=nextChunk | 必须循环到 hasMore=false |
能力边界(写提示词时必须知道)
poster、宽高、时长;原片回看靠控制台链接。creativeAIAnalysisData 只给卖点标签,不含景别/运镜/光线/人物/道具;镜头级拆解只能来自 youclaw 的「画面理解」追问,或本地截帧后人眼看。impression_inc_2y 是累计总曝光(字段名带 _inc_2y),不是当前窗口内的曝光。报告里只能写「累计曝光」,或改用互动数据。creativeResourceUrl(封面下载)不属于有米有数口径,禁止使用。锁对象 → 拉素材 → 取 ASR/卖点 → 量投放强度 → (需要时)达人 → 拼 ID 回看 → 建素材库对应工具顺序:searchBrands / filterOptions → searchMaterials(+getMcpChunk)→ creativeAsr / creativeAIAnalysisData → materialCreativeList → searchKols / kolBaseInfo → 控制台链接 → 本地目录 + catalog。
执行铁律
searchBrands 拿 brandId,品类必须 filterOptions 拿 category;不许凭名称猜。total 耗尽;出现 _chunk.hasMore=true 必须取完再统计。id 回填素材池,统计覆盖率。每条固定六项:放在哪 / 必带参数 / 句式(可抄) / 落章 / 口径 / 兜底。
这些模块既可以单独发,也可以被第 3 章总控提示词按编号引用。
「先调用 searchBrands,keyword=「{品牌名}」,page=1;返回多个候选时,列出 id/name/nickname/description,按 {官方旗舰店/主营类目/你确认的主体} 选定,并把 brandId 与判定依据写进页首口径区。再用 productSalesRanking 取该品牌近 {30} 天销量 TOP{5} 商品,作为本次 SPU 清单。」
「调用一次 filterOptions,取 category 中与「{品类}」匹配的 id;同时取 mtype=视频、videoTime={15–30s/30–60s}、ratios=竖版的 id。整次任务只调用一次,后续全部复用,不得重复取。」
「调用 searchMaterials:startDate={}、endDate={}、brandId={}、category={}、mtype={视频}、order={按曝光降序}、page=1、limit=200;逐页取到累计 ≥{目标量} 或 total 耗尽。每页保留:id、slogan、lines、duration、impression_inc_2y、material_score、firstTime/lastTime、cnt_ad_id、socialInfo、cc_uids、brandIds、categoryIds、resource。跨品类/颜色词/同音词按「{去噪规则}」剔除,并记录剔除条数。」
<id>-<type>,原样透传);批次 ≤100。「对素材池中 {N} 条视频,按每批 ≤100 个 materialId 调用 creativeAsr;返回按 id 对齐素材池,统计有 ASR 的条数与覆盖率。无返回的素材标 asr_status=missing,不得用标题或 slogan 冒充口播。」
「批量调用 creativeAIAnalysisData 取每条素材的 sellPoint;把标签归一为 {6–8} 个卖点轴(同义合并,原标签保留在明细);再用 material_score 分层:≥80 高 / 60–79 中 / <60 低。说明这是平台质量指数,不是投放效果承诺。」
sellpoint_source=manual;标签过于碎 → 先出「原始标签频次表」再合并。「对入选的 {20–30} 条代表素材调用 materialCreativeList,取关联广告数 total、投放起止、投放天数 duration、广告文案 slogan、流量平台 channel;与素材表的 cnt_ad_id 交叉核对,判断「素材少但广告多」的堆量型投放。」
202)。「所有代表素材保留完整 ID,渲染为 https://console.youshu.youcloud.com/material/{ID}/overview,显示文本用「前 8 位…-202 ↗」。素材卡展示时长、比例(宽高)、封面、累计曝光、关联广告数;缺失 ID 的素材不展示。禁止使用 appgrowing 的 creativeResourceUrl。」
「先 searchKols(media=20,keyword=「{达人名/抖音号}」)取 uid;同名账号必须用 kolBaseInfo 核对粉丝数与关联店铺后再定;再用 searchMaterials(uid=...) 拉该达人近 {30} 天素材,统计条数、累计曝光、主卖点、口播首句。」
cc_uids 反查;仍无 → 该维度不写。「先统计有多少条素材带画面标注(N/总数、覆盖率 X%)。画面结论只基于这 N 条;其余只做「口播+卖点」结构描述。若 N<10 或覆盖率<10%,本章标题改为「口播与卖点结构」,不得写『画面演绎』。」
「searchMaterials 按 page=1..N 翻页,直到累计 ≥ 目标或 page > ceil(total/limit);若响应含 _chunk.hasMore=true,必须用 getMcpChunk 传 nextChunk 循环取完,按 chunkIndex 合并后再统计。禁止只看第一块就下结论;不要用重新调用原工具替代翻块。」
MCP_CHUNK_EXPIRED → 重调原工具拿新 cursor;仍失败 → 降级为「前 N 页抽样」,并在页首注明。用法:整段复制,替换 {};如需视频服务,把第四段改成对应 V 编号;不需要的段可删,但口径段与交付段不能删。你是我的「报告生产总控」。本次只使用有米有数数据(mcp_youshu-mcp_* 与 @skill:youclaw),
禁止 appgrowing、蝉妈妈、飞瓜等任何其他来源;外部证据只能单独标来源,不得混入素材结论。
【一、对象与范围】
分析对象:{品牌名 / 品类名 / 材质 / 成分 / 赛道}
对象类型:{品牌 / 品类 / 材质 / 成分 / 赛道}
覆盖范围:{品牌列表 或 细分 SPU/子品类}
平台:抖音
时间窗:{YYYY-MM-DD ~ YYYY-MM-DD}
样本目标:{≥1000 条;品类模式为品类整体,且覆盖 TOP 3-5 品牌}
重点品牌/SPU:{...}
【二、报告类型与结构】
报告类型:R{1-6}(类目矩阵 / 材质渗透 / 趋势深挖 / 爆款拆解 / 季节外部变量 / 单品牌)
章节模板:严格执行《报告生产配方库 v1.0》§{8.1-8.6},不增删主章;确需增章先说明理由。
分析轴:{人群×卖点 / 人群×场景 / 场景×卖点}
人群数 {8-10};卖点/场景数 {6-8};核心交叉点 {8-12} 个。
五段式:停/病/药/信/买,每段 1-2 句,尽量引用素材原话。
证据分级:{A 素材/B 外部/C 待验证 或 L1 元数据/L2 画面/L3 细节}。
【三、取数流水线(按序执行,不得跳步)】
1) 锁对象:searchBrands(keyword) 取 brandId;多候选时列出候选与选择依据;
品类用 filterOptions 取 category id(整任务只调一次,后续复用)。
2) 拉素材:searchMaterials(startDate,endDate,brandId/category/keyword,mtype=视频,
order=按曝光降序,page=1,limit=200),逐页取满目标量或 total 耗尽;
出现 _chunk.hasMore=true 必须用 getMcpChunk 取完再统计。
去噪规则:{跨品类/颜色词/同音词/其他},并记录剔除条数。
3) 转写与卖点:按每批 ≤100 个 materialId 调 creativeAsr 与 creativeAIAnalysisData;
按 id 回填素材池,统计 ASR 覆盖率与卖点覆盖率。
4) 强度:对代表素材调 materialCreativeList(≤90 天/次)核对关联广告数与投放天数。
5) 达人(如需要):searchKols(media=20) → kolBaseInfo 核对 → searchMaterials(uid)。
6) 回看:所有代表素材完整 ID(32位hex-202)→ console.youshu.youcloud.com/material/{ID}/overview。
【四、视频服务(按需)】
调用【视频服务模块 {V0/V1/V2/V3/V4/V5/V6/VALL}】,参数块见任务附带的 JSON;
拆解深度 {L1 元数据 / L2 口播+卖点 / L3 截帧+镜头};留存根目录 {路径}。
未指定则 V0(不下载、不截帧,只用 ASR+卖点标签)。
【五、口径(必须写在页首)】
- 目标 / 实际 / 有效 三级样本量 + 分母;
- 去噪规则与剔除条数;
- 多标签不互斥、不可加总;
- 素材未出现的场景/时段/画面一律写「未覆盖」,禁止经验补全;
- impression_inc_2y 为累计口径,不得写成「近30天曝光」;
- 画面结论仅基于 N 条有标注素材,覆盖率 X%;
- 外部证据单独成章/单独标注来源与时间。
【六、外部证据(可选)】
{需要 / 不需要}。需要时主题为 {气候/价格/工艺/政策/赛事},来源限 {机构/协会/平台公开报告},
逐条给「数值 + 来源 + 时间」,在版面上用 B 级标注,不与素材证据混排。
【七、交付】
单文件 HTML;配色 {类目调性 / 品牌官网实测色};章节编号 + 英文 eyebrow;矩阵可点击抽屉;
素材 ID 可点击;<title> = H1 = 报告名「{报告名}」;页脚含来源/口径/查询快照。
做完用 @skill:pagepub 发布,curl 校验 200 且 <title> 正确,把短链发我。
【八、自检】
交付前按《报告生产配方库 v1.0》§11 清单逐项自查;不达标项先说明,不得静默跳过。最小必填项(其余可用默认值):分析对象、对象类型、时间窗、报告类型。 默认值:平台=抖音;样本=1000;人群 8–10;卖点 6–8;配色按类目;发布=是;视频=V0。
每条都自带默认值:只发这一条也能跑;若前面已发总控,则本条只作为「类型插件」,不重复全局设定。
【R1 类目竞争矩阵】对象:{品类名};时间窗:{近30天};头部品牌:{品牌A/B/C…};重点品牌:{X,需≥200条}。
按配方库 §8.1 执行:人群 {8-10} × 卖点 {6-8},格内四行(主内容/演绎句/人群细分/烈度),
抽屉走「人→情境→JTBD→停→病→药→信→买」,另出人群画像、品牌格局、4 张竞争策略卡、
表达方向+钩子TOP5+话术模板、机会交叉点 TOP3-5、洞察 5 条(每条 2-3 个素材 ID)。
默认:1000 条、类目调性配色、pagepub 发布。【R2 材质渗透】对象:{材质/成分};时间窗:{近30天};覆盖:{品类范围}。
按配方库 §8.2 执行:先出 {10-12} 类 SPU 渗透表(素材量/品牌/价格线索/原话/阶段,空白单列),
再出 8×8 人群×卖点矩阵与 {10} 个核心交叉点;单独一章写外部「{原材料价格 + 工艺变化}」
如何改写话术(价格四宫格/工艺表/5 步传导链/3-5 条市场规模,逐条标来源与时间);
另出投放动线、画面与演示、话术库、合规风险盘点({10-12} 条,A–F 六类 + 改写方向)。
数据只来自有米有数;外部数据单独分区。默认 1000 条;pagepub 发布。【R3 趋势深挖】赛道群:{...};深挖品类:{...};子品类:{...};时间窗:{近30天}。
按配方库 §8.3 执行:第一层出 {9} 条赛道热度表、目标赛道 3 条硬约束、内容侧 3 迁移、
{4} 条对照赛道爆红公式、共同公式 ✓/✗/△ 对照(外部数据标来源);
第二层深挖素材:人群×场景×卖点矩阵 + 多品牌竞争 + 五段式,证据分 L1/L2/L3 并写各级样本量,
另出 24h 动线、画面、话术库、{2-3} 子品类沟通逻辑对照、机会点排序。
默认 700 条目标、抖音单平台、pagepub 发布。【R4 爆款拆解】对象:{成分/产品};窗口:{近7天};取样:全池 → 曝光降序前 {200} → TOP{5} 品牌各 Top{10}。
按配方库 §8.4 执行:5 条核心结论(每条带曝光+素材)、品牌榜(含单条均值效率对比)、
逐品牌素材卡(曝光/首句台词/卖点/场景/直链/控制台链接)、五段式口播框架、
{6} 类开头模板、卖点×场景表述矩阵、{4} 套脚本模板、落地投放建议、数据口径与限制。
台词必须 ASR 原文;形式分布给条数与曝光占比。默认 45 条、pagepub 发布。【R5 季节外部变量】节点:{秋冬/年货节/双11…};类目:{...};外部变量:{气候/政策/节日/原料}。
按配方库 §8.5 执行:证据分 A/B/C;外部变量章(4-6 节点时间轴+关键判断+3 重含义+素材零佐证边界);
类目结构({3-5} 子块);人群 {8-10} × 场景 {6-8} 矩阵;表达方向与场景密度;
24h 动线(含「素材中不存在的时段」);画面专项核查(0/N);20-30 条话术;
洞察(主线叙事+3-4 打法+5-6 机会位+内容日历)。默认 1000 条、pagepub 发布。【R6 单品牌】品牌:{品牌名};时间窗:{近30天}。
按配方库 §8.6 执行:人群 {8-10} × 场景 {6-8}(场景须素材实际出现);
抽屉顺序=主卖点+强度→核心演绎→停病药信买→画面演绎→卖点强度分布→代表素材;
24h 动线只收录有佐证的触点;配色从品牌官网 CSS 实测提取(curl 官网抓 #hex 按频次排序),
矩阵强度用品牌主色同色系深浅阶;样本 ≥1000 条;pagepub 发布。只发子指令时的默认值:平台抖音;样本 1000(R4 为 45);时间窗近 30 天;发布=是;视频=V0;配色=类目调性。 子指令与总控冲突时:以子指令为准,但总控的口径段与交付段仍生效。
目标:把「找视频 → 存下来 → 拆开 → 写进报告 → 下次还能用」做成一条可重复的服务,而不是每次临时找几条素材。
服务对象:单条爆款、批量竞品、品牌素材库、季度复盘。
V0 只用元数据(不下载)
V1 取素材:筛选 + 盘点 + 够用判定
V2 单条拆解:ASR + 卖点 + 五段式 + 素材卡
V3 画面范式:截帧 + 镜头表 + 声画模式
V4 竞品对比:同交叉点多品牌并排
V5 话术库:批量 ASR 聚类 + 原话库
V6 达人矩阵:账号维度聚合
VALL 全链路:V1→V2/V3→入库→进报告环境依赖
| 能力 | 依赖 | 没有时怎么办 |
|---|---|---|
| 取数/ASR/卖点 | 有数 MCP(已有) | —— |
| 视频下载 | 有数控制台账号 + 浏览器;可选 curl | 走「链接留存」模式(5.3.6) |
| 截帧/转码 | ffmpeg(按需安装,当前环境未装) | 用封面 + MCP 卖点标签,画面章降级 |
| 带时间轴字幕 | 本地 ASR(Whisper/faster-whisper)或人工 | 用 MCP ASR 纯文本,不做时间码 |
| 视频直链抓取 | 浏览器 DevTools + curl(带 Referer/UA) | 仅手动留档,不批量 |
安装命令(需要时再装,不装不影响 V0/V1/V2/V5):
winget install --id Gyan.FFmpeg -e
# 可选:本地转写(带时间码)
pip install faster-whisper独立指令(可直接发)
【V1 取素材】为《{报告名}》建立视频样本池。
参数:平台=抖音;时间窗={起}~{止};对象={品牌/品类};形式=视频;
时长={不限/15-30s/30-60s};比例={竖版};质量={material_score≥60 或 按曝光降序};
目标={N} 条;去噪={跨品类/颜色词/同音词}。
执行:
1) searchBrands / filterOptions 锁定 brandId / category;
2) searchMaterials 逐页(limit=200,跨度≤180天)取满或 total 耗尽,分块必须取完;
3) 按 brandIds/categoryIds 与 slogan/ASR 关键词去噪,记录剔除条数;
4) 输出《样本盘点表》:总条数、去重后、有 ASR 数、有卖点数、有画面标注数、
品牌分布、时长分布、曝光分位(P50/P90)、TOP10 素材(ID+曝光+首句)。
判定是否够用(三条同时满足才可做占比结论):
a) 有效样本 ≥ 目标 60%,且 ≥300 条;
b) TOP3 品牌各 ≥50 条(单品牌模式该品牌 ≥300 条);
c) 有 ASR 的素材 ≥50%。
不满足:先放宽到 180 天,再改用关键词检索;仍不足则降级为「样本观察」,
标题与结论都加「样本观察,不外推」。够用判定表
| 指标 | 达标线 | 不达标时 |
|---|---|---|
| 有效样本 | ≥300 且 ≥目标 60% | 降级为样本观察 |
| 品牌覆盖 | TOP3 各 ≥50 | 补拉品牌,或只做单品牌 |
| ASR 覆盖 | ≥50% | 话术章只做结构归纳 |
| 画面标注 | ≥10 条且 ≥10% | 画面章改「口播与卖点结构」 |
| 时长分布 | 至少两档可比 | 只描述,不做时长优劣结论 |
{完整ID},根目录 {path}」{清单.csv},根目录 {path},按品牌/月分目录」| 路径 | 操作 | 适用 | 结果标记 |
|---|---|---|---|
| A 控制台手动/半自动 | 打开 console.youshu.youcloud.com/material/{ID}/overview → 播放器下载/右键另存 | 有账号、量少 | asset_status=downloaded |
| B 直链抓取 | 控制台详情页 DevTools → Network 过滤 media/mp4 → 复制 URL → curl 带 UA/Referer/Cookie 下载 | 有账号、需批量 | asset_status=downloaded |
| C 链接留存 | 只存 ID、控制台链接、封面、ASR、卖点,不存视频 | 无账号/防盗链/合规限制 | asset_status=link_only |
有数 MCP 不提供视频文件 URL;路径 B 的直链来自控制台页面本身,需登录态。仅用于内部研究,不二次分发。
video-library/
└─ douyin/
└─ {对象类型}-{对象名}/ # 例:category-厨房电器 / brand-苏泊尔
└─ {YYYY-MM}/ # 按投放月,不按抓取日
├─ {YYYYMMDD}-{品牌}-{ID前8位}-{首句前12字}.mp4
├─ 同名.json # 元数据
├─ 同名.asr.txt # 口播纯文本
├─ 同名.srt # 有时间码时
├─ 同名.poster.jpg # 封面
└─ 同名.frames/ # 截帧
├─ 00-00-00.jpg
└─ frames.csv # 时间码/景别/画面描述-;空格转 -;长度 ≤80 字符;首句去标点。catalog.csv 的 material_id,命中则跳过;文件级再用 sha256 去重。firstTime(首次投放月),不取下载日,便于按投放周期回溯。{
"material_id": "8f77a5b874c815b4c54a574dfcb1a0b4-202",
"platform": "douyin",
"object_type": "brand",
"object_name": "苏泊尔",
"brand_ids": ["123"],
"category_ids": ["456"],
"window": ["2026-10-20", "2026-11-18"],
"first_time": "2026-10-22",
"last_time": "2026-11-15",
"duration_sec": 38,
"width": 1080,
"height": 1920,
"impression_inc_2y": 1234567,
"material_score": 82,
"ad_count": 14,
"slogan": "……",
"asr_status": "ok",
"sellpoint_source": "mcp",
"console_url": "https://console.youshu.youcloud.com/material/{ID}/overview",
"poster_file": "同名.poster.jpg",
"video_file": "同名.mp4",
"asset_status": "downloaded",
"download_path": "A",
"sha256": "…",
"captured_at": "2026-11-18T16:00:00+08:00",
"analysis_version": 1,
"tags": ["无涂层", "健康", "家庭主厨"]
}ffprobe -v error -show_entries format=duration,size -of csv=p=0 "{file}"
# 时长与元数据相差 >3 秒 → 标记 corrupt,重新下载asset_status=link_only:报告里只引用 ASR 原句、卖点标签、封面、控制台链接,不写截帧/景别/运镜。| 层级 | 方法 | 产物 | 适用 |
|---|---|---|---|
| T1 文本 | creativeAsr(≤100/批) | asr.txt(纯文本) | 所有视频,默认 |
| T2 时间码 | 本地 faster-whisper | srt(句级时间码) | 需要卡点/首句秒数 |
| T3 人工校对 | 人听 + 改错字 | 校对版 srt | 头部 10 条爆款 |
T2 命令(有 ffmpeg + faster-whisper 时):
ffmpeg -y -i "{mp4}" -vn -ac 1 -ar 16000 "{wav}"
faster-whisper "{wav}" --model small --language zh --output_format srt --output_dir "{dir}"没有本地 ASR 就停在 T1;报告里不写「第 3 秒说……」,只写「首句为……」。
# 1) 每秒 1 帧(保底,便于逐秒看)
ffmpeg -y -i "{mp4}" -vf "fps=1,scale=540:-1" "{frames}\%02d.jpg"
# 2) 场景切换帧(更省,适合长视频)
ffmpeg -y -i "{mp4}" -vf "select='gt(scene,0.35)',scale=540:-1" -vsync vfr "{frames}\scene-%02d.jpg"
# 3) 九宫格联络图(快速浏览)
ffmpeg -y -i "{mp4}" -vf "fps=1/3,scale=320:-1,tile=3x3" "{frames}\contact-%02d.jpg"镜头表字段(每帧/每镜一行)
时间码|镜号|景别(远/全/中/近/特)|人物(谁/状态/出镜方式)|场景|道具|动作|字幕(原文)|产品露出(有/无/方式)|光线|运镜(固定/推/拉/摇/跟/手持)|声音(口播/音乐/音效)|画面描述
做法:先看联络图定位关键帧,再对关键帧逐张描述;不确定的字段写「不可判定」,不猜。
卖点轴:用 M5 的 sellPoint 归一为 6–8 轴;每条素材保留原始标签。
创意手法标签(12 类,固定词表)
| 维度 | 取值 |
|---|---|
| 开场钩子 | 价格钩子 / 痛点质问 / 身份点名 / 对比落差 / 结果前置 / 剧情冲突 / 权威背书 / 悬念 |
| 叙事结构 | 问题-解决 / 测评对比 / 一日 vlog / 剧情短剧 / 直播切片 / 清单罗列 / 工厂溯源 |
| 证据类型 | 检测报告 / 实拍实验 / 前后对比 / 成分表 / 认证特证 / 用户证言 / 专家出镜 |
| 转化机制 | 拍一发N / 限时降价 / 赠品 / 运费险 / 试用装 / 直播间专属 |
| 情绪 | 焦虑 / 孝心 / 悦己 / 从众 / 省钱 / 猎奇 |
| 形式 | 真人口播 / 达人测评 / 纯商品展示 / 剧情 / 图文 / AI 生成 |
批量组织方式
manifest.csv(material_id, 时长, ASR状态, 下载状态)。batch-{n}.csv 与 batch-{n}.md 小结。analysis.json 且 analysis_version 相同则跳过。failed.csv:记录 ID、失败环节、原因、重试次数。analysis-all.json,再进报告。| 视频产物 | 落在哪一章 | 呈现形式 | 与矩阵怎么互证 |
|---|---|---|---|
| 样本盘点表(V1) | 页首 KPI / 配方库 §2 的 L0–L1 | 6 个数字 + 口径卡 | 矩阵分母 = 有效样本数 |
| 素材库总表 | 附录 A 或第 2 章 | 表格(ID/品牌/曝光/时长/卖点/链接) | 每个交叉点的素材可回查 |
| 单条拆解卡(V2) | 抽屉 或 R4 逐品牌章节 | 封面 + 首句 + 五段 + 指标 + 链接 | 交叉点结论落到具体素材 |
| 逐条拆解表(V2 批量) | R4 的 03–07 章 | 一行一条:ID/曝光/首句/卖点/场景/钩子 | 支撑「谁爆、为什么爆」 |
| ASR 话术库(V5) | 话术库 / 五段式 | 按卖点分组,原话 + ID | 交叉点「停/病/药/信/买」引用原话 |
| 画面范式(V3) | 画面演绎章 | 3–6 张截帧 + 范式说明 + 占比 | 解释「同一卖点为什么这条更强」 |
| 竞品对比表(V4) | 竞争策略章 | 品牌 × 维度并排 | 证明该交叉点的烈度与差异 |
| 创意手法分布 | 表达方向章 | 条形/表格 | 解释矩阵强度的来源 |
| 证据三件套 | 每个交叉点抽屉 | ①素材数 ②代表 ID + 原句 ③截帧/标签 | 矩阵强度 = 该格素材条数(或标注估算) |
互证规则(写进提示词)
【V2 单条】拆这条视频:{完整ID};深度 L3;落到《{报告名}》§{章节}。
输出:素材卡(封面/首句/五段/卖点/指标/链接)+ 一条「它为什么有效」的判断(≤60字)。【V2 批量】拆这批:{清单.csv 或 20 个 ID};每批 ≤20 条;
输出 batch.csv + 每品牌 3 张卡 + 失败清单;中途失败不中断,记录后继续。【调用视频服务模块 V2】
{
"task": "V2",
"report": "口服麦角硫因 · 近7天爆款素材内容分析策略报告",
"window": ["2026-11-09", "2026-11-15"],
"object": {"type": "category", "name": "口服麦角硫因"},
"materials": ["{ID1}", "{ID2}"],
"depth": "L3",
"library": "D:\\report-lab\\video-library",
"output": {"format": ["csv", "cards"], "chapter": "§8.4"}
}参数传递规则
materials 为空时,先用 V1 的筛选条件建池,再按 top_n 取。depth 决定是否下载/截帧:L1 不下载;L2 只 ASR+标签;L3 下载+截帧。library 下,禁止散落桌面。| 缺失 | 报告写法 | 禁止写法 |
|---|---|---|
| 视频下载失败 | 「该素材仅保留元数据与控制台链接,画面未纳入分析」 | 「该素材无画面」 |
| ASR 缺失 | 「该素材无口播文本,仅按标题与卖点标签归类」 | 用标题冒充口播原句 |
| 画面标注少 | 「画面结论基于 M 条可获取画面素材,覆盖率 X%」 | 用台词反推景别/运镜 |
| 达人信息缺失 | 「账号维度样本不足,不做达人层级结论」 | 编造粉丝量 |
| 分块未取完 | 「本次统计基于前 N 页样本」 | 声称全量 |
video-library/
├─ catalog.csv # 总索引(一行一条素材)
├─ catalog.json # 同上,程序用
├─ douyin/… # 按对象/月存放(见 5.3.3)
├─ reports/ # 引用过这些素材的报告快照
└─ schemas/
├─ material.schema.json
└─ analysis.schema.jsonmaterial_id, platform, object_type, object_name, brand_ids, category_ids, window_start, window_end, first_time, last_time, duration_sec, width, height, impression_inc_2y, material_score, ad_count, slogan, asr_status, sellpoint_source, asset_status, video_file, poster_file, srt_file, frames_dir, console_url, sha256, download_path, captured_at, analysis_version, tags, report_refs, notes
{
"material_id": "…-202",
"analysis_version": 1,
"asr": {"text": "…", "coverage": "full"},
"first_3s": "…",
"sellpoints": ["…"],
"creative": {"hook": "对比落差", "structure": "测评对比", "proof": "实拍实验", "cta": "拍一发N", "emotion": "省钱", "format": "真人口播"},
"shots": [{"tc": "00:03", "shot": "近景", "人物": "…", "场景": "…", "字幕": "…", "产品露出": "手持特写"}],
"sound_pattern": "痛点画面+功效字幕",
"why_it_works": "…",
"evidence_level": "L3",
"analyzed_at": "2026-11-18"
}last_time/impression/ad_count。analysis_version+1,保留旧版,报告引用版本号。asset_status=failed 保留 30 天后重试;link_only 永久保留元数据。从库里取:{品牌/类目} + {月份} + {卖点标签} 的全部素材,输出 ID/曝光/首句/链接;
把其中曝光 TOP10 按 V3 补截帧,其余只出元数据。| 场景 | 推荐组合 | 说明 |
|---|---|---|
| 新报告、要求高 | 总控 + 子指令 + 视频 V1 | 一次把对象、口径、结构、素材池定好 |
| 日常快报 | 只发子指令 | 默认值已内置;产出简化版 |
| 已有报告补内容 | 只发模块(M/V) | 复用原素材池与会话,不重拉 |
| 复盘/复用 | 只发库查询 + 子指令 | 用旧库当证据,减少取数 |
chat_mode=2(youclaw)或直接走 MCP。session_id,不传 chat_mode。| 阶段 | 交接物 | 给谁 |
|---|---|---|
| 取数 | materials.csv(ID/品牌/曝光/时长/ASR状态) | 视频服务、报告生成 |
| 转写 | analysis-all.json | 报告生成 |
| 留存 | catalog.csv + video-library/ | 下次复用 |
| 成文 | index.html + 报告名 | pagepub |
| 发布 | 短链 + <title> 校验结果 | 用户 |
「按总控做一份 R1《{品类} · 人群×卖点竞争策略矩阵》,近 30 天,覆盖 {品牌A/B/C},做完发布给我。」
适合:对象明确、只要标准结构。默认样本 1000、抖音、类目配色、pagepub 发布。
按总控做 R{1-6}《{报告名}》。
对象:{品牌/品类/材质/成分};时间:{起}~{止};
覆盖:{头部品牌/细分SPU};重点:{必须加量的品牌};
我最想回答的 3 个问题:①{…} ②{…} ③{…};
要矩阵抽屉、素材链接、话术库;做完 pagepub 发布。按总控做 R{2/5}《{报告名}》,时间 {…}。
在标准版基础上加三件事:
1) 外部证据:引用 {气候/原料价格/工艺/政策/赛事},逐条标来源与时间,单独成章,不与素材混排;
2) 视频服务:VALL,先建 {N} 条样本池,TOP{20} 下载留存并按 L3 拆解(首句/五段/卖点/截帧),
落到第 {X} 章与抽屉;拿不到视频的标 link_only,不写画面结论;
3) 交付:单文件 HTML,配色按{类目/品牌官网实测},<title>=H1=报告名,发布后把短链和本地路径都发我。| 漏掉的信息 | 默认行为 | 风险 |
|---|---|---|
| 报告类型 | 按对象猜(品类→R1、材质→R2、近7天→R4) | 可能做成四不像,章节不对 |
| 时间窗 | 近 30 天 | 错过节点(如大促/换季),结论过期 |
| 头部品牌 | 只按关键词拉 | 样本被单一品牌垄断,竞争结论失真 |
| 样本量 | 1000(实际受 600 上限) | 小品类拿不满,占比不稳 |
| 外部证据 | 不加 | 趋势无解释,报告停在「素材描述」 |
| 视频深度 | V0(不下载) | 没有画面/截帧,画面章写不实 |
| 发布 | 默认发布 | 只得到本地文件,没法直接发客户 |
| 配色 | 类目调性 | 可能和品牌 VI 不符 |
| 口径 | 默认三级样本 | 客户追问时无法解释分母 |
| 目的 | 说法 |
|---|---|
| 换轴 | 「第 3 章矩阵横轴换成场景,其他不动;只重做该章。」 |
| 补章 | 「复用现有素材池,补一章 ASR 话术库,按卖点分组,别重拉。」 |
| 补视频 | 「V3 给第 6 章补 6 张截帧,标时间码和素材 ID。」 |
| 改口径 | 「把所有占比分母改成 {X} 条有效样本,并在页首写明多标签不互斥。」 |
| 改视觉 | 「配色换成 {品牌色},矩阵强度用主色 4 阶,不要红黄绿。」 |
| 改结论 | 「第 5 条洞察证据不足,删掉或降级为『待验证』。」 |
| 换样本 | 「只保留 {品牌} 的素材重算矩阵,其他品牌作为对比不参与分母。」 |
| 发布更新 | 「改完重新发布同一页面,保留版本记录,把新短链发我。」 |
本文件不重复配方库正文;以下是要回写到配方库的最小改动,避免两套文档打架。
| 位置 | 改动 | 类型 |
|---|---|---|
| 配方库 §1 总表 | 增加一列「MCP 取数路径」:R1=品牌逐个+品类;R2=关键词+SPU;R3=关键词×赛道;R4=全池→曝光排序;R5=子块;R6=单品牌 | 【升级】 |
| 配方库 §3 维度字典 | D11 增加「impression_inc_2y=累计曝光,不是窗口曝光」;新增 D13「素材质量分 material_score」、D14「关联广告数 cnt_ad_id」 | 【升级】 |
| 配方库 §8.1–8.6 | 每类开头加「取数步骤(M1→M2→M3→M4/M5→M6)」与「视频深度默认 V0」 | 【升级】 |
| 配方库 §9.2 必写句 | 增加三句:分块取完句、ASR 覆盖率句、视频拿不到时的 link_only 句 | 【升级】 |
| 配方库 §11 检查清单 | 增加 6 项:分块是否取完、ASR 覆盖率、无效 ID 数、视频留存状态、截帧时间码、库索引是否更新 | 【升级】 |
| 配方库 附录 B | 标注「youclaw 四段模板」与「MCP 直连模板(本文 §2)」二选一;不要把两者混用在同一轮 | 【升级】 |
| 配方库 附录 C | 增加「禁止使用 appgrowing 的 creativeResourceUrl」「禁止把累计曝光写成窗口曝光」 | 【升级】 |
| 配方库版本记录 | 追加 v1.1:接入 MCP 直连与视频服务模块 | 【升级】 |
两套文档的分工
| 场景 | 现象 | 处理 | 报告里怎么写 |
|---|---|---|---|
| 认证 | 401 / Key 失效 | 重新配置有数 API Key | 不写进报告,先解决 |
| youclaw | 600s 超时 | 等待或重试;不中途发「正在处理」 | 「本次分析未返回,结论以 MCP 样本为准」 |
| 分块 | MCP_CHUNK_EXPIRED | 重调原工具,换新 cursor | 「样本按最新一次取数」 |
| 样本 | 不足 1000/目标 | 放宽窗口→关键词→降级 | 「目标 X / 实际 Y / 有效 Z」 |
| 去噪 | 跨品类/颜色词 | 记录剔除条数与规则 | 页首口径区 |
| 品牌 | 多候选 | 列候选 + 店铺/主营核对 | 「brandId=X,依据=官方旗舰店」 |
| ASR | 覆盖率低 | 只做结构归纳 | 「ASR 覆盖 X%,话术结论不外推」 |
| 画面 | 标注少/无视频 | 章名降级 | 「画面结论基于 M 条,覆盖率 X%」 |
| 下载 | 防盗链/无账号 | link_only | 「仅保留元数据与控制台链接」 |
| 截帧 | 无 ffmpeg | 不截帧 | 「未做截帧,画面以封面与标签为准」 |
| 达人 | 同名 | 粉丝/店铺核对 | 「账号按 UID 认定,非昵称」 |
| 发布 | 会话过期 | 用已存 API Key 重新登录再发 | 不写进报告 |
| 发布 | title 不一致 | 改 <title> 重发 | 校验后再给链接 |
| 占位符 | 含义 | 示例 |
|---|---|---|
{分析对象} | 品牌/品类/材质/成分/赛道 | 钛 / 调味品 |
{对象类型} | brand/category/material/ingredient/track | category |
{时间窗} | 起止日期 | 2026-10-20 ~ 11-18 |
{样本目标} | 目标条数 | 1000 |
{brandId} | searchBrands 返回的纯数字 | 12345 |
{categoryId} | filterOptions 的 category id | 456 |
{uid} | 达人 ID(纯数字) | 98765 |
{materialIds} | 完整 <id>-<type> 数组 | 8f77…-202 |
{视频深度} | V0/V1/V2/V3/V4/V5/V6/VALL | V2 |
{拆解深度} | L1/L2/L3 | L3 |
{库根目录} | 本地路径 | D:\report-lab\video-library |
{报告名} | title=H1 | 钛 · 材质渗透地图 × 人群×卖点 内容营销矩阵 |
| 样本 | 建议类型 | 取数动作 | 视频深度 | 备注 |
|---|---|---|---|---|
| S01 秋冬家庭必备 | R5 | 4 子块关键词分别检索后合并;600 条;画面送检 251、标注 41 | V1 + V3(元素核查) | 外部气候章单独分区 |
| S02 钛 | R2 | 关键词 + 12 类 SPU;600→390;剔除颜色词/车型 | V1 + V2(30 条标注) | 外部价格/工艺章 |
| S03 调味品 | R1 | 7 品牌各 50 + 重点 200 | V1 | 品牌定位对比 |
| S04 厨房电器 | R1 | 品类单次 500 → 可辨识 280 | V1 | 跨品类去噪 |
| S05 流行运动 | R3 | 赛道关键词 × 深挖品类;约 290;画面 13 | V1 + V2 | L1/L2/L3 分级 |
| S06 家居家装 | R1 | 8 品牌 1020→960;ASR+画面 | V1 + V2 + V3 | 品牌画面对比 |
| S07 麦角硫因 | R4 | 全池 1422→前 200→45;逐条 ASR | V2 + V5 | 曝光排序取样 |
impression_inc_2y 写成「近 30 天曝光」。<title>。