Guía de flujo para Tumblr

gallery-dl Tumblr: guía para descargar blogs y publicaciones

El soporte de gallery-dl Tumblr se entiende mejor si separas el alcance de la URL, el acceso y el control de las ejecuciones repetidas. Aquí aprenderás a probar un blog público, descargar una etiqueta o publicación concreta, añadir cookies solo cuando sea necesario y mantener un archivo local predecible.

URL de blogEtiquetas y búsquedaCookiesArchivos sin duplicados
Una URL de blog de Tumblr pasa por una prueba de gallery-dl y termina en un archivo local ordenado
Un flujo específico para Tumblr empieza con una prueba pequeña y termina en un archivo local revisado.
Respuesta rápida

Usa como entrada una URL pública de blog, etiqueta, publicación o búsqueda de Tumblr. Empieza con gallery-dl --simulate para ver el resultado sin escribir archivos; después repite la misma URL con un alcance pequeño y un destino conocido. Añade cookies del navegador solo si Tumblr exige una sesión autenticada y conserva un archivo de historial cuando pienses repetir el trabajo.

Selección de URL

Elige el tipo de URL de Tumblr correcto

Empieza con la URL más pequeña que responda a tu pregunta. Una publicación sirve para verificar que gallery-dl puede analizar un elemento concreto. Una URL de blog tiene sentido si vas a seguir los medios de un autor. Una etiqueta o búsqueda es más amplia y menos estable porque pueden aparecer resultados nuevos entre ejecuciones. Si copias una dirección desde una aplicación móvil, elimina parámetros de seguimiento solo después de confirmar que la URL limpia apunta al mismo alcance.

Los blogs de Tumblr pueden aparecer con varias formas. Un enlace `tumblr.com/blog/nombre`, un subdominio `nombre.tumblr.com` y un enlace permanente pueden señalar el mismo blog, pero no son igual de cómodos para una prueba. Prefiere la forma más corta y canónica y anota la URL original para explicar una diferencia posterior.

No supongas que cada imagen visible en un tema es una publicación descargable. Los temas pueden incluir avatares, recomendaciones, inserciones externas o recursos decorativos. Las líneas de resultado de la simulación son el límite útil: revisa identificadores, medios y tipos de publicación antes de crear un filtro.

AlcancePrimer uso recomendadoPrecaución
Una publicaciónComprobar análisis y permisosPuede no contener un medio descargable
BlogArchivo de un autor o colecciónPuede convertirse en una tarea grande
EtiquetaMuestra de un temaLos resultados cambian con el índice
BúsquedaDescubrimiento inicialEs difícil reproducirla exactamente
SubdominioFlujo directo de un blogConfirma que pertenece a Tumblr
Empieza con una URL

Una simulación de una sola publicación ofrece una evidencia más clara que un comando grande que mezcle recursos del tema, reblogs y resultados no relacionados.

Primera ejecución

Instala y ejecuta una primera prueba segura

Instala gallery-dl con el método que encaje con tu entorno de Python o paquetes. La guía de instalación del sitio explica las opciones; cuando `gallery-dl --version` responda, haz que la primera ejecución de Tumblr sea pequeña. Una simulación muestra mensajes del extractor sin guardar medios, así que puedes detectar una URL incorrecta, una pantalla de acceso o un alcance demasiado amplio antes de crear archivos.

Usa una forma de comando como la siguiente y sustituye la URL por un destino público que tengas permiso para inspeccionar. La salida es evidencia para la siguiente decisión, no una promesa de que cada publicación contenga un archivo.

Cuando la simulación sea coherente, elige una carpeta de prueba vacía y repite la misma URL sin `--simulate`. Mantén el destino separado de un archivo existente en esta primera pasada. Así puedes comparar mensajes y archivos y eliminar el resultado de prueba sin tocar una colección cuidada.

