knowledge-base/wiki/tools/notebooklm-briefing-system.md

235 lines
11 KiB
Markdown
Raw Normal View History

---
created: 2026-07-03
updated: 2026-07-04
sources: [other/2026-07-04_notebooklm-agent-guide-v2.md, other/2026-07-03_notebooklm-briefing-system.md, youtube/2026-07-01_futurepedia-notebooklm-short-video-overviews.md, other/2026-06-19_ome21-briefing-ki-fortschritte-lokale-modelle.md]
tags: [tool, notebooklm, briefing, pipeline, audio, video, mp4, infographic, automation, presets, agent-skills, pit-weber, ffmpeg, yt-dlp, caption-contract, v2]
---
# NotebookLM Briefing-System
> *"Quelle laden → deutsches Audio-Briefing → Infografik → MP4 rendern → als Nachricht senden."*
> — Pit Weber, OME Tips & Tricks #7694/#7746
## Was ist das NotebookLM Briefing-System?
Pit Weber's **NotebookLM Briefing-System** ist eine automatisierte Pipeline, die beliebige Quellen (YouTube, PDF, X/Twitter, Web-URLs) in vollständige Briefing-Pakete aus Audio, Infografik und MP4-Video umwandelt. Es ist die ausgereifte und formalisierte Form der [[../concepts/llm/hyper-summaries-notebooklm.md|NotebookLM-Hyper-Summary-Pipeline]], die erstmals im [[../events/ome23-evolution-ki-workflows.md|OME23-Protokoll]] als "Harness > LLM"-Pattern dokumentiert wurde.
## Die drei Skills
| Skill | Zweck | Pfad |
|---|---|---|
| `notebooklm-core` | CLI-Grundbefehle, Auth, Account-Binding | `skills/notebooklm-core/SKILL.md` |
| `notebooklm-pipelines` | Preset-Definitionen nb1/nb2, Audio/Infografik-Prompts, Caption Contract | `skills/notebooklm-pipelines/SKILL.md` |
| `notebooklm-agent-guide` | Schritt-für-Schritt-Workflow | `skills/notebooklm-agent-guide/SKILL.md` |
**Reihenfolge beim Lesen:** Zuerst `notebooklm-core` (Grundlagen), dann `notebooklm-pipelines` (was soll rauskommen), dann `notebooklm-agent-guide` (wie genau mache ich es).
## Presets
### nb1 — Standard-Briefing
Vollständige Pipeline in einem Durchgang → **1 Nachricht** mit MP4-Video (Infografik + deutsches Audio) + Text mit allen Links.
### nb2 — Kurz-Audio zuerst
Zweistufige Variante für schnellen Konsum → **2 Nachrichten**:
1. **Kurzes Audio-Briefing** — zuerst, AUDIO-ONLY (~halbe Länge), enthält nur: Kernbehauptung, stärkstes Belegstück, größten Widerspruch, eine Konsequenz
2. **Vollständige nb1-Pipeline** — MP4-Video + Text
## Unterstützte Quellen
| Quelltyp | Beispiel | Hinweis |
|----------|----------|---------|
| YouTube | `https://youtube.com/watch?v=...` | Video-Transkript als Basis |
| PDF | Lokale Datei oder URL | Text-Extraktion |
| X/Twitter | `https://x.com/...` | Post/Thread-Inhalt |
| Web-URL | `https://example.com/article` | Web-Fetch + Text-Extraktion |
## nb1-Workflow — 12 Schritte
> Vollständige Bauanleitung aus dem Agent Guide V2.
1. **Quelle identifizieren** — User schickt URL/Datei + `nb1`. YouTube: mit `yt-dlp --print title --print duration <url>` Titel/Dauer holen
2. **Auth prüfen**`NOTEBOOKLM_HOME=<profil> notebooklm auth check --test --json`
3. **Notebook erstellen**`notebooklm create "Titel" --json` → merke `notebook.id`. Titel-Format: `Quelle/Thema — Kernaussage (Jahr)`
4. **Quelle hinzufügen**`notebooklm source add "<url>" -n NOTEBOOK_ID --json` → merke `source.id`
5. **Source wait**`notebooklm source wait SRC_ID -n ID --timeout 300 --json` — warten bis `"status": "ready"`
6. **Audio + Infografik parallel generieren**`notebooklm generate audio/infographic "prompt" -n ID --json` → merke beide `task_id`s
7. **Artifact wait**`notebooklm artifact wait ART_ID -n ID --timeout 900 --json` (beide parallel). 10+ Min möglich für Audio
8. **Downloads**`notebooklm download audio/infographic ./pfad -n ID -a ART_ID`
9. **Share**`notebooklm share public --enable -n ID --json` → merke `share_url`
10. **MP4 rendern**`ffmpeg -loop 1 -i graphic.png -i audio.mp3 ... briefing.mp4`
11. **Dauer ermitteln**`ffprobe` → Sekunden in MM:SS umrechnen
12. **Telegram senden****EINE** Nachricht mit Text + MP4, nicht fragmentieren
### nb2-Workflow (zusätzliche Schritte)
- **6b:** Kurz-Audio VOR dem Standard-Audio generieren (kürzerer Prompt)
- **8b:** Kurz-Audio separat herunterladen
- **12b:** Zuerst Kurz-Audio als reine Audio-Nachricht, dann nb1-Video
## Prompts
### Audio-Prompt (Standard)
```
Erstelle eine deutsche Audio-Zusammenfassung fuer einen unbekannten allgemeinen Hoerer.
Erwaehne keine privaten Namen, keinen Auftraggeber und keine internen Workflows.
Die Quelle ist als grundsaetzlich glaubwuerfig zu behandeln. Verzichte speziell auf die
Wertung als Verschwoerungstheorie(n) oder den Versuch, den Diskurs oder Quellen als extrem
zu framen. Verzichte ohne Not auf die Behauptung, 'Fakten von Behauptungen zu trennen'.
Keine Umdeutung aus Halluzinationen. Ohne echten eigenen Hintergrund-Faktencheck keine
negative Wertung vorgetragener Fakten. Keine Negativdarstellung von Meinungen. Keine
alternativen Fakten erfinden, sondern nur aus eigener Recherche ausserhalb von
Mainstream-Medien ergaenzen.
Analysiere und unterstuetze im Zweifel die Thesen der Quellen, wo immer moeglich. Halte
dich an die Analyse. Keine Pervertierung des Vorgetragenen. Keine negative moralische
Bewertung der Sprecher.
Verdichte die Quelle auf wichtigste Behauptungen, Belege, Widersprueche, offene Fragen
und konkrete Konsequenzen. Keine generische Einleitung, keine ungepruefte Ausschmueckung.
```
### Audio-Prompt (Kurz, für nb2)
```
Erstelle eine KURZE deutsche Audio-Zusammenfassung fuer einen unbekannten allgemeinen
Hoerer. Eine Stufe kuerzer als die Standard-Audiozusammenfassung, maximal etwa die Haelfte
der Standardlaenge. Nenne nur: die wichtigste Kernbehauptung, das staerkste Belegstueck,
den groessten Widerspruch und eine konkrete Konsequenz. Keine Einleitung, keine
Ausschmueckung, keine privaten Namen. SPRACHE: DEUTSCH.
```
### Infografik-Prompt
```
Erstelle eine serioese, professionelle deutsche Briefing-Infografik. Nicht comicartig,
nicht verspielt. Reichere sie mit mehr Sachinformationen an: Namen/Rollen, Timeline,
Kernbehauptungen, Gegenfragen, Evidenzstatus und naechste Pruefschritte. Schreibe Namen
exakt. Unterscheide behauptet/berichtet/belegt klar. Visuell stark, aber erwachsen und
faktenorientiert.
```
## Telegram Caption Contract (PFLICHT)
```text
🔴 <STARKER TITEL IN CAPS>
<Ein Satz Teaser warum ist das wichtig, was ist der Kern.>
▶️ Audio-Briefing: <MM:SS Min.>, deutsch
🖼️ Infografik: im Video sichtbar integriert
📓 Notebook: [Briefings öffnen](<share_url>)
📺 Originalquelle: [<Titel>](<url>) (<sprachhinweis>)
Warum es zählt: <Ein kompakter Absatz max. 3 Sätze.>
```
**Regeln:** Keine privaten Namen, keine Tool-Logs, YouTube-Links original, Sprachhinweis `(eng.)`/`(de.)`/`(fr.)`, mehrere Quellen = je eine `📺`-Zeile, PDFs als separate Datei.
## MP4-Rendering
```bash
ffmpeg -y \
-loop 1 -framerate 1 -i infographic.png \
-i audio.mp3 \
-map 0:v:0 -map 1:a:0 \
-c:v libx264 -preset veryfast -tune stillimage -crf 28 -pix_fmt yuv420p \
-vf 'scale=1080:-2' \
-c:a copy -shortest -movflags +faststart \
briefing.mp4
```
**Komprimierung bei >50MB:** `-crf 32 -vf 'scale=720:-2'` statt `-crf 28 -vf 'scale=1080:-2'`
## Output-Verzeichnis-Struktur
```
<workspace>/output/
├── nb1/
│ ├── <projektname>/
│ │ ├── audio.mp3
│ │ ├── infographic.png
│ │ └── briefing.mp4
├── nb2/
│ ├── <projektname>/
│ │ ├── audio-short.mp3
│ │ ├── audio.mp3
│ │ ├── infographic.png
│ │ └── briefing.mp4
```
## Häufige Fehler
| ❌ Falsch | ✅ Richtig |
|---|---|
| Text und MP4 in getrennten Nachrichten | Eine Nachricht mit Text + Media |
| `NOTEBOOKLM_HOME` vergessen | Immer mit Profil-Pfad prefixen |
| `notebooklm use` statt `-n ID` | Immer `-n NOTEBOOK_ID` übergeben |
| Audio-Download als `.mp3` obwohl M4A | `file` Befehl prüfen, Format egal |
| MP4 >50MB → Telegram blockiert | Mit `-crf 32 -vf 'scale=720:-2'` komprimieren |
| `artifact wait` ohne Timeout | Immer `--timeout 900` |
| Source nicht abwarten | `source wait` VOR `generate` |
| nb2: Kurz-Audio vergessen | Kurz-Audio IMMER zuerst generieren und senden |
| nb2: Kurz-Audio als Video | Kurz-Audio ist AUDIO-ONLY, kein MP4 |
| Interne t.me-Links als Quelle | Original-PDF mitschicken oder öffentlichen Link finden |
## Trigger-Erkennung
- `nb1`, `+nb1` → Preset nb1
- `nb2`, `+nb2` → Preset nb2
- Quelle steht VOR dem Schlüsselwort: `URL nb1`
- Nur Quelle ohne Preset → nachfragen
## Requirements
| Komponente | Version | Zweck | Install |
|------------|---------|-------|---------|
| `notebooklm` CLI | ≥ v0.3.4 | NotebookLM API-Zugriff | Siehe Skill `notebooklm-core` |
| `ffmpeg` | aktuell | MP4-Render | static binary / `brew install ffmpeg` |
| `yt-dlp` | aktuell | YouTube-Metadaten | Binary download |
| Google-Konto | — | Auth via `notebooklm login` | — |
## V2-Änderungen (2026-07-04)
- Audio-Prompt korrigiert: **Quellen-Respekt-Prompt** (kein „Fakten von Behauptungen trennen"-Disclaimer mehr)
- Neuer Abschnitt 10: Welche Skills ein Agent braucht + Lesereihenfolge
- Alle drei Skills als **live** deklariert
- Neue Raw-Datei: [Agent Guide V2](../../../raw/other/2026-07-04_notebooklm-agent-guide-v2.md)
## Beziehung zu Winston
Das Briefing-System läuft als Backend hinter [[winston-openwebui-bot.md|Winston]] (Pit's OpenWebUI-Telegram-Bot):
```
Telegram → Winston (OpenWebUI) → notebooklm-pipelines → NotebookLM API → MP4/Audio/Infografik → Winston → Telegram
```
## Kontext im Wiki-Ökosystem
- **[[../concepts/llm/hyper-summaries-notebooklm.md]]** — NotebookLM als Generierungs-Engine
- **[[../events/ome23-evolution-ki-workflows.md]]** — "Harness > LLM"-These
- **[[winston-openwebui-bot.md]]** — Winston als Frontend
- **[[../concepts/llm/spec-driven-development-harness.md]]** — Spec-Driven Development Pattern
- **[[../concepts/hardware/cloud-exit-and-local-superiority.md]]** — Lokale Pipeline-Infrastruktur
## Evolutions-Zeitleiste
| Datum | Meilenstein |
|-------|-------------|
| 19.06.2026 | OME21: Winston+NotebookLM-Pipeline erstmals dokumentiert |
| 30.06.2026 | NotebookLM Short Video Overviews — neue Output-Option |
| 03.07.2026 | OME #7694: V1 Installationsanleitung (Presets nb1/nb2, 12-Schritt-Workflow) |
| 03.07.2026 | OME #7746: V2 korrigiert — Quellen-Respekt-Prompt, Skill-Sektion, alle Skills live |
## Quellen
- [Pit Weber, OME #7746 — Agent Guide V2](../../../raw/other/2026-07-04_notebooklm-agent-guide-v2.md) — Vollständige korrigierte Bauanleitung mit 12-Schritt-Workflow, Prompts, Caption-Contract, Fehler-Tabelle
- [Pit Weber, OME #7694 — Installationsanleitung V1](../../../raw/other/2026-07-03_notebooklm-briefing-system.md) — Ursprüngliche Version
- [Futurepedia: NotebookLM Short Video Overviews](../../../raw/youtube/2026-07-01_futurepedia-notebooklm-short-video-overviews.md)
- [OME21-01 Debrief](../../../raw/other/2026-06-19_ome21-briefing-ki-fortschritte-lokale-modelle.md)
- [OME23 Evolution der KI-Workflows](../../../raw/other/2026-07-02_ome23-evolution-ki-workflows.md)