Communitygithub.com

BEKO2210/Firstbrain

从 YouTube 视频中提取转录文本,并利用智能分析框架生成全面、详细的摘要。

Firstbrain 是什么?

该技能旨在为用户提供从 YouTube 视频中提取转录文本并生成详尽摘要的能力。它利用 STAR + R-I-S-E 框架,确保摘要不仅覆盖所有关键点,还具备结构化的逻辑和深度分析。技能会首先验证视频 URL 的有效性和可访问性,然后使用 `youtube-transcript-api` Python 库提取转录文本。提取成功后,技能会将完整的转录文本输入到增强的提示模板中,生成一个包含视频元数据、执行摘要、详细分节分析、概念术语表和结论的 Markdown 格式文档。该技能特别适用于需要深入学习、记录参考文档或从教育内容中提取洞察的开发者和研究人员。它支持多种常见的 YouTube URL 格式,并提供了清晰的错误处理和进度反馈机制,确保用户体验流畅。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BEKO2210/Firstbrain/tree/HEAD/03%20-%20Resources/Skills/youtube-summarizer

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

youtube-summarizer

目的

此技能用于从 YouTube 视频中提取转录文本,并使用 STAR + R-I-S-E 框架生成全面、详细的摘要。它会验证视频的可用性,使用 youtube-transcript-api Python 库提取转录文本,并生成详细的文档,捕获所有见解、论点和关键点。

该技能专为需要从教育视频、讲座、教程或信息类内容中进行全面内容分析和生成参考文档的用户设计。

何时使用此技能

当出现以下情况时,应使用此技能:

  • 用户提供了 YouTube 视频 URL 并希望获得详细摘要
  • 用户需要记录视频内容以供参考,而无需重新观看
  • 用户希望从教育内容中提取见解、关键点和论据
  • 用户需要从 YouTube 视频中提取转录文本进行分析
  • 用户要求“总结”、“概述”或“提取内容”来自 YouTube 视频
  • 用户希望获得内容完整、详尽而非简短的文档

步骤 0:发现与设置

在处理视频之前,验证环境和依赖项:

# 检查 youtube-transcript-api 是否已安装
python3 -c "import youtube_transcript_api" 2>/dev/null
if [ $? -ne 0 ]; then
    echo "⚠️  未找到 youtube-transcript-api"
    # 提供安装选项
fi

# 检查 Python 是否可用
if ! command -v python3 &>/dev/null; then
    echo "❌ 需要 Python 3 但未安装"
    exit 1
fi

如果依赖项缺失,询问用户:

youtube-transcript-api 是必需的,但尚未安装。

是否要立即安装?
- [ ] 是 - 使用 pip 安装 (pip install youtube-transcript-api)
- [ ] 否 - 我将手动安装

如果用户选择“是”:

pip install youtube-transcript-api

验证安装:

python3 -c "import youtube_transcript_api; print('✅ youtube-transcript-api 安装成功')"

主要工作流程

进度跟踪指南

在整个工作流程中,每个步骤前显示一个可视进度条,以告知用户最新状态。进度条格式如下:

echo "[████░░░░░░░░░░░░░░░░] 20% - 步骤 1/5:验证 URL"

格式规范:

  • 宽度为 20 个字符(使用 █ 表示已完成部分,░ 表示未完成部分)
  • 百分比增量:步骤 1=20%,步骤 2=40%,步骤 3=60%,步骤 4=80%,步骤 5=100%
  • 步骤计数器显示当前/总计(例如“步骤 3/5”)
  • 当前阶段的简要说明

在步骤 1 之前显示初始状态框:

╔══════════════════════════════════════════════════════════════╗
║     📹 YOUTUBE 摘要生成器 - 正在处理视频                       ║
╠══════════════════════════════════════════════════════════════╣
║ → 步骤 1:验证 URL                 [进行中]                    ║
║ ○ 步骤 2:检查可用性                                          ║
║ ○ 步骤 3:提取转录文本                                        ║
║ ○ 步骤 4:生成摘要                                            ║
║ ○ 步骤 5:格式化输出                                          ║
╠══════════════════════════════════════════════════════════════╣
║ 进度:██████░░░░░░░░░░░░░░░░░░░░░░░░  20%                    ║
╚══════════════════════════════════════════════════════════════╝

步骤 1:验证 YouTube URL

目标: 提取视频 ID 并验证 URL 格式。

支持的 URL 格式:

  • https://www.youtube.com/watch?v=VIDEO_ID
  • https://youtube.com/watch?v=VIDEO_ID
  • https://youtu.be/VIDEO_ID
  • https://m.youtube.com/watch?v=VIDEO_ID

操作:

