IMGLAB Weibo Downloader — ユーザーガイド
ユーザーガイド & ヘルプセンター

Weiboの画像・動画を
完璧にダウンロード

インストールから上級機能まで — 完全ガイド。weibo.com フィードと s.weibo.com 検索結果の全投稿に赤いダウンロードボタンを自動注入します。

2
対応ページ
4
メディア形式
原画質
圧縮なし
0
登録不要
1 はじめに

インストール — 60秒で完了

IMGLAB Weibo Downloader はChrome拡張機能です。以下の手順に従えば1分以内にWeiboから画像・動画をダウンロードできるようになります。

01
Chrome ウェブストアから追加する

製品ページの 「Chrome に追加 — 無料」 をクリック。確認ダイアログが表示されたら 「拡張機能を追加」 をクリックします。Chrome ツールバーに IMGLAB のアイコン ⚡ が表示されます。登録・アカウント・支払いは不要です。

⚠️ ツールバーにアイコンが見えない場合は、Chrome ツールバーのパズルピース 🧩 アイコンをクリックし、IMGLAB Weibo Image & Video Downloader をピン留めしてください。
02
Chrome拡張機能ページを開く

Chromeのアドレスバーに以下を入力してEnterキーを押します:

chrome://extensions/

拡張機能の管理ページが開きます。ページ右上の「デベロッパーモード」スイッチをオンにしてください。「パッケージ化されていない拡張機能を読み込む」ボタンが表示されます。

💡 デベロッパーモードは完全に安全です。Chrome ウェブストア以外のローカルフォルダから拡張機能を読み込むことを許可するだけです。
03
拡張機能フォルダを読み込む

「パッケージ化されていない拡張機能を読み込む」をクリックします。フォルダ選択ダイアログが開きます。手順1で解凍したフォルダ — manifest.json ファイルが含まれているフォルダ — を選択してください。Chromeが即座に拡張機能を読み込みます。拡張機能リストに IMGLAB Weibo Downloader が表示されます。

💡 ツールバーにアイコンが表示されない場合は、Chromeツールバーのパズルアイコン 🧩 をクリックし、IMGLAB Weibo Downloader をピン留めしてください。
04
Weiboにログインする

Chromeで weibo.com にアクセスし、Weiboアカウントにログインしてください。拡張機能はあなたの既存のセッションクッキーを使用して画像・動画ダウンロードの認証を行います。認証情報を保存したり送信したりすることはありません。

⚠️ Weiboにログインしていない状態でダウンロードを試みると、APIが401 Unauthorizedまたは空のレスポンスを返します。ダウンロードが機能しない場合はまずログイン状態を確認してください。
05
初めてダウンロードする

weibo.com にアクセスします。フィードをスクロールすると、画像または動画を含む各投稿カードに赤い「ダウンロード」ボタンが自動的に表示されます。ボタンをクリックするとその投稿の全メディアが一括ダウンロードされます。

個別の画像をダウンロードしたい場合は、サムネイル上にカーソルを合わせると表示される小さな円形バッジをクリックしてください。ファイルは Downloads/weibo/{username}/ に保存されます。

💡 s.weibo.com の検索結果ページでも同じボタンが表示されます。ただし、検索ページで使用する際は必ず weibo.com のタブを1つ開いておく必要があります(詳細はセクション③を参照)。
🔄
拡張機能の更新:新バージョンが公開されたら、拡張機能フォルダ内のファイルを新しいものに置き換えてください。その後 chrome://extensions/ を開き、IMGLABカードの ↺ 更新ボタンをクリックします。設定は自動的に保持されます。
2 使い方

ダウンロードの操作方法

拡張機能には2つのダウンロード方法があります。投稿全体の一括ダウンロードと、画像1枚ずつの個別ダウンロードです。

方法A — 一括ダウンロード
「ダウンロード」フッターボタン
対象: 投稿内の全メディア(画像・動画すべて)

各投稿カードのフッターアクションバー(リツイート・コメント・いいねボタンの横)に赤い「ダウンロード」ボタンが表示されます。クリックすると投稿内のすべての画像と動画が順番にダウンロードされます。

動画のM3U8処理中はボタンのラベルがセグメント進捗(例: "32/96 segs")に変わります。完了すると「○ファイル ✓」に変わります。

