meta-ads-analyser

分析提取的元广告创意并生成专业的策略报告。在 /meta_ads_extractor 之后使用可生成干净、有组织的分析文档，其中包含按漏斗/着陆页分组的内嵌视频/图像。

# Meta Ads Analyser

Generate a professional ad strategy analysis report from extracted Meta ad creatives.

## Prerequisites

- Extracted ad assets from `/meta_ads_extractor` (images, videos, landing page screenshots)
- Ad creative analysis (hooks, scripts, emotions, CTAs, strengths/weaknesses)
- Landing page analysis (headlines, strategies, conversion flows)

## Input

Assets folder from extraction, typically at:
```
~/clawd/output/meta-ads/{advertiser-slug}/
├── {slug}-video-01.mp4
├── {slug}-video-02.mp4
├── {slug}-image-01.jpg
├── {slug}-image-02.jpg
├── landing-{page-name}.jpg
└── ...
```

## Analysis Process

### 1. Analyze Each Creative

For each ad creative, identify:
- **Aspect Ratio** — Dimensions and ratio (1:1, 4:5, 9:16, 16:9)
- **Duration** — For videos, length in seconds
- **Hook** — Opening line/visual that stops the scroll
- **Script/Copy** — Key messaging and value proposition
- **Visual Flow** — Sequence of scenes/elements (for video)
- **Emotion** — Primary emotional trigger (curiosity, fear, aspiration, etc.)
- **CTA** — Call to action and friction level
- **Strengths** — What works well
- **Weaknesses/Gaps** — What could be improved

Use vision model for images, Gemini for video analysis.

**Get dimensions with:**
```bash
# Images (macOS)
sips -g pixelWidth -g pixelHeight image.jpg

# Videos
ffprobe -v error -select_streams v:0 -show_entries stream=width,height -of csv=p=0 video.mp4
```

**Common aspect ratios:**
| Ratio | Use Case |
|-------|----------|
| 1:1 | Feed (universal) |
| 4:5 | Feed (recommended) |
| 9:16 | Stories/Reels |
| 16:9 | Landscape video |

### 2. Analyze Landing Pages

For each landing page, identify:
- **Headline** — Primary value proposition
- **Strategy** — Key conversion elements (social proof, urgency, etc.)
- **Conversion Flow** — Path from landing to purchase/signup
- **Strengths** — What converts well
- **Gaps** — Missing elements or friction points

### 3. Map Funnels

Group ads by their destination landing page. Each funnel = landing page + all ads driving to it.

Typical funnel types:
- **TOFU (Top of Funnel)** — Awareness, lead magnets, quizzes, free content
- **BOFU (Bottom of Funnel)** — Direct offer, application, purchase

### 4. Identify Strategy Patterns

