• 提示：始终添加 --cookies-from-browser 以避免登录限制。默认为 chrome。
• 如果因浏览器错误失败（例如“无法打开 Chrome”），请要求用户指定其可用的浏览器（例如 firefox、safari、edge）并重试。

2.3 下载字幕

yt-dlp --cookies-from-browser=chrome --write-auto-sub --write-sub --sub-lang zh-Hans,zh-Hant,en --skip-download --output "<Video Title>.%(ext)s" "[VIDEO_URL]"

2.4 转换为纯文本

yt-dlp 将字幕保存为 .vtt 或 .srt 文件。将下载的文件转换为纯 时间戳 文本 格式：

1. 读取下载的字幕文件（.vtt 或 .srt）。
2. 去除 VTT/SRT 头部信息、样式标签和重复行。
3. 保存为 <Video Title>.txt，每行一个 时间戳 文本 条目。

2.5 验证结果

• 退出码 0：转换并保存字幕文件，然后报告完成。
• 退出码非 0：
  • 如果错误与浏览器/cookies 相关，请询问用户正确的浏览器并重试。
  • 如果是其他错误（例如视频不可用），则继续 步骤 3。

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

当 CLI 方法失败或缺少 yt-dlp 时，使用 Chrome DevTools MCP 通过浏览器 UI 自动化提取字幕。

3.1 检查工具可用性

检查 Chrome DevTools MCP 工具是否可用（查找匹配 chrome__new_page 或类似的工具）。

如果 Chrome DevTools MCP 不可用 且步骤 2 中 未找到 yt-dlp，则停止并通知用户：“无法继续。请安装 yt-dlp（用于快速 CLI 提取）或配置 Chrome DevTools MCP（用于浏览器自动化）。”

3.2 打开视频页面

使用 Chrome DevTools MCP new_page 打开视频 URL。

3.3 分析页面状态

使用 Chrome DevTools MCP take_snapshot 读取页面的无障碍功能树。

3.4 展开视频描述

“显示转录稿”按钮通常隐藏在折叠的描述区域内。

1. 在快照中搜索标记为 "...more"、"...更多" 或 "Show more" 的按钮（位于视频标题下方的描述块中）。
2. 使用 Chrome DevTools MCP click 点击该按钮。

3.5 打开转录稿面板

1. 使用 Chrome DevTools MCP take_snapshot 获取更新后的 UI。
2. 搜索标记为 "Show transcript"、"显示转录稿" 或 "内容转文字" 的按钮。
3. 使用 Chrome DevTools MCP click 点击该按钮。
4. 如果未找到该按钮，则视频可能没有可用的转录稿——通知用户并停止。

3.6 通过 DOM 提取内容

直接读取长转录稿列表的无障碍功能树速度慢且消耗大量 token。改用 Chrome DevTools MCP 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 次）。

3.7 保存并清理

1. 将提取的文本保存为 <Video Title>.txt。
2. 使用 Chrome DevTools MCP close_page 释放资源。

输出要求

• 将字幕文件保存到当前工作目录。
• 文件名格式：<Video Title>.txt
• 文件内容格式：每行应为 时间戳 字幕文本。
• 完成后报告：文件路径、字幕语言和总行数。

每周安装数

97

仓库

feiskyer/claude…settings

GitHub 星标数

1.4K

首次出现

2026 年 1 月 23 日

安全审计

Gen Agent Trust HubPassSocketPassSnykWarn

安装于

opencode85

gemini-cli81

codex81

cursor78

claude-code75

github-copilot74