🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

GEO Visual Content Engine

by @geo-seo

Use when the user wants to turn a product and keyword opportunity into AI-generated visuals, structured product data, localized commerce copy, or export-read...

Versionv3.0.5
Downloads1,087
TERMINAL
clawhub install geo-visual-opportunity-engine

πŸ“– About This Skill


name: geo-visual-opportunity-engine description: Use when the user wants to turn a product and keyword opportunity into AI-generated visuals, structured product data, localized commerce copy, or export-ready commerce assets. Trigger for product image generation, product listing preparation, GEO-aware commerce content, and AI-native visual content workflows. metadata: author: GEO-SEO version: "3.0.5" homepage: https://github.com/GEO-SEO/geo-visual-opportunity-engine primaryEnv: GOOGLE_API_KEY requires: env: - GOOGLE_API_KEY - SHOPIFY_STORE_URL - SHOPIFY_ACCESS_TOKEN - WOOCOMMERCE_STORE_URL - WOOCOMMERCE_CONSUMER_KEY - WOOCOMMERCE_CONSUMER_SECRET bins: - python3

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 (sales@dageno.ai)

    πŸ’‘ Examples

    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 )

    βš™οΈ 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