/ ディレクトリ / プレイグラウンド / youtube-fetcher-to-markdown
● コミュニティ JimmySadek ⚡ 即起動

youtube-fetcher-to-markdown

作者 JimmySadek · JimmySadek/youtube-fetcher-to-markdown

Turn any YouTube URL into a queryable Markdown note — YAML frontmatter, chapters, full transcript, Obsidian-ready.

JimmySadek/youtube-fetcher-to-markdown converts YouTube videos into structured Markdown in ~/yt_transcripts/. Accepts URLs in any format. Options: --timestamps (temporal markers), --lang (caption language), --format (json / srt), --source (project tag). Output includes YAML frontmatter (title, channel, id, date, duration, language), full description with links, chapter timestamps, and transcript. Frontmatter lets Obsidian Dataview query your entire transcript library.

なぜ使うのか

主な機能

ライブデモ

実際の動作

youtube-fetcher-to-markdown-skill.replay ▶ 準備完了
0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "youtube-fetcher-to-markdown-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/JimmySadek/youtube-fetcher-to-markdown",
        "~/.claude/skills/youtube-fetcher-to-markdown"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "youtube-fetcher-to-markdown-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/JimmySadek/youtube-fetcher-to-markdown",
        "~/.claude/skills/youtube-fetcher-to-markdown"
      ],
      "_inferred": true
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "youtube-fetcher-to-markdown-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/JimmySadek/youtube-fetcher-to-markdown",
        "~/.claude/skills/youtube-fetcher-to-markdown"
      ],
      "_inferred": true
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "youtube-fetcher-to-markdown-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/JimmySadek/youtube-fetcher-to-markdown",
        "~/.claude/skills/youtube-fetcher-to-markdown"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "youtube-fetcher-to-markdown-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/JimmySadek/youtube-fetcher-to-markdown",
        "~/.claude/skills/youtube-fetcher-to-markdown"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json
{
  "context_servers": {
    "youtube-fetcher-to-markdown-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/JimmySadek/youtube-fetcher-to-markdown",
          "~/.claude/skills/youtube-fetcher-to-markdown"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add youtube-fetcher-to-markdown-skill -- git clone https://github.com/JimmySadek/youtube-fetcher-to-markdown ~/.claude/skills/youtube-fetcher-to-markdown

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方: youtube-fetcher-to-markdown

Archive a YouTube lecture series as a searchable Obsidian vault

👤 Self-learners and researchers ⏱ ~20 min beginner

使うタイミング: You're studying from YouTube and want to search across 20+ videos later.

前提条件
  • Skill cloned — git clone https://github.com/JimmySadek/youtube-fetcher-to-markdown ~/.claude/skills/youtube-fetcher-to-markdown
  • yt-dlp or equivalent installed — brew install yt-dlp
フロー
  1. Fetch a playlist's transcripts
    youtube-fetcher-to-markdown — fetch every video in playlist <URL>, include timestamps, source=cs-course.✓ コピーしました
    → ~/yt_transcripts/ fills with per-video markdown files, all tagged source: cs-course
  2. Query via Dataview
    In Obsidian, write a Dataview query listing all cs-course videos sorted by upload date.✓ コピーしました
    → Dataview returns the set because the frontmatter is consistent

結果: A queryable knowledge base you can grep, tag, and cross-link.

注意点
  • Some videos have no captions and the transcript is empty — Check the skill's log; fall back to Whisper locally for those
組み合わせ: filesystem

Turn a YouTube talk into a blog post draft

👤 Creators repurposing content ⏱ ~25 min beginner

使うタイミング: Your talk went up; you want a written version for SEO.

フロー
  1. Fetch the transcript
    youtube-fetcher-to-markdown <URL> with chapters and timestamps.✓ コピーしました
    → Markdown with chapter-delimited sections
  2. Rewrite as blog
    Now draft a blog post from this transcript.✓ コピーしました
    → Structured post using the chapters as section anchors

結果: Draft-quality blog post based on your own talk.

組み合わせ: seo-blog-writer-claude-skill

組み合わせ

他のMCPと組み合わせて10倍の力を

youtube-fetcher-to-markdown-skill + filesystem

Route transcripts into a specific Obsidian vault folder with custom naming

Save fetched transcripts to ~/obsidian/sources/youtube/.✓ コピーしました
youtube-fetcher-to-markdown-skill + seo-blog-writer-claude-skill

Fetch transcript → generate blog post in one chain

Fetch the transcript for <URL>, then seo-blog-writer target keyword 'X'.✓ コピーしました
youtube-fetcher-to-markdown-skill + claude-content-writer-skill

Turn transcripts into newsletters in your brand voice

Fetch transcript, then claude-content-writer newsletter version in my voice profile.✓ コピーしました

ツール

このMCPが提供する機能

ツール入力呼び出すタイミングコスト
fetch_single URL + options (timestamps, lang, format, source) One video at a time 0
fetch_playlist playlist URL + options Bulk archiving 0
export_json URL You want the data in a non-markdown pipeline 0

コストと制限

運用コスト

APIクォータ
YouTube has no explicit scrape quota for captions but be reasonable
呼び出しあたりのトークン
Proportional to video length
金額
Free — skills are local files
ヒント
For very long videos, use JSON export + snippet extraction instead of loading full transcripts into context.

セキュリティ

権限、シークレット、影響範囲

認証情報の保管: No credentials — pure prompts
データ送信先: Fetches from YouTube. No data leaves your machine afterward.

トラブルシューティング

よくあるエラーと対処法

Skill not invoked — Claude summarizes without fetching

Say 'fetch the transcript using youtube-fetcher-to-markdown' explicitly.

確認: ls ~/.claude/skills/youtube-fetcher-to-markdown/SKILL.md
SKILL.md frontmatter wrong

Re-clone; description drives activation.

確認: head ~/.claude/skills/youtube-fetcher-to-markdown/SKILL.md
Wrong trigger keywords — transcript has no timestamps

Pass --timestamps explicitly in the prompt.

代替案

youtube-fetcher-to-markdown 他との比較

代替案代わりに使う場面トレードオフ
Whisper (local)No captions available on the videoNeeds GPU or patience; better accuracy on accented speech
Online transcript sitesOne-off copy-pasteNo Obsidian integration, no structured frontmatter

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る