YouTube 字幕提取

从 YouTube 视频 URL 提取字幕/转录文本，并保存为本地文件。

输入 YouTube URL：$ARGUMENTS

步骤 1：验证 URL 并获取视频信息

1. 验证 URL 格式：确认输入为有效的 YouTube URL（支持 youtube.com/watch?v= 或 youtu.be/ 格式）。

2. 获取视频信息：使用 WebFetch 或 firecrawl 抓取页面，提取视频标题以用于后续文件命名。

步骤 2：CLI 快速提取（优先尝试）

使用命令行工具快速提取字幕。

1. 检查工具可用性：
   执行 which yt-dlp。

   • 若 yt-dlp 存在，继续执行字幕下载。
   • 若 yt-dlp 不存在，立即跳转至 步骤 3。

2. 执行字幕下载（仅当检测到 yt-dlp 时）：

   • 提示：始终添加 --cookies-from-browser 参数以规避登录限制，默认使用 chrome。
   • 重试逻辑：若 yt-dlp 因浏览器错误失败（例如 “Could not open Chrome”），请向用户询问其可用的浏览器（如 firefox、safari、edge），并使用指定浏览器重试。

   # 先获取标题（默认尝试 chrome）
   yt-dlp --cookies-from-browser=chrome --get-title "[VIDEO_URL]"
   
   # 下载字幕
   yt-dlp --cookies-from-browser=chrome --write-auto-sub --write-sub --sub-lang zh-Hans,zh-Hant,en --skip-download --output "

3. 验证结果：

   • 检查命令退出码（exit code）。
   • 退出码为 0（成功）：字幕已成功保存至本地，任务完成。
   • 退出码非 0（失败）：
     • 若错误与浏览器/cookies 相关，请用户确认正确浏览器并重试步骤 2；
     • 若为其他错误（例如视频不可用），则进入 步骤 3。

步骤 3：浏览器自动化（备用方案）

当 CLI 方法失败或系统未安装 yt-dlp 时，采用浏览器 UI 自动化方式提取字幕。

1. 检查工具可用性：

   • 检查是否具备 chrome-devtools-mcp 工具（特别是 mcp__plugin_claude-code-settings_chrome__new_page）。
   • 关键检查：若 chrome-devtools-mcp 不可用，且步骤 2 中 yt-dlp 也 未被找到，则：
     • 中止执行；
     • 通知用户：“无法继续执行。请安装 yt-dlp（用于快速 CLI 提取），或配置 chrome-devtools-mcp（用于浏览器自动化）。”

2. 初始化浏览器会话（若工具可用）：

   调用 mcp__plugin_claude-code-settings_chrome__new_page 打开视频 URL。

3.2 分析页面状态

调用 mcp__plugin_claude-code-settings_chrome__take_snapshot 获取当前页面的可访问性树（accessibility tree）。

3.3 展开视频描述区域

原因：“Show transcript” 按钮通常隐藏在已折叠的视频描述区域内。

1. 在快照中搜索文字为 “...more”、“...更多” 或 “Show more” 的按钮（通常位于视频标题下方的描述区块中）。
2. 调用 mcp__plugin_claude-code-settings_chrome__click 点击该按钮。

3.4 打开字幕面板

1. 调用 mcp__plugin_claude-code-settings_chrome__take_snapshot 获取更新后的 UI 快照。
2. 搜索文字为 “Show transcript”、“显示转录稿” 或 “内容转文字” 的按钮。
3. 调用 mcp__plugin_claude-code-settings_chrome__click 点击该按钮。

3.5 通过 DOM 提取内容

原因：对长列表直接读取可访问性树效率低且消耗大量 token；DOM 注入方式更高效。

调用 mcp__plugin_claude-code-settings_chrome__evaluate_script 执行以下 JavaScript：

() => {
  // 选取所有字幕片段容器
  const segments = document.querySelectorAll("ytd-transcript-segment-renderer");
  if (!segments.length) return "BUFFERING"; // 若为空则重试

  // 遍历并格式化为 "时间戳 文本"
  return Array.from(segments)
    .map((seg) => {
      const time = seg.querySelector(".segment-timestamp")?.innerText.trim();
      const text = seg.querySelector(".segment-text")?.innerText.trim();
      return `${time} ${text}`;
    })
    .join("\n");
};

若返回值为 "BUFFERING"，等待数秒后重试。

3.6 保存与清理

1. 使用 Write 工具将提取的文本保存为本地文件（例如：）。
2. 调用 mcp__plugin_claude-code-settings_chrome__close_page 释放浏览器资源。

输出要求

• 将字幕文件保存至当前工作目录。
• 文件名格式：
• 文件内容格式：每行为 时间戳 字幕文本。
• 任务完成后报告：文件路径、字幕语言、总行数。