SuperAPI AI 工具集

youtube-transcribe-skill

写作与研究

查看项目

更新于 10-15 21:41

技能介绍

用途:从 YouTube 视频提取字幕或转录文本,保存为本地带时间戳的规范化纯文本,适合需要视频口述内容的场景。

主要能力:通过捆绑脚本 scripts/transcribe_youtube.py 调用 yt-dlp 下载字幕,按偏好选择语言,将 WebVTT 字幕转换为带时间戳的纯文本,并报告输出路径与行数。支持普通 watch 链接以及 youtu.be、Shorts、live、embed 链接。默认语言偏好为简体中文、繁体中文、其他中文变体、英文。

使用方式:先安装 yt-dlp 并确认 yt-dlp --version 成功;确定包含 SKILL.md 的绝对目录 <skill-dir>。默认先不使用浏览器 Cookie 运行: python3 "<skill-dir>/scripts/transcribe_youtube.py" "<youtube-url>" --output-dir "$PWD" 如需指定语言: python3 "<skill-dir>/scripts/transcribe_youtube.py" "<youtube-url>" --languages "ja.,en." --output-dir "$PWD" 成功时生成一个 .txt 文件,非空行形如“00:03 字幕文本”。输出默认放在用户当前工作目录,除非另有要求。

Cookie 重试:默认不读取浏览器 Cookie。仅当首次失败明确因视频需要登录、年龄验证、会员或认证会话时,先说明重试会让 yt-dlp 读取本地浏览器配置的 YouTube Cookie,询问用户批准使用哪个浏览器配置,批准后再运行: python3 "<skill-dir>/scripts/transcribe_youtube.py" "<youtube-url>" --cookies-from-browser chrome --output-dir "$PWD" 不得在转录或日志中打印、复制或持久化浏览器 Cookie。

浏览器回退:仅当 yt-dlp 不可用或无法获取字幕,且当前会话具备浏览器控制能力时使用。检查当前会话可用工具,不假定固定 MCP 服务器或工具名;打开视频、显示转录面板、提取可见的时间戳/文本对,保存为 <sanitized-video-title>.txt,并关闭仅为该任务打开的页面或会话。若两种方式都不可用,应报告能力缺失,不得声称成功。

完成报告需返回:转录文件的绝对路径、所选字幕语言、转录行数、是否使用了浏览器 Cookie 或浏览器自动化。

限制:依赖 yt-dlp 获取字幕;Python 包装脚本本身仅用标准库,未安装 yt-dlp 时仍可显示 --help。其他平台、收费、价格等信息暂未提供。