HOME SKILLS BLOG GITHUB
// OPTIONAL EXTENSION

SEO IMAGE GENERATION

Plan six image-generation command formats for social previews, page heroes, product images, infographics, custom assets, and prompt variations.

By Daniel Agrici · Verified 2026-08-27 against the Claude SEO v2.2.5 source snapshot and current Google AI documentation.

MCP ROUTE UPDATE REQUIRED

The pinned MCP adapter is unavailable; the bundled direct API fallback is source-verified but execution-unverified. The adapter still maps to retired Gemini preview models. The fallback dispatch path is verified in the v2.2.5 source, but no paid current-model request was made here. Test the selected route with a supported model before any provider request.

!
/seo image-gen og <description>
REFERENCE SYNTAX

MCP ROUTE BLOCKED // DIRECT FALLBACK NEEDS A CONTROLLED TEST

An amber warning gate disconnects the pinned MCP image controls from dimmed landscape, square, and portrait outputs
// RUN PREVIEW

What is the current run readiness?

This reference is ready for planning. The pinned MCP route is blocked, while the documented direct fallback remains execution-unverified. Prepare the brief now, then repair the MCP route or complete a controlled fallback test before any provider call.

OUTCOME TODAY

A command reference and repair plan, not a generated image.

REQUIRED INPUT

An asset type and description. Audience, subject, style, composition, and constraints make the generated brief more useful.

READINESS

Mixed. The pinned MCP adapter is blocked. The bundled direct API fallback is source-documented but has not been live-tested here.

OUTPUT AFTER A VERIFIED RUN

A generated raster candidate that still needs exact cropping, web conversion, alt text, and human review.

SIDE EFFECTS OF A LIVE RUN

A network request to Gemini, possible provider charges, and local file writes.

APPROVAL GATES

Confirm selected-route compatibility, current pricing, key handling, input rights, and final visual quality before publication.

// DECISION GUIDE

When should you plan for the image generation extension?

Use this reference to prepare a brief and understand the intended command surface. Do not run the pinned MCP adapter until compatibility is restored. The documented direct fallback also needs a controlled current-model test. Once a selected route is verified, use generation only when the task needs a raster image and a human will review the result before publication.

PLAN IT FOR

  • Original social-preview and page-hero concepts.
  • Unbranded product scenes and editorial illustrations.
  • Infographic drafts from verified source data.
  • Several visual directions for one approved brief.

USE ANOTHER TOOL WHEN

  • You need to audit or optimize existing files. Use /seo images.
  • Exact text, logos, measurements, or factual diagrams must be deterministic.
  • You do not hold rights to a reference image or depicted identity.
  • No paid provider call or external file write has been approved.
  • Neither the repaired MCP route nor the direct fallback has passed a controlled current-model test.
01

CLASSIFY

Select the documented command form and describe the intended asset, audience, subject, style, composition, and constraints.

02

SELECT ROUTE

Repair the retired MCP model mappings or inspect the documented direct fallback with an explicitly supported model.

03

TEST

Inspect the connected tools and complete a controlled generation test with current pricing, limits, and write paths confirmed.

04

REVIEW

Inspect any returned image, crop to exact pixels, convert for the web, write alt text, and obtain human approval.

// COMMAND REFERENCE

Which image-generation commands are documented?

Syntax reference. The six forms below define the intended command surface. Execute them only after the selected route uses a supported model and passes a controlled test.

Claude SEO documents six command forms. The format defaults below belong to the extension contract. They do not prove current adapter compatibility or exact publication pixels.

Complete command surface

CommandDocumented behavior
/seo image-gen og <description>Documents a 16:9, 1K social-preview concept. An approved result would still need a separate exact 1200 by 630 export.
/seo image-gen hero <description>Documents a 16:9, 2K editorial or cinematic hero concept.
/seo image-gen product <description>Documents a 4:3, 2K product image with the product-oriented prompt mode.
/seo image-gen infographic <description>Documents a 2:3, 4K infographic draft that would require label and data verification.
/seo image-gen custom <description>Documents the full creative-director workflow for an asset outside the preset formats.
/seo image-gen batch <description> [N]Documents N variations of one concept, with three as the stated default.
Batch means prompt variations. The pinned command does not take a JSON manifest, and it is not evidence that requests use Google's separately priced Batch API. Confirm cost and execution behavior before a multi-image run.

Representative example

This is syntax documentation, not a runnable example or a claim about a resulting file:

/seo image-gen og "Editorial illustration of a technical site audit becoming a prioritized action plan, dark matte palette, no text"

The intended output shape is an image and a reported file path. The pinned extension documentation names ~/Documents/nanobanana_generated/ as its expected directory, but no current output exists because neither documented generation route was run.

Installation and permissions

