seo-image-gen

補足資料の入手可能性

このカタログのコピーには、以下のインラインガイダンスが含まれていますが、次の補足パスは含まれていません。これらは外部の前提条件であり、同梱ファイルではありません。

• <support-root>/references/prompt-engineering.md
• <support-root>/references/seo-image-presets.md
• <support-root>/references/gemini-models.md
• <support-root>/references/mcp-tools.md
• <support-root>/references/post-processing.md
• <support-root>/references/cost-tracking.md
• <support-root>/references/presets.md

必要な資料は、宣言された上流ソースまたはユーザーが提供したそのソースのインストール環境から入手してください。各パスをそのインストール環境からの相対パスとして解決し、内容を確認したうえで、該当するライセンスと実行要件を検証してください。必須ファイルが存在することを確認するまでは、コマンドを実行したり、参照先の手順に従ったと主張したりしないでください。不足しているスクリプトを捏造したり、同じ名前の無関係なファイルを同等のものとして扱ったりしないでください。ここに完全に記載されている独立した手順は、ユーザーが許可した範囲内で実行できます。依存する手順が利用できない場合は、その旨を報告してください。

SEO Image Gen：SEO アセット向け AI 画像生成（拡張機能）

banana Creative Director パイプラインを介した Gemini の画像生成を使用して、SEO 用途向けの本番環境対応画像を生成します。SEO のニーズを最適化されたドメインモード、アスペクト比、解像度のデフォルト値に対応付けます。

使用する場面

• OG 画像、ヒーロー画像、スキーマ用ビジュアル、インフォグラフィックなど、同様の SEO アセットを生成するときに使用します。
• 画像生成がより広範な SEO または公開ワークフローの一部であるときに使用します。
• 必要な画像生成拡張機能が利用可能な場合にのみ使用します。

アーキテクチャに関する注記

このスキルには、役割の異なる 2 つのコンポーネントがあります。

• SKILL.md（このファイル）：画像を生成する対話型の /seo image-gen コマンドを処理します
• エージェント（agents/seo-image-gen.md）：/seo audit の実行時に起動される監査専用の分析エージェントです。既存の OG／ソーシャル画像を評価して生成計画を作成します（自動生成は行いません）

前提条件

以下に記載されているインストーラー、エージェント、スクリプトは同梱されていません。パスを推測して実行したり、拡張機能を自動インストールしたりしないでください。セットアップの許可がある場合に限り、確認済みの固定された上流リビジョンを使用してください。ツールの利用可能性、モデル ID、費用、割り当て量は、実際に使用するプロバイダーで確認してください。以下の過去の見積もりは、請求額を保証するものではありません。ホストまたはユーザーが選択した画像ツールを尊重してください。生成の許可は公開の許可を意味するものではありません。また、提供された非公開画像をプロバイダーにアップロードするには、許可が必要です。

このスキルを使用するには、banana 拡張機能がインストールされている必要があります。

./extensions/banana/install.sh

利用可能か確認する： 画像生成ツールを使用する前に、gemini_generate_image または set_aspect_ratio ツールが利用可能かどうかを確認し、MCP サーバーが接続されていることを検証してください。ツールが利用できない場合は、拡張機能がインストールされていないことをユーザーに伝え、インストール手順を案内してください。

クイックリファレンス

コマンド	内容
/seo image-gen og <description>	OG／ソーシャルプレビュー画像を生成します（1200x630 相当）
/seo image-gen hero <description>	ブログのヒーロー画像を生成します（ワイドスクリーン、ドラマチック）
/seo image-gen product <description>	商品写真を生成します（すっきりした白背景）
/seo image-gen infographic <description>	インフォグラフィックのビジュアルを生成します（縦長、データ量の多い構成）
/seo image-gen custom <description>	Creative Director パイプライン全体を使用してカスタム画像を生成します
/seo image-gen batch <description> [N]	N 個のバリエーションを生成します（デフォルト：3）

SEO 画像のユースケース

各ユースケースには、事前設定された banana パラメーターが対応しています。

ユースケース	アスペクト比	解像度	ドメインモード	備考
OG／ソーシャルプレビュー	1200:630（非対応の場合はトリミング／リサイズ）	1K	Product または UI/Web	すっきりとしたプロフェッショナルな仕上がりで、テキストを配置しやすい
ブログのヒーロー画像	16:9	2K	Cinema または Editorial	ドラマチックで雰囲気があり、エディトリアル品質
スキーマ画像	4:3	1K	Product	すっきりとした説明的な画像で、スキーマの ImageObject 向け
ソーシャル用スクエア画像	1:1	1K	UI/Web	プラットフォームに最適化された正方形
製品写真	4:3	2K	Product	白い背景、スタジオ照明
インフォグラフィック	2:3	4K	Infographic	情報量が多く、縦型レイアウト
ファビコン／アイコン	1:1	512	Logo	ミニマルで、拡大縮小しやすく、認識しやすい
Pinterest ピン	2:3	2K	Editorial	縦長のカード

生成パイプライン

生成リクエストごとに、次の手順を実行します。

1. コマンドまたはコンテキスト（og、hero、product など）からユースケースを特定します
2. 上記のユースケース表からSEO のデフォルト設定を適用します
3. set_aspect_ratio MCP ツールでアスペクト比を設定します
4. banana Creative Director パイプラインを使用してReasoning Brief を作成します。
   • 6 コンポーネントシステムについて references/prompt-engineering.md を読み込みます
   • ドメインモードの重点配分（Subject 30%、Style 25%、Context 15% など）を適用します
   • 具体的かつ生き生きと描写します。カメラに何が映るのかを記述します
