SEO Image Generator

何时使用

• 当 SEO / 内容发布流程中需要生成成品视觉时：OG/社交预览卡、博客头图、产品图、信息图、Schema 配图、社交方图、Pinterest 长图、favicon 等。
• 当上游审计（如 seo-images）已识别出缺失或低质图片，需据此驱动生成时。

不该用：

• 图像生成扩展（banana MCP）未安装/未连接时——先安装再用。
• 只做图片分析/审计打分而不生成时（那是 seo-images 或审计 agent 的职责，本技能不自动生成）。
• 非 SEO、与发布无关的随手出图场景。

前置检查

需要 banana 扩展提供 MCP 工具。使用前先确认 gemini_generate_image、set_aspect_ratio 等工具可用；不可用则提示用户安装：

./extensions/banana/install.sh

步骤 / 指令

1. 识别用例：从命令或上下文判定（og / hero / product / infographic / custom / batch）。
2. 套用 SEO 默认参数：按下表映射宽高比、分辨率、领域模式。
3. 设置宽高比：调用 set_aspect_ratio MCP 工具。
4. 构建推理简报（创意总监 6 要素管线，按需加载 references/prompt-engineering.md）：领域模式加权（Subject 30% / Style 25% / Context 15% …），描述要具体且有画面感——写"镜头看到了什么"。
5. 生成：调用 gemini_generate_image。
6. 跑生成后 SEO 清单（见下）。

用例 → 参数映射

模型路由

预设（可选）

用户提到品牌或已配置 SEO 预设时，先列出并套用为默认：

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

也可参考 references/seo-image-presets.md 中的 SEO 预设模板。

生成后 SEO 清单

每次成功生成后，引导用户完成：

1. Alt 文本：写描述性、含目标关键词的 alt。
2. 文件命名：关键词-描述-宽x高.webp。
3. WebP 转换（提速）：

   magick output.png -quality 85 output.webp
   

4. 体积：Hero 图 <200KB，缩略图 <100KB。
5. Schema 标记（ImageObject）：

   {
     "@type": "ImageObject",
     "url": "https://example.com/images/keyword-description.webp",
     "width": 1200,
     "height": 630,
     "caption": "含目标关键词的描述性说明"
   }
   

6. OG meta 标签（社交预览图）：

   <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="描述性 alt 文本" />
   

示例

/seo image-gen og  "SaaS 仪表盘上线公告，深色科技风，左侧留白叠标题"
/seo image-gen hero "AI 数据中心夜景，冷蓝光，电影级氛围"
/seo image-gen infographic "2026 内容营销趋势，竖版，5 段数据，品牌主色"
/seo image-gen batch "极简咖啡品牌产品图" 3   # 生成 3 个变体（默认 3）

返回时务必给出：图片保存路径、实际发送的提示词（教学用）、设置（模型/宽高比/分辨率）、SEO 清单、可用的 ImageObject 或 og:image 片段。

注意事项

• 成本透明：出图花钱。批量前先报估价；每次生成记账，需要时出汇总：

  python3 ~/.claude/skills/seo-image-generator/scripts/cost_tracker.py log --model MODEL --resolution RES --prompt "brief"
  python3 ~/.claude/skills/seo-image-generator/scripts/cost_tracker.py summary
  

  参考价（gemini-3.1-flash）：512 ≈ $0.02、1K ≈ $0.04、2K ≈ $0.08、4K ≈ $0.16 /张。
• 错误处理：
  • MCP 未配置 / 扩展未装 → ./extensions/banana/install.sh。
  • API key 失效 → 在 https://aistudio.google.com/apikey 重新申请。
  • 限流 429 → 等 60s 重试（免费档约 10 RPM / 500 RPD）。
  • IMAGE_SAFETY → 改写提示词（见 references/prompt-engineering.md 安全节）。
  • MCP 不可用兜底：python3 ~/.claude/skills/seo-image-generator/scripts/generate.py --prompt "..." --aspect-ratio "16:9"。
• 按需加载参考：勿启动即全量加载 references/ 下文档（prompt-engineering / gemini-models / mcp-tools / post-processing / cost-tracking / presets …）。
• 生成结果不替代环境内的验证、测试或专家审核；输入、权限、安全边界或成功标准缺失时，先停下来问清。

互见

• related：seo-images —— 图片分析/审计，识别缺失或低质图，其结论可驱动本技能生成。
• combines_with：seo-schema —— 生成后产出 ImageObject Schema 指向新资源。
• related：seo-audit —— 站点审计会派生（audit-only）分析 agent，产出生成计划（计划由它出、图由本技能生）。

采编自 sickn33/antigravity-awesome-skills（MIT）。