# 使用正则表达式或 URL 解析提取视频 ID
URL="$USER_PROVIDED_URL"

# 模式 1:youtube.com/watch?v=VIDEO_ID
if echo "$URL" | grep -qE 'youtube\.com/watch\?v='; then
    VIDEO_ID=$(echo "$URL" | sed -E 's/.*[?&]v=([^&]+).*/\1/')
# 模式 2:youtu.be/VIDEO_ID  
elif echo "$URL" | grep -qE 'youtu\.be/'; then
    VIDEO_ID=$(echo "$URL" | sed -E 's/.*youtu\.be\/([^?]+).*/\1/')
else
    echo "❌ 无效的 YouTube URL 格式"
    exit 1
fi

echo "📹 视频 ID 已提取: $VIDEO_ID"

如果 URL 无效:

❌ 无效的 YouTube URL

请提供以下格式之一的有效 YouTube URL:
- https://www.youtube.com/watch?v=VIDEO_ID
- https://youtu.be/VIDEO_ID

示例:https://www.youtube.com/watch?v=dQw4w9WgXcQ

步骤 2:检查视频和转录文本可用性

进度:

echo "[████████░░░░░░░░░░░░] 40% - 步骤 2/5:检查可用性"

目标: 验证视频是否存在且转录文本可访问。

操作:

from youtube_transcript_api import YouTubeTranscriptApi, TranscriptsDisabled, NoTranscriptFound
import sys

video_id = sys.argv[1]

try:
    # 获取可用转录列表
    transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)
    
    print(f"✅ 视频可访问: {video_id}")
    print("📝 可用的转录文本:")
    
    for transcript in transcript_list:
        print(f"  - {transcript.language} ({transcript.language_code})")
        if transcript.is_generated:
            print("    [自动生成]")
    
except TranscriptsDisabled:
    print(f"❌ 视频 {video_id} 的转录文本功能已禁用")
    sys.exit(1)
    
except NoTranscriptFound:
    print(f"❌ 未找到视频 {video_id} 的转录文本")
    sys.exit(1)
    
except Exception as e:
    print(f"❌ 访问视频时出错: {e}")
    sys.exit(1)

错误处理:

错误消息操作
视频未找到"❌ 视频不存在或已设为私密"要求用户验证 URL
转录文本已禁用"❌ 此视频的转录文本功能已禁用"无法继续
无可用转录文本"❌ 未找到转录文本(未自动生成或手动添加)"无法继续
私密/受限视频"❌ 视频是私密的或受限的"要求提供公开视频

步骤 3:提取转录文本

进度:

echo "[████████████░░░░░░░░] 60% - 步骤 3/5:提取转录文本"

目标: 以首选语言检索转录文本。

操作:

from youtube_transcript_api import YouTubeTranscriptApi

video_id = "VIDEO_ID"

try:
    # 首先尝试以用户首选语言获取转录文本
    # 如果不可用则回退到英语
    transcript = YouTubeTranscriptApi.get_transcript(
        video_id, 
        languages=['pt', 'en']  # 首选葡萄牙语,回退到英语
    )
    
    # 将转录片段合并为完整文本
    full_text = " ".join([entry['text'] for entry in transcript])
    
    # 获取视频元数据
    from youtube_transcript_api import YouTubeTranscriptApi
    transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)
    
    print("✅ 转录文本提取成功")
    print(f"📊 转录文本长度: {len(full_text)} 个字符")
    
    # 保存到临时文件以供处理
    with open(f"/tmp/transcript_{video_id}.txt", "w") as f:
        f.write(full_text)
    
except Exception as e:
    print(f"❌ 提取转录文本时出错: {e}")
    exit(1)

转录文本处理:

  • 将所有转录片段合并为连贯的文本
  • 尽可能保留标点和格式
  • 删除重复或重叠的片段(如果是自动生成的伪影)
  • 存储在临时文件中以供分析

步骤 4:生成综合摘要

进度:

echo "[████████████████░░░░] 80% - 步骤 4/5:生成摘要"

目标: 应用增强版 STAR + R-I-S-E 提示,创建详细摘要。

应用的提示:

使用阶段 2 中的增强版提示(STAR + R-I-S-E 框架),并将提取的转录文本作为输入。

操作:

  1. 加载完整的转录文本
  2. 应用综合摘要生成提示
  3. 使用 AI 模型(Claude/GPT)生成结构化摘要
  4. 确保输出遵循定义的结构:
    • 包含视频元数据的标题
    • 执行概要
    • 详细的分节逐段分析
    • 关键见解和结论
    • 概念与术语
    • 资源与参考

实现:

# 使用转录文本文件作为 AI 提示的输入
TRANSCRIPT_FILE="/tmp/transcript_${VIDEO_ID}.txt"

