🎬 Social Video Analyzer
Download and analyze any social media video — Instagram, YouTube, TikTok, X, Reddit, and 1000+ more platforms.
Features
- Download from 1000+ sites via yt-dlp (YouTube, Instagram, TikTok, X, Reddit, Facebook, Vimeo, Twitch)
- Transcribe full audio — complete spoken content extraction
- Describe visuals — scene-by-scene breakdown of what's shown
- Extract key takeaways — summarized main points
- Analyze content format — platform, duration, style, production quality
- Custom prompts — ask specific questions about any video
- Native video understanding — Gemini processes video natively (not frame extraction)
- Shell and Python interfaces — quick bash script or full Python control
- Auto-cleanup — temporary files managed automatically
- Handles large videos — up to 2GB per Gemini API limits
Requirements
| Variable | Required | Description |
|---|---|---|
GOOGLE_AI_API_KEY | ✅ | Get from Google AI Studio |
Quick Start
# Quick analysis (shell)
./skills/social-video-analyzer/scripts/analyze_video.sh "https://www.youtube.com/watch?v=VIDEO_ID"
# Full control (Python)
GOOGLE_AI_API_KEY=your_key python3 skills/social-video-analyzer/scripts/analyze_video.py "https://youtube.com/watch?v=VIDEO_ID"
# Custom question
python3 skills/social-video-analyzer/scripts/analyze_video.py "https://tiktok.com/@user/video/123" --prompt "What product is being advertised?"
Commands
Shell Script (Quick)
./scripts/analyze_video.sh "VIDEO_URL"
Python (Full Control)
# Default analysis
python3 scripts/analyze_video.py "VIDEO_URL"
# Custom prompt
python3 scripts/analyze_video.py "VIDEO_URL" --prompt "Your question"
# Competitive analysis
python3 scripts/analyze_video.py "VIDEO_URL" --prompt "What hooks and CTAs are used?"
# Content repurposing
python3 scripts/analyze_video.py "VIDEO_URL" --prompt "Extract quotes suitable for social media posts"
Output Format
## Transcript
[Full spoken content]
## Visual Description
[Scene-by-scene breakdown]
## Key Takeaways
- Point 1
- Point 2
## Content Format Analysis
- Platform: YouTube
- Duration: ~3:20
- Style: Tutorial/explainer
- Production: Professional
Supported Platforms
YouTube, Instagram, TikTok, X/Twitter, Reddit, Facebook, Vimeo, Twitch clips, and 1000+ more.
Script Reference
| Script | Description |
|---|---|
{baseDir}/scripts/analyze_video.sh | Quick shell wrapper for video analysis |
{baseDir}/scripts/analyze_video.py | Full Python CLI with custom prompts |
Limitations
- Max video size: 2GB (Gemini API limit)
- Private/login-required videos may fail
- Rate limits apply per platform
Data Policy
Videos are temporarily downloaded for analysis, uploaded to Google Gemini API for processing, and auto-cleaned after 48 hours.
Built by M. Abidi
LinkedIn · YouTube · GitHub · Book a Call