Was ist das?

Video URL Analyzer MCP ist ein Model Context Protocol (MCP) Server, mit dem Claude (oder jede andere MCP-kompatible KI) Videos von YouTube, TikTok und Instagram analysieren kann — einfach die URL einfügen. Angetrieben von Googles Gemini API mit vollständiger Audio- und Videoanalyse, extrahiert er Transkripte, liefert KI-gestützte Erkenntnisse und kann sogar ausführbare Tutorial-Schritte extrahieren.

Funktionen

YouTube-Analyse — Direkte Analyse über die Gemini API (kein Download erforderlich)
TikTok & Instagram — Asynchrones Job-Muster mit yt-dlp Download + Gemini Files API
Vollständige Audio- + Videoanalyse — Analysiert sowohl Videobilder als auch Audio/Sprache
6 Tools — analyze, transcript, Q&A, watch & analyze, execute tutorials, check jobs
Zweisprachig — Unterstützt arabische und englische Prompts und Antworten
Asynchrone Jobs — Hintergrundverarbeitung verhindert Timeouts bei Claude Desktop
Sicherheitsgehärtet — URL-Allowlist, SSRF-Schutz, Schutz vor Befehlsinjektion, Blockierung von Pfad-Traversal
Zero-Config-Installation — uvx video-url-analyzer-mcp und es läuft

Unterstützte Plattformen

Plattform	Methode	Geschwindigkeit
YouTube	Direkte Gemini-Analyse — kein Download nötig	Sofort
TikTok	tikwm.com API (schnell) → yt-dlp Fallback	~8s
Instagram	Seiten-Scraping via curl_cffi (schnell) → yt-dlp Fallback	~10s

YouTube-Videos werden direkt durch Geminis natives Videoverständnis analysiert — kein Download, kein Upload, maximale Geschwindigkeit.

Schnellstart

Option 1: uvx (Empfohlen)

Erfordert uv.

Claude Desktop -- zu claude_desktop_config.json hinzufügen:

{
  "mcpServers": {
    "video-analyzer": {
      "command": "uvx",
      "args": ["video-url-analyzer-mcp"],
      "env": {
        "GEMINI_API_KEY": "your_key"
      }
    }
  }
}

Claude Code:

claude mcp add video-analyzer -s user -e GEMINI_API_KEY=your_key -- uvx video-url-analyzer-mcp

Cursor / VS Code -- zu .cursor/mcp.json oder .vscode/mcp.json hinzufügen:

{
  "servers": {
    "video-analyzer": {
      "command": "uvx",
      "args": ["video-url-analyzer-mcp"],
      "env": { "GEMINI_API_KEY": "your_key" }
    }
  }
}

Windsurf -- zu ~/.codeium/windsurf/mcp_config.json hinzufügen:

{
  "mcpServers": {
    "video-analyzer": {
      "command": "uvx",
      "args": ["video-url-analyzer-mcp"],
      "env": { "GEMINI_API_KEY": "your_key" }
    }
  }
}

Option 2: pip install

pip install video-url-analyzer-mcp

Option 3: Aus dem Quellcode

git clone https://github.com/u2n4/video-url-analyzer-mcp.git
cd video-url-analyzer-mcp
pip install -e .

Tools

Tool	Was es tut
`analyze_video`	Vollständige Audio- + Videoanalyse mit benutzerdefinierten Prompts. Nutzt Gemini für modernstes multimodales Verständnis.
`get_transcript`	Extrahiert zeitgestempelte Transkripte mit Sprecheridentifikation. Unterstützt über 100 Sprachen durch automatische Erkennung.
`ask_about_video`	Stellen Sie jede Frage — "Wie viele Personen sind zu sehen?", "Welche Marke ist bei 0:45 zu sehen?", "Fasse das Hauptargument zusammen."
`watch_and_analyze`	Extrahiert Tutorial-Schritte, Shell-Befehle, Code-Snippets und Dateipfade aus technischen Videos.
`execute_tutorial_steps`	Überprüfen Sie extrahierte Schritte sicher und führen Sie sie dann mit Bestätigung aus. In einer Sandbox mit Befehls- und Pfadvalidierung.
`check_analysis_job`	Fragt den Status von Hintergrundjobs für asynchrone TikTok/Instagram-Downloads ab.

