Video Content Analyzer
Analyze short-form videos with Gemini AI to extract hooks, content structure, delivery style, and CTA strategies.
Prerequisites
GEMINI_API_KEY environment variable
google-genai and requests Python packages
Usage
python3 .claude/skills/video-content-analyzer/scripts/analyze_videos.py \
--input outliers.json \
--output video-analysis.json \
--platform instagram \
--max-videos 5
Parameters
| Arg |
Description |
--input, -i |
Input JSON file with outlier posts (required) |
--output, -o |
Output JSON file for results (required) |
--platform, -p |
Platform: instagram, tiktok, or youtube (default: instagram) |
--max-videos, -n |
Max videos to analyze (default: 5) |
Input Format
Accepts outlier JSON from platform-specific research skills. Handles both formats:
- Direct list:
[{post1}, {post2}, ...]
- Wrapped:
{"outliers": [{post1}, {post2}, ...]}
The script automatically maps platform-specific fields:
| Platform |
Video URL Fields |
Caption |
Username |
| Instagram |
videoUrl |
caption |
ownerUsername |
| TikTok |
videoUrl, video_url, webVideoUrl |
text, desc |
authorUsername |
| YouTube |
videoUrl, url |
title |
channelTitle |
TikTok Note: The Apify TikTok Scraper returns webVideoUrl (the TikTok page URL) rather than a direct video download URL. Gemini will attempt to analyze from this page URL.
Output
Returns JSON array with analysis for each video:
[
{
"post_id": "ABC123",
"username": "creator",
"url": "https://...",
"platform": "instagram",
"likes": 50000,
"comments": 1200,
"views": 500000,
"analysis": {
"hook": {
"technique": "pattern-interrupt",
"opening_line": "Stop scrolling if you...",
"attention_grab": "Creates urgency and targets specific audience",
"replicable_formula": "Stop scrolling if you [pain point]"
},
"content_structure": {
"format": "problem-solution",
"sections": [...],
"pacing": "fast",
"retention_techniques": ["pattern interrupts", "text overlays"]
},
"delivery_style": {
"speaking": "direct-to-camera",
"energy": "high-energy",
"text_overlays": true,
"visual_style": "quick cuts with b-roll"
},
"cta_strategy": {
"type": "follow",
"cta_text": "Follow for more tips",
"placement": "end"
},
"why_it_works": "..."
}
}
]
Hook Techniques
The analyzer identifies these hook types:
pattern-interrupt - Breaks expected patterns
question - Opens with engaging question
bold-claim - Makes surprising statement
story-tease - Hints at compelling narrative
visual-shock - Striking visual opening
curiosity-gap - Creates information gap
direct-address - Speaks to specific audience
controversial-take - Polarizing opinion
relatable-pain - Targets common struggle
transformation-preview - Shows before/after
Content Formats
problem-solution - Present problem, offer fix
listicle - Numbered tips/items
story - Narrative arc
tutorial - Step-by-step how-to
before-after - Transformation reveal
day-in-life - Lifestyle content
reaction - Response to other content
hot-take - Opinion piece
tool-demo - Product/tool showcase
1---2name: video-content-analyzer3description: |4 Analyze short-form videos with Gemini AI to extract hooks, content structure, and replicable patterns.5 Supports Instagram Reels, TikTok, and YouTube Shorts.67 Use when asked to:8 - Analyze video content for hooks and structure9 - Extract replicable formulas from viral videos10 - Understand why a video performed well11 - Get AI analysis of video content patterns1213 Triggers: "analyze videos", "extract hooks", "video analysis", "analyze reels",14 "what makes this video work", "hook analysis", "content structure analysis"15metadata:16 source: https://skillmd.com/skills/bradautomates/video-content-analyzer17---1819# Video Content Analyzer2021Analyze short-form videos with Gemini AI to extract hooks, content structure, delivery style, and CTA strategies.2223## Prerequisites2425- `GEMINI_API_KEY` environment variable26- `google-genai` and `requests` Python packages2728## Usage2930```bash31python3 .claude/skills/video-content-analyzer/scripts/analyze_videos.py \32 --input outliers.json \33 --output video-analysis.json \34 --platform instagram \35 --max-videos 536```3738### Parameters3940| Arg | Description |41|-----|-------------|42| `--input`, `-i` | Input JSON file with outlier posts (required) |43| `--output`, `-o` | Output JSON file for results (required) |44| `--platform`, `-p` | Platform: `instagram`, `tiktok`, or `youtube` (default: instagram) |45| `--max-videos`, `-n` | Max videos to analyze (default: 5) |4647## Input Format4849Accepts outlier JSON from platform-specific research skills. Handles both formats:50- Direct list: `[{post1}, {post2}, ...]`51- Wrapped: `{"outliers": [{post1}, {post2}, ...]}`5253The script automatically maps platform-specific fields:5455| Platform | Video URL Fields | Caption | Username |56|----------|-----------------|---------|----------|57| Instagram | `videoUrl` | `caption` | `ownerUsername` |58| TikTok | `videoUrl`, `video_url`, `webVideoUrl` | `text`, `desc` | `authorUsername` |59| YouTube | `videoUrl`, `url` | `title` | `channelTitle` |6061**TikTok Note**: The Apify TikTok Scraper returns `webVideoUrl` (the TikTok page URL) rather than a direct video download URL. Gemini will attempt to analyze from this page URL.6263## Output6465Returns JSON array with analysis for each video:6667```json68[69 {70 "post_id": "ABC123",71 "username": "creator",72 "url": "https://...",73 "platform": "instagram",74 "likes": 50000,75 "comments": 1200,76 "views": 500000,77 "analysis": {78 "hook": {79 "technique": "pattern-interrupt",80 "opening_line": "Stop scrolling if you...",81 "attention_grab": "Creates urgency and targets specific audience",82 "replicable_formula": "Stop scrolling if you [pain point]"83 },84 "content_structure": {85 "format": "problem-solution",86 "sections": [...],87 "pacing": "fast",88 "retention_techniques": ["pattern interrupts", "text overlays"]89 },90 "delivery_style": {91 "speaking": "direct-to-camera",92 "energy": "high-energy",93 "text_overlays": true,94 "visual_style": "quick cuts with b-roll"95 },96 "cta_strategy": {97 "type": "follow",98 "cta_text": "Follow for more tips",99 "placement": "end"100 },101 "why_it_works": "..."102 }103 }104]105```106107## Hook Techniques108109The analyzer identifies these hook types:110- `pattern-interrupt` - Breaks expected patterns111- `question` - Opens with engaging question112- `bold-claim` - Makes surprising statement113- `story-tease` - Hints at compelling narrative114- `visual-shock` - Striking visual opening115- `curiosity-gap` - Creates information gap116- `direct-address` - Speaks to specific audience117- `controversial-take` - Polarizing opinion118- `relatable-pain` - Targets common struggle119- `transformation-preview` - Shows before/after120121## Content Formats122123- `problem-solution` - Present problem, offer fix124- `listicle` - Numbered tips/items125- `story` - Narrative arc126- `tutorial` - Step-by-step how-to127- `before-after` - Transformation reveal128- `day-in-life` - Lifestyle content129- `reaction` - Response to other content130- `hot-take` - Opinion piece131- `tool-demo` - Product/tool showcase