MASTER SOP VIDEO TO BLOG WORKFLOW.md
本地来源：seo-llm/raw/seo知识库/TXT整理/seo方法论/seo-knowledge-base/Guideline/MASTER-SOP-VIDEO-TO-BLOG-WORKFLOW.md.txt
# 视频转博客完整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 + 转录脚本提取工具
**步骤**:
1. **搜索关键词视频**
```bash
# 使用YouTube API搜索 (需要API key)
npx tsx "SEO/Scripts for Youtube/fetch-seedvr2-videos.ts"
```
2. **提取视频元数据**
- 视频ID
- 标题
- 频道名
- 观看量
- 发布日期
- 时长
- 描述
3. **下载转录脚本**
- 自动转录 (YouTube auto-caption)
- 手动转录 (YoutubeScribe.com 等工具)
```bash
npx tsx "SEO/Scripts for Youtube/re-extract-transcripts.ts"
```
4. **保存到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 创建博客规划文档
**每个博客需要的规划文档**:
```markdown
# 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规范
```yaml
---
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之前
```jsx
<HeroMini
title="简洁有力的标题 (10-15词)"
subtitle="补充说明目标用户和应用场景 (15-20词)"
primaryCTA="主要行动"
primaryLink="#section-anchor"
secondaryCTA="次要行动"
secondaryLink="/blog?category=tutorials"
/>
```
#### 结尾CTA (HeroFull) - 必需
**位置**: FAQ之后，Related Resources之前
```jsx
<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"
/>
```
**验证命令**:
```bash
# 检查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 博客结构标准
```markdown
---
[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`
**核心输入参数**:
```yaml
video_title: '[视频标题]'
channel_name: '[频道名]'
duration: '[时长]'
video_url: '[YouTube URL]'
transcript: '[完整转录文本]'
target_skill: '[目标技能]'
difficulty: 'Beginner/Intermediate/Advanced'
```
---
## 📋 阶段4: 图片生成
### 4.1 Ideogram图片Prompt规范
**必须包含元素** (按权重):
1. **主体描述** (30%): 与博客主题直接相关的可视化元素
2. **风格美学** (25%): REALISTIC/DESIGN风格，专业科技感
3. **光线色彩** (20%): 根据主题选择色彩心理学
4. **构图** (15%): 16:9 landscape format，清晰焦点
5. **细节** (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模型)**:
```bash
# 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 快速检查清单 (发布前必做)
```bash
# 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提交规范
```bash
# 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 验证上线
```bash
# 等待部署完成 (通常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提交 (必应)
```bash
# 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: 复制通用文档
```bash
# 创建新项目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: 全局替换品牌名
```bash
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: 创建项目特定文档
```bash
# 初始化任务清单
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:）
**解决**:
```bash
# 检查重复字段
grep -n "^image:" content/blog/tutorials/xxx.mdx
# 删除重复行
awk 'NR!=7' xxx.mdx > temp.mdx && mv temp.mdx xxx.mdx
```
### 问题2: 404链接
**原因**: Related Resources中的链接不存在
**解决**:
```bash
# 批量替换假链接
find content/blog -name "*.mdx" -exec sed -i '' \
's|https://fake-url.com|https://real-url.com|g' {} \;
```
### 问题3: 构建失败
**原因**: MDX语法错误
**解决**:
```bash
# 检查语法
pnpm content
# 查看具体错误
pnpm build 2>&1 | grep -A 5 "Error"
```
### 问题4: 图片不显示
**原因**: 图片路径错误或文件不存在
**解决**:
```bash
# 检查路径
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/seo-llm/raw-seo知识库-TXT整理-seo方法论-seo-knowledge-base-Guideline-MASTER--81cd24.txt（仅本地保留，不入库不部署）