Flujo de tres pasos de gallery-dl Tumblr: URL, prueba y archivo
Un trabajo repetible en Tumblr tiene tres etapas visibles: elegir una URL, simular el resultado y archivar una muestra.

Lee la salida de simulación

Busca el nombre del extractor, el blog o identificador de publicación, las URL de medios y cualquier aviso de autenticación. Si aparece un resultado vacío, no añadas cookies ni cambies muchos ajustes de inmediato. Comprueba primero que la URL sea una forma compatible, que el blog sea público y que tu versión instalada pueda procesar la respuesta actual del sitio.

  • Usa `--verbose` al diagnosticar una URL nueva y quítalo en ejecuciones rutinarias.
  • Usa `--range` o un alcance reducido antes de archivar un blog completo.
  • Anota URL, fecha, comando y carpeta de destino.
Inspeccionar sin escribir archivos
gallery-dl --simulate --verbose https://example.tumblr.com/
Probar una publicación en una carpeta propia
gallery-dl -d ./tumblr-test https://example.tumblr.com/post/123456789
Limitar una muestra de etiqueta
gallery-dl --range 1-20 -d ./tumblr-sample https://www.tumblr.com/tagged/photography
Flujos

Descarga blogs, etiquetas, publicaciones y búsquedas

Descargar un blog es el flujo más habitual, pero no debe ser la opción automática para cada tarea. Si necesitas una imagen concreta, usa su publicación. Si estás reuniendo un tema, usa una etiqueta y un rango pequeño. Si exploras un asunto desconocido, usa la búsqueda para descubrir publicaciones y conviértelas después en trabajos de publicaciones o blogs que puedas repetir.

El extractor puede encontrar más que fotos. Las publicaciones de vídeo y audio pueden tener un comportamiento distinto; las de texto, cita o respuesta pueden no producir ningún archivo; y los reblogs pueden aportar metadatos que no quieres en un nombre. La simulación debe mostrar qué tipos aparecen antes de escribir un filtro. Un filtro pensado solo para fotos puede hacer que un blog mixto parezca vacío aunque el extractor funcione.

Para un blog grande, divide la tarea en puntos de control. Ejecuta un rango inicial, revisa la carpeta, guarda el archivo de historial y amplía solo después. Si aparece un error de red, los nombres estables y el historial permiten continuar sin tratar todos los elementos anteriores como nuevos.

Secuencia práctica

Primero valida una publicación. Después valida el alcance del blog o etiqueta. Luego decide si necesitas cookies. Añade la distribución y el historial al final y repite solo cuando la muestra sea comprensible. Esta secuencia separa problemas de análisis y de acceso y evita que una carpeta enorme esconda el error original.

  • URL de publicación: mejor para comprobar un elemento.
  • URL de blog: mejor para un archivo de autor o colección.
  • URL de etiqueta: mejor para una muestra temática acotada.
  • URL de búsqueda: mejor para descubrir, no para una clave de archivo inmutable.

Qué es un buen resultado

Un buen resultado se puede explicar: sabes qué URL lo produjo, por qué la cantidad de archivos parece razonable, qué tipos se incluyeron y dónde se escribió el archivo. Descargar muchos archivos sin poder repetir ni auditar la tarea es un flujo arriesgado aunque la carpeta parezca completa.

Repetibilidad

Controla configuración, nombres e historial

Pasa las decisiones estables a la configuración de gallery-dl cuando entiendas el comando de prueba. Un archivo de configuración puede definir la carpeta de Tumblr, los campos del nombre, un historial de descargas y una pausa prudente. Centralizar estas decisiones reduce las diferencias entre una ejecución manual y otra programada.

Los nombres de Tumblr deben responder a tres preguntas: qué blog produjo el archivo, qué publicación o identificador está implicado y qué número distingue varios medios. Usa la guía de plantillas para descubrir palabras clave en vez de adivinar campos. Si un campo no existe para un tipo de publicación, elige un respaldo legible en lugar de depender de separadores vacíos o de un texto completo.

