知识库首页知识库-世界 MASTER-SOP-VIDEO-TO-BLOG-WORKFLOW.md

MASTER SOP VIDEO TO BLOG WORKFLOW

本地来源：Knowledge/World/项目/Practice/SAAS博客文档/Guideline/MASTER-SOP-VIDEO-TO-BLOG-WORKFLOW.md

视频转博客完整SOP工作流 (Master SOP: Video-to-Blog Workflow)

文档版本: v1.0 创建日期: 2026-01-24 用途: 将YouTube视频批量转化为高质量SEO博客文章的完整操作流程 复用性: ⭐⭐⭐⭐⭐ 可直接复制到任何类似项目

📊 当前项目统计（seedvr2.net）

指标	数量	百分比
总视频数	94个	100%
有转录视频	66个	70%
已完成博客	46篇	49%
待生成博客	48篇	51%
有专属配图	19篇	41%
使用默认图	27篇	59%

目标: 完成70-80篇高质量博客文章

🎯 工作流概览

阶段1: 数据准备
   ↓
阶段2: 内容规划
   ↓
阶段3: 博客生成
   ↓
阶段4: 图片生成
   ↓
阶段5: 质量检查
   ↓
阶段6: 发布上线
   ↓
阶段7: 索引提交

📋 阶段1: 数据准备

1.1 收集YouTube视频数据

目标: 获取所有相关视频的元数据和转录脚本

工具: YouTube Data API + 转录脚本提取工具

步骤:

搜索关键词视频 bash # 使用YouTube API搜索 (需要API key) npx tsx "SEO/Scripts for Youtube/fetch-seedvr2-videos.ts"
提取视频元数据 - 视频ID - 标题 - 频道名 - 观看量 - 发布日期 - 时长 - 描述
下载转录脚本 - 自动转录 (YouTube auto-caption) - 手动转录 (YoutubeScribe.com 等工具) bash npx tsx "SEO/Scripts for Youtube/re-extract-transcripts.ts"
保存到JSON文件 json { "videoId": "xxxxx", "title": "视频标题", "channelName": "频道名", "viewCount": 12345, "publishedAt": "2026-01-01", "duration": "PT10M30S", "transcript": "完整转录文本..." }

输出: PROJECT-SPECIFIC/Videos/seedvr2.json

1.2 视频质量筛选

筛选标准 (按优先级排序):

优先级	观看量	转录可用	适合博客
P0 🔥	>10K	✅ 有	核心教程
P1 🔶	5K-10K	✅ 有	实用指南
P2 🟡	2K-5K	✅ 有	补充内容
P3 🟢	<2K	✅ 有	可选
Skip ❌	Any	❌ 无	跳过

排除条件: - 无转录脚本 - 纯实战案例展示（无教学内容） - 非英文视频（除非翻译价值高） - 重复内容 - 过时技术（已被新版本替代）

输出: PROJECT-SPECIFIC/VIDEO-TO-BLOG-MAPPING.md

📋 阶段2: 内容规划

2.1 创建博客规划文档

每个博客需要的规划文档:

# Blog #XX 规划文档

## 视频信息
- Video ID: xxxxx
- 标题: [视频标题]
- 观看量: XX.XK
- 时长: XX分钟

## 内容分析
### 核心主题
[一句话总结]

### 关键要点
1. 要点1
2. 要点2
3. 要点3...

## SEO关键词策略
### 主关键词
- keyword1
- keyword2

### 长尾关键词
- long tail keyword 1
- long tail keyword 2

## 文章结构规划
1. TL;DR
2. [H2 章节1]
3. [H2 章节2]
...

## Ideogram图片Prompt
[详细的图片生成提示词]

参考模板: SEO/blog-39-seedvr2-v25-official-guide-planning.md

2.2 选择博客模板

模板选择决策树:

开始
 │
 ├─ 是否有视频转录？
 │   ├─ 是 → Standard Template
 │   └─ 否 → 跳过或手动创作
 │
 ├─ 是否需要分步骤操作指导？
 │   ├─ 是 → Tutorial Template ⭐推荐
 │   └─ 否 → 继续
 │
 ├─ 是否需要对比2+个工具？
 │   ├─ 是 → Comparison Template
 │   └─ 否 → 继续
 │
 ├─ 目标读者是企业决策者？
 │   ├─ 是 → HubSpot Premium Style
 │   └─ 否 → Standard/Adobe Style

可用模板: - Templates/blog-template-tutorial.md - 教程类 - Templates/blog-template-comparison.md - 对比类 - Templates/blog-template-standard.md - 标准类 - Templates/blog-template-adobe-style.md - Adobe风格 - Templates/blog-template-skywork-style.md - Skywork风格 - Templates/blog-template-premium-hubspot-inspired.md - HubSpot风格

