NotebookLM Agentvaardigheid voor Claude Code

NotebookLM Claude Code Vaardigheid

Laat Claude Code rechtstreeks chatten met NotebookLM voor brondgedragen antwoorden gebaseerd op exclusief jouw geüploade documenten

Gebruik deze vaardigheid om je Google NotebookLM-notitieboeken rechtstreeks vanuit Claude Code te bevragen voor brondgedragen, op citaties gebaseerde antwoorden van Gemini. Browserautomatisering, bibliotheekbeheer, persistente authenticatie. Drastisch verminderde hallucinaties - antwoorden alleen uit jouw geüploade documenten.

Installatie • Snelle Start • Waarom NotebookLM • Hoe Het Werkt • MCP Alternatief

⚠️ Belangrijk: Alleen Lokale Claude Code

Deze vaardigheid werkt ALLEEN met lokale Claude Code installaties, NIET in de web-UI.

De web-UI voert vaardigheden uit in een sandbox zonder netwerktoegang, wat deze vaardigheid nodig heeft voor browserautomatisering. Je moet Claude Code lokaal op je computer gebruiken.

Het Probleem

Wanneer je Claude Code vertelt om "door mijn lokale documentatie te zoeken", gebeurt dit:

• Enorm tokenverbruik: Het doorzoeken van documentatie betekent dat meerdere bestanden herhaaldelijk worden gelezen
• Onnauwkeurige retrieval: Zoekt op trefwoorden, mist context en verbanden tussen documenten
• Hallucinaties: Wanneer het iets niet kan vinden, verzint het plausibel klinkende API's
• Handmatig kopiëren-plakken: Constant schakelen tussen de NotebookLM-browser en je editor

De Oplossing

Deze Claude Code Vaardigheid stelt Claude Code in staat rechtstreeks te chatten met NotebookLM — Google's brondgedragen kennisbank aangedreven door Gemini 2.5 die intelligente, gesynthetiseerde antwoorden levert exclusief uit jouw geüploade documenten.

Jouw Taak → Claude vraagt NotebookLM → Gemini synthetiseert antwoord → Claude schrijft correcte code

Geen kopieer-plakdans meer: Claude stelt vragen rechtstreeks en krijgt antwoorden direct terug in de CLI. Het bouwt diepgaand begrip op via automatische vervolgvragen, waarbij specifieke implementatiedetails, randgevallen en best practices worden verkregen.

Waarom NotebookLM, Niet Lokale RAG?

Wat Maakt NotebookLM Superieur?

1. Voorverwerkt door Gemini: Upload documenten eenmalig, krijg direct expertkennis
2. Natuurlijke taal Q&A: Niet alleen retrieval — daadwerkelijk begrip en synthese
3. Multi-bron correlatie: Verbindt informatie uit 50+ documenten
4. Citaat-onderbouwd: Elk antwoord bevat bronverwijzingen
5. Geen infrastructuur: Geen vector-DB's, embeddings of chunking-strategieën nodig

Installatie

De eenvoudigste installatie ooit:

# 1. Creëer vaardighedendirectory (als deze niet bestaat)
mkdir -p ~/.claude/skills

# 2. Kloon deze repository
cd ~/.claude/skills
git clone https://github.com/PleasePrompto/notebooklm-skill notebooklm

# 3. Dat is het! Open Claude Code en zeg:
"Wat zijn mijn vaardigheden?"

Wanneer je de vaardigheid voor het eerst gebruikt, gebeurt het volgende automatisch:

• Creëert een geïsoleerde Python-omgeving (.venv)
• Installeert alle afhankelijkheden inclusief Google Chrome
• Stelt browserautomatisering in met Chrome (niet Chromium) voor maximale betrouwbaarheid
• Alles blijft binnen de vaardighedendirectory

Opmerking: De setup gebruikt echte Chrome in plaats van Chromium voor platformonafhankelijke betrouwbaarheid, consistente browser-vingerafdruk en betere anti-detectie met Google-services

Snelle Start

1. Controleer je vaardigheden

Zeg in Claude Code:

"Welke vaardigheden heb ik?"

Claude zal je beschikbare vaardigheden tonen, inclusief NotebookLM.

