notebooklm-py
teng-lin/notebooklm-pyПолный программный доступ к функциям Google NotebookLM через Python, CLI и AI-агентов (Claude Code, Codex). Поддерживает генерацию подкастов, слайдов, квизов, экспорт данных и возможности, недоступные в веб-интерфейсе.
Установка
npx skills add teng-lin/notebooklm-pyREADME
notebooklm-py
Комплексный скилл для NotebookLM и неофициальный Python API. Полный программный доступ к функциям NotebookLM — включая возможности, недоступные в веб-интерфейсе — через Python, CLI и AI-агентов, таких как Claude Code, Codex и OpenClaw.
Исходный код и разработка: https://github.com/teng-lin/notebooklm-py
⚠️ Неофициальная библиотека — используйте на свой страх и риск
Библиотека использует недокументированные Google API, которые могут измениться без предупреждения.
- Не аффилирована с Google — это сообщественный проект
- API могут сломаться — Google может изменить внутренние эндпоинты в любой момент
- Действуют ограничения по частоте запросов — интенсивное использование может быть замедлено
Лучше всего подходит для прототипов, исследований и личных проектов. Советы по отладке — в разделе Troubleshooting.
Что можно построить
🤖 Инструменты для AI-агентов — интегрируйте NotebookLM в Claude Code, Codex и другие LLM-агенты. В комплекте идёт корневой скилл NotebookLM для GitHub и обнаружения через npx skills add, локальная поддержка notebooklm skill install для Claude Code и директорий скиллов .agents, а также руководство для Codex на уровне репозитория в AGENTS.md.
📚 Автоматизация исследований — массовый импорт источников (URL, PDF, YouTube, Google Drive), выполнение веб-запросов и запросов к Drive с автоимпортом, программное извлечение инсайтов. Создавайте воспроизводимые исследовательские пайплайны.
🎙️ Генерация контента — создавайте Audio Overview (подкасты), видео, слайд-деки, квизы, карточки для запоминания, инфографику, таблицы данных, ментальные карты и учебные руководства. Полный контроль над форматами, стилями и выводом.
📥 Загрузка и экспорт — скачивайте все сгенерированные артефакты локально (MP3, MP4, PDF, PNG, CSV, JSON, Markdown). Экспорт в Google Docs/Sheets. Возможности, недоступные в веб-интерфейсе: пакетная загрузка, экспорт квизов и карточек в нескольких форматах, извлечение JSON ментальных карт.
Три способа использования
| Метод | Лучше всего подходит для |
|---|---|
| Python API | Интеграция в приложения, асинхронные воркфлоу, кастомные пайплайны |
| CLI | Shell-скрипты, быстрые задачи, CI/CD-автоматизация |
| Интеграция с агентами | Claude Code, Codex, LLM-агенты, автоматизация на естественном языке |
Возможности
Полное покрытие NotebookLM
| Категория | Возможности |
|---|---|
| Ноутбуки | Создание, список, переименование, удаление |
| Источники | URL, YouTube, файлы (PDF, текст, Markdown, Word, аудио, видео, изображения), Google Drive, вставленный текст; обновление, получение руководства/полного текста |
| Чат | Вопросы, история разговора, кастомные персоны |
| Исследования | Веб-агенты и агенты Drive (быстрый/глубокий режим) с автоимпортом |
| Публикация | Публичные/приватные ссылки, права пользователей (просмотр/редактирование), управление уровнем доступа |
Генерация контента (все типы NotebookLM Studio)
| Тип | Параметры | Формат загрузки |
|---|---|---|
| Audio Overview | 4 формата (deep-dive, brief, critique, debate), 3 длины, 50+ языков | MP3/MP4 |
| Video Overview | 3 формата (explainer, brief, cinematic), 9 визуальных стилей, плюс отдельный алиас CLI cinematic-video | MP4 |
| Слайд-дек | Подробный или формат для презентатора, настраиваемая длина; редактирование отдельных слайдов | PDF, PPTX |
| Инфографика | 3 ориентации, 3 уровня детализации | PNG |
| Квиз | Настраиваемое количество и сложность | JSON, Markdown, HTML |
| Карточки для запоминания | Настраиваемое количество и сложность | JSON, Markdown, HTML |
| Отчёт | Краткий документ, учебное руководство, пост в блог или кастомный промпт | Markdown |
| Таблица данных | Кастомная структура через естественный язык | CSV |
| Ментальная карта | Интерактивная иерархическая визуализация | JSON |
Возможности сверх веб-интерфейса
Эти функции доступны через API/CLI, но не представлены в веб-интерфейсе NotebookLM:
- Пакетная загрузка — скачивайте все артефакты одного типа за раз
- Экспорт квизов и карточек — получайте структурированный JSON, Markdown или HTML (веб-интерфейс показывает только интерактивный вид)
- Извлечение данных ментальных карт — экспорт иерархического JSON для инструментов визуализации
- Экспорт таблиц данных в CSV — скачивайте структурированные таблицы как электронные таблицы
- Слайд-дек в формате PPTX — скачивайте редактируемые файлы PowerPoint (веб-интерфейс предлагает только PDF)
- Редактирование слайдов — изменяйте отдельные слайды с помощью промптов на естественном языке
- Кастомизация шаблонов отчётов — добавляйте дополнительные инструкции к встроенным шаблонам форматов
- Сохранение чата в заметки — сохраняйте ответы на вопросы или историю разговора как заметки ноутбука
- Доступ к полному тексту источников — получайте индексированное текстовое содержимое любого источника
- Программное управление публикацией — управляйте правами без использования интерфейса
Установка
# Базовая установка
pip install notebooklm-py
# С поддержкой входа через браузер (требуется при первоначальной настройке)
pip install "notebooklm-py[browser]"
playwright install chromiumЕсли playwright install chromium завершается ошибкой TypeError: onExit is not a function, смотрите обходное решение для Linux в разделе Troubleshooting.
Установка для разработки
Для контрибьюторов или тестирования нереализованных функций:
pip install git+https://github.com/teng-lin/notebooklm-py@main
⚠️ Ветка main может содержать нестабильные изменения.