/ Diretório / Playground / NotebookLM-py
← Todos os servidores ↗ GitHub
● Comunidade teng-lin ⚡ Instantâneo

NotebookLM-py

por teng-lin · teng-lin/notebooklm-py

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

Demo ao vivo

Como fica na prática

pronto

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "notebooklm-py-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/teng-lin/notebooklm-py",
        "~/.claude/skills/notebooklm-py"
      ],
      "_inferred": true
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "notebooklm-py-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/teng-lin/notebooklm-py",
        "~/.claude/skills/notebooklm-py"
      ],
      "_inferred": true
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "notebooklm-py-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/teng-lin/notebooklm-py",
        "~/.claude/skills/notebooklm-py"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "notebooklm-py-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/teng-lin/notebooklm-py",
        "~/.claude/skills/notebooklm-py"
      ],
      "_inferred": true
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "notebooklm-py-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/teng-lin/notebooklm-py",
        "~/.claude/skills/notebooklm-py"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json
{
  "context_servers": {
    "notebooklm-py-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/teng-lin/notebooklm-py",
          "~/.claude/skills/notebooklm-py"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add notebooklm-py-skill -- git clone https://github.com/teng-lin/notebooklm-py ~/.claude/skills/notebooklm-py

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

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
  1. Ingerir
    Use notebooklm-py. Crie um notebook 'Leitura T2'. Adicione os 10 PDFs em /papers/.✓ Copiado
    → Notebook criado; fontes carregadas
  2. Sintetizar
    Gere um resumo agrupado por tópico em todas as fontes.✓ Copiado
    → Síntese entre fontes
  3. Á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
  1. Carregar
    Crie um notebook a partir de /docs (recursivo). Gere FAQ.✓ Copiado
    → Output do FAQ
  2. 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

FerramentaEntradasQuando chamarCusto
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

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

AlternativaQuando usarTroca
Interface web do NotebookLMUso manual pontualSem automação; perde recursos programáticos
Pipeline RAG customizadoVocê precisa de controle total sobre os modelosMuita 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