# Youtube Outliers

> Find viral YouTube videos in your niche for competitive intelligence. Use when user asks to find YouTube outliers, monitor competitors, or track viral videos.

- Skill: `aiagentwithdhruv/youtube-outliers` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add aiagentwithdhruv/youtube-outliers`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aiagentwithdhruv/youtube-outliers/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: aiagentwithdhruv (https://skillmd.com/u/aiagentwithdhruv)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/aiagentwithdhruv/youtube-outliers

---


# YouTube Outlier Detection

## Goal
Find high-performing videos in your niche for competitive intelligence and content inspiration.

## Scripts
- `./scripts/scrape_youtube_outliers.py` - Scrape and score outliers
- `./scripts/update_transcripts.py` - Fetch transcripts for existing outliers

## Usage

```bash
# Default run
python3 ./scripts/scrape_youtube_outliers.py

# Custom parameters
python3 ./scripts/scrape_youtube_outliers.py \
  --keywords "AI automation,AI agents" \
  --days 30 \
  --min_score 1.5 \
  --limit 50
```

## How It Works
1. Searches YouTube for keywords
2. Calculates outlier score (views / channel average)
3. Applies recency boost
4. Fetches transcripts
5. Generates Claude summaries
6. Saves to Google Sheet

## Output
Google Sheet with:
- Outlier Score, Views, Duration
- Title, Video Link, Channel
- Thumbnail, Summary, Transcript
- Publish Date

## vs Cross-Niche Outliers
- **youtube_outliers**: Your core niche (daily monitoring)
- **cross-niche-outliers**: Adjacent niches (weekly inspiration)

## Environment
```
APIFY_API_TOKEN=your_token
ANTHROPIC_API_KEY=your_key
```

---

## Schema

### Inputs
| Name | Type | Required | Description |
|------|------|----------|-------------|
| `keywords` | string | No | Comma-separated keywords (default: niche keywords) |
| `days` | integer | No | Lookback period in days (default: 30) |
| `min_score` | float | No | Minimum outlier score (default: 1.5) |
| `limit` | integer | No | Max results (default: 50) |

### Outputs
| Name | Type | Description |
|------|------|-------------|
| `sheet_url` | string | Google Sheet with outlier videos |

### Credentials
| Name | Source |
|------|--------|
| `APIFY_API_TOKEN` | .env |
| `ANTHROPIC_API_KEY` | .env |

### Composable With
Skills that chain well with this one: `title-variants`, `recreate-thumbnails`, `cross-niche-outliers`

### Cost
Apify credits + Claude API