El historial registra identificadores procesados; no es una copia de seguridad de los medios. Guárdalo junto a la configuración, inclúyelo en tu plan de copias y no lo publiques si contiene datos sensibles de URL. Si cambias la carpeta o el patrón de nombres, conserva el mismo historial solo si quieres seguir omitiendo los mismos elementos lógicos.

Forma mínima de configuración
{
  "extractor": {
    "tumblr": {
      "directory": ["tumblr", "{blog_name}"],
      "filename": "{id}_{num:>02}.{extension}",
      "archive": "./state/tumblr-{blog_name}.sqlite3"
    }
  }
}
Ver palabras clave disponibles
gallery-dl --list-keywords https://example.tumblr.com/
Mantén estable el historial

Cambiar una carpeta no cambia la identidad del historial. Decide si una publicación debe seguir omitida antes de mover archivos o dividir un blog en nuevos destinos.

Acceso

Usa cookies solo cuando Tumblr las necesite

Las páginas públicas de Tumblr deben ser la primera prueba. Si el navegador ve una página pero gallery-dl recibe un error de acceso, puede faltar una cookie de sesión, un estado de consentimiento o una respuesta que cambia después de cargar el navegador. La ayuda de cookies del sitio explica cómo exportarlas localmente; sigue ese flujo y entrega el archivo mediante la opción compatible en vez de pegar valores en un comando o en un informe público.

Las cookies no convierten una página privada en pública ni garantizan que una publicación pueda archivarse. Caducan, reflejan los permisos de la cuenta que las creó y pueden exponer el acceso si se copian sin cuidado. Guarda el archivo con permisos restrictivos, fuera de una carpeta pública, y elimínalo cuando termine la prueba.

Cuando falle un comando con cookies, compáralo con una simulación pública. Si también falla la prueba pública, probablemente el problema sea la URL, la versión, la red o el límite de solicitudes, no la autenticación. Esta comparación evita rotar credenciales cuando el extractor necesita una actualización o un ritmo más lento.

Lista de acceso prudente

Confirma primero la URL pública. Exporta solo las cookies necesarias. Ejecuta una simulación de una publicación. No subas el archivo al repositorio ni lo dejes en el directorio del proyecto. Revoca o borra la sesión cuando ya no la necesites.

  • Nunca pegues cabeceras de cookies en tutoriales, registros o incidencias.
  • No publiques contenido autenticado de otra persona sin permiso.
  • Usa el alcance autenticado mínimo que resuelva la tarea.
Control

Añade filtros, pausas y límites responsables

Un archivo de Tumblr se administra mejor cuando el comando expresa lo que buscas. Usa un rango para la primera muestra, un filtro de fecha o publicación cuando los metadatos lo permitan y una condición de tipo cuando el contenido mixto no sea útil. Verifica cada condición con una simulación porque un filtro que no coincide puede parecer un extractor roto.

Un ritmo respetuoso protege tu flujo y el servicio. Una pausa breve, un rango moderado y una condición de parada son mejores valores iniciales que varios procesos completos en paralelo. Si Tumblr devuelve un límite o un error temporal, detente, conserva los registros y reintenta más tarde con un alcance menor. No intentes superar un bloqueo rotando cuentas o enviando solicitudes agresivas.

La capacidad técnica de guardar un archivo no equivale a permiso para republicarlo. Revisa las condiciones del creador, las políticas de Tumblr y la licencia o copyright del medio. Mantén fuera de los archivos públicos el material privado o sensible y conserva la URL de origen cuando necesites procedencia.

ControlAyudaQué verificar
Rango pequeñoLimita la primera escrituraEl rango coincide con el orden esperado
Filtro de tipoEvita texto o medios irrelevantesLa simulación muestra coincidencias
PausaReduce picos de tráficoEl trabajo sigue siendo práctico
HistorialOmite identificadores conocidosLa ruta es estable y está respaldada
Destino separadoProtege archivos cuidadosLa carpeta de prueba se puede borrar
Recuperación

