Web ページの画像をまとめて集めて、Mac の「写真」へそのまま取り込む

拡張機能が読むもの、読まないもの

最初にはっきりさせておくべきなのはスキャンの範囲です。ページを読むブラウザ拡張機能は、本来まさに疑ってかかるべき種類のものだからです。

• 動くのは 1 つのタブに対してだけ、しかも指示したときだけです。 拡張機能が Safari に求めているのは、現在のタブへのアクセス、そのタブでスキャンを実行する権限、そして Mac 上のアプリとの通信路の 3 つです。ポップアップを開いて「スキャン」を押すまで何も起きません。Safari も「機能拡張」の画面で同じことを自分の言葉で書いています。現在のタブのページに対して、拡張機能を使ったときだけ、と。
• 集めるのはアドレスであって画像ではありません。 Safari からアプリへ渡るのは、画像の URL の一覧と、ページのアドレスとタイトルです。ダウンロードはそのあとアプリが、サイトから直接行います。
• 送る先がそもそもありません。 Emerald Tools のアカウントもなく、開発者が運用しているサーバーもなく、アプリにも拡張機能にも解析の仕組みは入っていません。拡張機能とアプリをつなぐキューは、お使いの Mac の中の共有された設定領域です。
• サムネイルはその場で作られます。 ポップアップのプレビューは、ページが既に読み込んでいる画像をブラウザの中で長辺 128 ピクセルまで縮小したものです。どこかから取り寄せているわけではなく、残りもしません。

右クリックでは届かない画像を、どうやって見つけるのか

今どきのページが、すべての画像を同時に抱えていることはまずありません。ギャラリーはスクロールに合わせて画像を出し入れし、レスポンシブなレイアウトは同じ絵を何通りかの大きさで用意してブラウザに選ばせ、装飾用の画像に至っては文書の側から見れば画像ですらありません。CSS で当てられた背景です。

スキャンはそれを前提に作られています。1 画面ぶんずつ、最大 30 画面ぶんまでページを下りながら、最後にまとめてではなく各段階で在庫を取ります。これが効くのは、画面の近くにある間だけ画像が存在するような一覧です。スクロールして戻ったころには、その画像はもう消えています。横にスクロールする領域も同じように、最大 20 画面ぶんまで走査します。走査が終わると、まだ通信中の画像が落ち着くのを待ち、最後にもう一度在庫を取り、スクロール位置を元に戻します。

ページが実際に描いている画像とあわせて、ページが言及しているだけのアドレスも読みます。srcset に並ぶ候補、スクリプトが差し替えるまで本来のアドレスを保持している遅延読み込み用の属性、CSS で指定された背景、SNS プレビュー用の og:image、そして noscript の中に置かれた代替の記述です。こうした参照はたいてい寸法を伴わないので、拡張機能は 1 件につき 1 回、2 秒を上限に取得を試み、寸法を測ってプレビューを作ります。測れなかったものも一覧には出します。スキャンが判断できなかった画像は、見せないより見せたほうがましだからです。

ページから「写真」まで、ひと続きで

「収集」を押した時点で選択がアプリへ渡り、ポップアップの役目は終わります。Mac 側ではアプリがコレクターを開き、お客様にしか答えられない問い（これをどこへ入れるか）まで一気に進み、新規アルバムの名前にはページのタイトルを入れておきます。ほぼ確実に、自分で打ち込んだであろう名前です。

そのあとのダウンロードは、意図的に急がない作りになっています。既定は同時 3 本、1 本終わってから次を始めるまでに 0.5 秒、1 ファイルあたり最大 3 回のリトライで待ち時間は 2 秒・4 秒・8 秒、そして収集元ページを名乗る Referer ヘッダを付けます。自分のページから来たリクエストにしか画像を返さないサイトがかなりの数あるためです。404 はリトライしません。待っても何も出てこないからです。実行中の様子は画面のログに 1 ファイル 1 行で書き出され、サイズと、実際にどの形式だったかが分かります。

形式はアドレスではなくファイルそのもので決まります。ダウンロードした先頭のバイト列から WebP・PNG・JPEG・GIF を判別し、それに合った拡張子で保存します。末尾が .jpg の URL から取得したファイルが、実体が WebP なら .webp として届くのはこのためです。名前と中身が食い違ったファイルで「写真」が詰まることもありません。判別できなかったものだけ、アドレスの拡張子をそのまま使います。

