Tumblrワークフローガイド

gallery-dl Tumblr:ブログとアーカイブを保存する方法

gallery-dl Tumblrを安全に使うには、URLの範囲、アクセス状態、繰り返し実行の管理を分けて考えます。このページでは公開ブログを試し、タグや投稿を小さく保存し、必要な場合だけCookieを使い、予測しやすいローカルアーカイブを作る手順を説明します。

ブログURLタグと検索Cookie重複を避けるアーカイブ
TumblrブログのURLがgallery-dlのテストを経て整理されたローカルアーカイブになる流れ
Tumblr専用の流れは、小さなURLテストから始めて確認済みのアーカイブで終わります。
まず結論

入力にはTumblrの公開ブログ、タグ、投稿、検索URLを使います。最初はgallery-dl --simulateでファイルを書かずに検出結果を確認し、その後同じURLを小さな範囲と既知の保存先で実行します。Tumblrがログイン状態を求める場合だけブラウザーCookieを追加し、再実行する予定ならアーカイブを残します。

URL選び

TumblrのURLタイプを使い分ける

知りたいことに必要な最小のURLから始めます。投稿URLは特定の項目を解析できるか確認するのに便利です。ブログURLは作者のメディアを継続的に整理する場合に使います。タグURLや検索URLは結果が変わるため、最初は狭い範囲にしてください。スマートフォンの共有URLに追跡パラメーターが付いている場合は、削除後も同じ対象を指すか確認します。

Tumblrのブログは複数の表記で現れます。`tumblr.com/blog/name`、`name.tumblr.com`、投稿のパーマリンクは同じブログを示すことがありますが、テストしやすさは異なります。正規形に近い短いURLを選び、元のURLもメモして後で差分を説明できるようにします。

テーマに表示された画像がすべて投稿メディアとは限りません。アバター、推薦、外部埋め込み、装飾素材が混ざることがあります。シミュレーションの結果行に出るID、メディアURL、投稿タイプを見てからフィルターを作成してください。

URL範囲最初の用途注意点
単一投稿解析と権限の確認メディアがない場合もある
ブログ作者やコレクションの整理大きな処理になりやすい
タグ話題の小さなサンプル結果が時間で変わる
検索候補の発見再現性が低い
カスタムサブドメイン直接的なブログ処理Tumblrの所有先か確認
URLは一つから

一件の投稿をシミュレーションする方が、テーマ素材やリブログまで混ぜる大きなコマンドより、正しい対象を確認しやすくなります。

最初の実行

安全な最初のテストを行う

Pythonやパッケージ環境に合う方法でgallery-dlをインストールします。インストールガイドで選択肢を確認し、`gallery-dl --version`が応答したら、Tumblrの最初の実行を小さくします。シミュレーションはメディアを書き込まずにExtractorのメッセージを表示するため、URLの誤り、ログイン画面、広すぎる範囲を早く見つけられます。

次のような形でコマンドを使い、実際に確認する権利のある公開URLへ置き換えます。出力は次の判断材料であり、すべての投稿にファイルがあるという保証ではありません。

シミュレーションが納得できたら、空のテストフォルダーを選び、`--simulate`を外して同じURLを実行します。最初は既存の大切なアーカイブと分けてください。メッセージ数とファイル数を比較でき、不要ならテスト結果だけを削除できます。

URL、テスト、アーカイブで構成されたgallery-dl Tumblrの三段階ワークフロー
Tumblrの再現可能な処理は、URL選択、結果のシミュレーション、小さな保存の三段階です。

シミュレーション結果の読み方

Extractor名、ブログまたは投稿ID、メディアURL、認証に関する警告を確認します。空の結果でもすぐにCookieを追加したり多くの設定を変えたりしません。URLが対応形式か、ブログが公開されているか、インストールしたバージョンが現在の応答を処理できるかを順番に確認します。

  • 新しいURLの診断中は`--verbose`を使い、通常処理では外す。
  • 全ブログの前に`--range`で小さく試す。
  • URL、日付、コマンド、保存先を記録する。
ファイルを書かずに確認
gallery-dl --simulate --verbose https://example.tumblr.com/
専用フォルダーで一件をテスト
gallery-dl -d ./tumblr-test https://example.tumblr.com/post/123456789
タグの範囲を制限
gallery-dl --range 1-20 -d ./tumblr-sample https://www.tumblr.com/tagged/photography
処理例

ブログ、タグ、投稿、検索を保存する

