---
title: NotebookLM päringud
description: Pärib Google NotebookLM märkmikest allikapõhiseid ja viidetega vastuseid.
category: Marketing
sublabel: Sisu
author: AgriciDaniel
tags: 
license: MIT
source: https://github.com/AgriciDaniel/claude-blog
---

# Blog NotebookLM: allikapõhine uurimistöö sinu dokumentidest

Päri Google NotebookLM-i märkmikke otse Claude Code'ist, et saada
Geminilt viidetega varustatud vastuseid. Iga küsimus avab peata brauserisessiooni, hangib
vastuse sinu üleslaetud dokumentidest ja sulgeb selle. Vastused on
allikapõhised mudeli vastused, mitte tõe tõendus: üleslaetud dokumendid võivad olla
esmased või teisesed ja vastus võib ikkagi konteksti välja jätta.

Vastused annavad kasutatavat päritolu ainult siis, kui tagastatud viide tuvastab
kontrollitava aluseks oleva allika. Pane kirja püsiv allika-URL ja avaldamis-,
uuringuperioodi- või hankimiskuupäev, kui see detail mõjutab kontrollimist või
tõlgendamist. Kasuta tekstisisese viitena aluseks oleva allika pealkirja. Ära
viita avaliku sisu kirjanduse kirjena privaatsele NotebookLM-i URL-ile.

## Kiirülevaade

| Käsk | Mida see teeb |
|---------|-------------|
| `/blog notebooklm ask <question>` | Päri märkmikust allikapõhiseid vastuseid |
| `/blog notebooklm discover <url>` | Avasta nutikalt märkmiku sisu enne kataloogimist |
| `/blog notebooklm library list` | Loetle kõik kogus olevad märkmikud |
| `/blog notebooklm library add <url>` | Lisa märkmik kogusse |
| `/blog notebooklm library search <query>` | Otsi märkmikke märksõna järgi |
| `/blog notebooklm library remove <id>` | Eemalda märkmik kogust |
| `/blog notebooklm setup` | Ühekordne Google'i autentimine (brauser nähtaval) |
| `/blog notebooklm status` | Kontrolli autentimise olekut |
| `/blog notebooklm cleanup` | Puhasta brauseri olek (säilitab kogu) |

## Eeldused

