FLUJO DEL EXTRACTOR DE PIXIV

Guía de gallery-dl Pixiv

Esta guía de gallery-dl para Pixiv convierte una URL de obra, usuario, ranking, búsqueda, serie o Sketch en un comando pequeño y revisable. Explica cookies locales, simulación, rangos, nombres, archivos de historial, configuración y los fallos que conviene separar antes de una descarga grande. Usa esta guía gallery-dl Pixiv como una lista de comprobación local y revisable.

URL de obras y perfilesCookies locales del navegadorFlujo con archivo de historial
Ilustración editorial de una URL de obra de Pixiv que pasa por un flujo local de gallery-dl hacia carpetas organizadas
Ilustración: conserva bajo tu control la URL de Pixiv, la sesión, el comando y los archivos guardados.
Respuesta corta: simula primero una URL de Pixiv

Empieza con una URL pública de una obra o perfil de Pixiv y ejecuta --simulate. Si Pixiv pide una sesión autenticada, usa --cookies-from-browser con un perfil que controles. Cuando el extractor seleccione los archivos esperados, añade un rango pequeño, un destino estable y un archivo de historial antes de ampliar el trabajo. Usa esta guía gallery-dl Pixiv como una lista de comprobación local y revisable.

ELIGE EL OBJETIVO

Prueba una URL de Pixiv antes de descargar

El extractor oficial de Pixiv cubre más que una obra individual. La lista de sitios compatibles incluye perfiles, imágenes, favoritos, seguidos, rankings, búsquedas, series, Sketch, pixivision, fondos y avatares. Trata cada URL como un alcance distinto: un perfil puede devolver muchas obras, mientras que una obra individual es una primera prueba más segura. Usa esta guía gallery-dl Pixiv como una lista de comprobación local y revisable.

Copia la URL canónica de www.pixiv.net de una página a la que tengas permiso de acceder, escríbela entre comillas y simula la extracción antes de crear archivos. La simulación muestra si la versión instalada reconoce la URL, si hace falta autenticación y qué medios se seleccionarían. No demuestra que todos los elementos de una colección grande estén disponibles para siempre.

Probar una obra
gallery-dl --simulate "https://www.pixiv.net/en/artworks/ARTWORK_ID"
Probar un perfil
gallery-dl --simulate "https://www.pixiv.net/en/users/USER_ID"
Inspeccionar metadatos
gallery-dl -K "https://www.pixiv.net/en/artworks/ARTWORK_ID"
Sustituye los marcadores

Cambia USER_ID y ARTWORK_ID por una URL real que puedas consultar. No publiques enlaces privados, nombres de cuenta ni detalles de sesión.

AUTENTICA DE FORMA LOCAL

Usa cookies del navegador cuando Pixiv pida iniciar sesión

Pixiv puede exigir una sesión iniciada para páginas o medios que no se abren con peticiones anónimas. Inicia sesión en el sitio normal de Pixiv desde un perfil del navegador que controles, confirma que allí se abre la página y deja que gallery-dl lea el almacén local de cookies. El selector reproduce el acceso que ya tiene tu cuenta; no concede permisos sobre obras privadas ni evita desafíos. Usa esta guía gallery-dl Pixiv como una lista de comprobación local y revisable.

Cierra el navegador si su base de cookies está bloqueada y selecciona el perfil que contiene la sesión activa de Pixiv. Si un comando funcionaba ayer y hoy muestra un error de autenticación, comprueba por separado la sesión, el nombre del perfil, el alcance de la URL y la versión instalada. Nunca pegues cookies, bases del navegador, tokens de actualización o contraseñas en una configuración pública.

Flujo editorial desde una URL de Pixiv y una sesión local hasta la simulación y un archivo organizado
Una primera ejecución segura pasa de elegir la URL a autenticar localmente, simular y guardar un trabajo pequeño.
Sesión de Firefox
gallery-dl --cookies-from-browser firefox --simulate "https://www.pixiv.net/en/users/USER_ID"
Sesión de Chrome
gallery-dl --cookies-from-browser chrome --simulate "https://www.pixiv.net/en/users/USER_ID"
Sesión de Edge
gallery-dl --cookies-from-browser edge --simulate "https://www.pixiv.net/en/users/USER_ID"
HAZ PREDECIBLE EL RESULTADO

Controla el alcance, los nombres y las carpetas de Pixiv

Una respuesta correcta del extractor es solo el comienzo. Usa esta guía gallery-dl Pixiv como una lista de comprobación local y revisable.

Mantén el destino fuera del perfil temporal del navegador y no mezcles cuentas en una sola carpeta.

Trabajo de perfil pequeño
gallery-dl --cookies-from-browser firefox --range "1-10" --destination "D:/Media/Pixiv" "https://www.pixiv.net/en/users/USER_ID"
Revisar campos primero
gallery-dl -K "https://www.pixiv.net/en/artworks/ARTWORK_ID"
Previsualizar sin escribir
gallery-dl --simulate --config-ignore "https://www.pixiv.net/en/artworks/ARTWORK_ID"
PROTEGE LAS EJECUCIONES REPETIDAS