The Image Gen extension is optional. Inspect the pinned installer, but do not run this path unchanged:

./extensions/banana/install.sh

The reviewed script checks for Claude SEO, Node, and npx, copies the installable skill, agent, and Python utilities, and configures @ycse/nanobanana-mcp@1.1.1. That MCP package only maps to retired preview IDs. The script can also store GOOGLE_AI_API_KEY in the local Claude Code MCP configuration. Do not expose a key while repairing or testing either route.

Network, cost, and provider boundary

LayerWhat is verified
Claude SEODefines the six command forms, use-case defaults, prompt workflow, and post-generation checklist.
MCP adapterThe pinned package maps only to two Gemini preview IDs that Google shut down on June 25, 2026. This route is unavailable until updated and tested.
Google Gemini APIReceives the generation request over the network. Provider pricing, usage limits, safety handling, and model availability apply.
Local filesThe installer changes the local Claude Code skill, scripts, and MCP configuration. A successful MCP or direct API request writes the returned image to disk.

On 2026-08-27, Google listed gemini-3.1-flash-image as a stable image model and listed no free API tier for that model. Standard output equivalents were USD 0.045 for 0.5K, 0.067 for 1K, 0.101 for 2K, and 0.151 for 4K, before applicable input, thinking, or grounding charges. These values are dated facts, not permanent guarantees. Check Google's current pricing and your active project limits before a paid or multi-image run.

// OUTPUTS AND LIMITS

What does the command return, and what still needs review?

Documented outputs after a route is verified

  • A generated image and reported file path from a working, controlled test of the selected route.
  • The crafted prompt and settings so the request can be reviewed or repeated.
  • A post-generation checklist covering alt text, file naming, WebP conversion, dimensions, and optional markup.

The command does not publish the asset or establish that it is correct. A human still needs to inspect the visual, verify any depicted facts, create exact web exports, decide appropriate alternative text, and update visible page content and metadata.

Important limitations

  • The reviewed installer pins @ycse/nanobanana-mcp@1.1.1. Its two allowed preview models are shut down, so the installed MCP route is unavailable as documented.
  • The v2.2.5 source contract is internally inconsistent. The root skills/seo-image-gen/SKILL.md says Claude SEO does not vendor a local generation fallback. The installable extensions/banana/skills/seo-image-gen/SKILL.md instead routes MCP failures to the bundled direct API utility, and the installer copies that skill and its scripts. The fallback is source-verified but execution-unverified because it was not installed or live-tested here.
  • Generated text, counts, object placement, product details, and factual diagrams can be wrong. Verify every important element against source material.
  • A generated 16:9 image is not an exact 1200 by 630 Open Graph file. Crop and export the approved master separately.
  • Rate limits depend on the Google project tier and account state. Google's documentation says the published limits are not guaranteed.
  • Google states that Gemini-generated images include SynthID. The presence of provenance technology does not replace a rights review.
  • Referencing an image in structured data requires separate visible-content parity and schema validation. Generation alone does not complete that work.
Confirmed model drift: Google's deprecation table lists gemini-3.1-flash-image-preview and gemini-3-pro-image-preview as shut down on June 25, 2026, with stable replacements. The pinned adapter rejects other model IDs, so this is an integration failure, not a generic future risk.

Verified sources

Tool behavior was checked against the Claude SEO v2.2.5 source snapshot. Provider claims were checked against Google-owned documentation on 2026-08-27.

Claude SEO source snapshot: root command source, installable extension skill, direct Python utility, installer, extension README, and MCP reference at reviewed commit 2384fdd9. The two skill files conflict about fallback status, so the page separates source verification from live execution. View the reviewed source.
Current model behavior: model choices, generation and editing, resolution support, safety reminders, and SynthID. Read Google's image generation guide.
Pinned adapter package: npm package 1.1.1 documents only the retired Flash and Pro preview model mappings. Inspect the published package record.
Google model lifecycle: both adapter preview IDs show a June 25, 2026 shutdown and stable replacements. Read Google's deprecation table.
Current model record: stable model code and capability flags. Read the Gemini 3.1 Flash Image model page.
Current operations: dated prices, account-tier limits, and model changes. Pricing, rate limits, and release notes.
// FAQ

What are frequently asked questions about image generation?

Claude SEO documents six forms: og, hero, product, infographic, custom, and batch. Each begins with /seo image-gen. They describe the reviewed command surface, but the reviewed MCP adapter is currently unavailable.
// RELATED SKILLS

EXPLORE MORE

VIEW ALL SKILLS →

PLAN THE ASSET.
VERIFY THE ROUTE BEFORE GENERATION.

!
/seo image-gen og "<description>"
REFERENCE SYNTAX
VIEW REVIEWED EXTENSION ALL SKILLS >