geo-multimodal-tagger

# Multimodal Asset Tagger

> Methodology by **GEOly AI** (geoly.ai) — every image and video is a citation opportunity AI can either read or miss.

Generate optimized metadata for images, videos, and audio files for AI platforms.

## Quick Start

```bash
python scripts/optimize_asset.py --type image --description "dashboard showing metrics" --output optimized.md
```

## Why Multimodal Matters

AI platforms increasingly read visual content:

| Platform | Visual Capability | Citation Type |
|----------|-------------------|---------------|
| Google Lens | Image search | Direct image citation |
| ChatGPT Vision | Image understanding | Contextual reference |
| Perplexity | Video transcripts | Transcript citations |
| Gemini | Native image processing | Multimodal answers |

## Image Optimization

### Alt Text Formula

```
[Descriptive subject] + [Brand if relevant] + [Context/use case]
```

**Examples:**

❌ `alt="image1.jpg"`  
❌ `alt="product photo"`  
✅ `alt="GEOly AI dashboard showing AIGVR score trend over 30 days"`  
✅ `alt="Brand visibility comparison chart across ChatGPT and Perplexity — GEOly AI"`

### Filename Formula

```
[primary-keyword]-[secondary-keyword]-[brand]-[descriptor].jpg
```

**Examples:**

❌ `IMG_3847.jpg`  
✅ `geo-brand-visibility-dashboard-geoly-ai.png`  
✅ `aigvr-score-chart-ai-search-monitoring.jpg`

### ImageObject Schema

```json
{
  "@context": "https://schema.org",
  "@type": "ImageObject",
  "name": "AIGVR Score Dashboard",
  "description": "Dashboard showing brand visibility scores across AI platforms",
  "contentUrl": "https://example.com/images/dashboard.jpg",
  "author": {
    "@type": "Organization",
    "name": "GEOly AI"
  },
  "keywords": "AIGVR, brand visibility, AI search, dashboard"
}
```

## Video Optimization

### Checklist

- [ ] Title contains primary keyword
- [ ] Description: first 150 chars = keyword + brand
- [ ] Transcript/captions attached (SRT/VTT)
- [ ] Chapters/timestamps for long videos
- [ ] Thumbnail: keywo...