📋 阶段3: 博客生成

3.1 Frontmatter规范

---
title: "[50-60字符标题包含关键词和年份]"
description: "[150-160字符meta描述包含CTA]"
date: "YYYY-MM-DD"
author: "Team Name"
image: "/images/blog/tutorials/[slug]-featured.jpg"
categories: ["tutorials"]
tags: ["tag1", "tag2", "tag3"]
published: true
---

关键规则: - Title: 50-60字符，主关键词在前10个字 - Description: 150-160字符，包含CTA - Image: 必须指定路径（即使图片未生成） - Published: 草稿设为false

3.2 强制CTA组件规则

⚠️ 每篇博客必须包含开头CTA和结尾CTA - 这是强制性要求！

开头CTA (HeroMini) - 必需

位置: Frontmatter之后，第一个H1之前

<HeroMini
  title="简洁有力的标题 (10-15词)"
  subtitle="补充说明目标用户和应用场景 (15-20词)"
  primaryCTA="主要行动"
  primaryLink="#section-anchor"
  secondaryCTA="次要行动"
  secondaryLink="/blog?category=tutorials"
/>

结尾CTA (HeroFull) - 必需

位置: FAQ之后，Related Resources之前

<HeroFull
  title="Ready to Start? (10-15词)"
  subtitle="社会证明或用户群体描述 (15-20词)"
  features={[
    { icon: "🚀", title: "Feature 1", description: "描述1" },
    { icon: "⚡", title: "Feature 2", description: "描述2" },
    { icon: "💰", title: "Feature 3", description: "描述3" },
    { icon: "🎯", title: "Feature 4", description: "描述4" },
    { icon: "📖", title: "Feature 5", description: "描述5" },
    { icon: "🤝", title: "Feature 6", description: "描述6" }
  ]}
  stats={{ users: "10,000+", videos: "500K+", rating: "4.9/5" }}
  primaryCTA="🎯 主要CTA"
  primaryLink="/"
  secondaryCTA="📚 次要CTA"
  secondaryLink="/blog?category=tutorials"
  tertiaryCTA="💬 第三CTA"
  tertiaryLink="/support"
/>

验证命令:

# 检查CTA组件数量
grep -c "<HeroMini" content/blog/tutorials/xxx.mdx  # 必须 = 1
grep -c "<HeroFull" content/blog/tutorials/xxx.mdx  # 必须 = 1
grep -A 25 "<HeroFull" xxx.mdx | grep -c "CTA="     # 必须 >= 3

3.3 博客结构标准

---
[Frontmatter]
---

<HeroMini ... />

## TL;DR
- ✅ 核心点1
- ✅ 核心点2
- ✅ 核心点3
- ✅ 核心点4
- ✅ 核心点5

**阅读时长**: X分钟 | **难度**: 初级/中级/高级

## 🔑 Key Takeaways
1. 📌 要点1
2. ⚡ 要点2
3. 🎯 要点3
...

## [H2 章节1]
### [H3 子章节]
...

## [H2 章节2]
### [H3 子章节]
...

## [H2 章节3-6]
...

## ❓ FAQ
### Q1: 问题1?
**A**: 回答1

### Q2: 问题2?
**A**: 回答2
...(5-10个问题)

<HeroFull ... />

## 🔗 Related Resources
- [相关文章1](/blog/xxx)
- [相关文章2](/blog/xxx)
- [官方文档](https://...)

3.4 AI生成提示词

使用对应模板的Prompt文件: - Prompts/prompt-blog-generate-tutorial.md - Prompts/prompt-blog-generate-comparison.md - Prompts/prompt-blog-generate-standard.md

核心输入参数:

video_title: "[视频标题]"
channel_name: "[频道名]"
duration: "[时长]"
video_url: "[YouTube URL]"
transcript: "[完整转录文本]"
target_skill: "[目标技能]"
difficulty: "Beginner/Intermediate/Advanced"

📋 阶段4: 图片生成

4.1 Ideogram图片Prompt规范

必须包含元素 (按权重):

主体描述 (30%): 与博客主题直接相关的可视化元素
风格美学 (25%): REALISTIC/DESIGN风格，专业科技感
光线色彩 (20%): 根据主题选择色彩心理学
构图 (15%): 16:9 landscape format，清晰焦点
细节 (10%): 高质量、锐利细节

颜色心理学: - 🔵 蓝色/青色: 信任、专业、技术（教程类） - 🟣 紫色: 创新、高级、AI科技（深度分析） - 🟢 绿色: 成功、优化、增长（性能提升） - 🟠 橙/黄: 能量、引导、注意力（新功能）

Negative Prompt标准:

text, labels, words, watermark, logo, typography,
low quality, blurry, distorted, cartoon, anime,
people, faces, hands, UI elements

4.2 图片生成API调用

使用Kie.ai API (Nano Banana模型):

# API调用示例
curl -X POST "https://api.kie.ai/generate" \
  -H "Authorization: Bearer $KIE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana",
    "prompt": "[Ideogram Prompt]",
    "aspect_ratio": "16:9",
    "style": "REALISTIC"
  }'

