🎬 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
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
1---2name: social-video-analyzer3description: Download and analyze any social media video from Instagram, YouTube, TikTok, X/Twitter, Reddit, Facebook, Vimeo, Twitch, and 1000+ platforms. Get full transcripts, visual scene descriptions, key takeaways, and content format analysis using Gemini native video understanding. Supports custom analysis prompts for competitive research, content repurposing, ad analysis, and influencer tracking. Built for AI agents — uses yt-dlp for downloading and Google Gemini for analysis. Use for video transcription, social media monitoring, content analysis, competitor research, video summarization, and multimedia intelligence.4license: MIT5---67# 🎬 Social Video Analyzer89Download and analyze any social media video — Instagram, YouTube, TikTok, X, Reddit, and 1000+ more platforms.1011## Features1213- **Download from 1000+ sites** via yt-dlp (YouTube, Instagram, TikTok, X, Reddit, Facebook, Vimeo, Twitch)14- **Transcribe full audio** — complete spoken content extraction15- **Describe visuals** — scene-by-scene breakdown of what's shown16- **Extract key takeaways** — summarized main points17- **Analyze content format** — platform, duration, style, production quality18- **Custom prompts** — ask specific questions about any video19- **Native video understanding** — Gemini processes video natively (not frame extraction)20- **Shell and Python interfaces** — quick bash script or full Python control21- **Auto-cleanup** — temporary files managed automatically22- **Handles large videos** — up to 2GB per Gemini API limits2324## Requirements2526| Variable | Required | Description |27|----------|----------|-------------|28| `GOOGLE_AI_API_KEY` | ✅ | Get from [Google AI Studio](https://aistudio.google.com/apikey) |2930## Quick Start3132```bash33# Quick analysis (shell)34./skills/social-video-analyzer/scripts/analyze_video.sh "https://www.youtube.com/watch?v=VIDEO_ID"3536# Full control (Python)37GOOGLE_AI_API_KEY=your_key python3 skills/social-video-analyzer/scripts/analyze_video.py "https://youtube.com/watch?v=VIDEO_ID"3839# Custom question40python3 skills/social-video-analyzer/scripts/analyze_video.py "https://tiktok.com/@user/video/123" --prompt "What product is being advertised?"41```4243## Commands4445### Shell Script (Quick)46```bash47./scripts/analyze_video.sh "VIDEO_URL"48```4950### Python (Full Control)51```bash52# Default analysis53python3 scripts/analyze_video.py "VIDEO_URL"5455# Custom prompt56python3 scripts/analyze_video.py "VIDEO_URL" --prompt "Your question"5758# Competitive analysis59python3 scripts/analyze_video.py "VIDEO_URL" --prompt "What hooks and CTAs are used?"6061# Content repurposing62python3 scripts/analyze_video.py "VIDEO_URL" --prompt "Extract quotes suitable for social media posts"63```6465## Output Format6667```68## Transcript69[Full spoken content]7071## Visual Description72[Scene-by-scene breakdown]7374## Key Takeaways75- Point 176- Point 27778## Content Format Analysis79- Platform: YouTube80- Duration: ~3:2081- Style: Tutorial/explainer82- Production: Professional83```8485## Supported Platforms8687YouTube, Instagram, TikTok, X/Twitter, Reddit, Facebook, Vimeo, Twitch clips, and [1000+ more](https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md).8889## Script Reference9091| Script | Description |92|--------|-------------|93| `{baseDir}/scripts/analyze_video.sh` | Quick shell wrapper for video analysis |94| `{baseDir}/scripts/analyze_video.py` | Full Python CLI with custom prompts |9596## Limitations9798- Max video size: 2GB (Gemini API limit)99- Private/login-required videos may fail100- Rate limits apply per platform101102## Data Policy103104Videos are temporarily downloaded for analysis, uploaded to Google Gemini API for processing, and auto-cleaned after 48 hours.105106---107108Built by [M. Abidi](https://www.agxntsix.ai)109110[LinkedIn](https://www.linkedin.com/in/mohammad-ali-abidi) · [YouTube](https://youtube.com/@aiwithabidi) · [GitHub](https://github.com/aiwithabidi) · [Book a Call](https://cal.com/agxntsix/abidi-openclaw)