notebooklm-py
Неофициальный Python API, CLI и агентский скилл для Google Gemini Notebook (NotebookLM): источники, вопросы с цитатами и генерация подкастов, видео и отчетов
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Авторизуется в аккаунте Google и работает через недокументированные API, создает и удаляет блокноты
- Режим master-token это полномочный доступ ко всему аккаунту, требует бережного хранения
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/notebooklm-pyОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Установите утилиту
pipx install notebooklm-pyБез pipx подойдет pip install notebooklm-py.
Установи CLI: uv tool install "notebooklm-py[browser]", затем notebooklm login для входа в Google. Поставь агентский скилл командой notebooklm skill install или npx skills add teng-lin/notebooklm-py. Проверь доступ командой notebooklm auth check --test --json.
Другие способы из описания автора
uv tool install "notebooklm-py[browser]"
notebooklm loginУстановка CLI в отдельное окружение и вход в Google. При первом входе автоматически скачивается Chromium около 170 МБ. Вместо uv tool можно использовать pipx.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект дает программный доступ к Gemini Notebook, бывшему NotebookLM, через Python API, CLI notebooklm и агентский скилл SKILL.md. Из кода или командной строки можно создавать блокноты, загружать источники (ссылки, PDF, YouTube, Google Drive, текст), задавать вопросы с ответами по источникам и цитатами, запускать веб-исследование и глубокий разбор с автоимпортом найденного. Отдельно генерируются аудиообзоры-подкасты, видео, слайды, инфографика, тесты, карточки, отчеты, таблицы и ментальные карты, все это скачивается локально в MP3, MP4, PDF, PNG, CSV, JSON и Markdown, часть форматов веб-интерфейс не отдает. Скилл учит агента вроде Claude Code или Codex работать через тот же CLI, а опциональный MCP-сервер в статусе превью подключает NotebookLM к MCP-клиентам, в том числе как удаленный коннектор через туннель.
Для кого. Для разработчиков, аналитиков и авторов, которым нужен автоматизируемый доступ к NotebookLM для исследований и генерации материалов.
Подходит, если
- Нужно массово загрузить источники в блокнот и получать ответы с цитатами из скрипта или агента
- Нужно генерировать подкасты, видео, отчеты или тесты по своим материалам и скачивать их пачками
- Нужно вынести тяжелый разбор корпуса документов на NotebookLM, а агентом только оркестрировать
- Нужно подключить NotebookLM к Claude Code или Codex как инструмент
Не подходит, если
- Разовая задача, которую проще сделать вручную в веб-интерфейсе NotebookLM
- Нужна стабильная поддержка: библиотека опирается на недокументированные API Google и может ломаться
Пример запроса к агенту
Создай блокнот, добавь туда эти PDF и сделай подкаст-обзор по нимОграничения
Это неофициальная библиотека, не связанная с Google, она использует недокументированные API, которые могут измениться в любой момент, при активном использовании возможны ограничения по частоте. Нужен аккаунт Google с доступом к NotebookLM и вход через браузер, для серверов и headless есть режим долговременного master-token, который дает полномочный доступ ко всему аккаунту, поэтому его советуют держать на отдельном аккаунте. Сам NotebookLM это сервис Google, из России без VPN он недоступен. CLI требует Python 3.10 и новее, для входа автоматически скачивается Chromium около 170 МБ. MCP-сервер в статусе превью, его набор инструментов может меняться между версиями.
Как отключить. Удалите CLI командой uv tool uninstall notebooklm-py или pipx uninstall notebooklm-py, либо удалите пакет из окружения проекта. Установленный скилл уберите из ~/.claude/skills/notebooklm и ~/.agents/skills/notebooklm. Файлы авторизации и профили лежат в ~/.notebooklm.
Проверка безопасности
- Авторизуется в аккаунте Google и работает через недокументированные API, создает и удаляет блокноты
- Режим master-token это полномочный доступ ко всему аккаунту, требует бережного хранения
Коротко о 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.
Частые вопросы
Это официальный инструмент Google?
Нет, проект неофициальный и не связан с Google, он работает через недокументированные API, которые могут измениться.
Как войти без браузера на сервере?
Используйте режим master-token: notebooklm login --master-token --account you@example.com, затем перенесите master_token.json в профиль. Это полномочный доступ ко всему аккаунту, держите его на отдельном аккаунте.
Похожие
Самостоятельно размещаемая база знаний с блочными ссылками и встроенным MCP-сервером для подключения AI-агентов к заметкам
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP
Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI