Metadata-Version: 2.4
Name: creative-tagger
Version: 0.1.0
Summary: Python SDK for Creative Tagger — structured creative intelligence API
Author: Stephen Lavender
License: MIT
Keywords: ads,creative,creative-intelligence,marketing,naming-conventions,taxonomy
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: httpx>=0.28.0
Description-Content-Type: text/markdown

# Creative Tagger Python SDK

Python client for [Creative Tagger](https://github.com/stephenlavender/creative-tagger) — structured creative intelligence API for performance marketing.

Analyze any ad creative (video, image, carousel, landing page, email) and get back structured classification across 28 taxonomy dimensions.

## Install

```bash
pip install creative-tagger
```

## Quick Start

```python
from creative_tagger import CreativeTagger

ct = CreativeTagger(api_key="ct_...")

# Analyze a video ad
result = ct.analyze("./ad_video.mp4", brand="Brand")
print(result.naming.default)
# → BRAND_UGC_Creator_LoFi_VOMus-Pop-Conv_ShopNow_9x16_30s_V1

print(result.visual.hook_type)    # → UGC
print(result.messaging_angle)     # → ProbSol
print(result.creative_type)       # → Testimonial
print(result.production_type)     # → LoFiUGC
print(result.offer_type)          # → PctOff

# Analyze a landing page
result = ct.analyze_url("https://example.com/lp", brand="BrandX")
print(result.visual_hierarchy)    # → HeroFocus

# Analyze email HTML
result = ct.analyze_email(html_string, brand="BrandX")
print(result.email_structure)     # → SingleCTA
```

## Batch Analysis

```python
results = ct.analyze_batch(["ad1.mp4", "ad2.jpg", "ad3.png"], brand="Brand")

# Export to CSV-ready rows
import csv
rows = [r.to_row() for r in results]
```

## Async Support

```python
result = await ct.analyze_async("./ad.mp4", brand="Brand")
```

## Local Development

Point to a local Creative Tagger API:

```python
ct = CreativeTagger(base_url="http://localhost:8000")
```

## License

MIT
