> ## Documentation Index
> Fetch the complete documentation index at: https://docs.praison.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Performance Analyzer

> Analyze content performance metrics from platform exports

# AI Performance Analyzer

Analyze content performance metrics and generate AI-powered insights and recommendations.

```mermaid theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
flowchart LR
    A[Metrics JSON] --> B[AI Performance Analyzer]
    B --> C[Analysis]
    C --> D[Insights & Recommendations]
    
    style A fill:#e1f5fe
    style D fill:#c8e6c9
```

## CLI Quickstart

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai recipe run ai-performance-analyzer \
  --input '{"metrics": {"views": 1000, "likes": 50, "comments": 10}, "platform": "youtube"}' \
  --json
```

## Use in Your App (SDK)

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import sys
sys.path.insert(0, 'agent_recipes/templates/ai-performance-analyzer')
from tools import analyze_metrics, generate_insights, compare_performance

# Analyze metrics
analysis = analyze_metrics(
    metrics={"views": 1000, "likes": 50, "comments": 10, "shares": 5},
    platform="youtube"
)

# Generate AI insights
insights = generate_insights(metrics)

# Compare periods
comparison = compare_performance(
    current={"views": 1000, "likes": 50},
    previous={"views": 800, "likes": 40}
)
```

## Input Schema

```json theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
{
  "type": "object",
  "properties": {
    "metrics": {
      "type": "object",
      "properties": {
        "views": {"type": "integer"},
        "likes": {"type": "integer"},
        "comments": {"type": "integer"},
        "shares": {"type": "integer"},
        "watch_time": {"type": "number"},
        "ctr": {"type": "number"}
      }
    },
    "platform": {"type": "string"}
  }
}
```

## Output Schema

```json theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
{
  "analysis": {
    "engagement_rate": 6.0,
    "performance_tier": "good"
  },
  "insights": "Your content is performing well...",
  "recommendations": ["Increase posting frequency", "Test different hooks"]
}
```

## Performance Tiers

| Tier               | Engagement Rate |
| ------------------ | --------------- |
| exceptional        | ≥10%            |
| excellent          | ≥5%             |
| good               | ≥2%             |
| average            | ≥1%             |
| needs\_improvement | less than 1%    |

## Environment Variables

| Variable         | Required | Description     |
| ---------------- | -------- | --------------- |
| OPENAI\_API\_KEY | Yes      | For AI insights |

## Related Tools

* [AI Comment Miner](/docs/examples/agent-recipes/creator-suite/ai-comment-miner)
* [AI A/B Hook Tester](/docs/examples/agent-recipes/creator-suite/ai-ab-hook-tester)