ブログ全体の保存はよくある用途ですが、すべての作業で最初に選ぶ必要はありません。一枚だけ必要なら投稿URLを使い、テーマを集めるならタグと小さい範囲を使います。未知の話題を探す場合は検索で候補を見つけ、後で投稿URLやブログURLの再現しやすい処理に変換します。

Extractorは写真だけを扱うとは限りません。動画や音声は別のメディア動作になり、テキスト、引用、回答の投稿はファイルを出さないことがあります。リブログのメタデータをファイル名に入れたくない場合もあります。フィルターを書く前に、シミュレーションで投稿タイプを確認してください。

大きなブログはチェックポイントに分けます。最初の範囲を実行し、フォルダーとアーカイブを確認してから広げます。ネットワークエラーで停止しても、安定した名前とアーカイブがあれば、過去の項目を新規として扱わずに再開できます。

実用的な順番

まず投稿を検証し、次にブログやタグの範囲を検証し、その後Cookieが必要か判断します。最後に保存先とアーカイブを追加し、小さな結果が理解できてから繰り返します。この順番なら解析の問題とアクセスの問題を分けられます。

  • 投稿URL:一件の解析確認に向く。
  • ブログURL:作者やコレクションの整理に向く。
  • タグURL:話題の小さなサンプルに向く。
  • 検索URL:発見用で、固定アーカイブのキーには向かない。

良い結果とは

良い結果は説明できます。どのURLから出たか、ファイル数が妥当な理由、含めた投稿タイプ、保存先が分かります。大量に保存できても、再現や監査ができない処理は安全なワークフローとは言えません。

再現性

設定、ファイル名、アーカイブを管理する

テストコマンドを理解したら、安定した選択をgallery-dlの設定へ移します。Tumblrのディレクトリ、ファイル名のフィールド、ダウンロードアーカイブ、控えめな待ち時間を一つのレビュー済み設定にまとめると、手動処理と定期処理の差が減ります。

Tumblrのファイル名は、どのブログか、どの投稿またはIDか、複数メディアの何番目かを示すと読みやすくなります。キーワードは推測せず、ファイル名ガイドで利用可能な項目を調べます。投稿タイプによって項目がない場合は、空の区切りに頼らず、読める代替を選びます。

アーカイブは処理済みIDの記録であり、メディアのバックアップではありません。設定のそばに置き、バックアップ計画に含め、URL情報を含む場合は公開しないでください。ディレクトリや名前を変えるとき、同じ論理項目を引き続き除外したい場合だけ同じアーカイブを使います。

最小設定の形
{
  "extractor": {
    "tumblr": {
      "directory": ["tumblr", "{blog_name}"],
      "filename": "{id}_{num:>02}.{extension}",
      "archive": "./state/tumblr-{blog_name}.sqlite3"
    }
  }
}
利用できるキーワードを確認
gallery-dl --list-keywords https://example.tumblr.com/
アーカイブを安定させる

フォルダー名を変えてもアーカイブの識別子は変わりません。ファイルを移動したり新しい保存先に分けたりする前に、同じ投稿を今後も除外するか決めてください。

アクセス

Tumblrが求めるときだけCookieを使う

公開Tumblrページを最初のテストにします。ブラウザーでは見えるのにgallery-dlがアクセスエラーを返す場合、セッションCookie、同意状態、またはブラウザー後に変わる応答が原因かもしれません。サイトのCookieヘルパーでローカルに書き出し、値をコマンドや公開Issueに貼らず、gallery-dlの対応オプションからファイルを渡します。

Cookieは非公開ページを公開に変えず、保存の許可も与えません。期限が切れ、作成したアカウントの権限を反映し、コピーするとアカウントへのアクセスを漏らす可能性があります。権限を制限し、公開ディレクトリの外で保管し、テスト後に削除します。

Cookie付きの処理が失敗したら、公開URLのシミュレーションと比較します。公開テストも失敗するなら、認証ではなくURL解析、バージョン、ネットワーク、待ち時間の問題である可能性が高くなります。

慎重なアクセス確認

公開URLを確認し、必要なCookieだけを書き出し、一件をシミュレーションします。Cookieファイルをリポジトリやプロジェクト内の公開場所に置かず、不要になったセッションは削除します。

  • Cookieヘッダーを記事、ログ、Issueに貼らない。
  • 許可なしに他人の認証済み内容を公開しない。
  • 作業に必要な最小の認証範囲だけを使う。
制御

フィルター、待ち時間、責任ある境界を加える

Tumblrアーカイブは、何を求めているかをコマンドに表すと管理しやすくなります。最初は範囲を指定し、利用できるメタデータで日付や投稿を絞り、混在コンテンツが不要なら投稿タイプを条件にします。条件が何も一致しないとExtractorの故障に見えるため、必ずシミュレーションで確認します。

