GEO Visual Opportunity Engine

Use this skill to turn a product and keyword opportunity into AI-generated visuals, structured product data, localized commerce copy, and export-ready commerce assets.

Overview

This skill connects GEO opportunity analysis, image generation, product-data synthesis, localization, and commerce asset preparation in one workflow.

Best For

• DTC and Shopify teams producing AI-generated product assets at scale
• commerce operators testing product narratives for search and AI-native discovery
• agencies managing cross-market visual content and listing workflows
• teams that want product analysis, visuals, and export-ready assets in one workflow

Start With

Generate AI product visuals and commerce copy for this product opportunity

Run GEO analysis for this product and keyword before generating assets

Create export-ready Shopify or WooCommerce assets for this product

Core Workflow

GEO Visual Opportunity Engine is an AI-powered commerce workflow that can generate product images using Nano Banana 2 (Google Gemini) and prepare platform-ready assets for Shopify or WooCommerce.

External Access And Minimum Credentials

This workflow uses external services. Required credentials depend on the actions you enable:

• GOOGLE_API_KEY: required for Nano Banana 2 / Gemini image generation
• SHOPIFY_STORE_URL and SHOPIFY_ACCESS_TOKEN: optional only when exporting directly to Shopify
• WOOCOMMERCE_STORE_URL, WOOCOMMERCE_CONSUMER_KEY, and WOOCOMMERCE_CONSUMER_SECRET: optional only when exporting directly to WooCommerce
• python3: required to run the packaged automation code

If store credentials are absent:

• the skill can stop at opportunity analysis, product data synthesis, image generation, and export packaging
• do not claim live publishing or platform write access unless the matching credentials are present and the user explicitly requests direct export

Access Policy

Safe default: this skill should stop at analysis, asset generation, product-data output, and export packaging unless direct platform export is explicitly enabled.

• image generation can run independently of commerce publishing
• direct Shopify export is optional and must be explicitly enabled
• direct WooCommerce export is optional and must be explicitly enabled
• do not claim store write access or completed publication unless the matching credentials are present and direct export is turned on

Features

• Product Data Synthesis: Auto-generate product titles, descriptions, SKU, prices, inventory
• AI Image Generation: Automatically calls Nano Banana 2 to generate product images
• Multi-Platform Support: Prepare assets for Shopify and WooCommerce
• Three Image Styles: White info, lifestyle, and hero images for each product
• GEO Opportunity Analysis: Identifies high-priority visual content opportunities

Installation

pip install -r requirements.txt

Quick Start

Basic Usage

from src.main import EcommerceAutomator

# Initialize with API key
automator = EcommerceAutomator(google_api_key="your-google-api-key")

# Run complete workflow - one input to finish everything
result = automator.run_complete_workflow(
    product_input="wireless bluetooth headphones",
    country="us",
    language="en",
    generate_images=True,
    publish_to_shopify=False,
    publish_to_woocommerce=False
)

print(result['product_data']['title'])
print(result['status'])

GEO Analysis Only

from src.main import EcommerceAutomator

automator = EcommerceAutomator()

# Run GEO opportunity analysis
result = automator.run_geo_analysis(
    brand="AcmeWatch",
    product="Acme DivePro 5",
    core_keyword="smartwatch water resistance",
    country="us",
    language="en",
    generate_images=True
)

print(f"Found {len(result['opportunities'])} opportunities")

Create Product Package

from src.main import EcommerceAutomator

automator = EcommerceAutomator(
    google_api_key="your-google-api-key",
    shopify_store_url="your-store.myshopify.com",
    shopify_access_token="your-access-token"
)

# Create a product package and optionally export it
result = automator.create_product(
    product_name="Wireless Bluetooth Headphones Pro",
    category="Electronics",
    base_price=79.99,
    generate_images=True,
    image_style="white_info",
    publish_to_shopify=False,
    publish_to_woocommerce=False
)

API Reference

EcommerceAutomator

Main class for e-commerce automation.

__init__(google_api_key, shopify_store_url, shopify_access_token, woo_store_url, woo_consumer_key, woo_consumer_secret)

Initialize the automator with API credentials.

run_complete_workflow(product_input, country='us', language='en', generate_images=True, publish_to_shopify=False, publish_to_woocommerce=False, output_dir='output')

Unified workflow - One input completes the entire process:

1. Analyze GEO opportunities
2. Synthesize product data (title, description, SKU, price)
3. Generate AI images
4. Export platform-ready assets or use direct export when explicitly enabled

run_geo_analysis(brand, product, core_keyword, country, language, competitors, platform_focus, generate_images)

Run GEO opportunity analysis with image generation.

create_product(product_name, category, base_price, description, language, target_platforms, generate_images, image_style, publish_to_shopify, publish_to_woocommerce)

Complete e-commerce product creation workflow.

Configuration

Environment Variables

• GOOGLE_API_KEY - Google API Key for Nano Banana 2 image generation
• SHOPIFY_STORE_URL - Shopify store URL
• SHOPIFY_ACCESS_TOKEN - Shopify Admin API access token
• WOOCOMMERCE_STORE_URL - WooCommerce store URL
• WOOCOMMERCE_CONSUMER_KEY - WooCommerce API consumer key
• WOOCOMMERCE_CONSUMER_SECRET - WooCommerce API consumer secret

Image Styles

• white_info: Clean white background, product-focused infographic
• lifestyle: Real-world场景 with human interaction, photorealistic
• hero: Dramatic hero shot with commercial photography quality

Version

3.0.0

Author

Tim ([email protected])