youtube-thumbnail-grabber

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 是否正在執行，因為它負責處理縮圖持久化所需的後端影像處理任務。