| name | notebooklm-connector |
| description | Full integration with Google NotebookLM: read sources, add URLs and files, merge all sources into one document, generate Audio Overview, Video Overview, Briefing Doc, Study Guide, FAQ, Timeline, Mind Map, Slide Deck, Infographic, Flashcards, Quizzes, Deep Research, and Chat with citations. ALWAYS use this skill when user mentions notebook or notebooklm, shares a notebooklm.google.com link, or says dodai do notebook, vytahny z notebook, obiednai dzherela, analizui notebook. Even without the word notebooklm: use when user wants to merge research sources, generate a podcast from documents, build a knowledge base, or analyze sources with cited answers. DO NOT use for: plain Google Docs tasks with no NotebookLM involvement; запуск спільного браузера — «відкрий браузер»/collaborative browser (collaborative-browser; MODE F делегує туди); синтез неочевидних зв'язків поверх власних нотаток поза NotebookLM (knowledge-synthesizer). |
| license | Proprietary |
| metadata | {"version":"4.4.0","author":"Melania (Master Administrator)","category":"knowledge","created":"2026-03-20T00:00:00.000Z","last_updated":"2026-07-26T00:00:00.000Z"} |
NotebookLM Connector — v4.4.0
Українською-перша: відповіді, пояснення й нотатки — українською за замовчуванням; UI-шляхи NotebookLM лишаються як є. Перемикання мови лише слідом за користувачем.
Неофіційний. Не пов'язаний з, не схвалений і не спонсорований Google. «NotebookLM» — продукт і торгова марка Google; назва вжита суто референційно (опис сумісності).
🛡️ Протокол Збереження Перед Оновленням (ОБОВ'ЯЗКОВО)
Обов'язковий перед БУДЬ-ЯКОЮ зміною цього скіла. Канонічне джерело (не дублювати тут): melania — секції «🛡️ Протокол Збереження Перед Оновленням» + «Update Workflow» + «Core Rule 10 — Re-Read Before Update».
Стисло: re-read диску → порівняти версії (диск новіший → диск база) → integrity-diff → validation-mesh → safety-compliance-gate (перед пакуванням/публікацією) → backup/snapshot → merge-not-replace → bump+CHANGELOG → показати diff і чекати явного схвалення MA (Закон II).
Core Rule
NotebookLM has no public API. Known constant — never stop to explain it. Cascade.
Critical Facts
- [C] NotebookLM не має публічного API. Це причина каскаду методів доступу (MCP-емуляція, Browserbase, артефакт, ручний спосіб) замість прямого виклику офіційного API.
- [C] Ліміт вставки джерела як тексту — приблизно 500 000 символів. Понад цей обсяг джерело потрібно ділити на частини з перехресними посиланнями (cross-refs), а не вставляти одним шматком.
- [C] Slide Deck на безкоштовному тарифі виходить із водяним знаком. Studio → Slide deck → Generate додає watermark, якщо акаунт не на платному плані.
- [C] Персона чату обмежена 10 000 символів. Налаштування Chat → ⚙ → persona prompt приймає текст довжиною до 10 000 символів.
Step 0 — Pre-flight
MODES:
A READ / EXTRACT — notebooklm.google.com URL given
B ADD SOURCES — URLs, files, or text to import
C GENERATE — any Studio feature
D CHAT ANALYSIS — ask questions, cited answers
E FILES / CONTEXT — format chat context or uploads for NotebookLM
F COLLAB BROWSER — "відкрий браузер" / "collaborative browser"
METHOD PRIORITY (check in order, use first available):
1. notebooklm_* MCP tools — Python MCP, 19 tools, Google RPC, downloads .mp3/.mp4/.pdf
2. browserbase_* tools — Cloud Browser MCP, 12 tools, screenshot every action ★ Android
3. Collaborative Browser — React Artifact, MODE F, Anthropic API, BroadcastChannel
4. web_fetch — for public sources
5. React Artifact OAuth — Google cookies, all devices
6. Guided Manual — explicit request or last resort
NEVER require npm / terminal / extensions on user device.
Step 1 — Access Methods
1A — Python MCP (notebooklm_*)
Check for notebooklm_session_status or notebooklm_authenticate.
Read references/python-mcp-advantage.md for full tool list.
notebooklm_session_status → check health, days remaining, refresh guide
notebooklm_authenticate → login or confirm
By task:
open / check → open_notebook(url) # has_access check before any read
read / merge → get_all_content(url)
one source → list_sources → get_source_content(url, id)
notes → get_notes(url)
briefing → generate_briefing(url)
chat → chat_query(url, query)
add source → add_source(url, source_url)
audio / .mp3 → generate_audio(url) → download(url, "audio")
video / .mp4 → generate_video(url) → download(url, "video")
quiz → generate_quiz(url, difficulty)
flashcards → generate_flashcards(url)
mind map → generate_mind_map(url)
slide deck / .pdf → generate_slide_deck(url) → download(url, "slide-deck")
all notebooks → list_notebooks()
inject cookies → notebooklm_inject_cookies { cookies_json: "<paste>" }
1B — Browserbase Cloud Browser (browserbase_*)
★ Primary for Android. Screenshots after every action.
Setup guide: references/browserbase-android-setup.md
browserbase_authenticate { storage_json: "<cookies>" } # once
notebooklm_browse_open(url) # → screenshot
notebooklm_browse_sources(url) # extract all
notebooklm_browse_studio(url, feature) # Briefing/Audio/Quiz
notebooklm_browse_chat(url, query) # → screenshot
browserbase_screenshot() # ← always after action
Raw browser control (when needed):
browserbase_navigate(url) # go to any URL
browserbase_click(selector, by_text=true) # click by text or CSS
browserbase_type(selector, text) # fill input fields
browserbase_extract(instruction) # extract content from page
browserbase_scroll(direction) # down/up/bottom/top
browserbase_wait(selector, ms) # wait for element or timeout
1C — Collaborative Browser Artifact (MODE F)
Trigger phrases: "відкрий браузер", "collaborative browser", "спільний браузер",
or whenever web content needs interactive real-time fetching.
Делегування (канон): повний браузерний артефакт живе у скілі collaborative-browser
(v3.x: Anthropic API-навігація, i18n UI in 6 languages, мультиплеєр, Autopilot,
Command Palette, Secrets, cookie-інʼєкція тощо). Цей скіл НЕ генерує власний collaborative-browser.jsx —
активуй collaborative-browser і передай NotebookLM-контекст (URL нотатника, ціль сесії,
потрібні Quick Actions). Історичний опис фіч — references/collaborative-browser-artifact.md
(застарілий, лише архів).
1D — React Artifact + Google OAuth
Triggers: 401/403, no MCP tools, cloud agent context.
Apply frontend-design skill — "Mission Control" dark aesthetic.
States: idle → auth → extracting → done → manual_fallback.
sendPrompt() returns content automatically. Persists via window.storage.
Full component: references/universal-auth-artifact.md
🔗 Канонічні auth-патерни (cookie-видобування/інʼєкція, OAuth-схема, моніторинг сесій, AES-GCM) тепер консолідовано у скілі auth-session-manager. Кроки 1A–1F нижче — NotebookLM-специфіка; за загальними деталями авторизації звертайся туди, щоб не дублювати.
1E — Direct Fetch + Adding Sources (MODE B)
web_fetch(url) → success → Step 2 | 403 → cascade to 1A/1B/1D
Adding sources (all parallel):
webpage → web_fetch + clean | pdf → extract or link
youtube → URL direct (public) | gdoc → check sharing first
github → README + /docs
Blocked doc: continue others → request sharing → auto-return when granted
1F — Guided Manual (last resort)
Mobile: ⋮ → View source → long-tap Select All → paste
Desktop: Studio → Briefing Doc → copy → paste
Any: Screenshot → attach → Claude extracts text
Step 2 — Decision Engine
merge / combine / один документ → execute_merge()
generate / overview / studio feat. → feature_generator()
analysis / analyze / порівняй → chain_analysis()
browser / відкрий браузер → collab_browser()
sources >= 3 → Audio Overview
academic content → Study Guide
business content → Briefing Doc
dated events → Timeline
technical docs → FAQ
Step 3 — Merge All Sources
1. Collect: MCP / Browserbase / Artifact / web_fetch / uploads / chat context
2. Detect: theme → sub-themes → sections → remove duplicates
3. Output format:
.docx / "Word document" → invoke docx skill after merge → deliver both .md + .docx
.pptx / "presentation" → invoke pptx skill → theme-factory if style requested
default → Markdown
4. Build with template below
5. NotebookLM prep: <500k chars → Copied text | >500k → split with cross-refs
# [TITLE]
Compiled: [date] | Sources: [N] | Words: [N]
## Table of Contents
[auto]
## [Section — theme]
> Source: [title / URL]
[content]
## Synthesis and Key Findings
[cross-source synthesis]
## Source Index
| # | Title | Type | Origin | Date |
Step 4 — Feature Generator (Studio Survey)
Read references/notebooklm-capabilities.md FIRST — features change frequently.
Ask ALL survey questions in ONE message:
1. Goal? Learning / Research / Business / Personal
2. Audience? Myself / Team / Students / Clients
3. Time? 5 min / 15 min / deep study
4. Outputs? Audio Overview / Video Overview / Briefing Doc / Study Guide /
FAQ / Timeline / Mind Map / Slide Deck / Infographic /
Flashcards+Quiz / Deep Research / Chat analysis
5. Language? (35+ supported)
6. Persona? optional — e.g. "strict PM, Decision Memo format only"
Build plan autonomously. Provide exact UI path per feature:
AUDIO OVERVIEW Studio → Audio Overview → format (Brief/Deep Dive/Critique/Debate)
→ Customize (focus, audience) → Generate
Interactive Mode: click Join during playback → ask live questions
VIDEO OVERVIEW Studio → Video Overview → Generate (~5-10 min)
BRIEFING DOC Studio → Briefing doc → Generate (30-60 sec)
STUDY GUIDE Studio → Study guide → Generate
FAQ Studio → FAQ → Generate
TIMELINE Studio → Timeline → Generate
MIND MAP Studio → Mind map → Generate (interactive)
SLIDE DECK Studio → Slide deck → Generate (Free = watermark)
INFOGRAPHIC Studio → Infographic → Generate
FLASHCARDS+QUIZ Studio → Flashcards / Quiz → Generate
DEEP RESEARCH Studio → Deep Research (agentic — searches web beyond sources)
CHAT PERSONA Chat → ⚙ → persona prompt up to 10,000 chars
DISCOVER SOURCES + Add source → Discover Sources → topic search
End Step 4 with 5 targeted Chat queries specific to content.
Step 5 — Deep Analysis
1. Get all content (MCP / Browserbase / Artifact / manual)
2. Analyze: themes, contradictions, key insights, data points
3. Generate 5+ targeted Chat queries for NotebookLM
4. Optionally produce local Briefing Doc before adding to Notebook
Step 6 — Import to NotebookLM
Always AFTER producing output, not instead of it:
notebooklm.google.com → Notebook → + Add source → Copied text
→ Paste [file] | Title: [SUGGESTED] | Insert | Wait 30-60 sec
→ Recommended next: [feature based on content type]
Source Queue
done — processed
awaiting_access — waiting for sharing permission → auto-retry when granted
failed — paywall / 404 / unavailable
pending — queued
Behavior Rules
| Situation | Do | Never |
|---|
| 403 from Google | Cascade methods 1A→1F | Stop + explain API |
| MCP absent | Silently use Browserbase or Artifact | Report as error |
| Android user | Browserbase ★ → Cookie Editor guide → screenshots | "Not possible on mobile" |
| Cookies pasted | inject_cookies → verify → retry | Ask to use desktop |
| session days < 7 | Warn + show Android guide proactively | Wait for failure |
| notebooklm_session_status shows needs_refresh | Immediately show Cookie Editor steps | Continue silently |
| days_remaining returns negative | Session expired — block and require re-auth | Try operations anyway |
| "відкрий браузер" | Activate collaborative-browser skill (делегування MODE F) | Генерувати власний .jsx-дубль |
| Collab Browser active | Use sendPrompt() content, trust BroadcastChannel | Ignore Artifact data |
| Language switch | Apply T[lang] across all UI, persist to storage, broadcast | Mix languages |
| Page translate request | translatePage(lang) via Claude API, show translation bar | Use external service |
| Merge task | Start immediately, no questions | Ask how to get data |
| Multiple URLs | All parallel | Sequential with permission |
| Generation request | Survey (one message) → plan → exact UI steps | Guess one feature |
| Feature list unsure | Read capabilities file first | Assume old feature set |
| .docx requested | docx skill after merge | Plain markdown only |
| .pptx requested | pptx skill + theme-factory | Plain markdown only |
| Download artifact | generate → download tool → return path | Stop at "generated" |
| Blocked Google Doc | Continue others + request sharing | Stop entire operation |
References
references/notebooklm-capabilities.md — Current features, limits, source types (read before Step 4)references/python-mcp-advantage.md — 19-tool Python MCP, downloads .mp3/.mp4/.pdfreferences/browserbase-android-setup.md — Android setup, Browserbase, Smithery, agent loopreferences/android-cookie-extraction.md — Cookie Editor, Remote Debug, session refreshreferences/universal-auth-artifact.md — React + Google OAuth component (Mission Control UI)references/mcp-server-deployment.md — Render / Vercel / VPS deploy guidereferences/platform-matrix.md — Device compatibility + language support matrixreferences/collaborative-browser-artifact.md — Collab Browser i18n + feature specreferences/content-processors.md — Processing algorithms by content type
📎 Advanced Patterns (v4)
Read references/citation-workflow.md WHEN you need: citation extraction, source comparison, multi-source synthesis, export strategies.
Load only on demand — not proactively.
Зміни
- v4.4.0 (2026-07-26) — Секція Critical Facts: фактичні твердження скіла винесено окремо й протеговано [C] за Core Rule 14 (claim-evidence). Лише додавання.
- v4.3.0 (2026-07-19) — Self-Dev Wave 2 (аудит 2026-07-18): MODE F більше не генерує власний
collaborative-browser.jsx (мертвий референс на «already built» артефакт) — тонке делегування у скіл collaborative-browser з передачею NotebookLM-контексту; Behavior-рядок «відкрий браузер» відповідно [#9]; з опису знято перехоплювальні тригери «відкрий браузер/спільний браузер» (канон — collaborative-browser) і додано межу з knowledge-synthesizer [#11]; синхрон H1-банера (був v4). Делегування; власна NotebookLM-механіка незмінна.
- v4.2.3 (2026-06-26) — Stage 3: S-3
evals/ відновлено (6 реальних кейсів v3.0.0 з форензик-пошуку: read-notebook-url, add-multiple-sources, feature-generator-survey, mobile-friendly-instructions, deep-research-new-feature, context-chat-export; канон-схема). S-2 дубльовану секцію «Зміни» + дубль v4.2.0 консолідовано (вміст збережено). Відновлення + консолідація.
- v4.2.2 (2026-06-15) — B2 (safety-compliance-gate): дисклеймер неприналежності — NotebookLM (Google).
- v4.2.1 (2026-06-15) — DRY: «Протокол Збереження» → тонкий міст на канон у
melania (де-дублювання + усунення 8-варіантного дрейфу). Поведінка незмінна.
- v4.2.0 (2026-06-02) — batch source import guide; output quality control table; Pre-Update Preservation Protocol; citation-workflow reference (citation extraction, source comparison, synthesis). (консолідовано з двох записів)
- v4.0.0 (2026-06-02) —
metadata-блок (версія машиночитана) + директива «українською-перша». evals/guard уже були. (аудит Кластер 3: metadata + P9)