2. Authenticeer met Google (eenmalig)

"Stel NotebookLM-authenticatie in"

Een Chrome-venster opent → log in met je Google-account

3. Creëer je kennisbank

Ga naar notebooklm.google.com → Creëer notitieboek → Upload je documenten:

• 📄 PDF's, Google Docs, markdown-bestanden
• 🔗 Websites, GitHub-repositories
• 🎥 YouTube-video's
• 📚 Meerdere bronnen per notitieboek

Delen: ⚙️ Delen → Iedereen met link → Kopieer

4. Voeg toe aan je bibliotheek

Optie A: Laat Claude het uitvogelen (Slim Toevoegen)

"Bevraag dit notitieboek over de inhoud en voeg het toe aan mijn bibliotheek: [jouw-link]"

Claude zal automatisch het notitieboek bevragen om de inhoud te ontdekken en het vervolgens toevoegen met passende metadata.

Optie B: Handmatig toevoegen

"Voeg dit NotebookLM toe aan mijn bibliotheek: [jouw-link]"

Claude zal vragen om een naam en onderwerpen, en het vervolgens opslaan voor toekomstig gebruik.

5. Start met onderzoeken

"Wat zegt mijn React-documentatie over hooks?"

Claude selecteert automatisch het juiste notitieboek en haalt het antwoord rechtstreeks uit NotebookLM.

Hoe Het Werkt

Dit is een Claude Code Vaardigheid - een lokale map met instructies en scripts die Claude Code kan gebruiken wanneer nodig. In tegenstelling tot de MCP-serverversie, draait dit rechtstreeks in Claude Code zonder dat een aparte server nodig is.

Belangrijkste Verschillen met MCP Server

Architectuur

~/.claude/skills/notebooklm/
├── SKILL.md              # Instructies voor Claude
├── scripts/              # Python automatiseringsscripts
│   ├── ask_question.py   # Bevraag NotebookLM
│   ├── notebook_manager.py # Bibliotheekbeheer
│   └── auth_manager.py   # Google-authenticatie
├── .venv/                # Geïsoleerde Python-omgeving (automatisch aangemaakt)
└── data/                 # Lokale notitieboekenbibliotheek

Wanneer je NotebookLM noemt of een notitieboek-URL stuurt, doet Claude:

1. Laadt de vaardigheidsinstructies
2. Voert het juiste Python-script uit
3. Opent een browser, stelt je vraag
4. Geeft het antwoord rechtstreeks aan jou terug
5. Gebruikt die kennis om te helpen met je taak

Kernfuncties

Brondgedragen Antwoorden

NotebookLM vermindert hallucinaties significant door uitsluitend te antwoorden op basis van jouw geüploade documenten. Als informatie niet beschikbaar is, geeft het onzekerheid aan in plaats van inhoud te verzinnen.

Directe Integratie

Geen kopiëren-plakken tussen browser en editor. Claude stelt vragen en ontvangt antwoorden programmatisch.

Slim Bibliotheekbeheer

Sla NotebookLM-links op met tags en beschrijvingen. Claude selecteert automatisch het juiste notitieboek voor jouw taak.

Automatische Authenticatie

Eenmalige Google-login, daarna blijft authenticatie behouden over sessies heen.

Zelfstandig

Alles draait in de vaardighedendirectory met een geïsoleerde Python-omgeving. Geen globale installaties.

Mensachtige Automatisering

Maakt gebruik van realistische typesnelheden en interactiepatronen om detectie te voorkomen.

Veelvoorkomende Commando's

Praktijkvoorbeelden

Voorbeeld 1: Werkplaatshandboek Vraag

Gebruiker vraagt: "Controleer mijn Suzuki GSR 600 werkplaatshandboek voor het type remvloeistof, motoroliespecificaties en aanhaalmoment van de achteras."

Claude doet automatisch:

• Authenticeert met NotebookLM
• Stelt uitgebreide vragen over elke specificatie
• Vraagt door wanneer de prompt "Is dat ALLES wat je moet weten?" verschijnt
• Geeft nauwkeurige specificaties: DOT 4 remvloeistof, SAE 10W-40 olie, 100 N·m aanhaalmoment achteras

