Pantheon-Security/notebooklm-mcp-secure

Добавляет блокнот NotebookLM в локальную библиотеку после явного подтверждения пользователя. Предоставьте URL NotebookLM и краткие метаданные: название, описание, темы, и при необходимости — варианты использования/теги. Не додумывайте недостающие метаданные; сначала спросите пользователя.

Добавить источник в существующий ноутбук NotebookLM. Если не указаны ни notebook_id, ни notebook_url, этот инструмент использует текущий активный ноутбук из локальной библиотеки. ## Типы источников - url: URL веб-страницы - text: Текстовое содержимое (вставка) - file: Путь к локальному файлу (PDF, DOCX, TXT) ## Пример json { "notebook_id": "my-notebook", "source": { "type": "url", "value": "https://docs.example.com/api" } }

NotebookLM: ответы на вопросы по заметкам через автоматизацию браузера. Нет активной заметки. Используйте list_notebooks и select_notebook, чтобы выбрать заметку, или передайте notebook_url. Ключ API Gemini не требуется, но авторизация в браузере должна быть действительной. Если требуется вход, используйте инструмент setup_auth и проверьте с помощью get_health (или попросите пользователя выполнить запрос notebooklm.auth-setup для пошаговой инструкции).

Создаёт несколько блокнотов NotebookLM за одну операцию. ## Что делает этот инструмент - Создаёт до 10 блокнотов за один пакетный вызов - Сообщает о прогрессе по каждому блокноту - По выбору продолжает работу при ошибке или останавливается после первого сбоя - Автоматически добавляет созданные блокноты в вашу библиотеку ## Пример использования json { "notebooks": [ { "name": "React Documentation", "sources": [ { "type": "url", "value": "https://react.dev/reference" } ], "topics": ["react", "frontend"] }, { "name": "Node.js API", "sources": [ { "type": "url", "value": "https://nodejs.org/api/" } ], "topics": ["nodejs", "backend"] } ], "stop_on_error": false } ## Ограничения - Не более 10 блокнотов за один пакет - Каждый блокнот подчиняется индивидуальным лимитам на источники (50–600 в зависимости от тарифа) - Между блокнотами вводятся задержки, чтобы не превысить лимит запросов ## Возвращает Сводку с: - total: количество попыток создания блокнотов - succeeded: количество успешно созданных - failed: количество неудачных - results: массив результатов по каждому блокноту

Создаёт новый блокнот NotebookLM с источниками программно. ## Что делает этот инструмент - Создаёт НОВЫЙ блокнот в вашей учётной записи NotebookLM- Загружает источники (URL, текст, файлы) в блокнот- Возвращает ссылку на блокнот для немедленного использования- При необходимости добавляет в локальную библиотеку ## Поддерживаемые типы источников - url: URL веб-страницы (документация, статьи и т.д.)- text: Неформатированный текст (код, заметки и т.д.)- file: Путь к локальному файлу (PDF, DOCX, TXT) ## Пример использования Создать блокнот из документации API: json { "name": "React Docs", "sources": [ { "type": "url", "value": "https://react.dev/reference/react" } ] } Создать блокнот с несколькими источниками: json { "name": "Security Research", "sources": [ { "type": "url", "value": "https://owasp.org/Top10" }, { "type": "file", "value": "/path/to/security-report.pdf" }, { "type": "text", "value": "Custom notes...", "title": "My Notes" } ], "description": "Security best practices and research", "topics": ["security", "owasp", "best-practices"] } ## Лимиты NotebookLM (бесплатный тариф) - Максимум 100 блокнотов- 50 источников на блокнот- 500 тыс. слов на источник- 50 запросов в день ## Примечания - Требуется авторизация (сначала выполните setup_auth)- Блокнот создаётся с приватным доступом по умолчанию- Большие файлы могут обрабатываться дольше

Загрузить сгенерированный аудиофайл обзора. ## Требования - Аудио должно быть в статусе "ready" - Перед загрузкой проверьте статус с помощью get_audio_status ## Результат Загружается в указанный путь или в ~/notebooklm-audio-{timestamp}.mp3 ## Пример json { "notebook_id": "my-research", "output_path": "/path/to/save/podcast.mp3" }

