Guia gallery-dl Pixiv

O extrator oficial do Pixiv cobre mais do que uma obra individual. A lista de suporte inclui perfis, imagens, favoritos, seguidos, rankings, pesquisas, séries, Sketch, pixivision, fundos e avatares. Trate cada URL como um escopo diferente: um perfil pode devolver muitas obras, enquanto uma obra individual é um primeiro teste mais seguro. Use este guia gallery-dl Pixiv como uma lista local e verificável.

Copie a URL canónica de www.pixiv.net de uma página que você pode acessar, coloque-a entre aspas e simule antes de gravar arquivos. A simulação mostra se a versão instalada reconhece a URL, se a autenticação é necessária e quais mídias seriam selecionadas. Ela não garante que toda uma coleção permaneça disponível.

gallery-dl --simulate "https://www.pixiv.net/en/artworks/ARTWORK_ID"

gallery-dl --simulate "https://www.pixiv.net/en/users/USER_ID"

gallery-dl -K "https://www.pixiv.net/en/artworks/ARTWORK_ID"

O Pixiv pode exigir uma sessão iniciada para páginas que rejeitam pedidos anónimos. Faça login no site normal do Pixiv num perfil de navegador que você controla, confirme que a página abre e deixe o gallery-dl ler o armazenamento local de cookies. O seletor reproduz o acesso que a conta já possui; não concede autorização adicional. Use este guia gallery-dl Pixiv como uma lista local e verificável.

Feche o navegador se a base de cookies estiver bloqueada e escolha o perfil com a sessão ativa. Se um comando funcionava ontem, verifique separadamente a sessão, o perfil, o escopo da URL e a versão instalada. Nunca cole cookies, bases do navegador, tokens ou palavras-passe numa configuração pública.

• Confirme o acesso normal com o mesmo perfil.
• Feche o navegador quando a base estiver bloqueada.
• Guarde cookies e identificadores no seu dispositivo.
• Considere inacessível o conteúdo privado, eliminado ou restrito.

gallery-dl --cookies-from-browser firefox --simulate "https://www.pixiv.net/en/users/USER_ID"

gallery-dl --cookies-from-browser chrome --simulate "https://www.pixiv.net/en/users/USER_ID"

gallery-dl --cookies-from-browser edge --simulate "https://www.pixiv.net/en/users/USER_ID"

Uma resposta correta do extrator é apenas o começo. Decida se quer uma obra, obras públicas de um utilizador, favoritos, ranking ou pesquisa. Depois fixe o destino e use um intervalo pequeno na primeira execução. Inspecione os metadados com -K antes de criar nomes: os registos do Pixiv podem trazer utilizador, ID, página, data e extensão. Use este guia gallery-dl Pixiv como uma lista local e verificável.

Mantenha o destino fora do perfil temporário do navegador e não misture contas na mesma pasta. Um arquivo partilhado pode fazer o teste de outra pessoa parecer vazio. Separe diagnósticos de tarefas recorrentes e anote URL e versão do gallery-dl junto ao comando.

gallery-dl --cookies-from-browser firefox --range "1-10" --destination "D:/Media/Pixiv" "https://www.pixiv.net/en/users/USER_ID"

gallery-dl -K "https://www.pixiv.net/en/artworks/ARTWORK_ID"

gallery-dl --simulate --config-ignore "https://www.pixiv.net/en/artworks/ARTWORK_ID"

Quando o lote pequeno estiver correto, adicione --download-archive com um ficheiro local estável. O arquivo guarda identificadores concluídos e permite ignorá-los depois. Não é uma cópia de segurança das mídias e não deve ser apagado porque uma URL voltou sem ficheiros. Um resultado vazio pode ser causado por escopo, filtro, conteúdo indisponível ou IDs já arquivados. Use este guia gallery-dl Pixiv como uma lista local e verificável.

Aumente o intervalo gradualmente e examine os arquivos após cada mudança. Perfis, rankings, pesquisas e séries do Pixiv podem mudar durante o trabalho. Se a tarefa for usada em várias máquinas, faça backup do arquivo de propósito, mantenha o caminho estável e não copie credenciais do navegador.

• Use um arquivo por tarefa recorrente.
• Faça backup do arquivo como histórico, não como mídia.
• Aumente o intervalo apenas após conferir o resultado.
• Um resultado vazio não é sempre falha do extrator.

gallery-dl --cookies-from-browser firefox --range "1-25" --download-archive "pixiv.sqlite3" "https://www.pixiv.net/en/users/USER_ID"

gallery-dl --write-metadata --download-archive "pixiv.sqlite3" "https://www.pixiv.net/en/artworks/ARTWORK_ID"

gallery-dl --download-archive "pixiv-diagnostic.sqlite3" --simulate "URL"

Passe escolhas estáveis para o ficheiro de configuração somente depois de a versão de linha de comandos funcionar. O gallery-dl aplica opções nos níveis base, categoria e subcategoria; um ajuste do Pixiv pode ser mais específico que um valor global. Comece com destino, arquivo e regra de nome verificada, em vez de copiar todas as opções. Use este guia gallery-dl Pixiv como uma lista local e verificável.

Valide o JSON e confira o ficheiro ativo antes de culpar o Pixiv. Use --config-status para caminhos carregados, --config-open quando existir e --config-ignore para comparar uma execução limpa. JSON não aceita comentários; vírgulas finais, barras invertidas do Windows sem escape e segredos nos exemplos tornam a configuração inválida ou insegura.

{
  "extractor": {
    "base-directory": "D:/Media/Pixiv",
    "archive": "D:/Media/Pixiv/pixiv.sqlite3"
  }
}

gallery-dl --config-status

gallery-dl --config-ignore --simulate "https://www.pixiv.net/en/artworks/ARTWORK_ID"

Trate autenticação, limites, reconhecimento de URL, filtros e saltos do arquivo como problemas distintos. Uma mensagem de autenticação costuma indicar um perfil ausente, expirado, bloqueado ou errado. Um 429 pede pausa e escopo menor, não tentativas paralelas. Nenhum arquivo pode resultar de URL incompatível, conteúdo apagado ou restrito, filtro, intervalo ou IDs já arquivados. Use este guia gallery-dl Pixiv como uma lista local e verificável.

Compare a mesma URL com --config-ignore e --simulate e depois acrescente uma opção de cada vez. Verifique versão, URL canónica, ficheiro ativo e acesso normal no navegador. Quando o extrator upstream mudar, consulte a lista e a documentação oficiais; repetir pedidos não corrige uma regra da plataforma.

• Use apenas conteúdo e contas autorizados.
• Não partilhe cookies, tokens, URLs privadas ou logs sem limpar.
• Mantenha o primeiro teste pequeno e simulado.
• Respeite regras do Pixiv, direitos autorais e limites.