ingest-youtube – YouTube-zu-Vault-Verbinder
Überführt YouTube-Transkripte als abfragbare, typisierte Gedächtniseinträge in einen Markdown-Vault, auf die nachgelagerte Skills (Wissensgraphenextraktion, Sprach-Fingerabdruck-Training, Content-Wiederverwendung, Aktionselementextraktion) zugreifen können.
Gleiches Muster wie ingest-slack, ingest-whatsapp, ingest-notion, ingest-linear, ingest-github, ingest-gmail. YouTube hinzuzufügen bedeutet einen neuen Normalisierer, keine neue Architektur.
Wann verwenden
- Benutzer fügt eine YouTube-URL ein und bittet um Transkript oder Zusammenfassung
- Benutzer sagt
/ingest-youtube <url>für ein einzelnes Video - Benutzer bittet um Erfassung, Synchronisation, Einlesen, Transkription oder Herunterladen eines Vortrags/Podcasts/Keynote in den Vault
NICHT verwenden für:
- Herunterladen der eigentlichen Videodatei (
yt-dlpdirekt mit-f bestnutzen) - Kanaleinlese oder
--days-Fenster; dieses Skript verarbeitet eine Video-URL pro Durchlauf - Live-Streams (Transkripte sind nicht stabil)
- Nicht-YouTube-Quellen (Vimeo, Twitch, Twitter Spaces haben eigene Verbinder)
- Einmalige Transkriptabfragen, bei denen der Benutzer keine Vault-Datei wünscht (direkt
yt-dlp --write-auto-subund an stdout weiterleiten)
Funktionsweise
- Eingabe als eine YouTube-Video-URL parsen.
- Prüfen, ob
yt-dlpinstalliert ist. Falls nicht, Skript beendet sich mit Installationsanweisungen:brew install yt-dlp(macOS) oderpip3 install --user yt-dlp. yt-dlp --list-subs <url>aufrufen, um verfügbare Untertitel aufzulisten.- Untertitelpriorität: Manuelle Untertitel > automatisch generierte Untertitel. Manuelle Untertitel erhalten die vom Ersteller bereitgestellte Zeichensetzung und Sprecherbezeichnungen; automatische Untertitel sind in Großbuchstaben und ohne Zeichensetzung.
- Den Untertitel mit höchster Priorität als VTT herunterladen via
yt-dlp --write-sub --sub-lang <sprache> --skip-download. Standard-Spracheinstellung:en,es(Englisch zuerst, Spanisch Zweitens). - VTT-Zeitmarken entfernen und zu sauberen Prosaabsätzen zusammenführen. Doppelte Zeilen deduplizieren (automatisch generierte VTTs sind zeilenverdoppelt). Sprecherbezeichnungen beibehalten, wenn die Quelle sie hatte.
- Video-Metadaten (Titel, Kanal, Upload-Datum, Dauer, video_id, URL) via
yt-dlp --print-json --skip-downloadabrufen. - Kanalnamen und Videotitel slugifizieren. Schreiben nach
External Inputs/YouTube/<kanal-slug>/<YYYY-MM-DD>-<video-slug>.md. - Transkript nach Schlüsselwörtern durchsuchen (Entscheidung, Framework, Modell, Prinzip, „die Lektion ist“, Playbook, Anti-Pattern, Fallstudie). Für jede Übereinstimmung einen Schreibnotiz-Stub erstellen unter
Meta/Captures/<YYYY-MM-DD>-youtube-<kanal-slug>-<video-id>.md, sodass die Notiz im Captures-Aggregator landet. - Zusammenfassung ausgeben: Dateipfad, Transkript-Wortanzahl, Sprache, erkannte Notizen.
Aufruf
python3 ingest.py <youtube-url> [--vault <pfad>] [--lang <code>]
Standardwerte:
--vault:$VAULT_ROOT-Umgebungsvariable oder aktuelles Verzeichnis--lang:en,es(Englisch zuerst, Spanisch Zweitens; entspricht einem häufigen zweisprachigen Standard)--whisper: als zukünftiges Fallback-Flag akzeptiert, aber diese Version schreibt einen Stub, wenn keine Untertitel verfügbar sind
Ausgabevereinbarung
Die Vault-Datei unter External Inputs/YouTube/<kanal-slug>/<YYYY-MM-DD>-<video-slug>.md enthält Frontmatter:
---
type: external-input
source: youtube
video_id: <11-stellige ID>
url: https://www.youtube.com/watch?v=<id>
channel: <kanalname>
channel_url: https://www.youtube.com/<handle>
title: <videotitel>
upload_date: <YYYY-MM-DD>
duration_seconds: <int>
language: <ISO-Code>
subtitle_source: manual | auto | whisper
word_count: <int>
ingested_at: <ISO 8601-Zeitstempel>
---
Body ist das bereinigte Transkript als Absatzprosa. Wenn die Quelle Sprecherbezeichnungen hatte, als **<sprecher>:** <text> pro Wechsel formatieren.
Idempotenz
Das erneute Einlesen derselben Video-URL überschreibt dieselbe Vault-Datei. Die Dateinamen der Captures-Stubs hashen die video_id, sodass dasselbe Quellvideo denselben Stub-Dateinamen bei wiederholten Durchläufen erzeugt. Wiederholungen aktualisieren, duplizieren nie.
Fehlende Untertitel
Wenn yt-dlp --list-subs keine manuellen oder automatischen Untertitel zurückgibt, schreibt das Skript einen Stub-Vault-Eintrag mit den Video-Metadaten und der Quell-URL, anstatt stillschweigend zu scheitern. Das --whisper-Flag ist für ein zukünftiges lokales Transkriptions-Fallback reserviert und meldet derzeit, dass das Fallback nicht implementiert ist.
Für ein manuelles Fallback heute: Audio mit yt-dlp herunterladen, mit Ihrem lokalen Whisper-Workflow transkribieren und Untertitel oder Transkripttext hinzufügen, bevor Sie den Einlesevorgang wiederholen.
Einschränkungen
- Verarbeitet eine YouTube-Video-URL pro Durchlauf; Kanal-Handles, Playlists und
--days-Fenster sind nicht abgedeckt. - Hängt von den von
yt-dlpzurückgegebenen Untertiteln ab; Videos ohne Untertitel erzeugen einen Metadaten-Stub, kein Transkript. - Lädt keine Videodateien herunter und führt in dieser Version keine eingebaute Whisper-Transkription durch.
- Netzwerkverfügbarkeit, YouTube-Untertitelzugriff und lokales
yt-dlp-Verhalten bestimmen, ob der Einlesevorgang erfolgreich ist.
Abnahmetest
Gegen das erste jemals hochgeladene YouTube-Video ausführen:
python3 ingest.py "https://www.youtube.com/watch?v=jNQXAC9IVRw" --vault /tmp/test
Erwartete Ausgabe:
39 Wörter geschrieben nach /tmp/test/External Inputs/YouTube/jawed/2005-04-24-me-at-the-zoo.md. Sprache: en. Untertitelquelle: manual.
Die Ausgabedatei enthält gültiges Frontmatter und einen sauberen Prosatext.
Abhängigkeiten
yt-dlp(erforderlich): installieren viabrew install yt-dlpoderpip3 install --user yt-dlpwhisper-cpp(optional für ein manuelles Fallback außerhalb dieses Skripts)
Quelle
Gebündelt in adelaidasofia/ai-brain-starter, einer Verifikationsumgebung um einen KI-Agenten, sodass sich Erinnerungen anreichern statt korrumpieren. Das Skill ist Teil der ingest-*-Familie von Vault-Connectoren.