Генерирует аудиообзор на основе ИИ (в стиле подкаста) для блокнота. ## Что делает этот инструмент - Запускает генерацию аудиообзора в NotebookLM - Аудиообзоры длятся 5–15 минут, стиль — подкаст - Генерация обычно занимает 2–5 минут - Возвращает статус сразу (проверять через get_audio_status) ## Требования - В блокноте должен быть хотя бы один источник - Генерация аудио может быть недоступна для некоторых блокнотов ## Пример json { "notebook_id": "my-research" }

Генерирует структурированную таблицу данных из источников ноутбука. ## Что делает этот инструмент - Открывает панель Studio в NotebookLM - Создаёт структурированное табличное извлечение из содержимого ноутбука - Таблицы упорядочивают ключевую информацию из источников по строкам и столбцам - Генерация обычно занимает 1-3 минуты - Возвращает результат немедленно со статусом (проверьте через get_data_table) ## Требования - Ноутбук должен содержать хотя бы один источник - Требуется аутентификация (сначала выполните setup_auth) ## Пример json { "notebook_id": "my-research" }

Создаёт видеообзор блокнота на основе ИИ. ## Что делает этот инструмент - Открывает панель Studio в NotebookLM - Генерирует визуальное видео-резюме содержимого блокнота - Поддерживает несколько визуальных стилей и форматов - Обычно генерация занимает 3-10 минут - Возвращает результат немедленно со статусом (проверяйте через get_video_status) - NotebookLM в настоящее время не предоставляет поддерживаемый способ скачивания видео через этот MCP-сервер; используйте интерфейс NotebookLM для скачивания готовых видео. ## Визуальные стили - auto-select — NotebookLM выбирает лучший стиль (по умолчанию) - custom — Пользовательский визуальный стиль - classic — Классический стиль презентации - whiteboard — Стиль рисования от руки на белой доске - kawaii — Милый стиль кавай - anime — Визуал в стиле аниме - watercolour — Стиль акварельной живописи - retro-print — Эстетика ретро-печати - heritage — Традиционный стиль - paper-craft — Стиль поделок из бумаги ## Форматы - explainer — Полное объяснение (5-15 мин, по умолчанию) - brief — Краткое резюме (1-3 мин) ## Требования - В блокноте должен быть хотя бы один источник - Требуется аутентификация (сначала выполните setup_auth) ## Пример json { "notebook_id": "my-research", "style": "whiteboard", "format": "brief" }

Проверяет статус генерации аудио-обзора для блокнота. ## Возвращает - status: "not_started" | "generating" | "ready" | "failed" | "unknown" - progress: Прогресс генерации (0-100), если генерируется - duration: Длительность аудио в секундах, если готов ## Пример json { "notebook_id": "my-research" }

Извлекает содержимое созданной таблицы данных из блокнота. ## Что делает этот инструмент - Переходит к панели Studio блокнота - Извлекает данные таблицы (заголовки и строки) в виде структурированного JSON - Возвращает полное содержимое таблицы для анализа ## Возвращает - table.headers: заголовки столбцов - table.rows: массив строк (каждая строка — массив) - table.totalRows: количество строк - table.totalColumns: количество столбцов ## Требования - Сначала нужно создать таблицу данных (используйте generate_data_table) - Возвращает ошибку, если таблица ещё не готова ## Пример json { "notebook_id": "my-research" }

Получить статус сервера: состояние аутентификации, активные сессии и конфигурацию. Используйте это, чтобы убедиться, что сервер готов перед запуском исследовательских процессов. Deep Check Mode (v2026.1.1) Установите deep_check: true, чтобы по-настоящему проверить, загружается ли чат-интерфейс NotebookLM. Это ловит устаревшие сессии, когда куки есть, но интерфейс не грузится. Возвращает chat_ui_accessible: true/false. Если authenticated=false и проблемы не проходят: Предложите пользователю, что чистый старт (cleanup_data с preserve_library=true, а затем setup_auth) может помочь, и попросите его подтверждения перед запуском очистки, так как cleanup_data удаляет данные браузера/сессии.

