freemcplab / Diretório / Playground / NotebookLM-py

● Comunidade teng-lin ⚡ Instantâneo

NotebookLM-py

Name: NotebookLM-py (Claude Skill)
Author: teng-lin

Opere o Google NotebookLM a partir do Claude — crie notebooks, ingira fontes, gere áudios de visão geral, incluindo recursos que a interface web esconde.

notebooklm-py é uma API Python não oficial + skill do Claude para o NotebookLM. Ele expõe CRUD de notebooks, ingestão de fontes (PDFs, URLs, YouTube) e os recursos de visão geral em áudio / mapa mental / FAQ. Inclui um CLI e uma skill de agente para que você possa dizer 'carregue estes PDFs em um notebook e me dê a visão geral em áudio' sem abrir notebooklm.google.com.

▶ Ver demo 📦 Instalar 💡 Casos de uso

Por que usar

Principais recursos

CRUD de notebooks via Python ou skill
Ingestão de múltiplas fontes (PDF, URL, YouTube)
Gere visões gerais em áudio, mapas mentais, FAQs programaticamente
Acesso a recursos que a interface web não expõe
CLI para scripts pontuais

Demo ao vivo

Como fica na prática

pronto

Instalação

Repositório do autor · Documentação oficial de Skills do Claude

Casos de uso

Usos do mundo real: NotebookLM-py

Construir um digest de pesquisa a partir de um lote de artigos

👤 Pesquisadores / analistas ⏱ ~20 min beginner

Quando usar: 10 artigos chegaram na sua caixa de entrada; você quer uma síntese rápida.

Pré-requisitos

Conta Google com acesso ao NotebookLM — Faça login uma vez via fluxo de autenticação Python

Fluxo

Ingerir

Use notebooklm-py. Crie um notebook 'Leitura T2'. Adicione os 10 PDFs em /papers/.✓ Copiado

→ Notebook criado; fontes carregadas
Sintetizar

Gere um resumo agrupado por tópico em todas as fontes.✓ Copiado

→ Síntese entre fontes
Áudio

Gere uma visão geral em áudio. Salve o MP3.✓ Copiado

→ Arquivo MP3

Resultado: 10 artigos digeridos em algo que você pode ler em 20 minutos ou ouvir caminhando.

Armadilhas

A qualidade das fontes varia — Peça atribuição por fonte na síntese

Combine com: filesystem

Gerar automaticamente um FAQ a partir da documentação do produto

👤 Product / DevRel ⏱ ~25 min beginner

Quando usar: Você tem documentação e precisa de um FAQ para usuários.

Fluxo

Carregar

Crie um notebook a partir de /docs (recursivo). Gere FAQ.✓ Copiado

→ Output do FAQ
Refinar

Remova itens do FAQ que não são realmente frequentemente perguntados. Adicione citações às seções de origem.✓ Copiado

→ FAQ citado e filtrado por relevância

Resultado: FAQ pronto para publicar.

Armadilhas

Perguntas genéricas — Forneça exemplos de perguntas reais de usuários se tiver

Combinações

Combine com outros MCPs para 10× de alavancagem

notebooklm-py-skill + filesystem

Salvar visões gerais em áudio + resumos localmente

Salve o MP3 em /research/audio/.✓ Copiado

notebooklm-py-skill + aris-research-skill

ARIS para pesquisa autônoma, NotebookLM para síntese

ARIS encontra artigos; NotebookLM os digere em uma visão geral em áudio.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
create_notebook	title	Novo projeto	1 operação NotebookLM
add_source	notebook_id, source: pdf\|url\|youtube	Construir o conjunto de fontes	1 operação + tempo de ingestão
generate_audio	notebook_id, style?	Visão geral em áudio	1 operação + render
generate_mind_map	notebook_id	Visualizar estrutura das fontes	1 operação
ask	notebook_id, question	Q&A ancorado nas fontes	1 operação

Custo e limites

O que custa rodar

Cota de API: Limitado pelos limites do plano do NotebookLM
Tokens por chamada: Tokens mínimos — a maior parte do custo é a API do NotebookLM
Monetário: Gratuito no nível gratuito do NotebookLM; pago para limites maiores
Dica: Reutilize notebooks; não crie e descarte

Segurança

Permissões, segredos, alcance

Escopos mínimos: Autenticação Google para NotebookLM

Armazenamento de credenciais: Cache local de token OAuth

Saída de dados: Google NotebookLM

Nunca conceda: Escopos OAuth de que você não precisa

Não oficial — pode quebrar se o Google mudar a surface subjacente

Solução de problemas

Erros comuns e correções

Fluxo de autenticação travado

Limpe o cache local de token e re-autentique

Ingestão de fonte falha para PDFs grandes

Divida em partes menores; o NotebookLM tem limites de tamanho por fonte

Geração de áudio na fila indefinidamente

A fila de áudio do NotebookLM pode ser lenta; tente novamente mais tarde

Alternativas

NotebookLM-py vs. outros

Alternativa	Quando usar	Troca
Interface web do NotebookLM	Uso manual pontual	Sem automação; perde recursos programáticos
Pipeline RAG customizado	Você precisa de controle total sobre os modelos	Muita engenharia vs recursos gratuitos do NotebookLM

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills