生产力
youtube-thumbnail-grabber avatar

youtube-thumbnail-grabber

下载各种分辨率与格式的 YouTube 视频缩略图。集成 yt-dlp 自动化获取视频预览图片与图像处理。

简介

YouTube Thumbnail Grabber 是一款专为内容创作者、研究人员与开发者设计的自动化代理技能,旨在高效获取 YouTube 视频元数据与视觉素材。通过整合行业标准工具 yt-dlp,此技能可编程化地下载多种画质的视频缩略图,涵盖从基础的 120x90 默认帧到 1280x720 的高分辨率版本。它简化了获取预览图以制作拼贴、建立参考档案库或集成至内容管理系统的繁琐流程。

  • 下载五种标准 YouTube 画质等级的缩略图:maxresdefault、sddefault、hqdefault、mqdefault 与 default。

  • 利用自动化工作流将各种格式(如 WebP)转换为标准化的 JPG 文件。

  • 支持批量处理功能,可处理整个 YouTube 播放列表或通过文本文件导入的视频链接列表。

  • 从完整 URL 中提取视频 ID,并获取包含标题与额外视频帧截取(0-3)在内的原始视频元数据。

  • 支持直接链接构建与基于 curl 的下载方式,适合高速度的无头(headless)环境运行。

  • 前置需求:在 Windows 与 macOS 上进行图像处理与格式转换时,必须保持 openclaw-agent 工具处于运行状态。

  • 依赖项:此技能依赖于本地环境中安装的 yt-dlp;请使用 pip install yt-dlp 进行初始化。

  • 最佳实践:请求 maxresdefault 时请检查高画质可用性;若失败则回退至 hqdefault 以确保素材生成的稳定性。

  • 故障排除:若下载失败,请确认 openclaw-agent 是否正在运行,因为它负责处理缩略图持久化所需的后端图像处理任务。

仓库统计

Star 数
4,456
Fork 数
1,217
Open Issue 数
7
主要语言
Python
默认分支
main
同步状态
空闲
最近同步时间
2026年4月30日 16:48
在 GitHub 查看