Guia de fluxo do Tumblr

gallery-dl Tumblr: baixar blogs e publicações

O suporte a gallery-dl Tumblr fica mais claro quando você separa o alcance da URL, o acesso e o controle de execuções repetidas. Este guia mostra como testar um blog público, baixar uma tag ou publicação específica, adicionar cookies somente quando necessário e manter um arquivo local previsível.

URLs de blogTags e buscaCookiesArquivos sem duplicatas
URL de um blog do Tumblr passando por um teste do gallery-dl até um arquivo local organizado
Um fluxo específico para Tumblr começa com um teste pequeno e termina em um arquivo local revisado.
Resposta rápida

Use como entrada uma URL pública de blog, tag, publicação ou busca do Tumblr. Comece com gallery-dl --simulate para ver o resultado sem gravar arquivos e depois repita a mesma URL com escopo pequeno e destino conhecido. Adicione cookies do navegador apenas se o Tumblr exigir uma sessão autenticada e mantenha um arquivo de histórico quando pretende repetir o trabalho.

Escolha da URL

Escolha o tipo certo de URL do Tumblr

Comece com a menor URL que responde à sua pergunta. Uma URL de post verifica se um item específico pode ser analisado. Uma URL de blog serve para acompanhar a mídia de um autor. Uma URL de tag ou busca é mais ampla e menos estável, pois resultados novos podem aparecer. Ao copiar uma URL do celular, remova parâmetros de rastreamento somente depois de confirmar que o escopo continua igual.

Blogs do Tumblr podem aparecer de várias formas. `tumblr.com/blog/nome`, `nome.tumblr.com` e um permalink podem apontar para o mesmo blog, mas não são igualmente práticos para um teste. Prefira a forma curta e próxima da canônica e anote a URL original.

Nem toda imagem visível em um tema é um post baixável. Avatares, recomendações, embeds externos e recursos decorativos podem aparecer juntos. Confira IDs, URLs de mídia e tipos de post na simulação antes de escrever um filtro.

EscopoPrimeiro usoCuidado principal
Post únicoChecar parser e permissãoPode não ter mídia baixável
BlogArquivo de autor ou coleçãoPode ficar grande
TagAmostra de assuntoResultados mudam
BuscaDescobrir candidatosDifícil de repetir
SubdomínioFluxo direto de blogConfirmar que pertence ao Tumblr
Comece com uma URL

A simulação de um post oferece evidência mais clara que um comando grande misturando recursos do tema, reblogs e resultados não relacionados.

Primeira execução

Instale e faça um primeiro teste seguro

Instale o gallery-dl com o método que combina com seu ambiente Python ou de pacotes. O guia de instalação explica as opções; quando `gallery-dl --version` responder, mantenha pequena a primeira execução no Tumblr. A simulação mostra mensagens do extractor sem salvar mídia e revela URL errada, tela de login ou escopo amplo antes da escrita.

Use um formato de comando como os exemplos e troque a URL por um destino público que você pode consultar. A saída é evidência para a próxima decisão, não uma garantia de que todo post terá arquivo.

Quando a simulação estiver correta, escolha uma pasta de teste vazia e repita sem `--simulate`. Separe o destino de um arquivo existente para comparar mensagens e arquivos e poder remover o teste sem tocar na coleção principal.

Fluxo gallery-dl Tumblr em três etapas: URL, teste e arquivo
Um trabalho repetível no Tumblr escolhe a URL, simula o resultado e arquiva uma amostra pequena.

Leia a saída da simulação

Procure o nome do extractor, o blog ou ID do post, URLs de mídia e avisos de autenticação. Um resultado vazio não é motivo para adicionar cookies imediatamente. Confirme primeiro o formato da URL, a visibilidade do blog e se a versão instalada entende a resposta atual do site.

  • Use `--verbose` para diagnosticar uma URL nova e remova no uso normal.
  • Use `--range` antes de um arquivo completo.
  • Registre URL, data, comando e pasta de saída.
Inspecionar sem gravar
gallery-dl --simulate --verbose https://example.tumblr.com/
Testar um post em pasta dedicada
gallery-dl -d ./tumblr-test https://example.tumblr.com/post/123456789
Limitar uma amostra de tag
gallery-dl --range 1-20 -d ./tumblr-sample https://www.tumblr.com/tagged/photography
Fluxos

Baixe blogs, tags, posts e resultados de busca