短い待ち時間、控えめな範囲、停止条件は、複数の全ブログ処理を並列で動かすより安全です。Tumblrがレート制限や一時エラーを返したら停止し、ログを残して、後で小さい範囲とゆっくりした速度で試します。アカウントを入れ替えてブロックを回避しないでください。

技術的に保存できることは、再公開の許可を意味しません。作者の条件、Tumblrのポリシー、メディアのライセンスや著作権を確認し、非公開または機微な内容を公開アーカイブへ入れないでください。

制御項目効果確認すること
小さい範囲最初の書き込みを制限範囲と想定順序が一致
投稿タイプ不要な内容を除外シミュレーションで一致を確認
待ち時間急なアクセスを減らす遅い実行でも現実的
アーカイブ既知IDをスキップ安定したパスでバックアップ済み
別の保存先既存ファイルを守るテストフォルダーを削除できる
復旧

Tumblrでよくある失敗を切り分ける

コマンドを変える前に失敗の種類を分けます。404や空の結果は、URLのコピー違い、ブログの移転、対応外のパスかもしれません。403やログイン表示はアクセス、同意、Cookie、サイトのポリシー応答を示します。タイムアウトや429は速度、ネットワーク、一時的な制限を示します。原因ごとに対処を変えてください。

URLの問題なら通常のブラウザーでページを開き、正規形に近いURLをコピーし、一件を`--simulate --verbose`で再試行します。アクセスの問題なら公開投稿と認証済みセッションを比較し、その結果が示す場合だけCookieヘルパーを使います。制限なら停止して待ち、範囲を小さくし、並列処理を避けます。ファイル数が想定外なら投稿タイプ、リブログ、テーマ素材、フィルターを調べてからアーカイブを消します。

助けを求めるときは元のエラー文を残します。gallery-dlのバージョン、OS、機密情報を除いたコマンド、プライベートトークンを外したURLの形、公開シミュレーションが動くかを伝えます。Cookieや非公開メディアは添付しません。

TumblrのURL、アクセス、待機エラーを分ける編集部向け診断図
設定や認証を変える前に、URL、アクセス、レート制限を分けて考えます。

診断の順序

URLの形を確認し、一件をテストし、公開と認証済みのアクセスを比べ、その後でフィルターや保存先を変更します。この順序なら単純な形式ミスを複雑な設定実験にしません。

  • URL:正規パス、ブログ名、投稿ID、リダイレクト。
  • アクセス:公開状態、同意、Cookie、アカウント範囲。
  • 待機:403/429、タイムアウト、遅延、再試行時間。
  • 出力:保存先、名前の項目、アーカイブ、重複数。
質問

gallery-dl Tumblr FAQ

ここでは再現可能なTumblr処理に関わる質問へ答えます。インストール、設定、Cookie、一般的なトラブルは下の関連ページで詳しく確認できます。

よくある質問

gallery-dl Tumblrの質問

gallery-dlでTumblrのブログ全体を保存できますか?

対応する公開ブログURLを処理できますが、最初はシミュレーションと小さい範囲にします。投稿タイプや履歴が多い場合があるため、安定した保存先とアーカイブを用意してから広げます。

TumblrではブログURLとタグURLのどちらを使いますか?

作者やコレクションならブログ、話題の小さなサンプルならタグ、一件の確認なら投稿を使います。検索URLは結果が変わるため発見用にします。

gallery-dl Tumblrの結果が空になる理由は?

URLの形、公開状態、gallery-dlのバージョン、シミュレーション出力を確認します。誤ったパス、対応外の状態、空のフィルター、アクセス要求が原因になり得ます。

TumblrのダウンロードにCookieは必要ですか?

すべての公開ページに必要ではありません。公開比較とエラーがブラウザーセッションを示す場合だけ使い、Cookieファイルを非公開にします。Cookieは非公開内容の権限を与えません。

同じTumblr投稿を二度保存しない方法は?

安定したアーカイブを設定し、処理と一緒に保管します。保存先や名前を変える場合は別のテストで、どのIDを抑制しているか確認します。

Tumblrで429やタイムアウトが出たら?

停止してログを残し、待ってから範囲を減らし、控えめな待ち時間で再試行します。並列リトライやアカウント切り替えで制限を回避しないでください。

公式資料

公式Tumblr Extractorのソース公式対応サイト資料gallery-dlのリリース情報
次のステップ

関連リソース