mcpField
T
transcribe-and-analyze

transcribe-and-analyze

github.com/nicepkg创意与媒体28869 次安装40 周前更新
代码仓库

关于 transcribe-and-analyze

transcribe-and-analyze 是一项命令行技能，可用 WhisperKit 在本地转录音视频链接，并按需分析转录文本。分析可使用 OpenAI 或本地 Ollama，生成摘要、见解、主题、引述和行动项。

主要功能

  1. 01在本地转录音视频链接
  2. 02选择不同尺寸的 Whisper 模型
  3. 03使用 OpenAI 或 Ollama 分析文本
  4. 04通过自定义提示词指定分析内容
  5. 05将转录和分析结果保存为 Markdown

适用场景

  1. 01在本地转录 YouTube 视频
  2. 02从讲座中提取见解和行动项
  3. 03对同一份转录文本进行多种定向分析

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/nicepkg/ai-workflow --skill transcribe-and-analyze

安装后在 Claude Code 中输入/transcribe-and-analyze确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
configuration.md
troubleshooting.md
usage-patterns.md
scripts/
analyze_transcript.py
transcribe.py

详细介绍

转录与分析

使用 WhisperKit 在本地转录音频/视频内容。可根据请求使用 OpenAI 或本地 Ollama 进行分析。

功能

  1. 转录 - 使用 WhisperKit 将音频/视频 URL 转换为文本（在本地运行，始终可用）
  2. 分析 - 从转录文本中提取洞见（仅在用户提出请求时进行，支持 OpenAI 或 Ollama）

快速开始

仅转录
python3 scripts/transcribe.py "https://youtube.com/watch?v=..."
转录并分析（OpenAI）
python3 scripts/transcribe.py "https://youtube.com/watch?v=..."
python3 scripts/analyze_transcript.py whisper-transcriptions/video.md
转录并分析（本地）
python3 scripts/transcribe.py "https://youtube.com/watch?v=..."
python3 scripts/analyze_transcript.py whisper-transcriptions/video.md --local

转录

脚本选项
# Basic
python3 scripts/transcribe.py "URL"

# Custom output directory
python3 scripts/transcribe.py "URL" --output-dir "/path/to/save"

# Higher accuracy (slower)
python3 scripts/transcribe.py "URL" --model medium

# Without timestamps
python3 scripts/transcribe.py "URL" --no-timestamps

# Custom filename
python3 scripts/transcribe.py "URL" --filename "my-transcription.md"
Whisper 模型
模型速度准确度适用场景
tiny最快最低快速草稿、测试
base快尚可简单内容
small均衡良好默认设置 - 适用于大多数场景
medium较慢高讲座、重要内容
large最慢最高需要关键级别的准确度
依赖项

脚本会检查这些依赖项；如果缺失，则提供安装说明。

输出

转录结果会以 Markdown 格式保存到 ./whisper-transcriptions/：

# Transcription

**Source:** https://youtube.com/watch?v=example
**Transcribed:** 2025-01-15 14:30:00
**Tool:** WhisperKit

---

[00:00:00.000 --> 00:00:05.000] Welcome to this video...

分析

提供方选项

OpenAI API（默认）：

python3 scripts/analyze_transcript.py transcript.md
python3 scripts/analyze_transcript.py transcript.md --model gpt-4o

需要 OPENAI_API_KEY 环境变量。

本地 Ollama：

python3 scripts/analyze_transcript.py transcript.md --local
python3 scripts/analyze_transcript.py transcript.md --local --model mistral

需要 Ollama 正在运行（ollama serve）。

脚本选项
# Default comprehensive analysis (OpenAI)
python3 scripts/analyze_transcript.py transcript.md

# Use local Ollama
python3 scripts/analyze_transcript.py transcript.md --local

# Specify model
python3 scripts/analyze_transcript.py transcript.md --model gpt-4o
python3 scripts/analyze_transcript.py transcript.md --local --model llama3.2

# Custom analysis prompt
python3 scripts/analyze_transcript.py transcript.md --prompt "List all tools mentioned"

# Custom output location
python3 scripts/analyze_transcript.py transcript.md --output ~/Documents/analysis.md

# Print to stdout instead of saving
python3 scripts/analyze_transcript.py transcript.md --print
默认分析包含
  • 执行摘要（2-3 段）
  • 关键洞见（5-7 个要点）
  • 讨论主题及摘要
  • 值得注意的引言（3-5 条令人印象深刻的引言）
  • 行动事项和建议
  • 其他观察
自定义提示词示例
--prompt "List all technologies and tools mentioned"
--prompt "What are the main arguments presented?"
--prompt "Extract all statistics and data points"
--prompt "Summarize in 5 bullet points"
--prompt "What questions were asked and how were they answered?"
依赖项
  • openai - pip install openai（OpenAI 和 Ollama 均使用）
  • OPENAI_API_KEY 环境变量（仅用于 OpenAI）
  • 本地运行的 Ollama（用于 --local 模式）
输出

分析结果会与转录文件保存在同一目录下，文件名为 transcript_name_analysis.md：

# Transcript Analysis

**Source Transcript:** path/to/transcript.md
**Analysis Model:** gpt-4o-mini (OpenAI)
**Tokens Used:** 33,763

---

[Analysis content]

常见工作流

完整流程：从 URL 到洞见（云端）
python3 scripts/transcribe.py "https://youtube.com/watch?v=abc123"
python3 scripts/analyze_transcript.py whisper-transcriptions/watch.md
完整流程：从 URL 到洞见（本地）
python3 scripts/transcribe.py "https://youtube.com/watch?v=abc123"
python3 scripts/analyze_transcript.py whisper-transcriptions/watch.md --local
对同一份转录进行多次分析
python3 scripts/analyze_transcript.py transcript.md --output summary.md
python3 scripts/analyze_transcript.py transcript.md --prompt "List action items" --output actions.md
python3 scripts/analyze_transcript.py transcript.md --prompt "Extract quotes" --output quotes.md
批量转录
python3 scripts/transcribe.py "URL1"
python3 scripts/transcribe.py "URL2"
python3 scripts/transcribe.py "URL3"

参考文件

故障排查（references/troubleshooting.md）
  • 下载失败
  • 转录错误
  • 依赖项问题
  • API 错误
配置（references/configuration.md）
  • 输出格式详情
  • 文件命名规则
  • 模型选择指南
使用模式（references/usage-patterns.md）
  • 常见转录场景
  • 分析模式
  • 批处理技巧

脚本

脚本用途
scripts/transcribe.py从 URL 下载并转录音频/视频（WhisperKit）
scripts/analyze_transcript.py对转录文件进行 AI 分析（OpenAI 或 Ollama）

评论

支持 Markdown