そのあとアニメーション WebP の処理に入ります。MP4 へ変換して元のファイルを削除し、動画が複数できた場合は、それらが同じアニメーションの連続した断片ではないかを調べます。ある動画の最後のフレームと、次の動画の最初のフレームを突き合わせ、一致するものを結合します。断片は残すので結合はやり直せます。取り込みの前に確認画面が出るのはこの場合だけです。収集したものがサムネイルで並び、変換された動画には印が付き、右クリックで QuickTime Player のプレビューが開き、取り込みボタンは選択が残っているものだけを入れます。変換するものが無ければ確認するものも無く、取り込みはそのまま進みます。変換機能は Emerald Tools の中で独立したツールとして設定を持っており、アニメーション WebP を MP4 に変換する手順は別のガイドで扱います。

サイトに拒まれたとき

ページの画像をまとめて集めるということは、人が閲覧しているときよりも短時間に多くのリクエストを出すということで、それを止めにかかるサイトもあります。アプリは 3 つの兆候を見ています。403、503、そして見落としやすいのが、ステータスは 200 なのに内容が HTML で返ってくる場合です。ボット判定が、求めた画像の代わりに確認ページを見せると決めたときの返り方です。

これが 3 回続くと、残りを最後まで擦り切らせて全部失敗させるのではなく、実行を一時停止します。通知が出て Dock アイコンが注意を促し、アプリはサインインや判定の通過ができるようにサイトをシート内で開くことを提案します。「完了」を押せば、いま確立したセッションで再開します。弾かれたファイルは切り捨てられず、キューへ戻ります。ダウンロード済みのものはそのまま残ります。

レート制限の厳しいサイトから集める場合は、同時接続数が調整の効くつまみです。アプリ自身も 5 本を超えると制限を招く可能性があると警告します。下げて困るのは所要時間だけです。

仕様と制限

以下はすべて現行バージョンの挙動で、計画ではありません。

• Safari での表示名: 「Emerald Tools - 画像コレクター」。Safari の設定の「機能拡張」に並びます。
• 拡張機能の権限: 現在のタブ、そこでスキャンを実行すること、アプリとの通信路。他のタブへの常時アクセスも、対象サイトの事前指定もありません。
• スキャンが読むもの: img 要素と遅延読み込み用の属性、img と picture の srcset の候補、CSS の背景画像、og:image、noscript の中の img 要素。
• 読まないもの: http と https 以外のアドレス（埋め込みのデータ URI を含む）。同じアドレスは 1 件にまとめます。
• スキャンの範囲: ページを下方向へ最大 30 画面ぶん、横にスクロールする領域は 1 つにつき最大 20 画面ぶん。
• サムネイル: ブラウザの中で長辺 128 ピクセルに縮小して生成。ページが寸法を示さなかった画像は、1 回だけ、2 秒を上限に取得し直して測ります。
• サイズフィルタ: 「最小幅」「最小高」をピクセルで指定。0 でそのしきい値は無効。寸法が分からない画像は残します。
• アプリへ渡すもの: 選択した画像のアドレス、ページのアドレス、ページのタイトル。画像そのものは渡しません。
• キュー: 拡張機能とアプリの間の受け渡しは Mac の中で行うので、アプリが終了していても収集でき、次回起動時に拾われます。
• ウィザード: 「保存先」「収集」「変換」の 3 段。自動変換を切ると「変換」の段は出ません。
• 保存先: 新規アルバム、新規フォルダとその中のアルバム、既存フォルダの中の新規アルバム、既存アルバム、アルバムなしのライブラリ。
• ダウンロード: 既定は同時 3 本（1〜10 で変更可）、1 本終わってから次を始めるまで 0.5 秒、収集元ページを名乗る Referer ヘッダ、1 ファイル 60 秒でタイムアウト。
• リトライ: 既定 3 回（0〜10 で変更可）、待ち時間は 2 秒・4 秒・8 秒。404 はリトライしません。
• 一時停止の条件: 403・503・画像の代わりに HTML、のいずれかが 3 回連続。再開すると弾かれたぶんはキューへ戻ります。
• 形式の扱い: WebP・PNG・JPEG・GIF を先頭のバイト列から判別。保存時の拡張子はアドレスではなくファイルに従います。
• 変換: アニメーション WebP から MP4 へ、既定で有効。静止画は変換しません。連続した断片は自動で結合し、元の断片は残します。
• 取り込み: 「写真」へ 50 件ずつ。まとめて失敗した場合は 1 件ずつ再試行し、静止画で受け付けられなかったものは PNG に変換して入れ直します。
• 履歴: 実行ごとにページのタイトル・アドレス・枚数・保存先を記録。直近 50 件かつ 14 日以内を保持し、いつでも消せます。
• 権限: 「写真」ライブラリへのアクセス。取り込みの開始時に要求します。このツールに画面収録やアクセシビリティの権限は不要です。
• 通信先: 収集元のサイトのみ。それ以外はありません。アカウントも解析もサーバーもありません。
• 動作環境: macOS 14.0 (Sonoma) 以降。