mcpField
W
wordpress-ai-image-optimizer

wordpress-ai-image-optimizer

github.com/respira-press開発4987 回インストール1 週間前に更新
リポジトリ

wordpress-ai-image-optimizer について

wordpress-ai-image-optimizerは、WordPressの画像とコンテンツ内の参照を監査・最適化するスキルです。画像をローカルで処理して原本を保持し、公開前に変更を確認できます。

主な機能

  1. 01画像の用途、サイズ、形式、メタデータを監査
  2. 02画像の圧縮、形式変換、リサイズ、改名
  3. 03代替テキストとレスポンシブ画像サイズの生成
  4. 04コンテンツの複製内で画像参照を更新
  5. 05スナップショット作成と実行レポート

活用シーン

  1. 01WordPressメディアライブラリの最適化項目を監査
  2. 02画像を縮小しWebPまたはAVIFに変換
  3. 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:包括的な画像監査

  1. サイト内のすべての画像をスキャンします:
    • メディアライブラリ(アップロード済みの全ファイル)
    • コンテンツ内の画像(投稿、固定ページ、カスタム投稿タイプ)
    • アイキャッチ画像
    • ビルダー内の画像(Elementor、Divi、Bricks など)
    • WooCommerce の商品画像(WooCommerce が有効な場合)
  2. 各画像を分析します(respira_analyze_images を使って監査を実施します。このツールは 1 回の呼び出しで画像ごとの分析結果を返します):
    • ファイルサイズと形式
    • 実際のサイズと表示サイズ
    • 代替テキストの有無と品質
    • ファイル名の SEO 対応度
    • 使用状況(この画像を使用しているページ/投稿)
    • レスポンシブ画像のサイズ(srcset)
    • 遅延読み込みの実装状況
  3. 最適化プラグイン/CDN を検出します:
    • Smush、ShortPixel、EWWW、Imagify、Optimole
    • Cloudflare、BunnyCDN、その他の CDN
  4. 効果に応じて最適化の機会を評価します:
    • ファイルサイズ × ページのトラフィック = 最適化の優先度
    • すぐに実行できる施策と、大きな効果が見込める施策を分けます
  5. 包括的なレポートを作成します

フェーズ 2:ユーザーの承認

レポートを提示し、実行する最適化を尋ねます:

  • サイズの大きすぎる画像を圧縮する
  • JPG/PNG を WebP に変換する
  • 不必要に大きなオリジナル画像のサイズを変更する
  • SEO に適さないファイル名を変更する
  • 不足している代替テキストを追加する
  • レスポンシブ画像のサイズを再生成する

ユーザーは次のいずれかを選択できます:

  • 「すべて最適化」(すべての最適化を実行)
  • 「圧縮のみ」(形式は変更しない)
  • 「上位 10 枚の画像」(効果の高いものから実行)
  • 「ホームページの画像のみ」(重要なページから実行)

フェーズ 3:AI による処理

  1. 書き込みを行う前に、respira_get_snapshot でメディアライブラリのスナップショットを取得します。これにより、respira_restore_snapshot を使ってバッチ全体を 1 回の操作で元に戻せます。バッチ処理の前に 1 回だけ取得し、画像ごとには取得しないでください。
  2. WordPress から画像をローカルのワークスペースにダウンロードします。
  3. 画像をローカルで処理します:
    • 圧縮
    • 形式変換
    • サイズ変更
    • SEO に適したファイル名への変更
    • AI による代替テキストの生成
    • オプション:画像の品質が低い場合やページに適していない場合は、オリジナルを再最適化する代わりに、respira_search_stock_images で差し替え画像を検索し、respira_sideload_image で取り込みます
  4. 最適化した画像を WordPress にアップロードします:
    • 新しいメディア項目を作成します(オリジナルファイルは変更しません)
    • 画像ごとに respira_update_media を呼び出すのではなく、respira_update_media_batch でメタデータをまとめて更新します。バッチでは最大約 50 件を処理できるため、通常のメディアライブラリなら 1 回の呼び出しで更新できます(代替テキスト、タイトル、キャプション、説明)。単発の修正に限り、respira_update_media を使用します。
    • 古いファイルに「非推奨 - [new-filename] に差し替え済み」とマークします
  5. コンテンツ内の参照を更新した複製を作成します:
  • 影響を受ける投稿/固定ページの複製を作成します
  • 古い画像 URL を新しい最適化済み URL に置き換えます
  • ビルダーと WooCommerce の画像参照を更新します
  1. レスポンシブ画像のサイズと srcset のサポートを再生成します

フェーズ 4:確認と公開

  1. 変更前後の比較を提示します:
  • ファイルサイズの削減量
  • 形式の変更
  • サイズの変更
  • ファイル名の改善
  • 影響を受けるページ
  1. ユーザーが WordPress 管理画面で複製を確認します
  2. ユーザーが公開を承認します
  3. 安全性とロールバックのため、古いファイルは引き続き利用できます
  4. respira_generate_activity_report で実行概要を生成し、作業を 1 行で監査できるようにします(例:「47 枚の画像を最適化し、1.2GB を削減、31 枚に代替テキストを追加」)。このツールは、Respira がバッチ処理についてすでに記録した変更ログを読み取ります。

誠実な免責事項

このスキルは画像をダウンロードし、AI で処理したうえで、最適化した画像をアップロードします。公開する前に、変更内容をすべて確認してください。

このスキルでできないこと:

  • 完璧な品質を保証すること(圧縮は非可逆です)
  • すでに破損している画像ファイルを修復すること
  • CSS の背景画像を最適化すること
  • WordPress のアップロード領域以外で外部ホストされている画像を処理すること
  • 構図やアートディレクションを改善すること(技術的な最適化のみ)

このスキルでできること:

  • 目に見える品質の低下を抑えて画像を圧縮すること
  • WebP に変換してファイルサイズを大幅に削減すること
  • 大きすぎるオリジナル画像を実用的な寸法にリサイズすること
  • SEO に適した名前にファイル名を変更すること
  • 説明的な代替テキストを生成すること
  • 重複ページ内の参照を自動的に更新すること
  • 安全性とロールバックに備えてオリジナル画像を保持すること

安全モデル

  • 非破壊:最適化した新しい画像を作成し、古いファイルは保持します
  • 重複を優先:重複ページ内のコンテンツを更新し、公開中のページには手を加えません
  • ユーザーの承認が必要:公開前に確認します
  • ロールバックに対応:古いファイルを保持し、元に戻せるようにします
  • 明示的な承認があるまで、公開中のサイトには影響しません

技術的な詳細

以下の Respira MCP ツールを使用します。

監査:

  • respira_analyze_images(フェーズ 1 の監査を実施。1 回の呼び出しで画像ごとの結果を取得します)

メディア操作:

  • respira_list_media
  • respira_get_media
  • respira_upload_media
  • respira_update_media_batch(メタデータの主な書き込み手段。1 回の呼び出しで最大約 50 件を処理します)
  • respira_update_media(単一アイテムへのフォールバック/個別の修正)
  • respira_delete_media(任意のクリーンアップ)

ストック画像の置き換え(任意):

  • respira_search_stock_images
  • respira_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_pages
  • respira_list_posts
  • respira_read_page
  • respira_read_post
  • respira_get_builder_info

コンテンツの更新:

  • respira_create_page_duplicate
  • respira_create_post_duplicate
  • respira_update_page
  • respira_update_post

WooCommerce(任意):

  • woocommerce_list_products
  • woocommerce_get_product
  • woocommerce_update_product

プラグインの検出:

  • respira_list_plugins

関連スキル

  • SEO & AEO Amplifier
  • WordPress Site DNA
  • Mobile Experience Report

Respira Team が作成 https://respira.press/skills/wordpress-ai-image-optimizer

コメント