方法B — 個別ダウンロード
サムネイル円形バッジ
対象: 1枚の画像のみ

各画像サムネイルの右上に小さな円形ダウンロードバッジが表示されます(ホバーで表示、クリックで即時ダウンロード)。投稿全体をダウンロードせずに特定の1枚だけ保存したい場合に便利です。

ライトボックスビューア(画像を拡大表示した状態)でも専用の大きなバッジが表示され、表示中の画像をそのままダウンロードできます。左右ナビゲーション後も継続して機能します。

⚠️
s.weibo.com 検索ページの要件:検索結果ページからダウンロードする場合、同じブラウザに weibo.com のタブが1つ以上開いている必要があります。これはChromeのMV3拡張機能モデルの制約によるものです。weibo.com 本体での利用には追加設定は不要です。

ボタン・バッジの状態表示

待機中(idle)

ダウンロード可能な状態。フッターボタンは「ダウンロード」と表示。サムネイルバッジは半透明の円形アイコンで、ホバー時に赤く光ります。

処理中(downloading)

APIからデータ取得中またはファイルダウンロード中。フッターボタンはグレーアウトして「ダウンロード中…」と表示(M3U8動画の場合はセグメント進捗)。バッジはスピナーアニメーションになります。この間は再クリックできません。

完了(done)

ダウンロード成功。フッターボタンは緑色で「○ファイル ✓」と表示。次回以降の訪問時は灰色で「Downloaded ✓」と表示(履歴追跡機能)。

エラー(error)

ダウンロード失敗。フッターボタンは赤色でエラーメッセージを表示。バッジは赤いエラーアイコンになり、クリックで再試行できます。Weiboのログアウトや通信エラーが主な原因です。

📊
ポップアップで統計確認:ツールバーの拡張機能アイコンをクリックするとポップアップが開き、累計ダウンロード数と今セッションのダウンロード数が確認できます。「ダウンロード履歴をクリア」ボタンで履歴と統計をリセットできます。
3 仕組み

ダウンロードの技術的な仕組み

他のツールが失敗するところでなぜこの拡張機能が動作するのかを技術的に解説します。Weiboの認証システムへの対処法を理解することで、動作しない場合のトラブルシューティングにも役立ちます。

1
MutationObserver によるボタン注入

MutationObserverがWeiboのDOMを監視し、新しい投稿カードが追加されるたびに検出します。無限スクロール・ページ遷移・動的読み込みすべてに対応。dataset.imglabInjected フラグで二重注入を防ぎます。weibo.comとs.weibo.comで異なるDOM構造に対応した別々の注入ロジックを使用しています。

2
Weibo API へのポストデータ取得

ボタンをクリックすると GET weibo.com/ajax/statuses/show?id={postId} をセッションクッキーと X-XSRF-TOKEN ヘッダー付きで呼び出します。weibo.com では直接の同一オリジンfetch。s.weibo.com では chrome.scripting.executeScript で開いているweibo.comタブに注入したコードが代わりにAPIを呼び出します — これがWeibo側のSec-Fetch-Site検証を通過できる唯一の確実な方法です。

3
メディアURL解決と画質選択

画像はCDNパス /large/ に解決され元の最高解像度を取得。動画は6段階の優先チェーンで最高画質のURLを解決: TV API (4K)playback_list HDmp4_hd_urlstream_url_hdstream_urlreplay_hd。M3U8マスタープレイリストは BANDWIDTH= 値で解析し最高ビットレートのストリームを自動選択します。

4
withCredentials XHR によるBlobフェッチ

weibo.comでの画像取得は XMLHttpRequest + withCredentials: true を使用。コンテンツスクリプトはページ自身のブラウジングコンテキストで動作するため、Weiboの sinaimg.cn CDNが要求する正しい Sec-Fetch-Site ヘッダーとセッションクッキーが自動的に付与されます。バックグラウンドのService Workerから同じリクエストを送ると403が返されます — これが多くの競合ツールが失敗する理由です。

5
s.weibo.com でのCORS回避