Look for:
- Credibility stacking (logos, credentials, social proof)
- Price anchoring
- Native creative (ads that don't look like ads)
- Identity-driven copy
- Testing patterns (variants of same creative)

## Output Format

Generate a self-contained HTML report using the template structure below.

### Report Structure

```
1. Header
   - Advertiser name
   - Stats (# ads, # funnels, date)

2. Strategy Overview (TOP)
   - High-level acquisition strategy
   - Funnel flow visualization
   - Creative testing patterns
   - Key takeaways (actionable insights)

3. Funnel Sections (one per landing page)
   - Funnel header (name, URL)
   - Landing page card (screenshot + analysis)
   - Ad cards grid (media + analysis for each)
   
4. Footer
   - Source attribution
   - Date generated
```

### Styling Guidelines

- **Clean, doc-like design** — white background, simple typography
- **No dark gradients or heavy styling** — should feel like a PDF/Notion doc
- **Inline media** — videos and images embedded and playable
- **Mobile-friendly** — responsive grid for ad cards
- **Badges for quick scanning** — TOFU/BOFU, Video/Image, Variant, Top performer, Aspect ratio (1:1, 4:5, 9:16)

### Ad Card Format

Each ad card should display:
```
[Media: video/image]
[Badges: Type | Funnel Stage | Aspect Ratio | Duration (if video)]
[Title]
[Analysis fields: Hook, Script, Emotion, Strengths, Gaps]
```

**Include aspect ratio badge** on every ad card so patterns are visible at a glance (e.g., "all TOFU ads are 4:5, BOFU ads are 1:1").

See `templates/report-template.html` for the full HTML/CSS template.

## Delivery

1. Generate HTML file in the assets folder:
   ```
   ~/clawd/output/meta-ads/{advertiser-slug}/{slug}-analysis.html
   ```

2. Zip the entire folder (HTML + all media assets)

3. Send via Telegram with caption explaining contents

**Important:** The HTML uses relative paths to media files. Always deliver as a zip so the recipient can open it locally with all assets.

## Example Workflow

```
User: Analyze the EricPartaker ads we extracted

1. Read assets folder: ~/clawd/output/meta-ads/ericpartaker/
2. Analyze each video with Gemini / image with vision
3. Analyze landing page screenshots
4. Map ads to landing pages (identify 3 funnels)
5. Identify strategy patterns
6. Generate HTML report
7. Zip folder
8. Send to user
```

## Integration

This skill is designed to follow `/meta_ads_extractor`:

```
/meta_ads_extractor → downloads assets
/meta_ads_analyser → generates strategy report
```

Can also integrate with:
- **ad-creative-analysis** — detailed individual ad breakdowns
- **landing-page-analysis** — deeper landing page audits

---

## 中文说明

# Meta Ads Analyser

从提取出的 Meta 广告创意生成一份专业的广告策略分析报告。

## 前置条件

- 来自 `/meta_ads_extractor` 提取的广告素材（图片、视频、着陆页截图）
- 广告创意分析（钩子、脚本、情绪、CTA、优势/劣势）
- 着陆页分析（标题、策略、转化流程）

## 输入

来自提取的素材文件夹，通常位于：
```
~/clawd/output/meta-ads/{advertiser-slug}/
├── {slug}-video-01.mp4
├── {slug}-video-02.mp4
├── {slug}-image-01.jpg
├── {slug}-image-02.jpg
├── landing-{page-name}.jpg
└── ...
```

## 分析流程

### 1. 分析每条创意

对每条广告创意，识别：
- **Aspect Ratio** — 尺寸与比例（1:1、4:5、9:16、16:9）
- **Duration** — 对于视频，时长（秒）
- **Hook** — 能让人停止滑动的开场白/画面
- **Script/Copy** — 关键信息与价值主张
- **Visual Flow** — 场景/元素序列（针对视频）
- **Emotion** — 主要情绪触发点（好奇、恐惧、向往等）
- **CTA** — 行动号召及其阻力程度
- **Strengths** — 做得好的地方
- **Weaknesses/Gaps** — 可改进之处

图片使用视觉模型分析，视频使用 Gemini 分析。

**获取尺寸：**
```bash
# Images (macOS)
sips -g pixelWidth -g pixelHeight image.jpg

# Videos
ffprobe -v error -select_streams v:0 -show_entries stream=width,height -of csv=p=0 video.mp4
```

**常见宽高比：**
| Ratio | Use Case |
|-------|----------|
| 1:1 | Feed (universal) |
| 4:5 | Feed (recommended) |
| 9:16 | Stories/Reels |
| 16:9 | Landscape video |

### 2. 分析着陆页

对每个着陆页，识别：
- **Headline** — 主要价值主张
- **Strategy** — 关键转化要素（社会证明、紧迫感等）
- **Conversion Flow** — 从落地到购买/注册的路径
- **Strengths** — 转化效果好的地方
- **Gaps** — 缺失的要素或阻力点

### 3. 映射漏斗

按广告所指向的着陆页对广告进行分组。每个漏斗 = 着陆页 + 所有导向它的广告。

典型漏斗类型：
- **TOFU（漏斗顶部）** — 认知、引流磁铁、测验、免费内容
- **BOFU（漏斗底部）** — 直接报价、申请、购买

### 4. 识别策略模式

寻找：
- 信誉叠加（logo、资质、社会证明）
- 价格锚定
- 原生创意（不像广告的广告）
- 身份驱动型文案
- 测试模式（同一创意的不同变体）

## 输出格式

使用下面的模板结构生成一份自包含的 HTML 报告。

### 报告结构

```
1. Header
   - Advertiser name
   - Stats (# ads, # funnels, date)

2. Strategy Overview (TOP)
   - High-level acquisition strategy
   - Funnel flow visualization
   - Creative testing patterns
   - Key takeaways (actionable insights)

3. Funnel Sections (one per landing page)
   - Funnel header (name, URL)
   - Landing page card (screenshot + analysis)
   - Ad cards grid (media + analysis for each)
   
4. Footer
   - Source attribution
   - Date generated
```

### 样式指南

- **简洁、文档风格的设计** — 白色背景、简单的排版
- **不使用深色渐变或厚重样式** — 应像 PDF/Notion 文档
- **内嵌媒体** — 视频和图片嵌入且可播放
- **移动端友好** — 广告卡片采用响应式网格
- **便于快速浏览的徽章** — TOFU/BOFU、Video/Image、Variant、Top performer、宽高比（1:1、4:5、9:16）

### 广告卡片格式

每张广告卡片应展示：
```
[Media: video/image]
[Badges: Type | Funnel Stage | Aspect Ratio | Duration (if video)]
[Title]
[Analysis fields: Hook, Script, Emotion, Strengths, Gaps]
```

**在每张广告卡片上都包含宽高比徽章**，以便一眼看出规律（例如"所有 TOFU 广告都是 4:5，BOFU 广告都是 1:1"）。

完整的 HTML/CSS 模板见 `templates/report-template.html`。

## 交付

1. 在素材文件夹中生成 HTML 文件：
   ```
   ~/clawd/output/meta-ads/{advertiser-slug}/{slug}-analysis.html
   ```

2. 将整个文件夹打包为 zip（HTML + 所有媒体素材）

3. 通过 Telegram 发送，并在说明文字中解释内容

**重要：** 该 HTML 使用相对路径引用媒体文件。始终以 zip 形式交付，以便接收方可在本地打开并加载所有素材。

## 示例工作流

```
User: Analyze the EricPartaker ads we extracted

1. Read assets folder: ~/clawd/output/meta-ads/ericpartaker/
2. Analyze each video with Gemini / image with vision
3. Analyze landing page screenshots
4. Map ads to landing pages (identify 3 funnels)
5. Identify strategy patterns
6. Generate HTML report
7. Zip folder
8. Send to u