跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
视频与音频

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"

自动完成:

  1. ✅ 获取视频信息(标题、描述、时长、缩略图)
  2. ✅ 生成 SEO 优化的描述(≤160 字符)
  3. ✅ 提取高质量关键词(5-8 个)
  4. ✅ 添加 YouTube 封面图
  5. ✅ 从描述提取真实内容(亮点、代码示例)
  6. ✅ 创建英文文件名(kebab-case)
  7. ✅ 将长描述拆成可读章节、步骤、代码块和资源区
  8. ✅ 内置 AI 痕迹去除(自然语言处理)
  9. ✅ 确保 SEO 优化
  10. ✅ 保存到 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
}

配置优先级

  1. ~/.youtube-blog-config.json (本地用户配置)
  2. --config 指定的配置文件
  3. 博客目录下的 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
阅读完整来源 ↗