Baixar um blog é comum, mas não deve ser o início de toda tarefa. Para uma imagem específica, use o post. Para um tema, use uma tag com intervalo pequeno. Para explorar, use a busca para descobrir posts e depois transforme os resultados úteis em tarefas de post ou blog que possam ser repetidas.

O extractor pode encontrar mais do que fotos. Posts de vídeo e áudio podem funcionar de outra forma; posts de texto, citação ou resposta podem não produzir arquivo; reblogs podem trazer metadados indesejados no nome. Veja os tipos na simulação antes de criar um filtro.

Para um blog grande, divida a tarefa em pontos de controle. Rode um primeiro intervalo, confira pasta e arquivo de histórico e só então amplie. Se houver erro de rede, nomes estáveis e histórico permitem retomar sem considerar tudo que já foi visto como novo.

Sequência prática

Valide primeiro um post, depois o escopo do blog ou tag. Decida sobre cookies, acrescente destino e histórico e só repita quando a amostra fizer sentido. Assim você separa problemas de análise e acesso.

  • Post: conferir um item.
  • Blog: arquivo de autor ou coleção.
  • Tag: amostra temática limitada.
  • Busca: descoberta, não chave de arquivo imutável.

O que é um bom resultado

Um bom resultado é explicável: URL de origem, quantidade plausível, tipos incluídos e pasta conhecida. Muitos arquivos sem repetibilidade ou auditoria formam um fluxo arriscado.

Repetição

Controle configuração, nomes e arquivos

Depois de entender o teste, coloque escolhas estáveis na configuração do gallery-dl. Ela pode definir diretório do Tumblr, campos do nome, arquivo de downloads e uma pausa moderada. Centralizar essas escolhas reduz diferenças entre execução manual e agendada.

Um nome de arquivo do Tumblr deve mostrar blog, post ou ID e o número que distingue várias mídias. Use o guia de modelos para descobrir palavras-chave em vez de adivinhar. Se um campo não existir para certo tipo de post, use um fallback legível.

O arquivo de histórico registra IDs processados; não substitui backup da mídia. Guarde-o com a configuração, faça cópia e não o publique se revelar dados de URL. Depois de mudar pasta ou padrão, mantenha o mesmo histórico somente se quiser ignorar os mesmos itens lógicos.

Formato mínimo de configuração
{
  "extractor": {
    "tumblr": {
      "directory": ["tumblr", "{blog_name}"],
      "filename": "{id}_{num:>02}.{extension}",
      "archive": "./state/tumblr-{blog_name}.sqlite3"
    }
  }
}
Ver palavras-chave disponíveis
gallery-dl --list-keywords https://example.tumblr.com/
Mantenha o histórico estável

Mudar a pasta não muda a identidade do histórico. Decida se o mesmo post deverá continuar sendo ignorado antes de mover arquivos.

Acesso

Use cookies somente quando o Tumblr exigir

Páginas públicas do Tumblr devem ser o primeiro teste. Se o navegador vê a página mas o gallery-dl retorna erro de acesso, pode faltar cookie de sessão, consentimento ou uma resposta diferente após o carregamento. O helper de cookies explica a exportação local; passe o arquivo pela opção do gallery-dl em vez de colar valores em comando ou issue pública.

Cookies não tornam página privada pública e não garantem direito de arquivamento. Eles expiram, refletem permissões da conta e podem expor acesso quando copiados. Proteja o arquivo, deixe-o fora de pastas públicas e apague depois do teste.

Quando um comando com cookie falhar, compare com uma simulação pública. Se a pública também falhar, a causa provavelmente é URL, versão, rede ou ritmo, e não autenticação.

Lista de acesso cuidadosa

Confirme a URL pública, exporte apenas os cookies necessários, simule um post, não faça commit do arquivo e remova a sessão quando não precisar mais.

  • Nunca cole cabeçalhos de cookies em tutorial, log ou issue.
  • Não publique conteúdo autenticado sem permissão.
  • Use o menor escopo autenticado que resolva a tarefa.
Controle

Adicione filtros, pausas e limites responsáveis

Um arquivo do Tumblr fica mais fácil de cuidar quando o comando descreve o objetivo. Use intervalo para a primeira amostra, filtro de data ou post quando os metadados permitirem e condição de tipo se conteúdo misto não for útil. Confirme cada condição na simulação, pois um filtro sem correspondência parece um extractor quebrado.

