Social Video Analyzer

通过 yt-dlp 下载 YouTube、Instagram、TikTok 等平台视频，调用 Google Gemini 原生视频理解生成完整转录、画面场景描述、关键要点与内容形式分析；支持自定义提问用于竞品研究、广告分析和内容再创作，并提供 shell 与 Python 两种命令行入口。

aiwithabidi

热度 20.11

最近更新 2026-05-10 17:38:36

分类：数据依赖：代码执行 / 读写文件 / 第三方 API / 内部调用大模型应用场景：摘要总结 / 研究 / 社交媒体 / 市场分析

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add a6-social-video-analyzer

Metadata

name: social-video-analyzer
description: 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.
homepage: https://www.agxntsix.ai
license: MIT
compatibility: Python 3.10+
metadata: {"openclaw":{"emoji":"🎬","requires":{"env":["GOOGLE_AI_API_KEY"]},"primaryEnv":"GOOGLE_AI_API_KEY","homepage":"https://www.agxntsix.ai"}}

🎬 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