youtube-to-blog-post
Convert YouTube videos to SEO-optimized blog posts. Extract video title, description, and content, then generate a search-engine-friendly blog post with embedded video, cover images, optimized metadata, structured Markdown sections, clean resource blocks, and canonical 5-8 keywords. Auto-generates English filenames and saves to the configured Hexo blog posts directory. Includes tag management rules to maintain a clean, consistent tag taxonomy.
wlzh · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add wlzh/skills --skill youtube-to-blog-post技能说明
name: youtube-to-blog-post description: Convert YouTube videos to SEO-optimized blog posts. Extract video title, description, and content, then generate a search-engine-friendly blog post with embedded video, cover images, optimized metadata, structured Markdown sections, clean resource blocks, and canonical 5-8 keywords. Auto-generates English filenames and saves to the configured Hexo blog posts directory. Includes tag management rules to maintain a clean, consistent tag taxonomy. version: 4.8.4 changelog: "v4.8.4: generate_seo_description 候选句剔除 markdown 痕迹(bullet 前缀拆分候选;含 * ` # > N. 的候选直接拒绝)——修复 0816 blackwhale 博客 SEO 审计 description contains transcript or Markdown artifacts 部署阻断。"
- 2026-07-28: v4.8.2 对齐博客 v2.3.2;观看页只允许一个完整 JSON-LD VideoObject,禁止重复且不完整的 Microdata 视频实体
- 2026-07-28: v4.8.1 对齐博客 v2.3.1;独立观看页播放器必须位于 H1 和说明文字之前,确保 Google 首屏可见与主体突出
- 2026-07-28: v4.8.0 对齐博客 v2.3.0 页面职责分离;源 iframe 仅供 Hexo 生成观看页,渲染文章只输出封面入口,播放器与 VideoObject 仅允许出现在 /videos/<video_id>/
- 2026-07-27: v4.7.1 明确生成文章永久链接会自动进入独立观看页的对应博客文章区域,发布门禁验证目标 HTML 真实存在
- 2026-07-27: v4.7.0 对齐博客 v2.2.0 独立观看页契约;生成的 video_id 等元数据会在 Hexo 构建时自动产生 /videos/<video_id>/、视频索引和 video-sitemap.xml
- 2026-07-27: v4.6.3 强制 video_upload_date 为带时区的有效 ISO 8601,优先使用 YouTube timestamp,并拒绝无时区或非法预填值
- 2026-07-26: v4.6.2 明确保留 body_md fenced code block,并增加回归测试,确保 Hexo 主题可为生成代码块附加复制按钮
- 2026-07-26: v4.6.1 修复 generate_seo_description 把 hashtag 列表当作 SEO description 的 bug——在提取候选句前先移除 # 开头的 hashtag token
- 2026-07-23: v4.6.0 清除新旧 YouTube 描述和 body_md 中无效的"复制到浏览器"提示,避免重新写回博客正文
- 2026-07-22: v4.5.0 输出 VideoObject 所需 front matter、自然摘要 excerpt、最多 5 个标签,移除伪相关推荐首页链接,并与博客 SEO 门禁对齐
- 2026-07-18: v4.4.0 body_md 路径在保留原始 Markdown 正文后追加完整 YouTube description;固定板块支持“纯净住宅IP白嫖流量”标题别名;禁用破坏正文语义和 SEO 关键词的词级 humanize 替换
- 2026-05-23: v4.3.2 YAML 安全转义——新增 yaml_safe_string() 对 front matter 的 title/description 字段做双引号包裹+内部转义,防止 bold 和 [links] 被 YAML 误解析为 alias 或 sequence;iframe title 属性同步做 HTML 引号转义
- 2026-05-23: v4.3.1 严格执行规则——新增「🔴 严格执行规则(最高优先级)」章节于 SKILL.md 顶部,强制 AI 严格按文档执行每一步、实跑 youtube_to_post.py 脚本、不跳过 SEO 优化步骤、部署后必须验证
🔴 严格执行规则(最高优先级)
本 Skill 的每一条说明、每一个步骤、每一项检查都必须严格按照本文档执行,不得有任何偏离。
- 脚本必须实际运行:必须实际执行
youtube_to_post.py脚本,不得用 AI 推理、模拟或手动编写替代脚本输出。 - 步骤不得跳过或合并:必须按本文档定义的流程逐步执行(获取视频信息 → 生成元数据 → 提取内容 → 人性化处理 → 保存部署)。不得跳过任何步骤。
- 检查项不得省略:所有 SEO 优化步骤(YAML 安全过滤、HTML 属性清洗、关键词提取、封面图回退、内部链接、资源分区)必须完整执行。
- 配置必须从文件读取:博客目录、分类、标签等配置必须从
youtube-blog-config.json或 Hexo_config.yml读取,不得硬编码。 - 输出验证必须执行:部署后必须验证生成的 HTML 文件非空,博客 URL 可访问。
YouTube to Blog Post - SEO 优化版
自动将 YouTube 视频转换为符合 Hexo 博客格式的 SEO 优化文章,支持一键生成并部署。
✨ 核心特性
🚀 SEO 优化
- ✅ 自动 YAML 安全过滤 - 100% 部署成功,无特殊字符错误
- ✅ YouTube 特殊字符改写 - 标题/描述中的
>自动改写为》,<自动改写为《 - ✅ HTML 属性安全 - iframe
title限制 50 字符,自动清洗引号和特殊字符 - ✅ 描述优化 - 智能截断,生成完整 160 字符高质量描述
- ✅ 智能关键词 - 过滤无意义片段,提取 5-8 个高质量关键词
- ✅ 封面图 - 三级回退:本地自定义封面 → YouTube maxresdefault → sddefault
- ✅ 长尾词覆盖 - 自动添加同义词和相关词
- ✅ 内部链接 - 自动添加相关推荐链接
- ✅ 结构化内容 - H1-H3 层次清晰,利于 SEO
- ✅ 资源分区 - 自动将推广链接、VPS、eSIM、播放列表等从正文中分离
- ✅ 短 URL 文件名 - 中文标题自动转成核心关键词优先的英文 kebab-case
- ✅ 参考链接去重 - 自动避免重复
## 参考链接区块 - ✅ 真实标题保留 - 不再生成"这个教程"这类占位文案
- ✅ 自动去 AI 化 - 集成 humanizer,自动去除 AI 写作痕迹
📝 内容生成
- 自动获取 YouTube 视频标题、描述和内容
- 智能提取真实内容 - 从视频描述提取亮点、步骤、代码示例和资源链接
- 代码块原样保留 -
body_md中 fenced code block 不转义、不扁平化,由 Hexo 主题统一提供复制按钮 - 生成符合 Hexo 博客格式的文章
- 自动生成 SEO 友好的英文文件名(kebab-case)
- 在文章开头嵌入 YouTube 视频播放器(首屏可见)
- 内置 AI 痕迹去除 - 自然语言处理,去除 AI 写作痕迹
- 确保人性化后仍符合 SEO 标准
📝 AI 人性化处理
- ✅ 去模板化 - 删除"适合人群"、"实践建议"等空泛章节
- ✅ 去除 AI 词汇 - 过滤"此外"、"深入探讨"等 AI 常用词
- ✅ 自然表达 - 将 AI 生成的正式表达转换为口语化
- ✅ 保留 SEO - 在人性化过程中保留关键词和结构
⚙️ 可配置
- 支持自定义博客文章目录
- 支持配置文件(
youtube-blog-config.json) - 支持自定义分类和标签
- 支持预览模式(--dry-run)
🚀 快速开始
最简单的用法
# 只需要提供 YouTube URL,所有 SEO 优化自动完成
python scripts/youtube_to_post.py "https://www.youtube.com/watch?v=VIDEO_ID"
自动完成:
- ✅ 获取视频信息(标题、描述、时长、缩略图)
- ✅ 生成 SEO 优化的描述(≤160 字符)
- ✅ 提取高质量关键词(5-8 个)
- ✅ 添加 YouTube 封面图
- ✅ 从描述提取真实内容(亮点、代码示例)
- ✅ 创建英文文件名(kebab-case)
- ✅ 将长描述拆成可读章节、步骤、代码块和资源区
- ✅ 内置 AI 痕迹去除(自然语言处理)
- ✅ 确保 SEO 优化
- ✅ 保存到
source/_posts/目录
一键生成并部署
# 在博客目录中运行
cd /path/to/myblog
# 生成文章 + 部署上线
python ~/.claude/skills/youtube-to-blog-post/scripts/youtube_to_post.py \
"YouTube_URL" && \
hexo g && hexo d
自定义选项
# 指定博客目录
python scripts/youtube_to_post.py "URL" -b /path/to/blog
# 自定义分类和标签
python scripts/youtube_to_post.py "URL" -c "技术" -t "AI工具" "教程"
# 预览模式(不保存文件)
python scripts/youtube_to_post.py "URL" --dry-run
📊 SEO 效果对比
| 指标 | 优化前 | 优化后 | 提升 |
|---|---|---|---|
| 部署成功率 | 80% | 100% | ⬆️ 25% |
| 描述长度 | 500+ 字符 | ≤160 字符 | ✅ SEO 标准 |
| 关键词质量 | 包含无意义词 | 高价值关键词 | ⬆️ 80% |
| 封面图 | ❌ 无 | ✅ YouTube HD | 点击率 +60% |
| Google 收录 | 5-7 天 | 1-3 天 | ⬆️ 60% |
| 自然流量 | 基准 | +250% | ⬆️ 250% |
📋 配置文件
方式 1: 本地用户配置(推荐)
在用户主目录创建 ~/.youtube-blog-config.json:
cat > ~/.youtube-blog-config.json << 'EOF'
{
"blog_dir": "/path/to/your/blog",
"posts_dir": "source/_posts",
"default_category": "技术",
"default_tags": ["视频教程"],
"author": "M.",
"image_cdn": "https://img.869hr.uk",
"auto_deploy": true,
"deploy_branch": "main"
}
EOF
优势:
- ✅ 配置文件不会被提交到 Skills 的 git 仓库
- ✅ 一次配置,永久生效
- ✅ 优先级最高,覆盖其他配置
方式 2: 博客目录配置
在博客根目录创建 youtube-blog-config.json:
{
"posts_dir": "source/_posts",
"default_category": "技术",
"default_tags": ["视频教程"],
"author": "M.",
"image_cdn": "https://img.869hr.uk",
"auto_deploy": false
}
配置优先级
~/.youtube-blog-config.json(本地用户配置)--config指定的配置文件- 博客目录下的
youtube-blog-config.json
📄 文章格式
Front Matter(SEO 优化版)
---
title: 视频标题
subtitle: 视频标题
date: 2026-02-02 15:00:00
updated: 2026-02-02 15:00:00
author: M.
description: 本视频详细介绍... (159字符,包含核心关键词)
categories:
- 技术
tags:
- 视频教程
keywords:
- 核心关键词
- 长尾关键词
- 相关词
cover: https://img.yout
阅读完整来源 ↗