# Geo Visual Opportunity Engine

> 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.

- Skill: `dvcrn/geo-visual-opportunity-engine` (Agent Skill, multi-file: 18 files)
- Install (CLI): `npx skillmds@latest add dvcrn/geo-visual-opportunity-engine`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/geo-visual-opportunity-engine/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Marketing & Growth
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/geo-visual-opportunity-engine

---


# 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

```text
Generate AI product visuals and commerce copy for this product opportunity
```

```text
Run GEO analysis for this product and keyword before generating assets
```

```text
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

```bash
pip install -r requirements.txt
```

## Quick Start

### Basic Usage

```python
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

```python
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

```python
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)