teng-lin/notebooklm-py v0.2.0

on GitHub

[0.2.0] - 2026-01-14

Added

• Source fulltext extraction - Retrieve the complete indexed text content of any source
  • New client.sources.get_fulltext(notebook_id, source_id) Python API
  • New source fulltext <source_id> CLI command with --json and -o output options
  • Returns SourceFulltext dataclass with content, title, URL, and character count
• Chat citation references - Get detailed source references for chat answers
  • AskResult.references field contains list of ChatReference objects
  • Each reference includes source_id, cited_text, start_char, end_char, chunk_id
  • Use notebooklm ask "question" --json to see references in CLI output
• Source status helper - New source_status_to_str() function for consistent status display
• Quiz and flashcard downloads - Export interactive study materials in multiple formats
  • New download quiz and download flashcards CLI commands
  • Supports JSON, Markdown, and HTML output formats via --format flag
  • Python API: client.artifacts.download_quiz() and client.artifacts.download_flashcards()
• Extended artifact downloads - Download additional artifact types
  • New download report command (exports as Markdown)
  • New download mind-map command (exports as JSON)
  • New download data-table command (exports as CSV)
  • All download commands support --all, --latest, --name, and --artifact selection options

Fixed

• Regional Google domain authentication - SID cookie extraction now works with regional Google domains (e.g., google.co.uk, google.de, google.cn) in addition to google.com
• Artifact completion detection - Media URL availability is now verified before reporting artifact as complete, preventing premature "ready" status
• URL hostname validation - Use proper URL parsing instead of string operations for security

Changed

• Pre-commit checks - Added mypy type checking to required pre-commit workflow

Install: pip install notebooklm-py==0.2.0

Full Changelog: v0.1.4...v0.2.0