Funktionsweise

YouTube — Synchron: Die URL wird direkt zur sofortigen Analyse an die Gemini API gesendet (kein Download).

TikTok & Instagram — Asynchron: Das Video wird via yt-dlp heruntergeladen, in die Gemini Files API hochgeladen, analysiert und anschließend gelöscht. Gibt sofort eine job_id zurück — abrufbar mit check_analysis_job.

Nutzungsbeispiele

# Full video analysis
analyze_video("https://www.youtube.com/watch?v=dQw4w9WgXcQ")

# Custom analysis prompt
analyze_video("https://www.tiktok.com/@user/video/123",
              prompt="List every product shown and estimate prices")

# Multilingual transcript extraction
get_transcript("https://www.instagram.com/reel/ABC123/", lang="ar")

# Ask specific questions about video content
ask_about_video("https://youtu.be/abc",
                question="What programming language is used in the tutorial?")

# Watch & build — extract tutorial steps
watch_and_analyze("https://www.youtube.com/watch?v=tutorial123")

Architektur

Komponente	Rolle
Gemini API	Multimodales Modell — vollständiges Audio- + Videoverständnis in einem Durchgang
FastMCP 3.x	MCP-Protokoll-Framework über stdio-Transport
yt-dlp + curl_cffi	Video-Download mit Chrome-Browser-Imitation zur Umgehung von Anti-Bot-Maßnahmen
tikwm.com API	TikTok-Fast-Path-Fallback, wenn yt-dlp durch WAF blockiert wird
Hintergrundjobs	Asynchrones Threading für TikTok/Instagram zur Vermeidung von Claude Desktop-Timeouts

video-url-analyzer-mcp/
├── pyproject.toml                    # Package metadata & dependencies
├── src/
│   └── video_url_analyzer_mcp/
│       ├── __init__.py               # Package init + version
│       ├── __main__.py               # python -m support
│       └── server.py                 # Main MCP server (all 6 tools)
├── .env.example                      # Environment variable template
├── llms.txt                          # AI-readable project summary
├── llms-install.md                   # AI-readable install guide
├── CONTRIBUTING.md
├── CHANGELOG.md
└── LICENSE

Plattformerkennung

URLs werden automatisch an die richtige Pipeline weitergeleitet:

YouTube: youtube.com, youtu.be, youtube.com/shorts/
TikTok: tiktok.com, vm.tiktok.com, vt.tiktok.com
Instagram: instagram.com/reels/, instagram.com/reel/, instagram.com/p/

Sicherheit

Dieser Server wurde gegen ein umfassendes Bedrohungsmodell gehärtet:

Ebene	Schutz
SSRF	URL-Allowlist — nur YouTube-, TikTok-, Instagram-Domains akzeptiert. Private IPs, localhost, `file://` blockiert.
Befehlsinjektion	`shell=False` + `shlex.split()`. Blockliste für gefährliche Befehle (rm -rf, Reverse Shells, eval, pipe-to-shell).
Pfad-Traversal	25+ sensible Pfadmuster blockiert (`.ssh`, `.aws`, `.env`, Systemverzeichnisse, AppData).
TLS	Vollständige Zertifikatsvalidierung bei allen Downloads.
Browser-Cookies	Nur Opt-in via `VIDEO_ANALYZER_COOKIES=true`. Standardmäßig deaktiviert.
Download-Größe	Hartes Limit von 100 MB pro Video.
DoS-Schutz	Maximal 10 gleichzeitige Hintergrundjobs. Automatische Löschung nach 1 Stunde. Speicherlimit von 200 Analysen.
Schema-Validierung	Gemini JSON-Antworten werden vor der Ausführung validiert. Antwortgröße auf 500K Zeichen begrenzt.
Abhängigkeiten	Alle Versionen in `pyproject.toml` fixiert.