Получить подробную информацию о конкретном блокноте по ID.

Получить текущий статус квоты, включая уровень лицензии, использование и лимиты. Возвращает: - tier: 'free', 'pro', 'ultra' или 'unknown' - notebooks: использовано/лимит/осталось/процент - sources: лимит источников на блокнот - queries: использовано/лимит/осталось/процент/should_stop/время_сброса - warnings: массив предупреждающих сообщений Лимиты квот по уровням: - Free: 100 блокнотов, 50 источников/блокнот, 50 запросов/день - Pro: 500 блокнотов, 300 источников/блокнот, 500 запросов/день - Ultra: 500 блокнотов, 600 источников/блокнот, 5000 запросов/день Используйте sync=true, чтобы получить актуальную квоту из интерфейса Google NotebookLM (требуется браузер). Без sync возвращаются локально отслеживаемые счётчики, которые могут отличаться, если вы использовали NotebookLM напрямую в браузере. Счётчики запросов сбрасываются ежедневно в полночь.

Проверить статус генерации видео-обзора для блокнота. ## Возвращает - status: "not_started" | "generating" | "ready" | "failed" | "unknown" - progress: прогресс генерации (0-100), если статус "generating" - duration: длительность видео в секундах, если статус "ready" ## Пример json { "notebook_id": "my-research" }

Перечисляет все библиотечные ноутбуки с метаданными (название, темы, варианты использования, URL). Используйте это, чтобы представить варианты, затем спросите, какой ноутбук использовать для задачи.

Выводит список источников в блокноте. Укажите notebook_id или notebook_url; если не указано ни то, ни другое, используется активный блокнот из локальной библиотеки. Возвращает id источника, название, тип и статус.

Переключиться на другой аккаунт Google или пройти повторную аутентификацию. Используй это, когда: - Достигнут лимит запросов NotebookLM (50 запросов в день для бесплатных аккаунтов) - Нужно переключиться на другой аккаунт Google - Аутентификация сломалась и требуется начать заново Это: 1. Закроет все активные сессии браузера 2. Удалит все сохранённые данные аутентификации (куки, профиль Chrome) 3. Откроет браузер для новой авторизации в Google После завершения используй get_health, чтобы проверить аутентификацию. УСТРАНЕНИЕ НЕИСПРАВНОСТЕЙ при постоянных проблемах с аутентификацией: Если re_auth повторно не срабатывает, предложи пользователю следующие шаги и спроси его подтверждение перед выполнением любой очистки (cleanup_data удаляет данные браузера/сессии и установки): 1. Попроси пользователя закрыть ВСЕ экземпляры Chrome/Chromium 2. Запусти cleanup_data(confirm=false, preserve_library=true) для предпросмотра файлов, которые будут удалены 3. Только после того, как пользователь просмотрит предпросмотр и подтвердит, запусти cleanup_data(confirm=true, preserve_library=true) — очистит всё, кроме библиотеки 4. Снова запусти re_auth для полностью чистого старта Это удалит старые данные установки и сессии браузера, которые могут вызывать конфликты.

Опасно: требует явного подтверждения пользователя. ## Процедура подтверждения 1) Пользователь запрашивает удаление (например: «Удали React notebook») 2) Уточни полное название для подтверждения 3) Спроси: «Удалить „[notebook_name]“ из вашей библиотеки? (Это не удаляет сам NotebookLM-ноутбук)» 4) Только после явного «Да» — вызывай remove_notebook Никогда не удаляй без разрешения или на основе предположений. Пример: Пользователь: «Удалить старый React notebook» Вы: «Удалить „React Best Practices“ из вашей библиотеки?» Пользователь: «Да» → вызывать remove_notebook