5. gemini_generate_image MCP ツールで生成します
6. 生成後の SEO チェックリストを実施します（下記参照）

プリセットの確認

ユーザーがブランドに言及した場合、または SEO プリセットが設定されている場合：

python3 ~/.claude/skills/seo-image-gen/scripts/presets.py list

一致するプリセットを読み込み、デフォルトとして適用します。SEO 固有のプリセットテンプレートについては、references/seo-image-presets.md も確認してください。

生成後の SEO チェックリスト

生成に成功した後は、毎回、ユーザーに次の項目を案内します。

1. 代替テキスト：画像の用途を簡潔に説明する代替テキストを作成します。装飾目的の画像には空の代替テキストを使用し、生成画像にキーワードを詰め込みすぎないようにします
2. ファイル名：SEO に適した形式に変更します：keyword-description-widthxheight.webp
3. WebP 変換：ページの読み込み速度を最適化するため、WebP に変換します。

   magick output.png -quality 85 output.webp
   

4. ファイルサイズ：ヒーロー画像は 200KB 未満、サムネイルは 100KB 未満を目標にします
5. スキーママークアップ：生成画像に ImageObject スキーマを使用するよう提案します。

   {
     "@type": "ImageObject",
     "url": "https://example.com/images/keyword-description.webp",
     "width": 1200,
     "height": 630,
     "caption": "Descriptive caption with target keyword"
   }
   

6. OG メタタグ：ソーシャルプレビュー画像について、次の点を確認するよう伝えます。

   <meta property="og:image" content="https://example.com/images/og-image.webp" />
   <meta property="og:image:width" content="1200" />
   <meta property="og:image:height" content="630" />
   <meta property="og:image:alt" content="Descriptive alt text" />
   

コストへの配慮

画像生成には費用がかかります。透明性を保ちましょう。

• 生成前に推定コストを提示します（特に一括生成の場合）
• 生成のたびに記録します：python3 ~/.claude/skills/seo-image-gen/scripts/cost_tracker.py log --model MODEL --resolution RES --prompt "brief"
• ユーザーから利用状況について尋ねられた場合は、cost_tracker.py summary を実行します

過去の参考コスト（最初に現在のモデルと料金を確認してください）：

• 512：画像 1 枚あたり約 $0.02
• 1K 解像度：画像 1 枚あたり約 $0.04
• 2K 解像度：画像 1 枚あたり約 $0.08
• 4K 解像度：画像 1 枚あたり約 $0.16

モデルの振り分け

シナリオ	モデル	理由
OG 画像、ソーシャルプレビュー	gemini-3.1-flash-image-preview @ 1K	高速でコスト効率が高い
ヒーロー画像、製品写真	gemini-3.1-flash-image-preview @ 2K	品質とディテールを両立
テキスト入りインフォグラフィック	gemini-3.1-flash-image-preview @ 2K, thinking: high	テキストのレンダリング性能が高い
クイックドラフト	gemini-2.5-flash-image @ 512	迅速に反復できる

エラー処理

エラー	解決方法
MCP が設定されていない	./extensions/banana/install.sh を実行します
API キーが無効	https://aistudio.google.com/apikey で新しいキーを取得します
レート制限（429）	Retry-After に従い、上限付きのバックオフを使用します。クォータは現在のアカウント／モデルによって異なります
IMAGE_SAFETY	プロンプトを言い換えます。references/prompt-engineering.md の Safety セクションを参照してください
MCP が利用できない	代替手段として、python3 ~/.claude/skills/seo-image-gen/scripts/generate.py --prompt "..." --aspect-ratio "16:9" を実行します
拡張機能がインストールされていない	インストール手順を提示します：./extensions/banana/install.sh

スキル間の連携

• seo-images（分析）はseo-image-gen（生成）に情報を提供します：/seo images の監査結果から、不足している画像や品質の低い画像を特定し、その結果を /seo image-gen コマンドに反映します
• seo-audit は、このスキルではなく seo-image-gen のエージェントを起動して、サイト全体の OG／ソーシャル画像を分析し、優先順位を付けた生成計画を作成します
• seo-schema は生成した画像を利用できます：生成後、新しいアセットを参照する ImageObject スキーママークアップを提案します

参考ドキュメント

必要に応じて読み込んでください。起動時にすべて読み込まないでください：

• references/prompt-engineering.md：6要素のシステム、ドメインモード、テンプレート
• references/gemini-models.md：モデルの仕様、レート制限、機能
• references/mcp-tools.md：MCP ツールのパラメーターとレスポンス
• references/post-processing.md：ImageMagick／FFmpeg のパイプラインレシピ
• references/cost-tracking.md：料金、使用状況の追跡
• references/presets.md：ブランドプリセットの管理
• references/seo-image-presets.md：SEO 固有のプリセットテンプレート

応答形式

生成後は、必ず以下を提示してください：

1. 画像パス：保存先
2. 作成したプロンプト：API に送信した内容を提示します（学習用）
3. 設定：モデル、アスペクト比、解像度
4. SEO チェックリスト：代替テキストの提案、ファイル名、WebP 変換
5. スキーマのスニペット：該当する場合は ImageObject または og:image のマークアップ

制限事項

• このスキルは、タスクが上記の説明に明確に合致する場合にのみ使用してください。
• 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
• 必要な入力、権限、安全上の境界、または成功基準が不足している場合は、作業を中断して確認してください。