mcpField
Y
youtube-processor

youtube-processor

github.com/nicepkg生产力288101 次安装40 周前更新
代码仓库

关于 youtube-processor

youtube-processor 是一项用于提取 YouTube 字幕、生成摘要并整理为 Obsidian 格式笔记的技能。它支持通过 Python 脚本或 API 提取字幕，并可按需求调整摘要内容。

主要功能

  1. 01提取 YouTube 字幕
  2. 02支持 Python 脚本和 API 提取
  3. 03生成简要或详细摘要
  4. 04整理为 Obsidian 格式笔记
  5. 05挖掘 newsletter 写作角度

适用场景

  1. 01总结 YouTube 视频
  2. 02将视频笔记保存为 Obsidian 格式
  3. 03从视频中寻找 newsletter 选题

安装

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

$npx skills add https://github.com/nicepkg/ai-workflow --skill youtube-processor

安装后在 Claude Code 中输入/youtube-processor确认已加载。

包含的文件

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

.gitignore
requirements.txt
TODO.md
vercel.json
api/
main.py
docs/
GUIDE.md
ROADMAP.md
examples/
sample-output.md
tools/
get_transcript.py
process_video.py
youtube_core.py

详细介绍

YouTube 处理器

功能说明

输入 YouTube URL，提取字幕，然后由你（Claude）进行总结。输出可直接用于 Obsidian 的 Markdown。零摩擦：分享链接，即可获得可执行的笔记。

适用场景

  • “总结这个视频：[URL]”
  • “把这个 YouTube 视频整理成笔记”
  • “这个视频讲了什么？”
  • “处理这个视频，供我的通讯使用”
  • 分享任何需要处理的 YouTube URL

位置

此技能的工具位于：

/Users/eddale/Documents/GitHub/powerhouse-lab/skills/youtube-processor/tools/

工作原理

步骤 1： Python 提取字幕（无需 API 密钥） 步骤 2： 你（Claude）结合自身智能与上下文进行总结 步骤 3： 你撰写符合 Obsidian 格式的输出

采用这种方式，你可以在总结时使用 mission-context、newsletter-coach 等技能。

使用说明

选择使用的方法
环境方法
Claude Code本地 Python 脚本（步骤 1a）
Claude.ai / Mac Client通过 WebFetch 调用 API（步骤 1b）
步骤 1a：提取字幕（Claude Code）

运行 Python 工具以获取字幕：

cd /Users/eddale/Documents/GitHub/powerhouse-lab/skills/youtube-processor/tools && \
python3 get_transcript.py --url "[URL]"

如需 JSON 输出（更易解析）：

python3 get_transcript.py --url "[URL]" --json
步骤 1b：提取字幕（Claude.ai / Mac Client）

通过 WebFetch 使用 API 端点：

WebFetch: https://youtube-processor-eight.vercel.app/transcript?url=[VIDEO_URL]

API 返回 JSON：

{
  "success": true,
  "video_id": "abc123",
  "language": "en",
  "transcript": "...",
  "char_count": 5000,
  "word_count": 850
}

WebFetch 提示词示例： “从响应中提取字幕文本”

步骤 2：总结字幕

获取字幕后，根据用户的需求进行总结：

快速总结：

  • 标题（1 句话）
  • 要点（3-5 条）
  • 核心结论

详细分析：

  • 标题摘要
  • 带背景信息的要点
  • 核心结论
  • 提及的行动事项
  • 这与 Ed 的工作有何关联（如相关）

通讯素材挖掘：

  • 文章的切入点构想
  • 核心洞见/框架
  • 轶事的故事脉络
  • 给读者的收获
  • The Little Blue Report 的通讯角度
步骤 3：整理为 Obsidian 格式

按以下结构创建 Markdown：

---
source: YouTube
video_id: [ID]
url: [URL]
processed: [YYYY-MM-DD HH:MM]
tags: [youtube, video-notes]
---

# [Video Title or Topic]

**Link**: [URL]
**Processed**: [Date]

## Summary

[Your summary here]

---

## Full Transcript

[The transcript]

---

_Generated by youtube-processor skill_
步骤 4：保存（可选）

保存到 Ed 的 Zettelkasten：

/Users/eddale/Documents/COPYobsidian/MAGI/Zettelkasten/

文件名格式：YT - [Topic] - YYYY-MM-DD.md

错误处理

错误含义处理方式
"Transcripts disabled"创作者关闭了字幕无法处理该视频
"No transcript found"没有可用的英文字幕尝试其他视频
"Video unavailable"视频为私有、已删除或有年龄限制检查 URL

示例

示例 1：快速总结

用户说：

Summarize this: https://www.youtube.com/watch?v=VIDEO_ID

你要做：

  1. 运行：python3 get_transcript.py --url "https://www.youtube.com/watch?v=VIDEO_ID"
  2. 阅读字幕输出
  3. 向用户提供总结
示例 2：保存到 Obsidian

用户说：

Turn this video into notes and save it: [URL]

你要做：

  1. 使用 Python 工具提取字幕
  2. 总结内容
  3. 整理为 Obsidian Markdown
  4. 使用 Write 工具保存到 Zettelkasten
  5. 确认：“已保存到 [filepath]”
示例 3：通讯素材挖掘

用户说：

I want to write about this video for the newsletter: [URL]

你要做：

  1. 提取字幕
  2. 分析通讯角度（切入点、洞见、故事脉络）
  3. 呈现这些角度
  4. 提议交由 newsletter-coach 技能继续处理

集成点

  • newsletter-coach：提取视频洞见后，交由其继续开发文章
  • mission-context：总结时采用 Ed 的口吻和风格
  • task-clarity-scanner：可将视频中的行动事项添加到每日笔记

依赖项

Python 工具需要：

youtube-transcript-api

如有需要，请安装：

pip3 install youtube-transcript-api

版本历史

版本日期变更
1.12026-01-03添加 Vercel API，以支持 Claude.ai/Mac 客户端
1.02026-01-02初始版本，支持字幕提取

备注与经验

  • youtube-transcript-api 无需 API 密钥即可使用
  • 大多数视频都有自动生成的英文字幕
  • 由 Claude 总结比由 Python 调用 API 更好（可以利用上下文）
  • 普通视频的字幕提取耗时约 3-5 秒

评论

支持 Markdown