SubDownload

Wrapper público do MCP para SubDownload. Obtenha transcrições do YouTube, pesquise vídeos, navegue por canais e playlists — dados instantâneos do YouTube para seu fluxo de trabalho com IA.

GitHub

Experimente este MCPPatrocinado

Documentação

Servidor MCP SubDownload

O SubDownload expõe o YouTube como uma fonte de dados nativa do MCP. Conecte-se uma vez via OAuth e seu agente de IA ganha ferramentas para resumir vídeos, buscar transcrições completas (incluindo vídeos sem legendas, via ASR de IA), pesquisar canais e playlists, e salvar tudo em uma base de conhecimento por usuário para recuperação entre sessões.

Endpoint hospedado: https://api.subdownload.com/mcp
Página inicial: https://subdownload.com?utm_source=gthb_awesome_9jqqed&utm_medium=code&utm_campaign=Awesome
Documentação: https://api.subdownload.com/docs/mcp
Glama (conector): https://glama.ai/mcp/connectors/com.subdownload.api/sub-download
Glama (servidor): https://glama.ai/mcp/servers/SubDownload/subdownload-mcp

A configuração recomendada é apontar seu cliente MCP diretamente para o endpoint hospedado acima e autenticar via OAuth — veja "Conexão rápida" abaixo. Este repositório também inclui um proxy stdio leve (Node + Docker) para ambientes que preferem um subprocesso local.

Autenticação

OAuth 2.1 com Dynamic Client Registration (RFC 7591). Sem client_id ou client_secret pré-compartilhados — seu cliente MCP se registra automaticamente na primeira conexão.

Descoberta (RFC 9728):

Um POST para /mcp sem token retorna 401 além de um cabeçalho WWW-Authenticate apontando para /.well-known/oauth-protected-resource
Esse documento aponta para o servidor de autorização (https://api.subdownload.com)
O cliente MCP segue o fluxo padrão authorize → callback → token com PKCE

Alternativa com chave de API: toda conta em https://subdownload.com/account expõe um token Bearer para clientes que não suportam OAuth.

Ferramentas

Ferramenta	O que faz
`search_youtube`	Pesquisa por palavras-chave no YouTube
`fetch_video_info`	Metadados do vídeo (título, canal, duração, contagem de visualizações)
`fetch_transcript`	Transcrição completa com timestamps
`transcribe_video`	Gera uma transcrição com ASR de IA para vídeos sem legendas
`get_asr_task`	Consulta um trabalho de transcrição de IA em andamento
`resolve_channel`	Busca um canal por handle, URL ou ID
`list_channel_videos`	Lista vídeos de um canal
`get_channel_latest_videos`	Vídeos mais recentes de um canal
`search_channel_videos`	Pesquisa dentro de um único canal
`list_playlist_videos`	Lista o conteúdo de uma playlist
`save_to_library`	Salva um resumo ou transcrição de vídeo na sua base de conhecimento pessoal
`list_library`	Navega pela sua base de conhecimento salva
`get_library_item`	Busca um único item salvo

Conexão rápida

Claude Desktop / Cursor / Windsurf / qualquer cliente MCP compatível com OAuth

{
  "mcpServers": {
    "subdownload": {
      "url": "https://api.subdownload.com/mcp"
    }
  }
}

Na primeira vez que você usar, o cliente aciona o OAuth e você faz login com Google ou LINUX DO. Créditos gratuitos no cadastro — sem necessidade de cartão.

Clientes com token Bearer

{
  "mcpServers": {
    "subdownload": {
      "url": "https://api.subdownload.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Obtenha sua chave de API na sua página de conta.

Proxy stdio local (Docker / npm)

Para clientes que preferem transporte por subprocesso, este repositório inclui um proxy Node leve que encaminha tools/call para o endpoint hospedado com sua chave de API.

# Docker
docker build -t subdownload-mcp .
docker run --rm -i -e SUBDOWNLOAD_API_KEY=YOUR_API_KEY subdownload-mcp

# Or via Node directly
npm install
SUBDOWNLOAD_API_KEY=YOUR_API_KEY npm start

Exemplo de configuração do cliente:

{
  "mcpServers": {
    "subdownload": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-e", "SUBDOWNLOAD_API_KEY", "subdownload-mcp"],
      "env": { "SUBDOWNLOAD_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Os schemas das ferramentas são declarados inline para que a introspecção (initialize, tools/list) funcione sem credenciais; tools/call exige SUBDOWNLOAD_API_KEY.

Preços

Créditos gratuitos no cadastro. Pro: 5.000 créditos por mês. Veja https://subdownload.com/pricing.

Suporte

Email: contact@subdownload.com
Status: https://subdownload.com/status

Licença

MIT (aplica-se a este repositório de documentação; o serviço SubDownload em si é SaaS hospedado — veja https://subdownload.com/terms).