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