图片保存路径: public/images/blog/tutorials/[slug]-featured.jpg

图片优化要求: - 格式: JPG - 尺寸: 1920x1080 或 1600x900 - 大小: <200KB - 比例: 16:9

详细指南: Guideline/AI-IMAGE-GENERATION-GUIDE.md

📋 阶段5: 质量检查

5.1 快速检查清单 (发布前必做)

# 1. CTA组件检查
grep -c "<HeroMini" content/blog/tutorials/xxx.mdx  # 必须 = 1
grep -c "<HeroFull" content/blog/tutorials/xxx.mdx  # 必须 = 1

# 2. 构建测试
pnpm build  # 必须通过

# 3. 图片检查
IMAGE=$(grep "^image:" xxx.mdx | sed 's/image: "//' | sed 's/"$//')
ls "public$IMAGE"  # 必须存在

# 4. 链接检查 (无404)
# 确保Related Resources中的链接都存在

5.2 完整质量检查清单

结构检查 (10分): - [ ] HeroMini组件存在且正确 - [ ] HeroFull组件存在且包含3个CTA - [ ] TL;DR章节包含5-8个要点 - [ ] Key Takeaways章节包含5-10个要点 - [ ] 至少5个H2章节 - [ ] FAQ章节包含5-10个问题 - [ ] Related Resources包含5-7个链接

内容检查 (10分): - [ ] 字数 ≥ 2000词 - [ ] 无技术错误 - [ ] 代码示例可运行 - [ ] 截图/表格辅助说明 - [ ] 自然的关键词密度

SEO检查 (10分): - [ ] Title ≤ 60字符 - [ ] Description 150-160字符 - [ ] 主关键词在Title前10个字 - [ ] 内部链接 ≥ 3个 - [ ] 图片有alt text

技术检查 (10分): - [ ] MDX语法正确 - [ ] 无YAML重复字段 - [ ] 图片路径存在 - [ ] 构建成功 - [ ] 本地预览正常

评分标准: - S级: ≥ 45/50 - 可发布 - A级: 40-44 - 小幅修改后发布 - B级: 35-39 - 需要修改 - C级: <35 - 重写

完整检查清单: Guideline/CHECKLIST.md

📋 阶段6: 发布上线

6.1 Git提交规范

# 1. 添加文件
git add content/blog/tutorials/xxx.mdx
git add public/images/blog/tutorials/xxx-featured.jpg

# 2. 提交 (包含字数)
git commit -m "feat: add Blog #XX - [博客标题简写] (X,XXX words)

Co-Authored-By: Claude <[email protected]>"

# 3. 推送
git push origin main

6.2 验证上线

# 等待部署完成 (通常1-3分钟)

# 验证URL可访问
curl -I https://yoursite.com/blog/tutorials/xxx-2026 | head -1
# 预期: HTTP/2 200

# 检查OpenGraph预览
curl https://yoursite.com/blog/tutorials/xxx-2026 | grep "og:image"

📋 阶段7: 索引提交

7.1 IndexNow提交 (必应)

# IndexNow API提交
curl -X POST "https://api.indexnow.org/IndexNow" \
  -H "Content-Type: application/json" \
  -d '{
    "host": "yoursite.com",
    "key": "YOUR_INDEXNOW_KEY",
    "urlList": [
      "https://yoursite.com/blog/tutorials/xxx-2026"
    ]
  }'

7.2 Google Search Console提交

手动提交 (每天限制10个): 1. 登录 GSC: https://search.google.com/search-console 2. 进入 URL检查 3. 输入新URL 4. 点击"请求编入索引"

批量提交策略: - 每天提交10个URL - 优先提交高价值页面 - 记录提交日期

详细指南: Guideline/GSC-URL-SUBMISSION.md

📁 文件目录结构