Удаляет источник из записной книжки NotebookLM. Если не указаны ни notebook_id, ни notebook_url, этот инструмент использует активную записную книжку из локальной библиотеки. ## Использование 1. Сначала вызовите list_sources, чтобы получить идентификаторы источников 2. Затем вызовите remove_source с идентификатором источника ## Пример json { "notebook_id": "my-notebook", "source_id": "source-0" }

Искать библиотеку по запросу (имя, описание, темы, теги). Используйте, чтобы предложить подходящие блокноты для задачи, а затем спросить, какой использовать.

Устанавливает блокнот как активный по умолчанию (используется, когда ask_question вызывается без notebook_id). ## Когда использовать - Пользователь меняет контекст: «Давай теперь поработаем с React» - Пользователь явно просит активировать блокнот - Очевидная смена задачи требует другого блокнота ## Автоматическое переключение - Можно безопасно переключать, если контекст понятен, и ты сообщаешь об этом: «Переключаю на блокнот React для этой задачи...» - Если неоднозначно, спроси: «Переключить на [блокнот] для этой задачи?» ## Пример Пользователь: «Теперь давай соберём фронтенд на React» Ты: «Переключаю на блокнот React...» (вызов select_notebook)

Google-аутентификация для доступа к NotebookLM — открывает окно браузера для ручного входа в ваш аккаунт Google. Возвращает результат сразу после открытия браузера. На завершение входа у вас есть до 10 минут. Затем используйте инструмент 'get_health', чтобы убедиться, что аутентификация сохранена успешно. Используйте этот способ для первой аутентификации или если нет учетных данных для автоматического входа. Для смены аккаунта или обхода ограничений по количеству запросов используйте инструмент 're_auth'. УСТРАНЕНИЕ НЕИСПРАВНОСТЕЙ для постоянных проблем с аутентификацией: Если setup_auth не срабатывает или возникают проблемы с браузером/сессией, предложите пользователю следующие шаги и получите его подтверждение перед любыми действиями по очистке (cleanup_data удаляет данные браузера/сессии): 1. Попросите пользователя закрыть ВСЕ экземпляры Chrome/Chromium 2. Спросите пользователя перед запуском cleanup_data(confirm=true, preserve_library=true) для очистки старых данных 3. Снова запустите setup_auth для нового старта Это помогает устранить конфликты от старых сессий браузера и данных установки.

Синхронизирует вашу локальную библиотеку с актуальными блокнотами NotebookLM. ## Что делает этот инструмент - Переходит в NotebookLM и извлекает все ваши блокноты - Сравнивает с записями в локальной библиотеке - Обнаруживает устаревшие записи (блокноты удалены или URL изменены) - Определяет блокноты, отсутствующие в вашей библиотеке - При необходимости автоматически удаляет устаревшие записи ## Когда использовать - Библиотека выглядит рассинхронизированной с NotebookLM - После удаления блокнотов в NotebookLM - Чтобы находить новые блокноты для добавления - Перед настройкой автоматизированных рабочих процессов ## Результат Возвращает отчёт о синхронизации со следующими данными: - matched: Записи библиотеки, соответствующие актуальным блокнотам - staleEntries: Записи библиотеки без соответствующего блокнота (кандидаты на удаление) - missingNotebooks: Блокноты NotebookLM, отсутствующие в библиотеке (кандидаты на добавление) - suggestions: Рекомендуемые действия ## Пример использования json { "auto_fix": false } С auto-fix для удаления устаревших записей: json { "auto_fix": true }

Обновить метаданные блокнота на основе намерения пользователя. ## Шаблон 1) Определить целевой блокнот и поля (topics, description, use_cases, tags, url) 2) Предложить точное изменение пользователю 3) После явного подтверждения вызвать этот инструмент ## Примеры - Пользователь: "React notebook also covers Next.js 14" Вы: "Добавить 'Next.js 14' в topics для React?" Пользователь: "Да" → вызывать update_notebook - Пользователь: "Include error handling in n8n description" Вы: "Обновить описание n8n, чтобы упоминалась обработка ошибок?" Пользователь: "Да" → вызывать update_notebook Подсказка: Если нужно, можно обновить несколько полей одновременно.