Imported from PatriotAi/ai-lab (melania-skills-ecosystem/skills/notebooklm-connector/SKILL.md). Install upstream with npx skills add PatriotAi/ai-lab --skill notebooklm-connector. Copyright stays with the author (Proprietary).

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()        # Step 3, no delay
generate / overview / studio feat. → feature_generator()   # Step 4
analysis / analyze / порівняй      → chain_analysis()      # Step 5
browser / відкрий браузер           → collab_browser()     # Step 1C

# Auto-suggest (announce first):
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

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/.pdf
• references/browserbase-android-setup.md — Android setup, Browserbase, Smithery, agent loop
• references/android-cookie-extraction.md — Cookie Editor, Remote Debug, session refresh
• references/universal-auth-artifact.md — React + Google OAuth component (Mission Control UI)
• references/mcp-server-deployment.md — Render / Vercel / VPS deploy guide
• references/platform-matrix.md — Device compatibility + language support matrix
• references/collaborative-browser-artifact.md — Collab Browser i18n + feature spec
• references/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)