feat: sync all plugins, skills, agents updates
New plugins: core-tools New skills: auto-expense, ticket-triage, design, security-check, aiktop-tasks, daily-digest, imap-triage, index-update, mindmap, notebooklm, proc-creator, tasks-overview, validate-component, perfex-module, report, calendar-manager New agents: design-critic, design-generator, design-lead, design-prompt-architect, design-researcher, compliance-auditor, metabase-analyst, gitea-integration-specialist Updated: all plugin configs, knowledge datasets, existing skills Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
406
gestao/skills/notebooklm/SKILL.md
Normal file
406
gestao/skills/notebooklm/SKILL.md
Normal file
@@ -0,0 +1,406 @@
|
||||
---
|
||||
name: notebooklm
|
||||
description: >
|
||||
Gestão programática completa do NotebookLM via MCP. Use when managing notebooks, adding sources,
|
||||
generating artifacts (audio, video, mindmap, report, flashcards, quiz, infographic, presentation, table),
|
||||
querying notebooks with RAG, running autonomous research, or when user mentions "notebooklm",
|
||||
"notebook", "audio overview", "podcast", "mapa mental", "questionário", "resumo", "investigação profunda",
|
||||
"adicionar fonte", "gerar artefacto".
|
||||
author: Descomplicar® Crescimento Digital
|
||||
version: 1.1.0
|
||||
user_invocable: true
|
||||
tags: [notebooklm, rag, audio, studio, research, gemini, knowledge, artifacts]
|
||||
allowed-tools: mcp__notebooklm__notebook_list, mcp__notebooklm__notebook_get, mcp__notebooklm__notebook_create, mcp__notebooklm__notebook_describe, mcp__notebooklm__notebook_rename, mcp__notebooklm__notebook_delete, mcp__notebooklm__source_add, mcp__notebooklm__source_delete, mcp__notebooklm__source_describe, mcp__notebooklm__source_get_content, mcp__notebooklm__source_sync_drive, mcp__notebooklm__source_list_drive, mcp__notebooklm__notebook_query, mcp__notebooklm__chat_configure, mcp__notebooklm__studio_create, mcp__notebooklm__studio_status, mcp__notebooklm__studio_delete, mcp__notebooklm__download_artifact, mcp__notebooklm__export_artifact, mcp__notebooklm__research_start, mcp__notebooklm__research_status, mcp__notebooklm__research_import, mcp__notebooklm__notebook_share_public, mcp__notebooklm__notebook_share_invite, mcp__notebooklm__notebook_share_status, mcp__notebooklm__refresh_auth, mcp__notebooklm__server_info
|
||||
category: knowledge
|
||||
quality_score: 90
|
||||
updated: "2026-02-24T20:00:00Z"
|
||||
---
|
||||
|
||||
# /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®
|
||||
Reference in New Issue
Block a user