Usa un archivo de historial para descargas repetibles de Pixiv

Cuando una prueba pequeña sea correcta, añade --download-archive con un archivo local estable. El historial guarda identificadores de elementos descargados correctamente y permite omitirlos después. No es una copia de seguridad de los medios y no debes borrarlo solo porque una URL posterior no devuelva archivos. Un resultado vacío puede significar que cambió el alcance, que el contenido ya no está disponible, que un filtro es demasiado estrecho o que el historial ya contiene los ID. Usa esta guía gallery-dl Pixiv como una lista de comprobación local y revisable.

Amplía el rango poco a poco y revisa los archivos después de cada cambio. Los perfiles, rankings, búsquedas y series de Pixiv pueden cambiar mientras trabajas, así que el mismo comando no garantiza el mismo conjunto. Si el trabajo se comparte entre equipos, respalda el historial deliberadamente y no copies credenciales del navegador junto con él.

Ilustración editorial de problemas de autenticación, pausas por límite y comprobación de duplicados en Pixiv
Autenticación, ritmo y saltos del historial son señales distintas; diagnostícalas por separado.
Trabajo pequeño repetible
gallery-dl --cookies-from-browser firefox --range "1-25" --download-archive "pixiv.sqlite3" "https://www.pixiv.net/en/users/USER_ID"
Escribir metadatos
gallery-dl --write-metadata --download-archive "pixiv.sqlite3" "https://www.pixiv.net/en/artworks/ARTWORK_ID"
Historial de diagnóstico separado
gallery-dl --download-archive "pixiv-diagnostic.sqlite3" --simulate "URL"
GUARDA VALORES REVISADOS

Configura gallery-dl para Pixiv después de probar el comando

Pasa las decisiones estables al archivo de configuración solo después de que funcione la versión de línea de comandos. Usa esta guía gallery-dl Pixiv como una lista de comprobación local y revisable.

Valida el JSON y revisa el archivo activo antes de culpar a Pixiv.

Valores mínimos de Pixiv
{
  "extractor": {
    "base-directory": "D:/Media/Pixiv",
    "archive": "D:/Media/Pixiv/pixiv.sqlite3"
  }
}
Comprobar la configuración activa
gallery-dl --config-status
Comparar sin configuración
gallery-dl --config-ignore --simulate "https://www.pixiv.net/en/artworks/ARTWORK_ID"
Separa la autenticación

Puedes dejar el selector del navegador en la línea de comandos cuando cada equipo usa un perfil distinto. No pongas cookies, contraseñas ni tokens en un JSON compartido.

SEPARA LAS CAUSAS

Corrige los errores habituales de gallery-dl en Pixiv

Trata la autenticación, los límites, el reconocimiento de URL, los filtros y los saltos del historial como problemas diferentes. Usa esta guía gallery-dl Pixiv como una lista de comprobación local y revisable.

Compara la misma URL con --config-ignore y --simulate y añade después una sola opción cada vez.

Versión comprobada

Los metadatos de PyPI comprobados el 8 de octubre de 2026 listan gallery-dl 1.32.15, subido el 3 de octubre de 2026. Revisa la versión oficial antes de confiar más adelante en un comportamiento sensible a la versión.

Preguntas frecuentes

Preguntas frecuentes sobre gallery-dl y Pixiv

¿gallery-dl funciona con Pixiv?

La lista oficial incluye obras, perfiles, rankings, búsquedas, series, Sketch y otras rutas de Pixiv. El resultado depende de la versión, la URL, el acceso de la cuenta y el estado de la plataforma; simula siempre la URL concreta.

¿Cómo uso gallery-dl con Pixiv?

Empieza con una URL canónica de obra o perfil y ejecuta --simulate. Si pide acceso, añade --cookies-from-browser para un perfil que controles. Cuando la selección sea correcta, añade rango, destino e historial.

¿Pixiv necesita cookies para gallery-dl?

Las pruebas públicas pueden funcionar sin cookies, pero perfiles o páginas restringidas pueden exigir una sesión del navegador. Usa un perfil local propio y nunca publiques sus valores.

¿Cómo arreglo un error de autenticación?

Confirma que el mismo perfil abre la URL, cierra el navegador si la base está bloqueada y simula con el selector correcto. Comprueba versión y alcance antes de tocar filtros.

¿Por qué no devuelve archivos?

Revisa tipo de URL, permisos, contenido eliminado, filtros, rango, configuración e historial. Compara con --config-ignore --simulate y añade ajustes uno a uno.

¿Cómo evito descargas duplicadas?

Usa --download-archive con un archivo SQLite estable. Gallery-dl guarda identificadores completados y los omite; el historial no sustituye una copia de los medios.

Referencias oficiales

Lista oficial de sitios compatibles de gallery-dlDocumentación oficial de configuración de gallery-dlMetadatos oficiales de versiones en PyPI
SIGUIENTE PASO

Recursos relacionados