sinaimg.cnAccess-Control-Allow-Origin: https://weibo.com を返します。s.weibo.comのコンテンツスクリプトからのXHRはオリジン不一致でCORSブロックされます。解決策: chrome.scripting.executeScript でweibo.comタブ内のコードがBlobをフェッチし、8KBチャンクに分割してBase64エンコードし、コンテンツスクリプトに返します。コンテンツスクリプト側でBlobを再構築してダウンロードします。

6
blob: URL + onDeterminingFilename でファイル保存

取得したBlobを URL.createObjectURL(blob)blob: URLに変換し(data: URLは使用しない)、chrome.downloads.download() に渡します。Blob URLのみが onDeterminingFilename イベントをトリガーするため、カスタムファイル名 weibo/{username}/{filename} を確実に適用できます。data: URLではこのイベントが発火せず、Chromeのデフォルトファイル名(例: ダウンロード(14).jpg)になってしまいます。

🗂️
postDataCache による重複APIコール防止:同じ投稿の複数のバッジをクリックしても、APIコールは最初の1回だけです。取得したデータはページセッション中はメモリ内にキャッシュされ、2回目以降のクリックは即時に応答します。
4 対応コンテンツ

対応コンテンツ種別

Weiboで表示できるメディアはほぼすべてダウンロードできます。各コンテンツ種別の技術的な処理方法を説明します。

