wordpress-ai-image-optimizer について
wordpress-ai-image-optimizerは、WordPressの画像とコンテンツ内の参照を監査・最適化するスキルです。画像をローカルで処理して原本を保持し、公開前に変更を確認できます。
主な機能
- 01画像の用途、サイズ、形式、メタデータを監査
- 02画像の圧縮、形式変換、リサイズ、改名
- 03代替テキストとレスポンシブ画像サイズの生成
- 04コンテンツの複製内で画像参照を更新
- 05スナップショット作成と実行レポート
活用シーン
- 01WordPressメディアライブラリの最適化項目を監査
- 02画像を縮小しWebPまたはAVIFに変換
- 03ファイル名、代替テキスト、レスポンシブ対応を改善
MCP 対応
RespiraのMCPツールでWordPress画像を監査し、メディアとコンテンツの管理、スナップショットの取得、変更の復元、レポート作成を行います。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ respira-press/ agent-skills-wordpress --skill wordpress-ai-image-optimizerインストール後、Claude Code で/wordpress-ai-image-optimizerを入力して読み込まれたか確認します。
詳細
WordPress AI 画像オプティマイザー
バージョン: 1.2.1
更新日: 2026-06-30
最新の更新: v1.2.0 では、画像ごとの respira_update_media ループを、1 回で最大約 50 件を処理する respira_update_media_batch に置き換えました。バッチ処理の前に respira_get_snapshot でメディアライブラリのスナップショットを取得するため、処理全体を 1 ステップで元に戻せます。respira_analyze_images で監査を実行し、respira_search_stock_images と respira_sideload_image を使って、オプションのストック画像への差し替え候補を提示します。最後に respira_generate_activity_report で「47 件の画像を最適化し、1.2GB を削減」のような概要を作成します。
WordPress サイト向けの AI を活用した画像最適化です。画像を自動で圧縮し、フォーマットを変換し、ファイル名を変更して、すべての参照先を更新します。AI コードエディターで画像をローカル処理して最適化版を作成し、安全のため元の画像は保持します。
このスキルでできること
スキャン対象:
- メディアライブラリ内のすべての画像
- 投稿や固定ページのコンテンツ内の画像
- アイキャッチ画像
- ページビルダーの要素内の画像(Elementor、Divi、Bricks など)
- WooCommerce の商品画像
- カスタム投稿タイプの画像
検出項目:
- ファイルサイズ(ディスク上の実際の KB/MB)
- 画像の寸法(幅 x 高さ、ピクセル単位)
- フォーマット(JPG、PNG、GIF、WebP、AVIF、SVG)
- HTML で幅/高さ属性が設定されているか
- 代替テキストがあるか(およびその品質)
- 画像が使用されているか(未使用のメディアか)
- レスポンシブ画像サイズが存在するか(WordPress の srcset)
- 圧縮品質(ファイルサイズから推定)
- 遅延読み込みの実装状況
- SEO に適さないファイル名(IMG_1234.jpg、screenshot.png など)
- サイズが大きすぎるオリジナル画像(必要な最大サイズが 2000px なのに 5000px でアップロードされている場合など)
- コンテンツ内の画像で srcset が設定されていないもの
- WordPress のレスポンシブシステムを介さないページビルダーの画像
AI コードエディターでの最適化:
- WordPress から画像をダウンロード
- 最適な品質設定で圧縮(JPG は 80~85%、PNG はロスレス)
- 最新のフォーマットに変換(WebP を優先し、適切な場合は AVIF を使用)
- サイズが大きすぎるオリジナル画像を最適な寸法にリサイズ
- SEO に適した内容がわかるファイル名に変更
- AI で不足している代替テキストを生成
- WordPress のレスポンシブ画像サイズを再生成
- 最適化した画像を WordPress にアップロード
- 新しいメディア項目を作成(元のファイルは安全のため保持)
- 重複ファイル内のコンテンツ参照をすべて更新
提供内容:
- 包括的な画像ヘルススコア(0~100)
- 効果の大きさに基づいて優先順位付けされた最適化候補
- 最適化前後のファイルサイズ比較
- ページ速度の改善見込み
- プラグイン/CDN の検出と推奨事項
必要条件
- Respira for WordPress プラグインがインストールされ、接続されていること
- MCP 接続が有効であること(デスクトップまたは WebMCP)
- 画像処理ツールを備えた AI コードエディター(Claude Code、Cursor など)
- WooCommerce アドオン(任意。商品画像の最適化に使用)
- 画像スキャン用の読み取りアクセス権と、最適化版のアップロード用の書き込みアクセス権
使用方法
トリガーフレーズ
「AI で WordPress の画像を最適化して」
その他のトリガー
- 「AI 画像最適化を実行して」
- 「すべての画像を圧縮して最適化して」
- 「メディアライブラリを監査して」
- 「画像のパフォーマンスを改善して」
実行内容
フェーズ 1:包括的な画像監査
- サイト内のすべての画像をスキャンします:
- メディアライブラリ(アップロード済みの全ファイル)
- コンテンツ内の画像(投稿、固定ページ、カスタム投稿タイプ)
- アイキャッチ画像
- ビルダー内の画像(Elementor、Divi、Bricks など)
- WooCommerce の商品画像(WooCommerce が有効な場合)
- 各画像を分析します(
respira_analyze_imagesを使って監査を実施します。このツールは 1 回の呼び出しで画像ごとの分析結果を返します):- ファイルサイズと形式
- 実際のサイズと表示サイズ
- 代替テキストの有無と品質
- ファイル名の SEO 対応度
- 使用状況(この画像を使用しているページ/投稿)
- レスポンシブ画像のサイズ(srcset)
- 遅延読み込みの実装状況
- 最適化プラグイン/CDN を検出します:
- Smush、ShortPixel、EWWW、Imagify、Optimole
- Cloudflare、BunnyCDN、その他の CDN
- 効果に応じて最適化の機会を評価します:
- ファイルサイズ × ページのトラフィック = 最適化の優先度
- すぐに実行できる施策と、大きな効果が見込める施策を分けます
- 包括的なレポートを作成します
フェーズ 2:ユーザーの承認
レポートを提示し、実行する最適化を尋ねます:
- サイズの大きすぎる画像を圧縮する
- JPG/PNG を WebP に変換する
- 不必要に大きなオリジナル画像のサイズを変更する
- SEO に適さないファイル名を変更する
- 不足している代替テキストを追加する
- レスポンシブ画像のサイズを再生成する
ユーザーは次のいずれかを選択できます:
- 「すべて最適化」(すべての最適化を実行)
- 「圧縮のみ」(形式は変更しない)
- 「上位 10 枚の画像」(効果の高いものから実行)
- 「ホームページの画像のみ」(重要なページから実行)
フェーズ 3:AI による処理
- 書き込みを行う前に、
respira_get_snapshotでメディアライブラリのスナップショットを取得します。これにより、respira_restore_snapshotを使ってバッチ全体を 1 回の操作で元に戻せます。バッチ処理の前に 1 回だけ取得し、画像ごとには取得しないでください。 - WordPress から画像をローカルのワークスペースにダウンロードします。
- 画像をローカルで処理します:
- 圧縮
- 形式変換
- サイズ変更
- SEO に適したファイル名への変更
- AI による代替テキストの生成
- オプション:画像の品質が低い場合やページに適していない場合は、オリジナルを再最適化する代わりに、
respira_search_stock_imagesで差し替え画像を検索し、respira_sideload_imageで取り込みます
- 最適化した画像を WordPress にアップロードします:
- 新しいメディア項目を作成します(オリジナルファイルは変更しません)
- 画像ごとに
respira_update_mediaを呼び出すのではなく、respira_update_media_batchでメタデータをまとめて更新します。バッチでは最大約 50 件を処理できるため、通常のメディアライブラリなら 1 回の呼び出しで更新できます(代替テキスト、タイトル、キャプション、説明)。単発の修正に限り、respira_update_mediaを使用します。 - 古いファイルに「非推奨 - [new-filename] に差し替え済み」とマークします
- コンテンツ内の参照を更新した複製を作成します:
- 影響を受ける投稿/固定ページの複製を作成します
- 古い画像 URL を新しい最適化済み URL に置き換えます
- ビルダーと WooCommerce の画像参照を更新します
- レスポンシブ画像のサイズと srcset のサポートを再生成します
フェーズ 4:確認と公開
- 変更前後の比較を提示します:
- ファイルサイズの削減量
- 形式の変更
- サイズの変更
- ファイル名の改善
- 影響を受けるページ
- ユーザーが WordPress 管理画面で複製を確認します
- ユーザーが公開を承認します
- 安全性とロールバックのため、古いファイルは引き続き利用できます
respira_generate_activity_reportで実行概要を生成し、作業を 1 行で監査できるようにします(例:「47 枚の画像を最適化し、1.2GB を削減、31 枚に代替テキストを追加」)。このツールは、Respira がバッチ処理についてすでに記録した変更ログを読み取ります。
誠実な免責事項
このスキルは画像をダウンロードし、AI で処理したうえで、最適化した画像をアップロードします。公開する前に、変更内容をすべて確認してください。
このスキルでできないこと:
- 完璧な品質を保証すること(圧縮は非可逆です)
- すでに破損している画像ファイルを修復すること
- CSS の背景画像を最適化すること
- WordPress のアップロード領域以外で外部ホストされている画像を処理すること
- 構図やアートディレクションを改善すること(技術的な最適化のみ)
このスキルでできること:
- 目に見える品質の低下を抑えて画像を圧縮すること
- WebP に変換してファイルサイズを大幅に削減すること
- 大きすぎるオリジナル画像を実用的な寸法にリサイズすること
- SEO に適した名前にファイル名を変更すること
- 説明的な代替テキストを生成すること
- 重複ページ内の参照を自動的に更新すること
- 安全性とロールバックに備えてオリジナル画像を保持すること
安全モデル
- 非破壊:最適化した新しい画像を作成し、古いファイルは保持します
- 重複を優先:重複ページ内のコンテンツを更新し、公開中のページには手を加えません
- ユーザーの承認が必要:公開前に確認します
- ロールバックに対応:古いファイルを保持し、元に戻せるようにします
- 明示的な承認があるまで、公開中のサイトには影響しません
技術的な詳細
以下の Respira MCP ツールを使用します。
監査:
respira_analyze_images(フェーズ 1 の監査を実施。1 回の呼び出しで画像ごとの結果を取得します)
メディア操作:
respira_list_mediarespira_get_mediarespira_upload_mediarespira_update_media_batch(メタデータの主な書き込み手段。1 回の呼び出しで最大約 50 件を処理します)respira_update_media(単一アイテムへのフォールバック/個別の修正)respira_delete_media(任意のクリーンアップ)
ストック画像の置き換え(任意):
respira_search_stock_imagesrespira_sideload_image
スナップショットとロールバック:
respira_get_snapshot(一括処理の前に取得します)respira_restore_snapshot(1 ステップで元に戻します)
レポート:
respira_generate_activity_report(実行概要:最適化した画像、削減した容量、追加した代替テキストを報告します。プラグイン 9.0 以降ではツールとして利用できます。旧バージョンのプラグインでは、ability: "respira/generate-activity-report"と同じ引数をargsに指定してrespira_invoke_abilityを呼び出します)
コンテンツのスキャン:
respira_list_pagesrespira_list_postsrespira_read_pagerespira_read_postrespira_get_builder_info
コンテンツの更新:
respira_create_page_duplicaterespira_create_post_duplicaterespira_update_pagerespira_update_post
WooCommerce(任意):
woocommerce_list_productswoocommerce_get_productwoocommerce_update_product
プラグインの検出:
respira_list_plugins
関連スキル
- SEO & AEO Amplifier
- WordPress Site DNA
- Mobile Experience Report
Respira Team が作成 https://respira.press/skills/wordpress-ai-image-optimizer