Geo Visual Opportunity Engine 1 5

# GEO Visual Opportunity Engine

## Overview

GEO Visual Opportunity Engine is an AI-powered e-commerce automation tool that generates product images using Nano Banana 2 (Google Gemini) and automatically publishes products to Shopify and WooCommerce.

## 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**: Publish to Shopify and WooCommerce simultaneously
- **Three Image Styles**: White info, lifestyle, and hero images for each product
- **GEO Opportunity Analysis**: Identifies high-priority visual content opportunities

## Installation

### One-Click Installation (Recommended)

```bash
# Download and install automatically
curl -sL https://clawhub.ai/GEO-SEO/geo-visual-opportunity-engine/archive/refs/heads/main.tar.gz | tar xz && cd geo-visual-opportunity-engine-* && pip install -r requirements.txt
```

Or use wget:

```bash
wget -qO- https://clawhub.ai/GEO-SEO/geo-visual-opportunity-engine/archive/refs/heads/main.tar.gz | tar xz && cd geo-visual-opportunity-engine-* && pip install -r requirements.txt
```

### Manual Installation

```bash
# Clone the repository
git clone https://clawhub.ai/GEO-SEO/geo-visual-opportunity-engine.git
cd geo-visual-opportunity-engine

# Install dependencies
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 Ecom...

# GeoCommerce Automator

[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
[![Version](https://img.shields.io/badge/Version-1.0.5-blue.svg)](https://clawhub.ai/GEO-SEO/geo-visual-opportunity-engine)
[![Platform](https://img.shields.io/badge/Platform-Dify%20%7C%20Coze%20%7C%20Python-orange.svg)](#)
[![Shopify](https://img.shields.io/badge/Shopify-API%20Integration-purple.svg)](#)
[![WooCommerce](https://img.shields.io/badge/WooCommerce-API%20Integration-purple.svg)](#)

> E-commerce automation tool that integrates Nano Banana 2 AI image generation with Shopify and WooCommerce. Automatically generates product data, creates product images, and publishes to e-commerce platforms.

## Features

### Core Features
- **Product Data Synthesis**: Auto-generate product titles, descriptions, SKU, prices, inventory
- **AI Image Generation**: Automatically calls Nano Banana 2 (Google Gemini 3.1 Flash) to generate product images
- **Multi-Platform Support**: Publish to Shopify and WooCommerce simultaneously
- **Three Image Styles**: White info, lifestyle, and hero images for each product

### E-commerce Integrations
- **Shopify Admin API**: Create products, upload images, set price/inventory/SKU
- **WooCommerce REST API**: Auto-publish products with full metadata
- **Product Data Generator**: Auto-generate titles, descriptions, SEO keywords, categories, tags

### GEO Features (v1.0)
- **Smart Opportunity Analysis**: Identifies high-priority GEO opportunities
- **Three Image Prompts**: Generates white info, lifestyle, and hero image prompts
- **Localized Content**: Supports 10+ languages for content generation
- **4-Week Publishing Rhythm**: Provides complete content publishing plan

## Input Parameters

**One unified workflow**: Input once → Opportunity Analysis → Content Generation (text + images) → Auto-publish to e-commerce platforms.

```json
{
  "brand": "AcmeWatch",
  "product": "Acme DivePro 5",
  "core_keyword": "smar...