youtube-fetcher-to-markdown MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Any YouTube URL format accepted (short, embed, playlist, watch)
YAML frontmatter for Obsidian Dataview querying across transcripts
Optional timestamps, language choice, JSON/SRT output
Chapter-aware markdown when the video has chapters
File naming with date + slug + video ID for stable sorting

Demo ao vivo

Como fica na prática

youtube-fetcher-to-markdown-skill.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/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
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.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 usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

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
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "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
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.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"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.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"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

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

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: youtube-fetcher-to-markdown

Archive a YouTube lecture series as a searchable Obsidian vault

👤 Self-learners and researchers ⏱ ~20 min beginner

Quando usar: You're studying from YouTube and want to search across 20+ videos later.

Pré-requisitos

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

Fluxo

Fetch a playlist's transcripts

youtube-fetcher-to-markdown — fetch every video in playlist <URL>, include timestamps, source=cs-course.✓ Copiado

→ ~/yt_transcripts/ fills with per-video markdown files, all tagged source: cs-course
Query via Dataview

In Obsidian, write a Dataview query listing all cs-course videos sorted by upload date.✓ Copiado

→ Dataview returns the set because the frontmatter is consistent

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

Armadilhas

Some videos have no captions and the transcript is empty — Check the skill's log; fall back to Whisper locally for those

Combine com: filesystem

Turn a YouTube talk into a blog post draft

👤 Creators repurposing content ⏱ ~25 min beginner

Quando usar: Your talk went up; you want a written version for SEO.

Fluxo

Fetch the transcript

youtube-fetcher-to-markdown <URL> with chapters and timestamps.✓ Copiado

→ Markdown with chapter-delimited sections
Rewrite as blog

Now draft a blog post from this transcript.✓ Copiado

→ Structured post using the chapters as section anchors

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

Combine com: seo-blog-writer-claude-skill

Combinações

Combine com outros MCPs para 10× de alavancagem

youtube-fetcher-to-markdown-skill + filesystem

Route transcripts into a specific Obsidian vault folder with custom naming

Save fetched transcripts to ~/obsidian/sources/youtube/.✓ Copiado

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'.✓ Copiado

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.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar
fetch_single	URL + options (timestamps, lang, format, source)	One video at a time
fetch_playlist	playlist URL + options	Bulk archiving
export_json	URL	You want the data in a non-markdown pipeline

Custo e limites

O que custa rodar

Cota de API: YouTube has no explicit scrape quota for captions but be reasonable
Tokens por chamada: Proportional to video length
Monetário: Free — skills are local files
Dica: For very long videos, use JSON export + snippet extraction instead of loading full transcripts into context.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: No credentials — pure prompts

Saída de dados: Fetches from YouTube. No data leaves your machine afterward.

Respect YouTube's ToS and creators' rights when redistributing transcripts.
Don't rely on auto-captions as ground truth for quotes — they have errors.

Solução de problemas

Erros comuns e correções

Skill not invoked — Claude summarizes without fetching

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

Verificar: ls ~/.claude/skills/youtube-fetcher-to-markdown/SKILL.md

SKILL.md frontmatter wrong

Re-clone; description drives activation.

Verificar: head ~/.claude/skills/youtube-fetcher-to-markdown/SKILL.md

Wrong trigger keywords — transcript has no timestamps

Pass --timestamps explicitly in the prompt.

Alternativas

youtube-fetcher-to-markdown vs. outros

Alternativa	Quando usar	Troca
Whisper (local)	No captions available on the video	Needs GPU or patience; better accuracy on accented speech
Online transcript sites	One-off copy-paste	No Obsidian integration, no structured frontmatter

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills