Corrigindo o erro "Signature extraction failed" do yt-dlp

O que "Signature extraction failed" significa

Quando o yt-dlp imprime Signature extraction failed: Some formats may be missing ou Could not find JS function, é porque o YouTube rotacionou o arquivo JavaScript do player que assina cada URL de stream. Cada URL de stream do YouTube traz um token de assinatura que precisa ser decifrado por uma função JS dentro do JS do player. Quando o YouTube troca essa função (a cada poucas semanas), versões mais antigas do yt-dlp não encontram o novo nome e a extração falha.

A página do vídeo continua carregando no seu navegador, por isso o erro causa surpresa — mas o download precisa do token decifrado, e o yt-dlp ainda não aprendeu o novo padrão.

Como corrigir pelo yt-dlp

A correção confiável é atualizar o yt-dlp:

# instalação via pip
pip install -U yt-dlp

# brew
brew upgrade yt-dlp

# pipx
pipx upgrade yt-dlp

# binário standalone
yt-dlp -U

Se você já está na versão mais recente e ainda assim vê o erro:

• Olhe as issues do yt-dlp no GitHub — costuma haver uma thread acompanhando a mudança de assinatura do momento com um patch já mesclado em master.
• Instale a partir do master: pip install -U "yt-dlp[default] @ git+https://github.com/yt-dlp/yt-dlp@master"
• Aguarde de 12 a 48 horas por uma release tagueada que inclua a correção.

Por que isso fica acontecendo

O YouTube rotaciona o esquema de assinatura de propósito, para atrapalhar scraping. O padrão é sempre o mesmo: sobe um novo player JS, a função de decifragem ganha outro nome e é minificada de outra forma, e cada baixador precisa redetectar a função e reescrever seu extractor. Os mantenedores do yt-dlp acompanham essas mudanças e publicam atualizações, mas sempre existe uma janela em que a última alteração do YouTube vai mais rápido que o último release do yt-dlp.

Use o Any4K no lugar

O Any4K mantém a extração de assinatura no lado do servidor como parte da operação normal. Quando o YouTube rotaciona o player JS, nossa infraestrutura é atualizada e os downloads continuam funcionando — normalmente em menos de uma hora, não em 48. Do seu lado, não há nada para atualizar: cole a URL em any4k.com e baixe.

Vantagens do Any4K durante rotações de assinatura

• Sem precisar atualizar o yt-dlp: o fix é aplicado do nosso lado.
• Sem instalações nightly: a ferramenta web está sempre atualizada.
• Mesmo fluxo independente das mudanças do YouTube: cola, escolhe, salva.
• Multiplataforma: YouTube, TikTok, Twitter, Instagram, Facebook, Reddit, Shorts.

Quando o yt-dlp ainda é a escolha certa

Para arquivamentos em massa, extração de legendas embutidas, assinaturas de canal e automações por script, o yt-dlp continua sendo a ferramenta mais profunda. Aceite que erros de assinatura são parte da manutenção rotineira — deixe yt-dlp -U no seu cron.

Conclusão

"Signature extraction failed" é o YouTube trocando as fechaduras. O yt-dlp publica chaves novas com frequência; nesse intervalo, o Baixador de vídeos Any4K lida com as rotações de assinatura no lado do servidor para que seus downloads continuem funcionando.