SEO/
├── Guideline/                          # 通用指南 (可复制)
│   ├── MASTER-SOP-VIDEO-TO-BLOG-WORKFLOW.md  # 本文档
│   ├── seoskill.md                     # SEO写作规范
│   ├── CHECKLIST.md                    # 质量检查清单
│   ├── AI-IMAGE-GENERATION-GUIDE.md    # 图片生成指南
│   ├── GSC-URL-SUBMISSION.md           # GSC提交指南
│   ├── INDEX-PREVENTION-SOP.md         # 防索引指南
│   └── SOP-CHECKLIST.md                # 快速操作清单
│
├── Templates/                          # 博客模板 (可复制)
│   ├── blog-template-tutorial.md
│   ├── blog-template-comparison.md
│   ├── blog-template-standard.md
│   ├── blog-template-adobe-style.md
│   └── blog-template-skywork-style.md
│
├── Prompts/                            # AI提示词 (可复制)
│   ├── prompt-blog-generate-tutorial.md
│   ├── prompt-blog-generate-comparison.md
│   ├── prompt-blog-generate-standard.md
│   └── prompt-blog-featured-image.md
│
├── PROJECT-SPECIFIC/                   # 项目特定 (不可复制)
│   ├── Videos/seedvr2.json             # 视频数据
│   ├── VIDEO-TO-BLOG-MAPPING.md        # 映射关系
│   ├── task.md                         # 任务清单
│   └── ...
│
└── Analysis-for-Templates/             # 模板分析 (参考用)
    ├── hubspot.blog.md
    ├── adobe.md
    └── ...

🔄 复制到新项目

步骤1: 复制通用文档

# 创建新项目SEO目录
mkdir -p /new-project/SEO/Guideline
mkdir -p /new-project/SEO/Templates
mkdir -p /new-project/SEO/Prompts
mkdir -p /new-project/SEO/PROJECT-SPECIFIC

# 复制通用文档
cp -r SEO/Guideline/* /new-project/SEO/Guideline/
cp -r SEO/Templates/* /new-project/SEO/Templates/
cp -r SEO/Prompts/* /new-project/SEO/Prompts/

步骤2: 全局替换品牌名

cd /new-project/SEO

# macOS
find . -name "*.md" -exec sed -i '' 's/SeedVR2/YourProduct/g' {} \;
find . -name "*.md" -exec sed -i '' 's/seedvr2.net/your-domain.com/g' {} \;

# Linux
find . -name "*.md" -exec sed -i 's/SeedVR2/YourProduct/g' {} \;
find . -name "*.md" -exec sed -i 's/seedvr2.net/your-domain.com/g' {} \;

步骤3: 创建项目特定文档

# 初始化任务清单
touch /new-project/SEO/PROJECT-SPECIFIC/task.md

# 初始化视频数据目录
mkdir -p /new-project/SEO/PROJECT-SPECIFIC/Videos

# 初始化映射文档
touch /new-project/SEO/PROJECT-SPECIFIC/VIDEO-TO-BLOG-MAPPING.md

📊 效率指标

单篇博客预计时间:

阶段	时间	备注
规划	5-10分钟	分析视频内容
AI生成	10-15分钟	使用模板生成
人工优化	10-15分钟	调整结构/内容
图片生成	5分钟	API调用
质量检查	5-10分钟	检查清单
发布提交	5分钟	Git + 索引
总计	40-60分钟	每篇

日产能: - 高效模式: 8-10篇/天 - 标准模式: 4-6篇/天 - 高质量模式: 2-3篇/天

⚠️ 常见问题与解决

问题1: YAML重复字段错误

YAMLException: duplicated mapping key

原因: Frontmatter中有重复的字段（如两个image:）

解决:

# 检查重复字段
grep -n "^image:" content/blog/tutorials/xxx.mdx

# 删除重复行
awk 'NR!=7' xxx.mdx > temp.mdx && mv temp.mdx xxx.mdx

问题2: 404链接

原因: Related Resources中的链接不存在

解决:

# 批量替换假链接
find content/blog -name "*.mdx" -exec sed -i '' \
  's|https://fake-url.com|https://real-url.com|g' {} \;

问题3: 构建失败

原因: MDX语法错误

解决:

# 检查语法
pnpm content

# 查看具体错误
pnpm build 2>&1 | grep -A 5 "Error"

问题4: 图片不显示

原因: 图片路径错误或文件不存在

解决:

# 检查路径
grep "^image:" xxx.mdx

# 确认文件存在
ls -la public/images/blog/tutorials/

📞 支持资源

完整SEO规范: Guideline/seoskill.md
质量检查清单: Guideline/CHECKLIST.md
图片生成指南: Guideline/AI-IMAGE-GENERATION-GUIDE.md
GSC提交指南: Guideline/GSC-URL-SUBMISSION.md

文档维护者: SEO Team 最后更新: 2026-01-24 版本: v1.0

本文档为站内渲染。原始文件本地路径：saas/source/knowledge-world/Knowledge-World-项目-Practice-SAAS博客文档-Guideline-MASTER-SOP-VI-3cdca1.md（仅本地保留，不入库不部署）