convez.ai
MCP ServerIntegração & APIsIntermediário
acidghost

yt-dlp MCP Server

acidghost/yt-dlp-mcp

Busca e legenda do YouTube via MCP com yt-dlp

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP HTTP minimalista que integra busca no YouTube e extração de legendas usando a CLI yt-dlp. Expõe dois tools principais: busca de vídeos com metadados estruturados e download de legendas auto-geradas em texto normalizado. Ideal para fluxos que precisam acessar conteúdo do YouTube programaticamente sem APIs oficiais.

Instalação

$npx convez-ai acidghost/yt-dlp-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 1 dia
Versão
nightly-2026-11-17-07-38-54
Issues abertas
1
Contribuidores
2

Casos de uso

  • Extrair legendas de vídeos YouTube para análise de conteúdo
  • Pesquisar vídeos no YouTube e capturar metadados (título, URL, duração)
  • Automatizar coleta de transcrições de vídeos para processamento de linguagem natural

Veredito

Ferramenta prática para quem precisa acessar YouTube via MCP sem autenticação complexa. Implementação leve em Go com bom suporte a concorrência; útil em pipelines de automação, mas requer cautela sobre ToS do YouTube em produção.

README

A tradução para o português deste README ainda está na fila.

yt-dlp-mcp

A tiny HTTP MCP server for YouTube search and subtitle extraction using the yt-dlp CLI.

Tools

search_videos

Search YouTube via ytsearchN:query.

{
  "query": "lo-fi music",
  "limit": 5,
  "timeout_ms": 60000
}

Returns structured results with title, URL, id, duration, uploader, and upload date when available.

download_subtitles

Download auto-generated subtitles in json3 format and return normalized plain text.

{
  "url": "https://www.youtube.com/watch?v=...",
  "lang": "en",
  "timeout_ms": 60000
}

lang defaults to en. Manual subtitles are not requested; this uses --write-auto-subs.

Server

  • MCP endpoint: http://localhost:3000/mcp
  • Health check: GET http://localhost:3000/healthz
  • No authentication; deploy only behind your trusted boundary.

Configuration can be supplied with CLI flags or environment variables:

yt-dlp-mcp --host 0.0.0.0 --port 3000
YT_DLP_MCP_PORT=3000 yt-dlp-mcp

Relevant env vars:

  • YT_DLP_MCP_HOST default 0.0.0.0
  • YT_DLP_MCP_PORT default 3000
  • YT_DLP_MCP_DEFAULT_TIMEOUT default 60s
  • YT_DLP_MCP_MAX_TIMEOUT default 5m
  • YT_DLP_MCP_MAX_CONCURRENCY default 2

Docker

just build-image
# or plain docker build:
docker build -t yt-dlp-mcp .

docker run --rm -p 3000:3000 yt-dlp-mcp

The runtime image is based on python:3.14-slim, installs yt-dlp[default], and copies deno for yt-dlp's JavaScript token handling.

Ver o original no GitHub

Bom para

Relacionados