Voorbeeld 2: Bouwen Zonder Hallucinaties

Jij: "Ik moet een n8n-workflow bouwen voor Gmail-spamfiltering. Gebruik mijn n8n-notitieboek."

Claude's interne proces:

→ Laadt NotebookLM-vaardigheid
→ Activeert n8n-notitieboek
→ Stelt uitgebreide vragen met vervolgvragen
→ Synthetiseert volledig antwoord uit meerdere query's

Resultaat: Werkende workflow bij eerste poging, geen debuggen van gehallucineerde API's.

Technische Details

Kerntechnologie

• Patchright: Browserautomatiseringsbibliotheek (gebaseerd op Playwright)
• Python: Implementatietaal voor deze vaardigheid
• Sluip-technieken: Mensachtige typ- en interactiepatronen

Opmerking: De MCP-server gebruikt dezelfde Patchright-bibliotheek maar via het TypeScript/npm-ecosysteem.

Afhankelijkheden

• patchright==1.55.2: Browserautomatisering
• python-dotenv==1.0.0: Omgevingsconfiguratie
• Automatisch geïnstalleerd in .venv bij eerste gebruik

Gegevensopslag

Alle gegevens worden lokaal opgeslagen in de vaardighedendirectory:

~/.claude/skills/notebooklm/data/
├── library.json       - Jouw notitieboekenbibliotheek met metadata
├── auth_info.json     - Authenticatiestatusinformatie
└── browser_state/     - Browsercookies en sessiegegevens

Belangrijke Veiligheidsopmerking:

• De data/-directory bevat gevoelige authenticatiegegevens en persoonlijke notitieboeken
• Het wordt automatisch uitgesloten van git via .gitignore
• Commit of deel NOOIT handmatig de inhoud van de data/-directory

Sessiemodel

In tegenstelling tot de MCP-server gebruikt deze vaardigheid een stateloos model:

• Elke vraag opent een nieuwe browser
• Stelt de vraag, krijgt het antwoord
• Voegt een vervolgprompt toe om Claude aan te moedigen meer vragen te stellen
• Sluit de browser onmiddellijk

Dit betekent:

• Geen persistente chatcontext
• Elke vraag is onafhankelijk
• Maar jouw notitieboekenbibliotheek blijft bestaan
• Vervolgmechanisme: Elk antwoord bevat "Is dat ALLES wat je moet weten?" om Claude te stimuleren uitgebreide vervolgvragen te stellen

Voor meerstapsonderzoek stelt Claude indien nodig automatisch vervolgvragen.

Beperkingen

Vaardigheid-Specifiek

• Alleen lokale Claude Code - Werkt niet in web-UI (sandboxbeperkingen)
• Geen sessiepersistentie - Elke vraag is onafhankelijk
• Geen vervolgcontext - Kan niet verwijzen naar "het vorige antwoord"

NotebookLM

• Snelheidslimieten - Free tier heeft dagelijkse querylimieten
• Handmatige upload - Je moet eerst documenten uploaden naar NotebookLM
• Deelvereiste - Notitieboeken moeten openbaar gedeeld worden

FAQ

Waarom werkt dit niet in de Claude web-UI? De web-UI voert vaardigheden uit in een sandbox zonder netwerktoegang. Browserautomatisering vereist netwerktoegang om NotebookLM te bereiken.

Hoe verschilt dit van de MCP-server? Dit is een eenvoudigere, op Python gebaseerde implementatie die rechtstreeks draait als een Claude Vaardigheid. De MCP-server is uitgebreider met persistente sessies en werkt met meerdere tools (Codex, Cursor, etc.).

Kan ik zowel deze vaardigheid als de MCP-server gebruiken? Ja! Ze dienen verschillende doelen. Gebruik de vaardigheid voor snelle integratie met Claude Code, gebruik de MCP-server voor persistente sessies en ondersteuning voor meerdere tools.

Wat als Chrome crasht? Voer uit: "Wis NotebookLM-browsergegevens" en probeer opnieuw.

