Emanuel Almeida
6b3a6f2698
- All SKILL.md files now <500 lines (avg reduction 69%) - Detailed content extracted to references/ subdirectories - Frontmatter standardised: only name + description (Anthropic standard) - New skills: brand-guidelines, spec-coauthor, report-templates, skill-creator - Design skills: anti-slop guidelines, premium-proposals reference - Removed non-standard frontmatter fields (triggers, version, author, category) Plugins affected: infraestrutura, marketing, dev-tools, crm-ops, gestao, core-tools, negocio, perfex-dev, wordpress, design-media Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
395 lines
13 KiB
Markdown
395 lines
13 KiB
Markdown
---
|
|
name: notebooklm
|
|
description: Gestão programática completa do NotebookLM via MCP. Gerir notebooks, adicionar fontes, gerar artefactos (áudio, vídeo, mindmap, relatório, flashcards, quiz, infografia, apresentação), consultar via RAG, investigação autónoma. Usar quando "notebooklm", "notebook", "audio overview", "podcast", "adicionar fonte", "gerar artefacto".
|
|
disable-model-invocation: true
|
|
---
|
|
|
|
# /notebooklm - Gestão Programática NotebookLM
|
|
|
|
Motor RAG Gemini com geração de artefactos multimédia. 29 ferramentas MCP disponíveis.
|
|
|
|
---
|
|
|
|
## Notebooks Descomplicar (58 total)
|
|
|
|
> Registry actualizado via `notebook_list`. Para IDs actualizados: `mcp__notebooklm__notebook_list`.
|
|
|
|
### Tecnologia / Dev (21)
|
|
|
|
| Nome | ID | Fontes |
|
|
|------|----|--------|
|
|
| **KiviCare EHR WP** | `78621405-a5bc-433f-856f-296260a80bd9` | 166 |
|
|
| **CWP** | `0ded7bd6-69b3-4c76-b327-452396bf7ea7` | 214 |
|
|
| **WordPress Config CLI** | `fb2f26bd-8cb0-4d4c-bafc-4f1ebb51c51d` | 268 |
|
|
| **WordPress e Elementor** | `5be0d1a6-00f2-4cd9-b835-978cb7721601` | 88 |
|
|
| **Cibersegurança WordPress** | `5f60adfd-2435-4725-8c12-9c11c5f51d75` | 95 |
|
|
| **Proxmox** | `276ccdde-6b95-42a3-ad96-4e64d64c8d52` | 120 |
|
|
| **Cloud e Infraestrutura TI** | `f9a79b5a-649f-4443-afaf-7ff562b6c2e7` | 146 |
|
|
| **Claude Code** | `2876d1fe-5cea-4d98-8140-b0e1a81c6bc4` | 132 |
|
|
| **Obsidian + Claude** | `ebee9fe1-78fd-4f85-8938-f19f3ea32131` | 117 |
|
|
| **Perfex CRM** | `df4688bb-c2c0-4aba-98c1-38c3b50a353c` | 141 |
|
|
| **Dev PerfexCRM** | `80606de8-2783-4d36-b08d-5825e6f9a8da` | 44 |
|
|
| **Reonic** | `b7e61158-0717-4582-8ef2-0301be3c73ae` | 131 |
|
|
| **Remotion** | `f2b75baa-1ab1-48d3-8f7c-a6a9e516934c` | 59 |
|
|
| **n8n** | `f2c809b8-1cb5-4dd0-aa7e-be2cfb6704d1` | 66 |
|
|
| **Desenvolvimento de MCPs** | `73102308-70ef-403e-9be9-eae0cfc62d55` | 22 |
|
|
| **Programação** | `24947ffa-0019-448a-a340-2f4a275d2eb1` | 53 |
|
|
| **Open Source Top Picks** | `cabf9821-c1ff-44cb-9bfd-59bda3599792` | 163 |
|
|
| **GitHub Trends** | `922b7532-ddf3-4dba-9d3c-6d5f83b89378` | 61 |
|
|
| **Zaia** | `087d76f1-e929-49da-9e3c-4edc22b42b3f` | 28 |
|
|
| **Open WebUI** | `be6f72ac-f8ba-4337-912d-abd5dd448519` | 15 |
|
|
| **AI Code Editors** | `57d9c6c9-48ba-4d83-8f71-cc890f348a53` | 20 |
|
|
|
|
### Gestão / Negócio (13)
|
|
|
|
| Nome | ID | Fontes |
|
|
|------|----|--------|
|
|
| **Estrategia e Empreendedorismo** | `79d43410-0e29-4be1-881d-84db6bdc239a` | 107 |
|
|
| **Gestão de Operações** | `f9dc59c2-718b-4b12-bd06-095d4bfa3e34` | 41 |
|
|
| **Gestão de Projectos e Agile** | `0c9c079c-a426-486c-99eb-1564d42d37ad` | 44 |
|
|
| **Transformacao Digital e IA** | `ab876d0d-12a8-43d9-bc62-59c1c8e9d0f8` | 73 |
|
|
| **E-commerce Pratico** | `226e384e-d4bc-48f4-bb82-7927360436cc` | 63 |
|
|
| **Descomplicar** | `f29c8457-f16d-4fb3-979d-6e5901de1b20` | 23 |
|
|
| **AI Automation and Orchestration** | `929ef67b-c131-4f01-abd0-8b078491a6b7` | 5 |
|
|
| **AI Agents Intensive Course** | `f4be0e3f-4d9e-4c5c-a743-9f14427f2e43` | 5 |
|
|
| **European E-Commerce** | `8a430cf2-ed99-413d-b4bf-a1400deaf49e` | 24 |
|
|
| **Documentação WooCommerce** | `bd06acff-4b9d-44aa-b3f7-60434bbd6b49` | 3 |
|
|
| **Produtos e Serviços BD** | `c451d7b4-79fd-4a67-9149-1da38d28345e` | 3 |
|
|
| **Erxes XOS** | `10ea7de8-5777-4f18-bd2c-f58952b6047c` | 10 |
|
|
| **Zender 3** | `7095e5fa-1465-4496-b1a3-48f2e6e07f79` | 3 |
|
|
|
|
### Marketing / Media (7)
|
|
|
|
| Nome | ID | Fontes |
|
|
|------|----|--------|
|
|
| **Marketing Digital PT** | `4c595973-ba10-420a-a3bf-e4389e424ad3` | 189 |
|
|
| **Marketing Digital Avancado** | `76647e0f-3ae2-4c00-a0a8-f457aebf5655` | 78 |
|
|
| **Social Media e Branding** | `9053d0e8-dd39-460b-b5ea-e67af3e9a675` | 51 |
|
|
| **Copywriting e Persuasao** | `7b8fec17-d34f-4e3f-a8c6-8231e51f6323` | 50 |
|
|
| **Produção de Video e Youtube** | `058a896e-6c9a-4e51-ae7d-9adb2738bc5f` | 49 |
|
|
| **YouTube Monetização e Compliance** | `60a209a7-e205-4d57-a6f3-fef3de61e87a` | 30 |
|
|
| **Podcast Descomplicar** | `a5bef96b-a1af-4293-9979-5da46f8d2301` | 33 |
|
|
|
|
### Design (3)
|
|
|
|
| Nome | ID | Fontes |
|
|
|------|----|--------|
|
|
| **Design Profissional AItomatizado** | `b568b13b-0eed-48c9-b513-5c5b7ec0b102` | 244 |
|
|
| **UI/UX Design** | `081ca512-8279-4850-b2b9-dff090267482` | 28 |
|
|
| **Tipografia e Cor para Web** | `f97a0d2b-a5b3-4640-b941-3cbb184b1b81` | 41 |
|
|
|
|
### Pessoal / Filosofia (11)
|
|
|
|
| Nome | ID | Fontes |
|
|
|------|----|--------|
|
|
| **Emanuel Almeida** | `8c6c8257-bda2-433c-bf55-f40d98bfde8f` | 36 |
|
|
| **Jung** | `d5c67d7f-7fe8-4542-9e5c-22403f3193ee` | 41 |
|
|
| **Taoism** | `aea85baf-9ddf-4d79-bf07-81391a275b09` | 28 |
|
|
| **ADHD** | `a4ff3fd7-fb7c-49a1-94ff-0433193e2338` | 17 |
|
|
| **Autismo** | `66eff78e-318f-4a8b-a3c7-039a4124b1ad` | 14 |
|
|
| **Psicologia Somática** | `3410893b-16a3-4178-9091-42650a41086f` | 10 |
|
|
| **Essência de Herói** | `6dcd08e8-79d9-4ae0-b6bf-b2ee96717bf2` | 13 |
|
|
| **Auto Kintsugi** | `82a95c2f-be56-4c4a-a96f-96f6677a6991` | 10 |
|
|
| **Marcus Aurelius** | `4b986ad4-49da-4604-a423-4fcdf20dd9da` | 3 |
|
|
| **Building Viral AI Philosophy** | `7bb570b3-9dc4-4e6f-817c-aca68df59e6d` | 13 |
|
|
|
|
### Clientes / Projectos (3)
|
|
|
|
| Nome | ID | Fontes |
|
|
|------|----|--------|
|
|
| **CarStuff** | `90f0bc77-b5e4-4ddd-a07c-013a1a30b247` | 25 |
|
|
| **Solar FV Engenharia** | `03d54e00-aefa-45dc-ba01-f3864a7c3112` | 5 |
|
|
| **OpenSolar Platform** | `0082bcaf-1e17-4b84-87cc-2256b1719b55` | 4 |
|
|
|
|
---
|
|
|
|
## Comandos
|
|
|
|
| Comando | Uso |
|
|
|---------|-----|
|
|
| `/notebooklm list` | Listar todos os notebooks |
|
|
| `/notebooklm query <id> <pergunta>` | Consulta RAG num notebook |
|
|
| `/notebooklm add <id> <fonte>` | Adicionar fonte (url/file/text/drive) |
|
|
| `/notebooklm studio <id> <tipo>` | Gerar artefacto |
|
|
| `/notebooklm research <id> <tema>` | Investigação autónoma web |
|
|
| `/notebooklm create <nome>` | Criar novo notebook |
|
|
|
|
---
|
|
|
|
## Studio — Artefactos
|
|
|
|
| Tipo (`artifact_type`) | Parâmetros Chave | Output | Tempo |
|
|
|------------------------|-----------------|--------|-------|
|
|
| `audio` | `format`: deep_dive, brief, critique, debate | MP3 | 3-7 min |
|
|
| `video` | `format`: explainer, brief | MP4 | 5-12 min |
|
|
| `mind_map` | — | Markdown/JSON | <1 min |
|
|
| `report` | `report_format`: Briefing Doc, Study Guide, Blog Post | Markdown/Docs | 1-2 min |
|
|
| `flashcards` | `difficulty`: hard, easy | JSON/HTML | <1 min |
|
|
| `quiz` | `question_count`: Integer | JSON/HTML | <1 min |
|
|
| `infographic` | `orientation`: 1=Landscape, 2=Portrait | PNG/SVG | 2-4 min |
|
|
| `slide_deck` | `orientation`, `visual_style` (1-10), `language`, `length` | PDF | 2-5 min |
|
|
| `data_table` | — | CSV/JSON/Sheets | 1-2 min |
|
|
|
|
### Workflow Geração de Artefacto
|
|
|
|
```
|
|
1. studio_create(notebook_id, artifact_type, ..., confirm=True)
|
|
→ devolve artifact_id
|
|
|
|
2. POLLING: studio_status(artifact_id)
|
|
→ repetir cada 20s até status="complete"
|
|
|
|
3a. download_artifact(artifact_id) → ficheiro local (MP3/MP4/JSON/MD)
|
|
3b. export_artifact(artifact_id) → Google Docs/Sheets
|
|
```
|
|
|
|
---
|
|
|
|
## Gestão de Fontes
|
|
|
|
### Adicionar fonte
|
|
|
|
```python
|
|
# URL
|
|
source_add(notebook_id, source_type="url", url="https://...", wait=True)
|
|
|
|
# Ficheiro local (PDF, MD, TXT)
|
|
source_add(notebook_id, source_type="file", file_path="/caminho/absoluto", wait=True)
|
|
|
|
# Texto directo
|
|
source_add(notebook_id, source_type="text", text="...", title="Título", wait=True)
|
|
|
|
# Google Drive
|
|
source_add(notebook_id, source_type="drive", document_id="gdrive-id", wait=True)
|
|
```
|
|
|
|
**Regra crítica:** Usar sempre `wait=True`. Sem isso o NotebookLM reporta sucesso mas o conteúdo não está indexado.
|
|
|
|
### Actualizar fontes Drive
|
|
|
|
```python
|
|
source_sync_drive(notebook_id, confirm=True)
|
|
```
|
|
|
|
Para PDFs/URLs não Drive: `source_delete` + `source_add` da versão nova.
|
|
|
|
---
|
|
|
|
## Consulta RAG (notebook_query)
|
|
|
|
### Padrão Drill-Down para documentos extensos
|
|
|
|
```
|
|
Passo 1 — Topologia:
|
|
"Mapeia a estrutura deste documento, identifica os capítulos sobre [tema]."
|
|
|
|
Passo 2 — Cirúrgico:
|
|
"Centra a análise em [secção específica]. Detalha [aspecto concreto]."
|
|
|
|
Passo 3 — Síntese externa:
|
|
Claude agrega as respostas parciais no seu próprio contexto.
|
|
```
|
|
|
|
### Multi-notebook (sem suporte nativo)
|
|
|
|
O NotebookLM não faz queries cross-notebook. Workflow:
|
|
```
|
|
1. notebook_query(notebook_A, pergunta)
|
|
2. notebook_query(notebook_B, pergunta)
|
|
3. Claude sintetiza os dois resultados localmente
|
|
```
|
|
|
|
### Rate limiting
|
|
|
|
~50 queries/dia em contas gratuitas. Contas Workspace: sem limite documentado.
|
|
|
|
---
|
|
|
|
## Investigação Autónoma
|
|
|
|
```python
|
|
# 1. Iniciar pesquisa
|
|
research_start(
|
|
notebook_id="uuid",
|
|
query="tendências telemedicina Portugal 2026",
|
|
mode="deep", # fast (~30s, 10 fontes) | deep (~5min, 40+ fontes)
|
|
source_type="web" # web | drive
|
|
)
|
|
# → devolve task_id
|
|
|
|
# 2. Polling
|
|
research_status(task_id) # repetir até status="complete"
|
|
|
|
# 3. Importar resultados
|
|
research_import(notebook_id, task_id)
|
|
```
|
|
|
|
**Atenção:** Iniciar nova pesquisa cancela qualquer pesquisa em curso no mesmo notebook.
|
|
|
|
---
|
|
|
|
## Casos de Uso Descomplicar
|
|
|
|
### Investigação técnica de plugin/tecnologia
|
|
|
|
```
|
|
1. Scraper → MDs em Hub/Manuais/
|
|
2. source_add(files) → notebook_create ou existente
|
|
3. notebook_query drill-down → extracção de padrões
|
|
4. studio_create(mind_map) → exportar para Obsidian
|
|
5. studio_create(audio, deep_dive) → consumo em mobilidade
|
|
```
|
|
|
|
### Onboarding novo projecto
|
|
|
|
```
|
|
1. notebook_create("Cliente - NomeProjecto")
|
|
2. source_add(contratos PDF + requisitos WikiJS)
|
|
3. notebook_share_invite(emails equipa + cliente)
|
|
4. studio_create(report, "Briefing Doc") → resumo executivo
|
|
```
|
|
|
|
### Proposta comercial
|
|
|
|
```
|
|
1. notebook_query → extrair capacidades relevantes
|
|
2. studio_create(data_table) → export_artifact → Google Sheets comparativo
|
|
3. studio_create(slide_deck, orientation=1, visual_style=1, language="pt") → esqueleto apresentação
|
|
```
|
|
|
|
### Rotina /today
|
|
|
|
```
|
|
notebook_query(Gestão de Operações, "3 métricas críticas com desvios hoje")
|
|
→ studio_create(audio, brief) → MP3 para consumo rápido
|
|
```
|
|
|
|
### Questionários de validação
|
|
|
|
```
|
|
studio_create(quiz, question_count=15) → JSON
|
|
→ n8n lê JSON → cria tasks Desk CRM para engenheiros
|
|
```
|
|
|
|
---
|
|
|
|
## Gestão de Notebooks
|
|
|
|
```python
|
|
# Listar
|
|
notebook_list()
|
|
|
|
# Metadados + fontes
|
|
notebook_get(notebook_id)
|
|
|
|
# Resumo IA com keywords
|
|
notebook_describe(notebook_id)
|
|
|
|
# Criar
|
|
notebook_create(name="Nome do Notebook")
|
|
|
|
# Partilha pública
|
|
notebook_share_public(notebook_id)
|
|
|
|
# Partilha por convite
|
|
notebook_share_invite(notebook_id, email="user@domain.com")
|
|
|
|
# Eliminar (irreversível)
|
|
notebook_delete(notebook_id, confirm=True)
|
|
```
|
|
|
|
---
|
|
|
|
## Integração n8n
|
|
|
|
O NotebookLM não tem API REST pública. Comunicar via JSON-RPC para o servidor MCP local:
|
|
|
|
```
|
|
NOTEBOOKLM_MCP_TRANSPORT=http
|
|
NOTEBOOKLM_MCP_HOST=0.0.0.0
|
|
NOTEBOOKLM_MCP_PORT=8000
|
|
```
|
|
|
|
### Flows úteis
|
|
|
|
**WikiJS → NotebookLM (ingestão dinâmica):**
|
|
```
|
|
Webhook (publicação WikiJS)
|
|
→ HTTP Request: source_add(source_type="text", wait=True)
|
|
→ Notificação Slack: "Nova doc indexada no RAG"
|
|
```
|
|
|
|
**Relatório semanal de projecto:**
|
|
```
|
|
Schedule (sexta 17h)
|
|
→ Desk CRM: extrair tasks semana
|
|
→ source_add(text) → studio_create(report, "Briefing Doc")
|
|
→ Polling studio_status
|
|
→ export_artifact → Google Docs
|
|
→ Link enviado para Slack do cliente
|
|
```
|
|
|
|
**Audio após actualização de manual:**
|
|
```
|
|
Drive webhook
|
|
→ source_sync_drive
|
|
→ studio_create(audio, deep_dive)
|
|
→ Polling + download_artifact
|
|
→ Email com MP3 anexo
|
|
```
|
|
|
|
---
|
|
|
|
## Limitações
|
|
|
|
| Limitação | Workaround |
|
|
|-----------|-----------|
|
|
| ~50 queries/dia (conta gratuita) | Usar conta Workspace; fallback Dify KB |
|
|
| Sem API REST oficial | JSON-RPC via servidor MCP local |
|
|
| Sem queries cross-notebook | Claude agrega respostas de múltiplos notebooks |
|
|
| Cookies expiram (2-4 semanas) | `refresh_auth()` automático; alertar se HTTP 401/499 |
|
|
| Slides com marca de água | Pós-processamento `clean-watermark.js` via n8n |
|
|
| Ficheiros estáticos imutáveis | `source_delete` + `source_add` para actualizar |
|
|
| `research_start` exclusivo | Só uma pesquisa activa por notebook de cada vez |
|
|
| Dados de treino Gemini | Workspace Enterprise: dados isentos de treino |
|
|
|
|
---
|
|
|
|
## Autenticação
|
|
|
|
```bash
|
|
# Verificar estado
|
|
nlm login status
|
|
|
|
# Renovar tokens
|
|
mcp__notebooklm__refresh_auth()
|
|
|
|
# Versão do servidor
|
|
mcp__notebooklm__server_info()
|
|
```
|
|
|
|
Auth guardada em: `~/.notebooklm-mcp-cli/profiles/<name>/auth.json`
|
|
|
|
---
|
|
|
|
## Roadmap de Adopção
|
|
|
|
**Fase 1 — Quick wins (<1 semana)**
|
|
- [ ] Conta Google Workspace dedicada a automações
|
|
- [ ] Servidor MCP em EasyPanel (projecto: descomplicar)
|
|
- [ ] Primeiro audio overview de manual técnico
|
|
|
|
**Fase 2 — Integrações (1-4 semanas)**
|
|
- [ ] n8n: ingestão dinâmica WikiJS → NotebookLM
|
|
- [ ] n8n: relatório semanal /today automático
|
|
- [ ] Claude Code: queries drill-down nos notebooks existentes
|
|
|
|
**Fase 3 — Escala (1-3 meses)**
|
|
- [ ] Notebook por cliente (criado automaticamente no Desk CRM)
|
|
- [ ] Quizzes de onboarding injectados em tarefas Desk CRM
|
|
- [ ] Research autónomo semanal: panorama competitivo por área
|
|
|
|
---
|
|
|
|
**Versão**: 1.0.0 | **Data**: 24-02-2026 | **Autor**: Descomplicar®
|