コンテンツ種別対応状況技術詳細
通常画像投稿(最大9枚) ✅ 対応 pic_infos から全画像取得・/large/ CDNパスで元解像度
画像+動画混在投稿 ✅ 対応 mix_media_info.items の各エントリを個別処理
動画のみの投稿 ✅ 対応 page_info.media_info + 6段階画質優先チェーン
ライブフォト(アニメーション) ✅ 対応 JPEG静止画と pic.video の動画トラック両方を保存
Weibo TV / HLS(長尺動画) ✅ 対応 M3U8セグメント結合・5並列 TaskQueue・マスタープレイリスト対応
ライブ配信アーカイブ ✅ 対応 object_type === 'live' の場合 replay_hd フィールドを使用
リツイート投稿 ✅ 対応 retweeted_status からメディア取得・リツイーターのコメントをファイル名スラグに使用
s.weibo.com 検索結果 ✅ 対応 executeScriptリレー経由・weibo.comタブが1つ必要
インラインライトボックスビューア ✅ 対応 weibo.com・s.weibo.com 両対応・左右ナビゲーション後も持続
ハッシュタグのみの投稿 ✅ 対応 ハッシュタグをそのままファイル名に使用(# は有効な文字)

ファイル名の命名ルール

1
第1優先: 投稿の本文テキスト

投稿テキストからURL・ハッシュタグ・@メンションを除去した先頭30文字を使用。例: username-post-caption-text-01.jpg

2
第2優先: ハッシュタグテキスト

本文が空または記号のみの場合、ハッシュタグをそのまま使用。# はWindowsとmacOSで有効なファイル名文字です。例: username-#tagA##tagB#-01.jpg

3
第3優先(最終フォールバック): 投稿ID

テキストが全く取得できない場合、投稿IDを使用。常に一意で元のWeibo投稿に追跡可能です。例: username-5079341827654-01.jpg

5 制限事項

既知の制限事項

以下の制限事項は実際に存在し、認識しています。ほとんどはChrome MV3のセキュリティアーキテクチャ、Weiboの認証システム、またはWeiboプラットフォームの意図的な設計によるものです。それぞれの原因を説明しているので、動作しない場合のトラブルシューティングに役立ててください。
🔑
Weiboへのログインが必須
必須要件

拡張機能はあなたのWeibo セッションクッキーと XSRF トークンを使用してAPIにアクセスします。未ログイン状態では 401 Forbidden または空のレスポンスが返され、ダウンロードが失敗します。

解決策: weibo.com にアクセスしてWeiboアカウントにログインしてください。
🌐
検索ページにはweibo.comタブが必要
s.weibo.com のみ

s.weibo.com での操作には同じブラウザに weibo.com タブが最低1つ開いている必要があります。これはChromeのMV3モデルにおける根本的な制約です — 拡張機能がweibo.comへの認証済みリクエストを行うには実際のweibo.comページコンテキスト内でコードを実行する必要があります。

解決策: s.weibo.com を使う前に weibo.com のタブを1つ開いてください。
🎬
動画ダウンロードは未テストの部分あり
実環境テスト推奨

M3U8/HLSセグメント結合・4K TV API・マスタープレイリスト画質選択・ライブ配信アーカイブのコードは実装済みですが、すべての動画形式で実環境テストが完了しているわけではありません。動画が期待通りにダウンロードされない場合はコンソールログを確認してください。

コンソールで [IMGLAB Weibo] のログを確認し、どの段階で問題が発生しているかを特定してください。
大きなM3U8動画はダウンロードに時間がかかる
仕様上の動作

M3U8動画は多数の .ts セグメントファイルを順次・並列でダウンロードして結合するため、直接のMP4ダウンロードより時間がかかります。5並列でダウンロードしていますが、100セグメント以上の長尺動画では数分かかる場合があります。ボタンに進捗状況(例: 32/96 segs)が表示されます。

ダウンロード中はボタンを再クリックしないでください。進捗が表示されている間は正常に処理中です。
🔄
Weiboのサイト変更による動作停止
随時対応中

WeiboはDOMの構造、CDNポリシー、APIのレスポンス形式を定期的に変更します。Weiboの変更によってボタンが表示されなくなったり、ダウンロードが失敗したりする場合があります。このような問題は通常、拡張機能の更新で修正されます。

拡張機能を最新バージョンに更新してください。問題が解決しない場合はサポートページからご報告ください。
🚫
一部の投稿でボタンが表示されない
稀に発生

投稿カードのDOM構造がWeiboのA/Bテストや地域差によって異なる場合、ボタン注入のセレクターが一致せず表示されないことがあります。特に動画投稿のフッター構造は通常投稿と異なる場合があります。

ページを再読み込みするか、別の投稿で試してみてください。継続して発生する場合はコンソールエラーログを添えてサポートにご報告ください。
💡
デバッグのヒント:問題が発生した場合はブラウザのデベロッパーツール(F12)のコンソールタブを開き、[IMGLAB Weibo] で始まるログを確認してください。APIのレスポンス、ダウンロードリストの内容、エラーメッセージが詳細に出力されています。
6 サポート

サポート & 寄付

無料 · オープン · コミュニティサポート

この拡張機能は
あなたのサポートで生きています

IMGLAB Weibo Downloader は完全無料です — 広告なし・サブスクリプションなし・データ収集なし。M3U8結合・s.weibo.com対応・ライブフォト両対応など、すべての機能はWeiboの認証システムに向き合い実際にデバッグする時間をかけて実現しました。

🐛 WeiboのDOM変更とCDNポリシー更新への継続的な対応
🌱 新機能:一括ダウンロード管理・動画画質選択UI・Firefoxポート
🧪 エッジケースのテスト — リツイート動画・ライブイベント・地域CDN差異
🔧 WeiboとChromeのAPI変更への継続的な追従

正直にお伝えします: WeiboはCDNとAPIを頻繁に変更します。拡張機能を動作させ続けるには継続的なメンテナンスが必要で、その工数はユーザーのサポートにかかっています。大切な画像や動画を保存できたなら — コーヒー1杯のサポートをご検討ください。

トラブルシューティング
ダウンロードボタンが表示されない
まずWeiboにログインしているか確認してください。ログイン済みなら、ページを再読み込みするか、ブラウザのコンソールで [IMGLAB Weibo] エラーを確認してください。
「エラー」と表示されてダウンロードできない
多くの場合、Weiboのセッション切れが原因です。weibo.com を開き直してログイン状態を確認してから再試行してください。
s.weibo.com でダウンロードが失敗する
同じブラウザウィンドウに weibo.com のタブが必要です。weibo.com を別タブで開いてから再試行してください。
動画のダウンロードが途中で止まる
M3U8動画は多数のセグメントを結合するため時間がかかります。ボタンに進捗が表示されていれば正常です。止まったと感じたらページを再読み込みして再試行してください。
ファイル名が「unknown」になる
投稿テキスト・ハッシュタグのどちらも取得できなかった場合、投稿IDがファイル名に使われます。これはフォールバック動作です。ファイルは正常に保存されています。
対応していない問題が発生した
Ko-fiまたはBuy Me a CoffeeのメッセージにURLとコンソールログを添えてご報告ください。ユーザーからの報告が今後の対応優先順位に直接反映されます。