gallery-dl Pixivガイド

公式Pixivエクストラクターは個別作品だけでなく、ユーザープロフィール、画像、ブックマーク、フォロー、ランキング、検索、シリーズ、Sketch、pixivision、背景、アバターなどを扱います。URLごとに取得範囲が違うため、最初は大量のプロフィールより個別作品を使う方が安全です。

アクセス権のあるページからwww.pixiv.netの正規URLをコピーし、引用符で囲んでファイルを書き込む前にシミュレーションします。認識されたエクストラクター、認証の要否、選択されるメディアを確認できます。大きなコレクションが将来も同じ状態とは限りません。

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"

Pixivは匿名アクセスを拒否するページでログイン済みセッションを求めることがあります。自分が管理するブラウザープロファイルで通常どおりログインし、対象ページが開くことを確認してから、gallery-dlにローカルCookieを読ませます。Cookieはアカウントがすでに持つ権限を再現するだけで、非公開作品への権限を追加しません。

Cookieデータベースがロックされている場合はブラウザーを終了し、Pixivの有効なセッションがあるプロファイルを選びます。昨日動いたコマンドが失敗したら、セッション、プロファイル、URLの範囲、インストール済みバージョンを別々に確認します。Cookie値、ブラウザーDB、トークン、パスワードは共有しないでください。

• 同じプロファイルで通常のPixiv閲覧を確認する。
• DBがロックされたらブラウザーを閉じる。
• Cookieとアカウント識別子を端末内に保管する。
• 非公開・削除済み・制限付きで開けない内容は取得しない。

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"

エクストラクターが応答しても作業は終わりません。

保存先をブラウザーの一時プロファイル内に置かず、複数アカウントを同じフォルダーに混ぜないでください。

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"

小さな実行が正しければ、固定したローカルファイルを--download-archiveで指定します。成功したIDを記録して次回にスキップできます。メディアのバックアップではないため、URLが空になっただけで削除しないでください。範囲、フィルター、非公開化、既存IDなど別の理由があります。

範囲は少しずつ広げ、変更するたびに結果を確認します。Pixivのプロフィール、ランキング、検索、シリーズは途中で変わるため、同じコマンドでも同じ集合とは限りません。複数端末で使う場合はアーカイブだけを意識してバックアップし、ブラウザー認証情報を一緒にコピーしないでください。

• 定期処理ごとにアーカイブを分ける。
• アーカイブは履歴としてバックアップする。
• 結果を確認してから範囲を増やす。
• 空の結果をすぐエラーと決めつけない。

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"

コマンドライン版が成功してから安定した項目を設定ファイルに移します。

Pixivを疑う前にJSONと有効なファイルを確認します。

{
  "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"

認証、レート制限、URL認識、フィルター、アーカイブによるスキップは別の問題です。

同じURLを--config-ignoreと--simulateで比較し、設定を一つずつ戻します。

• アクセスと利用が認められた内容だけを保存する。
• Cookie、トークン、非公開URL、未編集ログを共有しない。
• 最初のテストは小さくsimulateする。
• Pixivの規約、著作権、レート制限を守る。