- NotebookLM-i ligipääsuga Google'i konto
- Python 3.11+ (venv-i haldab automaatselt `run.py`)
- Google Chrome (paigaldatakse esmakäivitusel automaatselt Patchrighti kaudu)
- Ühekordne autentimise seadistus (interaktiivne Google'i sisselogimine nähtavas brauseris)

## Kasuta run.py mähist

Kutsu skripte ainult läbi run.py mähise: `python3 scripts/run.py [script]`:

```bash
# CORRECT:
python3 scripts/run.py auth_manager.py status
python3 scripts/run.py ask_question.py --question "..."

# Do not call files under scripts/ directly. The wrapper owns venv setup.
```

`run.py` mähis loob automaatselt `.venv`, paigaldab sõltuvused,
seadistab Chrome'i ja käivitab sihtskripti.

## Autentimise kontroll (värava muster)

Enne iga päringutoimingut kontrolli autentimist:

```bash
python3 scripts/run.py auth_manager.py status
```

- Kui autenditud: jätka päringuga
- Kui pole autenditud: teavita kasutajat ja juhata seadistusse:
  „NotebookLM nõuab Google'i sisselogimist. Autentimiseks käivita `/blog notebooklm setup`."
- **Kui kutsutakse sisemiselt** (blog-write'ist või blog-researcher'ist): tagasta vaikselt
  ilma veata, kui pole autenditud. Ära kunagi blokeeri kirjutamise töövoogu.

## Seadistuse töövoog

Käsu `/blog notebooklm setup` jaoks:

```bash
# Opens a visible browser for manual Google login (one-time)
python3 scripts/run.py auth_manager.py setup
```

Ütle kasutajale: „Avaneb brauseriaken. Palun logi sisse oma Google'i kontole."
Autentimine püsib brauseriprofiili + küpsiste sisestamise kaudu (hübriidlähenemine).

Muud autentimiskäsud:
```bash
python3 scripts/run.py auth_manager.py status   # Check auth
python3 scripts/run.py auth_manager.py reauth   # Re-authenticate
python3 scripts/run.py auth_manager.py clear     # Clear all auth data
```

## Päringu töövoog

Käsu `/blog notebooklm ask <question>` jaoks:

### Samm 1: kontrolli autentimist
Tee autentimise kontroll (vt värava muster ülal). Kui pole autenditud, juhata seadistusse.

### Samm 2: lahenda märkmik
Määra, millist märkmikku pärida:
- Kui `--notebook-url` on antud: valideeri, et see on NotebookLM-i märkmiku URL, seejärel kasuta seda
- Kui `--notebook-id` on antud: otsi kogust üles
- Kui ei kumbagi: kasuta kogu aktiivset märkmikku
- Kui aktiivset märkmikku pole: näita kogu ja palu kasutajal valida

### Samm 3: esita küsimus
```bash
# Basic query (uses active notebook)
python3 scripts/run.py ask_question.py --question "Your question here"

# Query specific notebook by ID
python3 scripts/run.py ask_question.py --question "..." --notebook-id notebook-id

# Query by URL directly
python3 scripts/run.py ask_question.py --question "..." --notebook-url "https://..."

# JSON output (for internal/programmatic use)
python3 scripts/run.py ask_question.py --question "..." --json

# Show browser for debugging
python3 scripts/run.py ask_question.py --question "..." --show-browser
```

### Samm 4: analüüsi ja küsi edasi
Iga vastus lõpeb jätkuviibaga. **Nõutav käitumine:**
1. **PEATU**: ära vasta kasutajale kohe
2. **ANALÜÜSI**: võrdle vastust kasutaja algse sooviga
3. **TUVASTA LÜNGAD**: määra, kas on vaja rohkem infot
4. **KÜSI EDASI**: kui lünki on, esita kohe jätkuküsimus
5. **KORDA**: jätka, kuni info on täielik
6. **SÜNTEESI**: kombineeri kõik vastused enne kasutajale vastamist

## Nutika avastamise töövoog

Käsu `/blog notebooklm discover <url>` jaoks:

Kui lisad märkmiku, teadmata selle sisu, päri seda esmalt:

```bash
# Step 1: Discover content
python3 scripts/run.py ask_question.py \
  --question "What is the content of this notebook? What topics are covered? Provide a complete overview briefly and concisely" \
  --notebook-url "<URL>"

# Step 2: Add with discovered metadata
python3 scripts/run.py notebook_manager.py add \
  --url "<URL>" \
  --name "<Based on content>" \
  --description "<Based on content>" \
  --topics "<Extracted topics>"
```

Ära arva kirjeldusi; avasta või küsi kasutajalt.

## Kogu haldamine

```bash
# List all notebooks
python3 scripts/run.py notebook_manager.py list

# Add notebook (all params required -- discover or ask user!)
python3 scripts/run.py notebook_manager.py add \
  --url "https://notebooklm.google.com/notebook/..." \
  --name "Descriptive Name" \
  --description "What this notebook contains" \
  --topics "topic1,topic2,topic3"

# Search by keyword
python3 scripts/run.py notebook_manager.py search --query "keyword"

# Set active notebook
python3 scripts/run.py notebook_manager.py activate --id notebook-id

# Remove notebook
python3 scripts/run.py notebook_manager.py remove --id notebook-id

# Library statistics
python3 scripts/run.py notebook_manager.py stats
```

## Sisemine API (blog-write / blog-researcher jaoks)

Kui kutsutakse Task-alamagendina blog-write'ist või blog-researcher'ist:

**Sisend** (annab kutsuv oskus):
- `question`: blogiteemaga seotud uurimisküsimus
- `notebook_id` või `notebook_url`: millist märkmikku pärida
- `context`: "internal" (annab märku sujuvast tagavararežiimist)

**Protsess:**
1. Kontrolli autentimise olekut: kui pole autenditud, tagasta vaikselt tühi tulemus
2. Päri märkmikku uurimisküsimusega
3. Parsi ja tagasta struktureeritud vastus

**Väljund** (tagastatakse kutsuvale oskusele):
```markdown
### NotebookLM Research
- **Source:** [Notebook name]
- **Question:** [What was asked]
- **Answer:** [Source-grounded response from user's documents]
- **Underlying Source:** [Public source URL or document identifier]
- **Underlying Source Date:** [Publication date or retrieval date]
- **Source Quality:** [Tier 1-3 after classifying the underlying document]
```

**Sujuv tagavara:** Kui autentimine puudub või päring ebaõnnestub, tagasta kohe
ilma veata. Kutsuv töövoog jätkab WebSearch-põhise uurimistööga.
Ära kunagi blokeeri blog-write'i ega blog-rewrite'i sellepärast, et NotebookLM pole saadaval.

## Andmete salvestamine

Kõik andmed salvestatakse oskuse kausta sisse:
- `data/library.json`: märkmike metaandmed ja kogu
- `data/auth_info.json`: autentimise olek
- `data/browser_state/`: Chrome'i profiil koos küpsistega

**Turvalisus:** Kõik andmekaustad on gitignore'itud. Ära kunagi committi autentimis- ega brauseriolekut.

Brauseri elutsükkel ja autenditud konteksti isolatsioon on koondatud
faili `scripts/browser_session.py`. Käsuskriptid peavad kasutama seda abilist, mitte
avama täiendavat püsivat profiili ega kopeerima küpsiseid teise faili.

## Vigade käsitlemine

| Viga | Lahendus |
|-------|-----------|
| Pole autenditud | Käivita `/blog notebooklm setup` |
| ModuleNotFoundError | Kasuta alati `run.py` mähist |
| Brauseri kokkujooksmine | `cleanup_manager.py --confirm --preserve-library`, seejärel autendi uuesti |
| Päringulimiit (50/päev) | Oota keskööni PST järgi või vaheta Google'i kontot |
| Märkmikku ei leitud | Kontrolli käsuga `notebook_manager.py list` |
| Päringu aegumine (120s) | Proovi uuesti lihtsama küsimusega või `--show-browser` silumiseks |
| MCP pole saadaval (sisemine) | Tagasta vaikselt: kirjutamise töövoog kasutab WebSearchi |

## Piirangud

- Sessioon ei püsi (iga küsimus = uus brauserisessioon)
- Päringulimiidid tasuta Google'i kontodel (50 päringut/päevas)
- Vaja on käsitsi üleslaadimist (kasutaja peab lisama dokumendid NotebookLM-i veebiliidesesse)
- Brauseri lisakoormus (paar sekundit küsimuse kohta käivituseks + sulgemiseks)
- Ainult kohalik Claude Code (pole saadaval veebiliideses)

## Viitedokumentatsioon

Lae vastavalt vajadusele: ÄRA lae kõike käivitusel:
- `references/commands.md`: täielikud CLI-käsud, parameetrid ja töövoomustrid
- `references/troubleshooting.md`: vealahendused, taastamisprotseduurid, silumine