# AI 代理将:
# 1. 读取转录文本
# 2. 应用 STAR + R-I-S-E 摘要生成框架
# 3. 生成全面的 Markdown 输出
# 4. 使用标题、列表和高亮进行结构化

Read "$TRANSCRIPT_FILE"  # 将转录文本读入上下文

然后应用完整的摘要生成提示(来自阶段 2 的增强版)。

步骤 5:格式化并呈现输出

进度:

echo "[████████████████████] 100% - 步骤 5/5:格式化输出"

目标: 以清晰、结构良好的 Markdown 格式提供摘要。

输出结构:

# [视频标题]

**频道:** [频道名称]  
**时长:** [时长]  
**URL:** [https://youtube.com/watch?v=VIDEO_ID]  
**发布日期:** [如可用]

---

## 📝 详细摘要

### [主题 1]

[包含示例、数据、引用的全面解释...]

#### [子主题 1.1]

[详细分析...]

### [主题 2]

[继续详细分析...]

---

## 📚 概念与术语

- **[术语 1]:** [定义和上下文]
- **[术语 2]:** [定义和上下文]

---

## 📌 结论

[最终综合和关键要点]

---

### **示例 2:缺少依赖项**

**用户输入:**

claude> 总结这个 YouTube 视频 https://youtu.be/abc123


**技能响应:**

⚠️ 未安装 youtube-transcript-api

此技能需要 Python 库 'youtube-transcript-api'。

是否要立即安装?

  • 是 - 使用 pip 安装
  • 否 - 我将手动安装

**用户选择“是”:**

```bash
$ pip install youtube-transcript-api
Successfully installed youtube-transcript-api-0.6.1

✅ 安装完成!正在继续视频摘要...

示例 4:无效 URL

用户输入:

claude> 总结 YouTube 视频 www.youtube.com/some-video

技能响应:

❌ 无效的 YouTube URL 格式

预期的格式示例:
- https://www.youtube.com/watch?v=VIDEO_ID
- https://youtu.be/VIDEO_ID

请提供有效的 YouTube 视频 URL。

📊 执行摘要

本视频全面介绍了人工智能(AI)的基本概念,旨在帮助初学者和专业人士理解现代 AI 的技术基础和实践应用。讲师涵盖了从基本定义到机器学习算法的所有内容,并使用实际示例和可视化来促进理解。

[... 继续详细摘要 ...]


**保存选项:**

您想保存什么? → 摘要 + 原始转录文本

✅ 文件已保存: resumo-exemplo123-2026-02-01.md (包含原始转录文本) [████████████████████] 100% - ✓ 处理完成!


---

欢迎来到这个关于机器学习基础知识的全面教程。在今天的视频中,我们将探讨驱动现代 AI 系统的核心概念...

版本: 1.2.0 最后更新: 2026-02-02 维护者: Eric Andrade

连接

  • 领域: [[设计与创意]]
  • 类别: [[视频与音频制作]]
  • 文件:
    • scripts/extract-transcript.py
    • scripts/install-dependencies.sh
  • 导航: [[技能概览]], [[主页]]

Individual skills in this repo

This repo contains 18 individual skills — each has its own dedicated page.

BEKO2210/Firstbrain

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

BEKO2210/Firstbrain

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

BEKO2210/Firstbrain

One sentence - what this skill does and when to invoke it

BEKO2210/Firstbrain

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

BEKO2210/Firstbrain

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

BEKO2210/Firstbrain

Expert in building portfolios that actually land jobs and clients -

BEKO2210/Firstbrain

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

BEKO2210/Firstbrain

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

BEKO2210/Firstbrain

Best practices for Remotion - Video creation in React

BEKO2210/Firstbrain

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

BEKO2210/Firstbrain

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

BEKO2210/Firstbrain

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

BEKO2210/Firstbrain

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

BEKO2210/Firstbrain

Automate TikTok tasks via Rube MCP (Composio): upload/publish videos, post photos, manage content, and view user profiles/stats. Always search tools first for current schemas.

BEKO2210/Firstbrain

Video and audio perception, indexing, and editing. Ingest files/URLs/live streams, build visual/spoken indexes, search with timestamps, edit timelines, add overlays/subtitles, generate media, and create real-time alerts.

BEKO2210/Firstbrain

Upload, stream, search, edit, transcribe, and generate AI video and audio using the VideoDB SDK.

BEKO2210/Firstbrain

One sentence - what this skill does and when to invoke it

BEKO2210/Firstbrain

Automate YouTube tasks via Rube MCP (Composio): upload videos, manage playlists, search content, get analytics, and handle comments. Always search tools first for current schemas.

相关技能