Is mijn Google-account veilig? Chrome draait lokaal op jouw computer. Jouw inloggegevens verlaten nooit jouw computer. Gebruik een speciaal Google-account als je je zorgen maakt.

Probleemoplossing

Vaardigheid niet gevonden

# Zorg ervoor dat het op de juiste locatie staat
ls ~/.claude/skills/notebooklm/
# Zou moeten tonen: SKILL.md, scripts/, etc.

Authenticatieproblemen

Zeg: "Reset NotebookLM-authenticatie"

Browsercrashes

Zeg: "Wis NotebookLM-browsergegevens"

Afhankelijkheidsproblemen

# Handmatig opnieuw installeren indien nodig
cd ~/.claude/skills/notebooklm
rm -rf .venv
python -m venv .venv
source .venv/bin/activate  # of .venv\Scripts\activate op Windows
pip install -r requirements.txt

Disclaimer

Deze tool automatiseert browserinteracties met NotebookLM om jouw workflow efficiënter te maken. Echter, een paar vriendelijke herinneringen:

Over browserautomatisering: Hoewel ik humaniseringsfuncties heb ingebouwd (realistische typesnelheden, natuurlijke vertragingen, muisbewegingen) om de automatisering natuurlijker te laten gedragen, kan ik niet garanderen dat Google geautomatiseerd gebruik niet detecteert of markeert. Ik raad aan om een speciaal Google-account te gebruiken voor automatisering in plaats van je primaire account—denk eraan zoals webscraping: waarschijnlijk oké, maar beter veilig dan sorry!

Over CLI-tools en AI-agenten: CLI-tools zoals Claude Code, Codex en soortgelijke AI-ondersteuners zijn ongelooflijk krachtig, maar ze kunnen fouten maken. Gebruik ze alsjeblieft met zorg en bewustzijn:

• Controleer altijd wijzigingen voordat je ze commit of deployt
• Test eerst in veilige omgevingen
• Maak back-ups van belangrijk werk
• Onthoud: AI-agenten zijn assistenten, geen onfeilbare orakels

Ik heb deze tool voor mezelf gebouwd omdat ik de kopieer-plakdans tussen NotebookLM en mijn editor beu was. Ik deel het in de hoop dat het anderen ook helpt, maar ik kan geen verantwoordelijkheid nemen voor eventuele problemen, gegevensverlies of accountproblemen die kunnen optreden. Gebruik naar eigen goeddunken en oordeel.

Dat gezegd hebbende, als je problemen tegenkomt of vragen hebt, voel je vrij om een issue te openen op GitHub. Ik help graag bij het oplossen van problemen!

Credits

Deze vaardigheid is geïnspireerd op mijn NotebookLM MCP-server en biedt een alternatieve implementatie als een Claude Code Vaardigheid:

• Beide gebruiken Patchright voor browserautomatisering (TypeScript voor MCP, Python voor Vaardigheid)
• Vaardigheidsversie draait rechtstreeks in Claude Code zonder MCP-protocol
• Stateloos ontwerp geoptimaliseerd voor vaardigheidsarchitectuur

Als je nodig hebt:

• Persistente sessies → Gebruik de MCP-server
• Ondersteuning voor meerdere tools (Codex, Cursor) → Gebruik de MCP-server
• Snelle integratie met Claude Code → Gebruik deze vaardigheid

De Kern

Zonder deze vaardigheid: NotebookLM in browser → Kopieer antwoord → Plak in Claude → Kopieer volgende vraag → Terug naar browser...

Met deze vaardigheid: Claude onderzoekt rechtstreeks → Krijgt antwoorden onmiddellijk → Schrijft correcte code

Stop met de kopieer-plakdans. Begin met het krijgen van accurate, brondgedragen antwoorden rechtstreeks in Claude Code.

# Ga aan de slag in 30 seconden
cd ~/.claude/skills
git clone https://github.com/PleasePrompto/notebooklm-skill notebooklm
# Open Claude Code: "Wat zijn mijn vaardigheden?"

Gebouwd als een Claude Code Vaardigheid-aanpassing van mijn NotebookLM MCP-server

Voor brondgedragen, documentgebaseerd onderzoek rechtstreeks in Claude Code