youtube-summarizer
Zweck
Diese Fähigkeit extrahiert Transkripte von YouTube-Videos und generiert umfassende, ausführliche Zusammenfassungen unter Verwendung des STAR + R-I-S-E-Frameworks. Sie validiert die Verfügbarkeit des Videos, extrahiert Transkripte mit der Python-Bibliothek youtube-transcript-api und erstellt detaillierte Dokumentationen, die alle Erkenntnisse, Argumente und Kernpunkte erfassen.
Die Fähigkeit ist für Benutzer konzipiert, die eine gründliche Inhaltsanalyse und Referenzdokumentation von Bildungsvideos, Vorlesungen, Tutorials oder informativen Inhalten benötigen.
Wann diese Fähigkeit verwendet werden sollte
Diese Fähigkeit sollte verwendet werden, wenn:
- Der Benutzer eine YouTube-Video-URL bereitstellt und eine detaillierte Zusammenfassung wünscht
- Der Benutzer Videoinhalte als Referenz dokumentieren muss, ohne das Video erneut anzusehen
- Der Benutzer Erkenntnisse, Kernpunkte und Argumente aus Bildungsinhalten extrahieren möchte
- Der Benutzer Transkripte von YouTube-Videos zur Analyse benötigt
- Der Benutzer darum bittet, YouTube-Videos "zusammenzufassen", "zu resümieren" oder "Inhalte zu extrahieren"
- Der Benutzer eine umfassende Dokumentation wünscht, die Vollständigkeit über Kürze stellt
Schritt 0: Erkennung & Einrichtung
Überprüfen Sie vor der Verarbeitung von Videos die Umgebung und Abhängigkeiten:
# Prüfen, ob youtube-transcript-api installiert ist
python3 -c "import youtube_transcript_api" 2>/dev/null
if [ $? -ne 0 ]; then
echo "⚠️ youtube-transcript-api nicht gefunden"
# Installation anbieten
fi
# Prüfen, ob Python verfügbar ist
if ! command -v python3 &>/dev/null; then
echo "❌ Python 3 wird benötigt, ist aber nicht installiert"
exit 1
fi
Den Benutzer fragen, wenn die Abhängigkeit fehlt:
youtube-transcript-api wird benötigt, ist aber nicht installiert.
Möchten Sie es jetzt installieren?
- [ ] Ja - Mit pip installieren (pip install youtube-transcript-api)
- [ ] Nein - Ich installiere es manuell
Wenn der Benutzer "Ja" auswählt:
pip install youtube-transcript-api
Installation überprüfen:
python3 -c "import youtube_transcript_api; print('✅ youtube-transcript-api erfolgreich installiert')"
Hauptworkflow
Richtlinien zur Fortschrittsverfolgung
Zeigen Sie während des gesamten Workflows vor jedem Schritt eine visuelle Fortschrittsanzeige an, um den Benutzer zu informieren. Das Format der Anzeige ist:
echo "[████░░░░░░░░░░░░░░░░] 20% - Schritt 1/5: URL validieren"
Formatspezifikationen:
- 20 Zeichen breit (█ für gefüllt, ░ für leer)
- Prozentschritte: Schritt 1=20%, Schritt 2=40%, Schritt 3=60%, Schritt 4=80%, Schritt 5=100%
- Schrittzähler mit aktuell/gesamt (z. B. "Schritt 3/5")
- Kurze Beschreibung der aktuellen Phase
Den Status-Container vor Schritt 1 anzeigen:
╔══════════════════════════════════════════════════════════════╗
║ 📹 YOUTUBE SUMMARIZER - Video wird verarbeitet ║
╠══════════════════════════════════════════════════════════════╣
║ → Schritt 1: URL validieren [IN BEARBEITUNG] ║
║ ○ Schritt 2: Verfügbarkeit prüfen ║
║ ○ Schritt 3: Transkript extrahieren ║
║ ○ Schritt 4: Zusammenfassung erstellen ║
║ ○ Schritt 5: Ausgabe formatieren ║
╠══════════════════════════════════════════════════════════════╣
║ Fortschritt: ██████░░░░░░░░░░░░░░░░░░░░░░░░ 20% ║
╚══════════════════════════════════════════════════════════════╝
Schritt 1: YouTube-URL validieren
Ziel: Video-ID extrahieren und URL-Format validieren.
Unterstützte URL-Formate:
https://www.youtube.com/watch?v=VIDEO_IDhttps://youtube.com/watch?v=VIDEO_IDhttps://youtu.be/VIDEO_IDhttps://m.youtube.com/watch?v=VIDEO_ID
Aktionen:
# Video-ID mit Regex oder URL-Parsing extrahieren
URL="$USER_PROVIDED_URL"
# Muster 1: youtube.com/watch?v=VIDEO_ID
if echo "$URL" | grep -qE 'youtube\.com/watch\?v='; then
VIDEO_ID=$(echo "$URL" | sed -E 's/.*[?&]v=([^&]+).*/\1/')
# Muster 2: youtu.be/VIDEO_ID
elif echo "$URL" | grep -qE 'youtu\.be/'; then
VIDEO_ID=$(echo "$URL" | sed -E 's/.*youtu\.be\/([^?]+).*/\1/')
else
echo "❌ Ungültiges YouTube-URL-Format"
exit 1
fi
echo "📹 Video-ID extrahiert: $VIDEO_ID"
Wenn die URL ungültig ist:
❌ Ungültige YouTube-URL
Bitte geben Sie eine gültige YouTube-URL in einem dieser Formate an:
- https://www.youtube.com/watch?v=VIDEO_ID
- https://youtu.be/VIDEO_ID
Beispiel: https://www.youtube.com/watch?v=dQw4w9WgXcQ
Schritt 2: Video- & Transkriptverfügbarkeit prüfen
Fortschritt:
echo "[████████░░░░░░░░░░░░] 40% - Schritt 2/5: Verfügbarkeit prüfen"
Ziel: Überprüfen, ob das Video existiert und das Transkript zugänglich ist.
Aktionen:
from youtube_transcript_api import YouTubeTranscriptApi, TranscriptsDisabled, NoTranscriptFound
import sys
video_id = sys.argv[1]
try:
# Liste der verfügbaren Transkripte abrufen
transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)
print(f"✅ Video zugänglich: {video_id}")
print("📝 Verfügbare Transkripte:")
for transcript in transcript_list:
print(f" - {transcript.language} ({transcript.language_code})")
if transcript.is_generated:
print(" [Automatisch generiert]")
except TranscriptsDisabled:
print(f"❌ Transkripte sind für Video {video_id} deaktiviert")
sys.exit(1)
except NoTranscriptFound:
print(f"❌ Kein Transkript für Video {video_id} gefunden")
sys.exit(1)
except Exception as e:
print(f"❌ Fehler beim Zugriff auf das Video: {e}")
sys.exit(1)
Fehlerbehandlung:
| Fehler | Meldung | Aktion |
|---|---|---|
| Video nicht gefunden | "❌ Video existiert nicht oder ist privat" | Benutzer bitten, URL zu überprüfen |
| Transkripte deaktiviert | "❌ Transkripte sind für dieses Video deaktiviert" | Kein Fortfahren möglich |
| Kein Transkript verfügbar | "❌ Kein Transkript gefunden (nicht automatisch generiert oder manuell hinzugefügt)" | Kein Fortfahren möglich |
| Privates/eingeschränktes Video | "❌ Video ist privat oder eingeschränkt" | Nach einem öffentlichen Video fragen |
Schritt 3: Transkript extrahieren
Fortschritt:
echo "[████████████░░░░░░░░] 60% - Schritt 3/5: Transkript extrahieren"
Ziel: Transkript in der bevorzugten Sprache abrufen.
Aktionen:
from youtube_transcript_api import YouTubeTranscriptApi
video_id = "VIDEO_ID"
try:
# Versuchen, das Transkript zuerst in der bevorzugten Sprache des Benutzers zu erhalten
# Fallback auf Englisch, falls nicht verfügbar
transcript = YouTubeTranscriptApi.get_transcript(
video_id,
languages=['pt', 'en'] # Portugiesisch bevorzugen, Fallback auf Englisch
)
# Transkriptsegmente zu vollständigem Text kombinieren
full_text = " ".join([entry['text'] for entry in transcript])
# Video-Metadaten abrufen
from youtube_transcript_api import YouTubeTranscriptApi
transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)
print("✅ Transkript erfolgreich extrahiert")
print(f"📊 Transkriptlänge: {len(full_text)} Zeichen")
# In temporäre Datei zur Verarbeitung speichern
with open(f"/tmp/transcript_{video_id}.txt", "w") as f:
f.write(full_text)
except Exception as e:
print(f"❌ Fehler beim Extrahieren des Transkripts: {e}")
exit(1)
Transkriptverarbeitung:
- Alle Transkriptsegmente zu einem zusammenhängenden Text kombinieren
- Zeichensetzung und Formatierung beibehalten, wo verfügbar
- Doppelte oder überlappende Segmente entfernen (falls Artefakte der automatischen Generierung)
- Zur Analyse in einer temporären Datei speichern
Schritt 4: Umfassende Zusammenfassung erstellen
Fortschritt:
echo "[████████████████░░░░] 80% - Schritt 4/5: Zusammenfassung erstellen"
Ziel: Verbesserten STAR + R-I-S-E-Prompt anwenden, um eine detaillierte Zusammenfassung zu erstellen.
Angewendeter Prompt:
Den erweiterten Prompt aus Phase 2 (STAR + R-I-S-E-Framework) mit dem extrahierten Transkript als Eingabe verwenden.
Aktionen:
- Den vollständigen Transkripttext laden
- Den umfassenden Zusammenfassungs-Prompt anwenden
- KI-Modell (Claude/GPT) zur Generierung einer strukturierten Zusammenfassung verwenden
- Sicherstellen, dass die Ausgabe der definierten Struktur folgt:
- Kopfzeile mit Video-Metadaten
- Executive Summary
- Detaillierte abschnittsweise Aufschlüsselung
- Wichtige Erkenntnisse und Schlussfolgerungen
- Konzepte und Terminologie
- Ressourcen und Referenzen
Implementierung:
# Die Transkriptdatei als Eingabe für den KI-Prompt verwenden
TRANSCRIPT_FILE="/tmp/transcript_${VIDEO_ID}.txt"
# Der KI-Agent wird:
# 1. Das Transkript lesen
# 2. Das STAR + R-I-S-E-Zusammenfassungsframework anwenden
# 3. Eine umfassende Markdown-Ausgabe generieren
# 4. Mit Überschriften, Listen und Hervorhebungen strukturieren
Read "$TRANSCRIPT_FILE" # Transkript in den Kontext laden
Dann den vollständigen Zusammenfassungs-Prompt anwenden (aus der erweiterten Version in Phase 2).
Schritt 5: Ausgabe formatieren und präsentieren
Fortschritt:
echo "[████████████████████] 100% - Schritt 5/5: Ausgabe formatieren"
Ziel: Die Zusammenfassung in sauberem, gut strukturiertem Markdown ausliefern.
Ausgabestruktur:
# [Video-Titel]
**Kanal:** [Kanalname]
**Dauer:** [Dauer]
**URL:** [https://youtube.com/watch?v=VIDEO_ID]
**Veröffentlichungsdatum:** [Datum, falls verfügbar]
## 📝 Detaillierte Zusammenfassung
### [Thema 1]
[Umfassende Erklärung mit Beispielen, Daten, Zitaten...]
#### [Unterthema 1.1]
[Detaillierte Aufschlüsselung...]
### [Thema 2]
[Fortgesetzte detaillierte Analyse...]
## 📚 Konzepte und Terminologie
- **[Begriff 1]:** [Definition und Kontext]
- **[Begriff 2]:** [Definition und Kontext]
## 📌 Fazit
[Abschließende Synthese und wichtigste Erkenntnisse]
Beispiel 2: Fehlende Abhängigkeit
Benutzereingabe:
claude> fasse dieses YouTube-Video zusammen https://youtu.be/abc123
Antwort der Fähigkeit:
⚠️ youtube-transcript-api nicht installiert
Diese Fähigkeit benötigt die Python-Bibliothek 'youtube-transcript-api'.
Möchten Sie, dass ich sie jetzt installiere?
- [ ] Ja - Mit pip installieren
- [ ] Nein - Ich installiere manuell
Benutzer wählt "Ja":
$ pip install youtube-transcript-api
Successfully installed youtube-transcript-api-0.6.1
✅ Installation abgeschlossen! Fahre mit der Video-Zusammenfassung fort...
Beispiel 4: Ungültige URL
Benutzereingabe:
claude> fasse YouTube-Video zusammen www.youtube.com/some-video
Antwort der Fähigkeit:
❌ Ungültiges YouTube-URL-Format
Erwartete Formatbeispiele:
- https://www.youtube.com/watch?v=VIDEO_ID
- https://youtu.be/VIDEO_ID
Bitte geben Sie eine gültige YouTube-Video-URL an.
📊 Executive Summary
Dieses Video bietet eine umfassende Einführung in die grundlegenden Konzepte der Künstlichen Intelligenz (KI), konzipiert für Anfänger und Fachleute, die die technischen Grundlagen und praktischen Anwendungen moderner KI verstehen möchten. Der Dozent behandelt alles von grundlegenden Definitionen bis hin zu Algorithmen des maschinellen Lernens, wobei er praktische Beispiele und Visualisierungen verwendet, um das Verständnis zu erleichtern.
[... fortgesetzte detaillierte Zusammenfassung ...]
**Speicheroptionen:**
Was möchten Sie speichern? → Zusammenfassung + rohes Transkript
✅ Datei gespeichert: zusammenfassung-beispiel123-2026-02-01.md (rohes Transkript enthalten) [████████████████████] 100% - ✓ Verarbeitung abgeschlossen!
Willkommen zu diesem umfassenden Tutorial über die Grundlagen des maschinellen Lernens. Im heutigen Video werden wir die Kernkonzepte erkunden, die moderne KI-Systeme antreiben...
**Version:** 1.2.0
**Letzte Aktualisierung:** 2026-02-02
**Gepflegt von:** Eric Andrade
## Einschränkungen
- Diese Fähigkeit nur verwenden, wenn die Aufgabe eindeutig dem oben beschriebenen Umfang entspricht.
- Die Ausgabe nicht als Ersatz für umgebungsspezifische Validierung, Tests oder Expertenüberprüfung betrachten.
- Bei fehlenden erforderlichen Eingaben, Berechtigungen, Sicherheitsgrenzen oder Erfolgskriterien anhalten und um Klärung bitten.