feat(marketing): adiciona plugin marketing (agents, skills, knowledge e metadados do projeto)

2026-10-28 16:09:09 +00:00
parent e43fec3bd9
commit 13c39d8000
96 changed files with 9733 additions and 0 deletions
@@ -0,0 +1,175 @@
+---
+name: youtube
+description: Gestao e optimizacao de canais YouTube. Estrategia de conteudo, SEO, thumbnails e analytics.
+layer: wiki
+---
+
+# /youtube - YouTube Complete Toolkit
+
+Comando para extrair transcricoes, metadados e estrategia de crescimento de canais YouTube. Best practices 2026.
+
+---
+
+## Contexto NotebookLM
+
+ANTES de executar, consultar notebooks para contexto especializado:
+
+| Notebook | ID | Consultar quando |
+|----------|-----|-----------------|
+| Producao de Video e YouTube | `058a896e` | Sempre |
+| YouTube Monetizacao e Compliance | `60a209a7` | Para questoes de monetizacao |
+
+```
+mcp__notebooklm__notebook_query({
+  notebook_id: "058a896e-6c9a-4e51-ae7d-9adb2738bc5f",
+  query: "<adaptar ao contexto>"
+})
+
+mcp__notebooklm__notebook_query({
+  notebook_id: "60a209a7-e205-4d57-a6f3-fef3de61e87a",
+  query: "<adaptar ao contexto>"
+})
+```
+
+---
+
+## Arquitectura v3.0.0
+
+| Funcionalidade | Metodo | Estado | Notas |
+|----------------|--------|--------|-------|
+| **Pesquisa** | MCP youtube-research | OK | Filtros avancados, regiao, legendas |
+| **Estatisticas** | MCP youtube-research | OK | Videos, canais, comparacoes |
+| **Comentarios** | MCP youtube-research | OK | Com replies e likes |
+| **Trending** | MCP youtube-research | OK | Por regiao e categoria |
+| **Transcricoes** | Script local | OK | `youtube_extractor.py` (MCP nao funciona) |
+| **Upload** | MCP youtube-uploader | Requer Auth | OAuth necessario |
+| **Estrategia Crescimento** | Skill internal | OK | Analise algoritmo, optimizacoes |
+
+---
+
+## MCP youtube-research (8/12 funcionais)
+
+### Ferramentas Funcionais
+
+| Ferramenta | Funcao | Parametros |
+|------------|--------|------------|
+| `search-videos` | Pesquisa avancada | query*, maxResults, regionCode, order, videoDuration |
+| `get-video-stats` | Estatisticas video | videoId* |
+| `get-video-comments` | Comentarios + replies | videoId*, maxResults, order, includeReplies |
+| `get-channel-stats` | Estatisticas canal | channelId* |
+| `analyze-channel-videos` | Analise performance | channelId*, maxResults, sortBy |
+| `get-trending-videos` | Trending por regiao | regionCode, maxResults, categoryId |
+| `get-video-categories` | Categorias disponiveis | regionCode |
+| `compare-videos` | Comparar multiplos | videoIds[]* (2-10 videos) |
+
+### Ferramentas com Problemas (nao usar)
+
+| Ferramenta | Problema |
+|------------|----------|
+| `get-video-transcript` | Nao devolve output |
+| `enhanced-transcript` | Transcricao vazia |
+| `get-key-moments` | Depende de transcricao |
+| `get-segmented-transcript` | Depende de transcricao |
+
+> **Aviso:** As ferramentas de transcricao do MCP youtube-research nao funcionam. Usar sempre o script local.
+
+---
+
+## Transcricoes (Script Local)
+
+```
+/media/ealmeida/Dados/Dev/ClaudeDev/Claude-Scripts/youtube-transcript/youtube_extractor.py
+```
+
+### Uso
+
+```bash
+cd /media/ealmeida/Dados/Dev/ClaudeDev/Claude-Scripts/youtube-transcript/
+source venv/bin/activate
+python youtube_extractor.py "https://youtube.com/watch?v=xxx"
+```
+
+Ou via skill: `/youtube https://youtube.com/watch?v=xxx`
+
+---
+
+## Casos de Uso
+
+### 1. Analise Concorrencia
+
+```javascript
+// Pesquisar top videos nicho
+mcp__youtube-research__search-videos({
+  query: "marketing digital portugal",
+  maxResults: 50,
+  order: "viewCount",
+  regionCode: "PT",
+  videoDuration: "medium"
+})
+
+// Analisar canal concorrente
+mcp__youtube-research__analyze-channel-videos({
+  channelId: "UCxxx...",
+  maxResults: 50,
+  sortBy: "viewCount"
+})
+```
+
+### 2. Keyword Research
+
+```javascript
+mcp__youtube-research__search-videos({
+  query: "ganhar dinheiro online",
+  maxResults: 100,
+  order: "relevance"
+})
+// Analisar: titulos mais usados, CTR estimado, competicao
+```
+
+### 3. Trending Topics Portugal
+
+```javascript
+mcp__youtube-research__get-trending-videos({
+  regionCode: "PT",
+  maxResults: 50,
+  categoryId: "22"
+})
+```
+
+---
+
+## Metricas Chave (YouTube Studio)
+
+| Metrica | Benchmark | Accao se < Benchmark |
+|---------|-----------|----------------------|
+| **AVD** (Average View Duration) | > 50% | Melhorar hook, cortar partes fracas |
+| **CTR** (Click-Through Rate) | > 8% | Testar thumbnail/titulo |
+| **Impressions** | Subir mes a mes | SEO, consistencia uploads |
+| **Subscribers Rate** | > 1% views | CTAs mais claros |
+| **Likes/Views** | > 5% | Pedir likes com razao |
+| **Comments/Views** | > 0.5% | Perguntas no video |
+
+---
+
+## SEO YouTube Rapido
+
+### Titulo (Peso: 40%)
+
+```
+[Keyword Principal] + [Beneficio/Curiosidade] + [Trigger]
+
+BOM: "Como Ganhar Dinheiro no YouTube 2026 (5000EUR/Mes)"
+BOM: "10 Erros FATAIS em Marketing Digital (Evita #7)"
+MAU: "Vlog #247" (sem keyword)
+MAU: "INCRIVEL!!! TENS QUE VER ISTO!!!" (clickbait spam)
+```
+
+**Regras:** < 60 caracteres, keyword primeiros 5 palavras, numeros especificos.
+
+### Descricao (Peso: 30%)
+
+Estrutura: Resumo + keyword (1a linha) -> Timestamps -> Descricao expandida (min 200 palavras) -> CTAs -> Links -> Hashtags (3-5) -> Contacto
+
+### Tags (Peso: 10%)
+
+10-15 tags total: 1-2 exact keyword + 3-5 variacoes