YouTube → Plaud（youtube-to-plaud）

把 YouTube（或任意在线视频）音频导出到 Plaud 并转写的完整工作流，封装成一个 Claude Code Skill。 A complete, first-principles workflow for exporting YouTube (or any online video) audio into Plaud and transcribing it — packaged as a Claude Code Skill.

从一次真实实战提炼（2026-07）。核心不是某个现成集成，而是把问题拆成三段不可再分的物理动作，并在每段找到"自动化的极限"。

第一性拆解 · First-Principles Decomposition

① 取音频          ② 送进 Plaud        ③ 转成文字
  Extract audio  →  Move across       →  Transcribe
  (from video)      systems              (speech → text)

核心洞察：不存在"YouTube 直连 Plaud"的产品，三段不能被同一工具贯通。正确做法是用三个独立环节拼一条链。

三条硬约束 · Hard Constraints (all battle-tested)

#	约束 Constraint	根因 Root cause	影响 Impact
1	Plaud 无公开 API/CLI	硬件+App 闭环生态	"送进 Plaud"无法纯脚本化，极限=产出兼容文件放到"可一键导入处"
2	大文件无法经 base64 内联上传	41MB→约 1450 万 tokens	大文件塞不进 MCP 工具调用，须另想通道
3	浏览器驱动传网盘脆弱	iframe UI / 原生文件框 / 标签页易失	可尝试但不可靠，慎用

推论：既然②的自动化上限只是"把文件放到能一键导入处"，桌面场景根本不需要网盘——直接 Plaud Web 拖入即可。

快速开始 · Quick Start

# 0. 环境（ffmpeg 必须；缺 yt-dlp 则装）
brew install yt-dlp ffmpeg

# 1a. 先验证可达性 + 时长（关系 Plaud 5h 上限）
yt-dlp --skip-download \
  --print "%(title)s | %(duration>%H:%M:%S)s" "<VIDEO_URL>"

# 1b. 抽音频转 mp3（ascii 文件名，规避特殊字符坑）
yt-dlp -x --audio-format mp3 --audio-quality 3 --embed-metadata \
  -o "audio.%(ext)s" "<VIDEO_URL>"

# 2. 送进 Plaud —— 桌面首选：web.plaud.ai → Import audio → 拖入 mp3
# 3. 转写 —— 交给 Plaud 云端 AI（或飞书妙记 / 本地 whisper）

单文件 ≤5 小时（超则 Plaud 自动切 2 段）；支持 mp3 / wav / m4a / aac。

作为 Claude Code Skill 安装 · Install as a Claude Code Skill

git clone https://github.com/weitzu-com/youtube-to-plaud.git \
  ~/.claude/skills/youtube-to-plaud

之后在 Claude Code 里说「把这个视频导出到 Plaud」「YouTube 音频转写」，或直接给出视频 URL 即可触发。完整 skill 定义见 SKILL.md。

复盘心法 · Transferable Lessons

适用于同类"跨闭环系统搬运"任务：

先证可达，再谈流程 — 用 --skip-download 先验证。
约束优先于设计 — 遇闭环生态（无 API）先问"自动化极限在哪"。
量纲检查挡住无效尝试 — 41MB→1450 万 tokens 是一眼算得出的死路。
脆弱路径设止损 — 一轮不通即撤，转最短可靠路径。
最短路径常在绕行方案的反面 — 拆开约束后发现桌面根本不需要网盘。

License

MIT