notebooklm-py CLI
Неофициальный Python API, CLI и агентский скилл для Google Gemini Notebook (NotebookLM): источники, вопросы с цитатами и генерация подкастов, видео и отчетов
- 20 216 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Авторизуется в аккаунте Google и работает через недокументированные API, создает и удаляет блокноты
- Режим master-token это полномочный доступ ко всему аккаунту, требует бережного хранения
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/notebooklm-pyОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Авторизуется в аккаунте Google и работает через недокументированные API, создает и удаляет блокноты
- Режим master-token это полномочный доступ ко всему аккаунту, требует бережного хранения
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
notebooklm-py входит в аккаунт Google через браузер Playwright или через уже вошедший Chrome, сохраняет сессию в профиле и дальше вызывает внутренние методы NotebookLM, который теперь называется Gemini Notebook. Командами notebooklm create, source add и ask вы создаете блокнот, загружаете ссылки, PDF, YouTube и файлы Drive и получаете ответы с цитатами по этим источникам. Команда generate строит аудиообзор в четырех форматах, видео, презентацию, инфографику, тест, карточки, отчет, таблицу и ментальную карту, а download сохраняет результат в MP3, MP4, PDF, PPTX, PNG, CSV, JSON или Markdown, в том числе пачкой. Тот же функционал доступен из асинхронного Python API, из локального REST-сервера и из MCP-сервера в статусе превью. Скилл ставится командой notebooklm skill install в ~/.claude/skills и ~/.agents/skills или через npx skills add.
Для кого. Для разработчиков, аналитиков и авторов, которым нужен автоматизируемый доступ к NotebookLM для исследований и генерации материалов.
Подходит, если
- У вас папка с тридцатью PDF по теме диссертации или аудита, и нужно получить ответы с цитатами, не тратя токены агента на чтение всего корпуса
- Нужно по одному набору документов получить подкаст, презентацию в PPTX и набор карточек для Anki через generate и download
- Ночью по расписанию (cron, launchd) нужно собирать аудиобрифинг: auth refresh --quiet держит сессию живой, generate audio делает выпуск
- Вы ведете заметки в Obsidian и запускаете CLI из корня хранилища, чтобы отчеты и JSON ментальных карт попадали в файлы
- На сервере или в CI нужна работа без браузера: режим master-token выдает свежие cookies по запросу
Не подходит, если
- Нужно один раз превратить статью в подкаст: быстрее сделать это руками в веб-интерфейсе NotebookLM
- Вам нужны гарантии стабильности и поддержка Google: библиотека неофициальная и опирается на внутренние методы, которые могут измениться без предупреждения
- Нужны только вопросы к готовым блокнотам из Claude Code: у NotebookLM Claude Code Skill набор проще, а Gemini Notebook CLI из раздела MCP покрывает подкасты, видео и отчеты через другой клиент
- Материалы нельзя загружать в сервис Google: библиотека отправляет источники в NotebookLM, для закрытых документов нужен локальный поиск без облака
Пример запроса к агенту
Создай блокнот «Аудит договоров 2026», добавь все PDF из папки ./contracts, спроси, какие пункты о неустойке встречаются чаще всего, ответ сохрани как заметку и сделай аудиообзор формата critiqueОграничения
Доступ: широкий. Вход идет через браузер или cookies вашего Chrome, а режим master-token дает долговременный полный доступ ко всему аккаунту Google, поэтому авторы советуют отдельный аккаунт и защиту профиля. Библиотека использует недокументированные API: они могут измениться, а при активной работе включаются ограничения по частоте. Нужен Python 3.10 или новее, при первом входе скачивается Chromium около 170 МБ. Сервис Google из России может быть недоступен, это зависит от вашей сети. Опциональный backend android требует отдельной установки и тоже работает через master-token. MCP-сервер в статусе превью, набор инструментов между версиями меняется. Лицензия MIT, платных частей у библиотеки нет, но лимиты самого NotebookLM зависят от вашего тарифа Google.
Как отключить. Удалите CLI командой uv tool uninstall notebooklm-py или pipx uninstall notebooklm-py, либо удалите пакет из окружения проекта. Установленный скилл уберите из ~/.claude/skills/notebooklm и ~/.agents/skills/notebooklm. Файлы авторизации и профили лежат в ~/.notebooklm.
Частые вопросы
Это официальный инструмент Google?
Нет, проект неофициальный и не связан с Google, он работает через недокументированные API, которые могут измениться. Авторы называют его подходящим для прототипов, исследований и личных проектов.
Как войти без браузера на сервере?
Используйте режим master-token: notebooklm login --master-token --account you@example.com, затем перенесите master_token.json в профиль. Это полномочный доступ ко всему аккаунту, держите его на отдельном аккаунте.
Как установить и войти?
Выполните uv tool install "notebooklm-py[browser]" или то же через pipx, затем notebooklm login. При первом запуске скачается Chromium и откроется окно входа в Google. Если вы входите уже вошедшим Chrome, есть вариант notebooklm login --browser-cookies chrome.
Как проверить, что вход сработал?
Команда notebooklm auth check --test --json должна вернуть статус ok. После этого notebooklm list покажет ваши блокноты.
Чем это отличается от веб-интерфейса NotebookLM?
Помимо автоматизации из кода и агента, библиотека умеет то, чего нет в интерфейсе: пакетную выгрузку артефактов, экспорт тестов и карточек в JSON, Markdown и HTML, получение полного текста источника, правку отдельных слайдов запросом и выгрузку презентации в PPTX.
Что делать, если playwright install chromium падает на Linux?
README сообщает об ошибке TypeError: onExit is not a function и отсылает к разделу Linux в docs/troubleshooting.md. Альтернатива без Playwright: войти через cookies браузера командой login --browser-cookies или через master-token.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыGemini Notebook CLI и MCP
Gemini Notebook CLI & MCP Server
Программный доступ к Gemini Notebook (бывший NotebookLM) через CLI и MCP: блокноты, источники, подкасты, видео, отчеты и исследования из агента
Скилл и MCP-сервер для Claude Code: Google NotebookLM создает блокноты из ссылок и файлов, отвечает с цитатами и выдает подкасты, слайды и тесты
Awesome NotebookLM Prompts
awesome-notebooklm-prompts
Подборка сильнейших промптов для слайдов в Google NotebookLM из заметок, блогов, WeChat, RED и X, с источником у каждого примера
Восемь скиллов Claude Code для Obsidian: заметки Granola, NotebookLM, задачи TaskNotes, память о сессиях, выгрузка диалогов
Двадцать два отдельных скилла: Notion, Todoist, Tavily, Context7, генерация картинок, конвертация документов в Markdown
Набор бытовых скиллов для агента: веб-поиск, автоматизация браузера, Gmail, Google Календарь и Диск, расшифровка речи и субтитры YouTube
Из блога
Коротко о README
README описывает notebooklm-py как всеобъемлющий скилл и неофициальный Python API для Gemini Notebook, бывшего NotebookLM, с полным программным доступом к его возможностям через Python, CLI, MCP и агентов. Перечислены сценарии: вынос тяжелого разбора на NotebookLM ради экономии токенов, память для агентов между сессиями, ответы с цитатами по своим источникам, генерация и массовое скачивание материалов, запуск по расписанию и удаленный доступ с телефона. Установка CLI через uv tool или pipx с последующим notebooklm login, библиотека ставится из PyPI, есть режимы авторизации через браузер, импорт cookies и долговременный master-token. Отдельно описаны опциональный бэкенд Android на gRPC и превью MCP-сервера. Лицензия MIT.