3

Pitch: WLX, uma extensão pra exportar o "Assistir mais tarde" do YouTube

Olá, pessoal!

Queria mostrar um projeto que fiz nos últimos meses e contar umas coisas que aprendi no caminho.

Tudo começou porque eu tenho mais de mil vídeos no "Assistir mais tarde" (coisa demais) e quis passar essa lista pra uma planilha, pra organizar e ter um backup. Fui procurar como fazer e descobri que não dá. O YouTube não tem botão de exportar. O Google Takeout até exporta as playlists que você criou, mas o "Assistir mais tarde" fica de fora. E a API oficial devolve essa lista vazia de propósito, desde 2016.

Achei algumas extensões que faziam isso, mas ou estavam abandonadas, ou liberavam tão pouco no grátis que não dava nem pra testar direito. Aí resolvi fazer a minha.

O que é

O WLX é uma extensão pro Firefox e pro Edge. Ela coloca um botão "Exportar CSV" na página da playlist, e com um clique lê a lista inteira e salva um arquivo com título, canal, duração, link e se o vídeo ainda está disponível. Funciona no "Assistir mais tarde", nos vídeos curtidos e em qualquer playlist.

Não precisa de conta nem de login em lugar nenhum: ela usa a sessão do YouTube que já está aberta no navegador, e o arquivo é gerado aí no seu computador mesmo. E não, ela não baixa vídeo, só a lista.

Algumas coisas que aprendi

Se a API não entrega, a página entrega. O próprio site do YouTube carrega o "Assistir mais tarde" por uma API interna, uns 100 vídeos por vez, e cada resposta vem com um código pra pedir o próximo pedaço. A extensão só faz os mesmos pedidos que a página faria, um de cada vez e com uma pausa entre eles. Uma lista de 5.000 vídeos leva menos de um minuto.

Vídeos apagados somem sem avisar. Por padrão o YouTube esconde da lista os vídeos excluídos e privados. Numa lista minha de 1.113 vídeos, só apareciam 958. Tem um parâmetro (o mesmo que a opção "Exibir vídeos indisponíveis" usa) que traz tudo, então no CSV esses vídeos aparecem marcados em vez de simplesmente sumirem.

Isso acabou virando um recurso que eu chamei de "O que sumiu?": quando você exporta de novo, a extensão compara com a exportação anterior (que fica salva só no seu navegador) e mostra quais vídeos ficaram indisponíveis, com o título e o canal que eles tinham. Quem já perdeu um vídeo salvo e nunca descobriu qual era vai entender.

O YouTube muda o formato o tempo todo. Cheguei a lidar com três formatos diferentes de item ao mesmo tempo: um no "Assistir mais tarde", outro nas playlists públicas e curtidos, e outro só pros Shorts. Pra não virar bagunça, só uma pasta do código conhece o formato do YouTube, e o resto trabalha com um objeto "Vídeo" nosso. Quando quebra, eu conserto num lugar só. E todo bug vira primeiro um exemplo de resposta real nos testes, antes da correção.

Manifest V3 complica um pouco. Parte do código precisa rodar dentro da página, pra aproveitar a sessão do YouTube, e parte fica isolada, cuidando da interface e do armazenamento. Os dois lados conversam por mensagens, e eu valido cada uma que chega, porque qualquer script da página poderia tentar imitar. A interface fica num Shadow DOM, já que o YouTube bloqueia innerHTML.

CSV pro Excel brasileiro dá trabalho. UTF-8 com BOM pros acentos não virarem lixo, ; como separador quando o idioma usa vírgula decimal, e títulos que começam com =, +, - ou @ neutralizados, senão o Excel tenta transformar em fórmula.

Publicar foi quase outro projeto. A loja do Firefox pede o código-fonte junto quando o pacote é gerado por alguma ferramenta de build, e a análise levou uns 3 dias. No Edge, a política de privacidade precisa falar do Edge e a página da loja não pode citar outros navegadores. Lá foi aprovado no mesmo dia.

Grátis e Pro

O grátis exporta playlists e curtidos com até 50 vídeos e uma amostra de 10 do "Assistir mais tarde". Tem também uma versão Pro, por US$ 5 e pagamento único, que tira os limites e libera Markdown, JSON, o "O que sumiu?" completo e o backup de todas as playlists num .zip.

Site: https://matthsanz.github.io/wlx/pt/
Firefox: https://addons.mozilla.org/pt-BR/firefox/addon/wlx-playlist-exporter/
Edge: https://microsoftedge.microsoft.com/addons/detail/cejnaobnjbnkbiihgnaepegdfenlhhhp

Se alguém testar, vou adorar saber o que achou, principalmente se encontrar algum bug. E se você já brigou com a API do YouTube, conta aí como foi!

Carregando publicação patrocinada...
1

Curti a clareza do passo a passo. Uma prática que ajuda muito na manutenção a longo prazo é manter contratos de API explícitos e mensagens de erro objetivas com status HTTP coerente.

1

Valeu, amigo! o WLX não tem servidor, então não tenho API minha, mas sofri com o contrário kkkk. A API do YouTube devolve 200 até quando a playlist nem existe, e o erro vem escondido no meio do JSON. Tive que caçar ele lá dentro pra saber se tinha dado certo.