Soluciona fallos habituales de Tumblr

Clasifica el fallo antes de cambiar el comando. Un 404 o resultado vacío puede indicar una URL mal copiada, un blog que cambió de dirección o una ruta que no es compatible. Un 403 o mensaje de inicio de sesión apunta a acceso, consentimiento, cookies o una respuesta de política. Un tiempo de espera o 429 apunta al ritmo, la red o un límite temporal. Cada categoría necesita una corrección distinta.

Para un problema de URL, abre la página en el navegador, copia la dirección canónica y repite una publicación con `--simulate --verbose`. Para un problema de acceso, compara una publicación pública con la sesión autenticada y usa la ayuda de cookies solo si la comparación lo justifica. Para un límite, detén el proceso, espera, reduce el rango y evita trabajos paralelos. Para una cantidad inesperada, revisa tipos, reblogs, recursos del tema y filtros antes de borrar el historial.

Conserva el texto original del error cuando pidas ayuda. Incluye la versión de gallery-dl, el sistema operativo, el comando saneado, la forma de la URL sin tokens privados y si funciona una simulación pública. Nunca adjuntes archivos de cookies ni medios privados a una incidencia pública.

Diagrama editorial que separa errores de URL, acceso y espera en Tumblr
Separa fallos de URL, acceso y límite antes de cambiar la configuración o las credenciales.

Orden de diagnóstico rápido

Comprueba la forma de la URL, prueba una publicación, compara acceso público y autenticado y solo después cambia filtros o destino. Este orden evita convertir un error de formato en un experimento de configuración confuso.

  • URL: ruta canónica, nombre del blog, ID de publicación y redirección.
  • Acceso: visibilidad, consentimiento, cookies y cuenta.
  • Espera: 403/429, tiempo de espera, pausa y ventana de reintento.
  • Salida: destino, campos de nombre, historial y duplicados.
Preguntas

Preguntas frecuentes sobre gallery-dl Tumblr

Estas respuestas se centran en decisiones que afectan a un trabajo de Tumblr repetible. Las páginas generales enlazadas ofrecen ejemplos más amplios cuando el problema no es específico de Tumblr.

Preguntas frecuentes

Preguntas de gallery-dl Tumblr

¿Puede gallery-dl descargar un blog completo de Tumblr?

Puede procesar una URL pública compatible, pero empieza con simulación y un rango pequeño. Un blog puede mezclar tipos, reblogs y mucho historial, así que usa un destino estable y un archivo antes de ampliarlo.

¿Uso una URL de blog o una etiqueta de Tumblr?

Usa el blog para un autor o colección, la etiqueta para una muestra temática y la publicación para verificar un elemento. La búsqueda sirve para descubrir porque sus resultados cambian entre ejecuciones.

¿Por qué gallery-dl Tumblr devuelve un resultado vacío?

Comprueba forma de URL, visibilidad, versión y salida de simulación. Puede ser una ruta incorrecta, un estado no compatible, un filtro sin coincidencias o una respuesta que exige acceso.

¿Necesito cookies para descargar desde Tumblr?

No para todas las páginas públicas. Úsalas solo si la comparación pública y el error muestran que hace falta una sesión. Mantén el archivo privado; las cookies no conceden permiso sobre contenido privado.

¿Cómo evito descargar dos veces la misma publicación?

Configura un historial estable y consérvalo con el trabajo. Prueba por separado los cambios de carpeta o nombre para entender qué identificadores está omitiendo.

¿Qué hago después de un 429 o un tiempo de espera?

Detén el trabajo, conserva el registro, espera, reduce el rango y añade una pausa prudente. Evita reintentos paralelos y no rotes cuentas para esquivar el límite.

Referencias oficiales

Código oficial del extractor TumblrDocumentación oficial de sitios compatiblesMetadatos de versiones de gallery-dl
SIGUIENTE PASO

Recursos relacionados