Uma pausa curta, intervalo moderado e condição de parada protegem seu fluxo e o serviço. Se o Tumblr devolver limite ou erro temporário, pare, guarde os registros e tente mais tarde com escopo menor. Não tente contornar bloqueio trocando contas ou enviando requisições agressivas.

A capacidade de salvar um arquivo não é permissão para republicá-lo. Verifique condições do autor, políticas do Tumblr e licença ou copyright. Mantenha material privado ou sensível fora de arquivos públicos e registre a URL de origem quando a proveniência importar.

ControleAjudaVerificar
Intervalo pequenoLimita a primeira escritaIntervalo bate com a ordem esperada
Tipo de postEvita conteúdo irrelevanteSimulação mostra correspondência
PausaReduz picosExecução continua viável
HistóricoIgnora IDs conhecidosCaminho estável e copiado
Destino separadoProtege coleçãoPasta de teste descartável
Recuperação

Resolva falhas comuns do Tumblr

Classifique a falha antes de mudar o comando. 404 ou resultado vazio pode ser URL copiada incorretamente, blog movido ou caminho não suportado. 403 ou login aponta para acesso, consentimento, cookies ou política. Timeout ou 429 aponta para ritmo, rede ou limite temporário. Cada grupo precisa de uma correção diferente.

Para problema de URL, abra a página no navegador, copie um endereço canônico e teste um post com `--simulate --verbose`. Para acesso, compare post público e sessão autenticada e use o helper de cookies apenas quando a comparação indicar. Para limite, pare, espere, reduza o intervalo e evite tarefas paralelas. Para quantidade inesperada, examine tipos, reblogs, recursos do tema e filtros antes de apagar o histórico.

Guarde a mensagem de erro original ao pedir ajuda. Informe versão do gallery-dl, sistema operacional, comando sem segredos, formato da URL sem tokens privados e se uma simulação pública funciona. Nunca anexe cookies ou mídia privada.

Diagrama editorial separando erros de URL, acesso e espera no Tumblr
Separe URL, acesso e limite antes de mudar configuração ou credenciais.

Ordem rápida de diagnóstico

Confira a URL, teste um post, compare acesso público e autenticado e só então mude filtros ou saída. Essa ordem impede que uma falha de formato vire um experimento confuso.

  • URL: caminho canônico, blog, ID e redirecionamento.
  • Acesso: visibilidade, consentimento, cookies e conta.
  • Espera: 403/429, timeout, pausa e janela de tentativa.
  • Saída: pasta, campos de nome, histórico e duplicatas.
Perguntas

Perguntas frequentes do gallery-dl Tumblr

As respostas abaixo tratam decisões para um trabalho repetível no Tumblr. Os guias relacionados oferecem detalhes gerais quando o problema não é específico da plataforma.

Perguntas frequentes

Perguntas do gallery-dl Tumblr

O gallery-dl consegue baixar um blog inteiro do Tumblr?

Ele pode processar uma URL pública compatível, mas comece com simulação e intervalo pequeno. Um blog pode ter muitos tipos, reblogs e histórico; use destino estável e arquivo antes de ampliar.

Uso URL de blog ou de tag do Tumblr?

Use blog para autor ou coleção, tag para amostra temática e post para validar um item. Busca serve para descoberta, pois o resultado muda.

Por que gallery-dl Tumblr retorna resultado vazio?

Confira formato da URL, visibilidade, versão e saída de simulação. Pode ser caminho errado, estado não suportado, filtro sem correspondência ou necessidade de acesso.

Preciso de cookies para downloads do Tumblr?

Não em toda página pública. Use somente quando comparação pública e erro mostrarem que uma sessão é necessária. Proteja o arquivo; cookies não dão direito a conteúdo privado.

Como evitar o mesmo post do Tumblr duas vezes?

Configure um histórico estável e mantenha-o com o trabalho. Teste mudanças de pasta ou nome separadamente para saber quais IDs são ignorados.

O que faço depois de 429 ou timeout no Tumblr?

Pare, guarde o log, espere, reduza o intervalo e repita com pausa moderada. Evite tentativas paralelas e troca de contas para contornar limite.

Referências oficiais

Código oficial do extractor TumblrDocumentação oficial de sites compatíveisMetadados de lançamento do gallery-dl
PRÓXIMO PASSO

Recursos relacionados