Konfiguration

Variable	Beschreibung	Standard
`GEMINI_API_KEY`	Google Gemini API-Schlüssel (erforderlich)	—
`ANALYSES_DIR`	Verzeichnis zum Speichern der Analyseergebnisse	`./analyses`
`VIDEO_ANALYZER_COOKIES`	Browser-Cookies für yt-dlp aktivieren	`false`

Tech-Stack

Technologie	Zweck
google-genai	Google Gemini API SDK
FastMCP	MCP-Protokoll-Framework
yt-dlp	Video-Downloader
curl_cffi	Browser-Imitation (TLS-Fingerabdruck)
python-dotenv	Laden von Umgebungsvariablen

Fehlerbehebung

Problem	Lösung
`GEMINI_API_KEY not set`	`.env`-Datei erstellen oder über Umgebungsvariable übergeben
TikTok-Download schlägt fehl	tikwm.com-Fallback aktiviert sich automatisch. Sicherstellen, dass `curl_cffi` installiert ist.
Instagram-Download schlägt fehl	`pip install curl_cffi` für Unterstützung der Browser-Imitation
`ENOENT` unter Windows	`uvx video-url-analyzer-mcp` als Befehl verwenden
Claude Desktop-Timeout	TikTok/Instagram laufen im Hintergrund — `check_analysis_job(job_id)` zum Abfragen verwenden
Python nicht gefunden	Python 3.10+ von python.org installieren

Mitwirken

Siehe CONTRIBUTING.md für Richtlinien.

Lizenz

MIT — siehe LICENSE.

Support

Wenn Sie dies nützlich finden, geben Sie diesem Repository bitte einen Stern!

Hergestellt mit ❤️ in der Ostprovinz von Saudi-Arabien.

العربية

خادم تحليل الفيديو بالذكاء الاصطناعي

خادم MCP لتحليل الفيديو باستخدام Google Gemini — احدث واقوى نموذج ذكاء اصطناعي متعدد الوسائط من جوجل.

المميزات

الاداة	الوصف
`analyze_video`	تحليل شامل للصوت والصورة مع دعم الاوامر المخصصة
`get_transcript`	استخراج النص المنطوق مع الطوابع الزمنية — يدعم +100 لغة
`ask_about_video`	اسال اي سؤال عن محتوى الفيديو
`watch_and_analyze`	استخراج خطوات الشروحات التقنية والاوامر والاكواد
`execute_tutorial_steps`	مراجعة وتنفيذ الخطوات المستخرجة بامان

المنصات المدعومة

المنصة	السرعة
يوتيوب	فوري — تحليل مباشر بدون تحميل
تيك توك	~8 ثواني — واجهة tikwm.com السريعة
انستاجرام	~10 ثواني — استخراج مباشر من الصفحة

التثبيت السريع

git clone https://github.com/u2n4/video-url-analyzer-mcp.git
cd video-url-analyzer-mcp
pip install -e .

الامان

الخادم محمي ضد:

SSRF — قائمة بيضاء للنطاقات المسموحة فقط
حقن الاوامر — حظر الاوامر الخطيرة + تنفيذ بدون shell
اختراق المسارات — حظر 25+ مسار حساس
حماية من الحمل الزائد — حد اقصى 10 مهام متزامنة

الحصول على مفتاح API

اذهب الى Google AI Studio
انشئ مفتاح API مجاني
ضعه في ملف .env

video-url-analyzer-mcp

Was ist das?

Funktionen

Unterstützte Plattformen

Schnellstart

Option 1: uvx (Empfohlen)

Option 2: pip install

Option 3: Aus dem Quellcode

Tools

Funktionsweise

Nutzungsbeispiele

Architektur

Plattformerkennung

Sicherheit

Konfiguration

Tech-Stack

Fehlerbehebung

Mitwirken

Lizenz

Support

العربية

خادم تحليل الفيديو بالذكاء الاصطناعي

المميزات

المنصات المدعومة

التثبيت السريع

الامان

الحصول على مفتاح API

Maintenance

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API