feat: adiciona 12 plugins Descomplicar ao marketplace

Plugins: automacao, crm-ops, design-media, dev-tools, gestao, infraestrutura, marketing, negocio, perfex-dev, project-manager, wordpress + hello-plugin (existente). Totais: 83 skills, 44 agents, 12 datasets.json Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-07 21:41:24 +00:00
parent bcce928beb
commit 2cb3210962
209 changed files with 50869 additions and 0 deletions
--- a/marketing/skills/youtube/SKILL.md
+++ b/marketing/skills/youtube/SKILL.md
@@ -0,0 +1,597 @@
+---
+name: youtube
+description: YouTube channel management and optimization. Content strategy, SEO, thumbnails,
+  and analytics. Use when user mentions "youtube", "canal youtube", "youtube seo",
+  "video optimization", "youtube analytics".
+author: Descomplicar® Crescimento Digital
+version: 3.0.0
+quality_score: 75
+user_invocable: true
+desk_task: 1490
+allowed-tools: Edit, Task
+---
+
+# /youtube - YouTube Complete Toolkit
+
+Comando para extrair transcrições, metadados E estratégia de crescimento de canais YouTube. Best practices 2026.
+
+---
+
+## 🎯 Arquitectura v3.0.0
+
+| Funcionalidade | Método | Estado | Notas |
+|----------------|--------|--------|-------|
+| **Pesquisa** | MCP youtube-research | ✅ OK | Filtros avançados, região, legendas |
+| **Estatísticas** | MCP youtube-research | ✅ OK | Vídeos, canais, comparações |
+| **Comentários** | MCP youtube-research | ✅ OK | Com replies e likes |
+| **Trending** | MCP youtube-research | ✅ OK | Por região e categoria |
+| **Transcrições** | Script local | ✅ OK | `youtube_extractor.py` (MCP não funciona) |
+| **Upload** | MCP youtube-uploader | ⚠️ Requer Auth | OAuth necessário |
+| **Estratégia Crescimento** | 🆕 Skill internal | ✅ OK | Análise algoritmo, optimizações |
+
+---
+
+## 📊 Algoritmo YouTube 2026 - Como Funciona
+
+### Watch Time é Rei
+
+| Métrica | Peso | Impacto | Benchmark |
+|---------|------|---------|-----------|
+| **Average View Duration** | 40% | Muito Alto | > 50% duração vídeo |
+| **CTR (Click-Through Rate)** | 30% | Alto | > 8% (home/search) |
+| **Engagement (likes, comments, shares)** | 20% | Médio-Alto | > 5% views |
+| **Session Time** | 10% | Médio | Manter utilizador no YouTube |
+
+### Factores Ranking Pesquisa
+
+1. **Relevância** (title, description, tags match query)
+2. **Engagement** (CTR, tempo visualização, likes)
+3. **Qualidade** (histórico canal, consistência)
+4. **Frescura** (vídeos novos boost temporário 48h)
+
+### Factores Recomendações (Home/Sidebar)
+
+1. **Histórico utilizador** (vídeos similares assistidos)
+2. **Session time** (vídeos que mantêm utilizador na plataforma)
+3. **CTR + Retention** (thumbnail + primeiros 30 segundos)
+4. **Canal performance** (consistência uploads, engagement médio)
+
+---
+
+## 🚀 Estratégia Crescimento Canal 2026
+
+### Fase 1: Fundação (0-1K Subscribers)
+
+**Objectivo:** Encontrar nicho e provar conceito
+
+```markdown
+**Conteúdo:**
+- 10-15 vídeos qualidade antes de esperar crescimento
+- Foco: Resolver problemas específicos (long-tail keywords)
+- Duração: 8-12 minutos (sweet spot retention)
+- Frequência: 1-2x/semana consistente
+
+**Optimizações:**
+- Thumbnails contrastantes, texto legível mobile
+- Títulos: Keyword + benefício (< 60 chars)
+- Primeiros 30 segundos: Hook forte
+- Descrição: 200+ palavras, keyword-rich
+- Tags: 10-15 (variações keyword)
+
+**Promoção:**
+- Reddit, Quora, fóruns nicho
+- Colaborar com canais similares (500-5K subs)
+- Partilhar em grupos Facebook/LinkedIn
+```
+
+**KPIs:**
+- AVD (Average View Duration) > 45%
+- CTR > 5%
+- 50-100 subs/mês
+
+### Fase 2: Aceleração (1K-10K Subscribers)
+
+**Objectivo:** Escalar o que funciona, construir audiência
+
+```markdown
+**Conteúdo:**
+- Analisar top 10 vídeos: Replicar formato/topic
+- Criar série (playlist temática, aumenta session time)
+- Mix: 70% comprovado, 30% experimental
+- Duração: 10-15 minutos (mais anúncios, melhor revenue)
+
+**Optimizações YouTube Studio:**
+- End screens (25% boost em views)
+- Cards (links vídeos relacionados)
+- Playlists organizadas (aumenta binge-watching)
+- Community tab (engagement entre vídeos)
+- Shorts (teasers vídeos longos, crescimento rápido)
+
+**Promoção:**
+- Email list (converter viewers em subscribers)
+- Cross-promote Instagram/TikTok
+- Guest appearances podcasts
+```
+
+**KPIs:**
+- AVD > 50%
+- CTR > 8%
+- 200-500 subs/mês
+- 10K+ views/mês
+
+### Fase 3: Escala (10K-100K+ Subscribers)
+
+**Objectivo:** Monetizar e profissionalizar
+
+```markdown
+**Conteúdo:**
+- 2-3x/semana upload schedule
+- Vídeos mais longos (15-20 min) se retention mantém
+- Invest em produção (lighting, áudio, edição)
+- Série flagship (identidade canal)
+
+**Monetização:**
+- AdSense (4K watch hours + 1K subs)
+- Afiliados/Sponsors (produtos relevantes)
+- Produtos próprios (cursos, consultoria)
+- Memberships/Super Chat
+
+**Team:**
+- Editor vídeo (libertar tempo para conteúdo)
+- Thumbnail designer (crítico para CTR)
+- Community manager (responder comentários)
+```
+
+**KPIs:**
+- AVD > 55%
+- CTR > 10%
+- 1K+ subs/mês
+- 100K+ views/mês
+- RPM (Revenue Per Mille) > €3
+
+---
+
+## 🎨 Optimização Títulos e Thumbnails
+
+### Títulos que Convertem (CTR > 10%)
+
+**Fórmulas Testadas:**
+
+| Padrão | Exemplo | CTR Médio |
+|--------|---------|-----------|
+| **Número + Benefício** | "7 Truques Para Duplicar Views" | 9-12% |
+| **Como Fazer** | "Como Crescer no YouTube em 2026" | 8-11% |
+| **Erro Comum** | "NUNCA Faças Isto no YouTube" | 10-13% |
+| **Resultado Surpreendente** | "Ganhei 10K Subs em 30 Dias (Como)" | 11-14% |
+| **Desafio/Experiência** | "30 Dias Publicando TODOS os Dias" | 9-12% |
+
+**Regras:**
+- **< 60 caracteres** (não corta em mobile)
+- **Keyword primeiros 5 palavras** (SEO YouTube)
+- **Maiúsculas estratégicas** (1-2 palavras, não spam)
+- **Números específicos** (não "muitos", mas "127")
+- **Trigger curiosidade** (sem clickbait excessivo)
+
+### Thumbnails que Destacam (CTR > 10%)
+
+```markdown
+**Elementos Críticos:**
+
+1. **Rosto/Expressão** (70% thumbnails top performers)
+   - Close-up rosto
+   - Expressão exagerada (surpresa, choque, alegria)
+   - Contraste alto (destaca em feed)
+
+2. **Texto Legível** (3-5 palavras MAX)
+   - Font grande (Montserrat Bold, Impact)
+   - Contraste cores (amarelo/preto, branco/vermelho)
+   - Legível em mobile (90% views)
+
+3. **Cores Contrastantes**
+   - Amarelo, laranja, vermelho (destacam)
+   - Evitar verde, azul (funde com YouTube UI)
+   - Background simples (não cluttered)
+
+4. **Regra dos Terços**
+   - Rosto/objecto principal num terço
+   - Espaço negativo equilibrado
+   - Não centrar tudo
+```
+
+**Ferramentas:**
+- Canva (templates YouTube)
+- Photopea (Photoshop online gratuito)
+- Remove.bg (remover backgrounds)
+
+**A/B Testing:**
+- YouTube permite trocar thumbnail DEPOIS upload
+- Testar 2-3 variações primeiras 48h
+- Manter versão com melhor CTR
+
+---
+
+## 📝 Optimização SEO YouTube
+
+### Título (Peso: 40%)
+
+```
+[Keyword Principal] + [Benefício/Curiosidade] + [Trigger]
+
+✅ "Como Ganhar Dinheiro no YouTube 2026 (€5K/Mês)"
+✅ "Photoshop para Iniciantes - Tutorial Completo PT"
+✅ "10 Erros FATAIS em Marketing Digital (Evita #7)"
+
+❌ "Vlog #247" (sem keyword)
+❌ "INCRÍVEL!!! TENS QUE VER ISTO!!!" (clickbait spam)
+```
+
+### Descrição (Peso: 30%)
+
+```markdown
+**Estrutura Optimizada:**
+
+[Primeira linha: Resumo + keyword - aparece em pesquisa]
+Aprende como ganhar dinheiro no YouTube em 2026. Estratégia completa para iniciantes.
+
+[Timestamp links - aumenta retention]
+0:00 Introdução
+2:15 Passo 1: Nicho
+5:30 Passo 2: Conteúdo
+10:45 Passo 3: Monetização
+
+[Descrição expandida - min 200 palavras, keyword 3-5x]
+Neste vídeo, mostro exactamente como ganhar dinheiro no YouTube...
+
+[CTAs]
+🔔 Subscreve: [URL canal]
+📧 Newsletter: [URL]
+💬 Discord: [URL]
+
+[Links relacionados]
+👉 Vídeo anterior: [URL]
+👉 Playlist: [URL]
+
+[Hashtags - 3-5 relevantes]
+#YouTubeMarketing #GanharDinheiro #YouTubePortugues
+
+[Contacto/Social]
+Instagram: @handle
+Email: email@domain.pt
+```
+
+### Tags (Peso: 10%)
+
+```
+**Estratégia Tags:**
+
+1. **Exact keyword** (1-2)
+   - "ganhar dinheiro youtube"
+   - "youtube portugal"
+
+2. **Variações** (3-5)
+   - "como ganhar dinheiro no youtube"
+   - "monetizar canal youtube"
+   - "youtube para iniciantes"
+
+3. **Long-tail** (3-5)
+   - "ganhar dinheiro youtube 2026"
+   - "monetizar youtube portugal"
+
+4. **Genéricas nicho** (2-3)
+   - "marketing digital"
+   - "empreendedorismo online"
+
+**Total: 10-15 tags**
+```
+
+---
+
+## 🎬 Hook Perfeito (Primeiros 30 Segundos)
+
+**80% viewers decide ficar ou sair nos primeiros 30 segundos.**
+
+### Framework Hook
+
+```
+[0-5s] **Pattern Interrupt**
+Imagem/som surpreendente, statement bold
+"Ganhei €50K com este canal em 90 dias."
+
+[5-15s] **Promessa + Preview**
+O que vão aprender + teaser resultado
+"Neste vídeo, mostro exactamente o método passo a passo. Incluindo screenshots das minhas receitas."
+
+[15-30s] **Credibilidade + CTA Suave**
+Porque confiar + pedir subscrição
+"Faço YouTube há 5 anos, 3 canais crescidos. Se queres crescer também, subscreve para não perder novos vídeos."
+
+[30s+] **Conteúdo prometido**
+Entregar valor IMEDIATAMENTE
+```
+
+**Anti-Patterns:**
+- ❌ Logo intro longa (> 5s) - viewers saem
+- ❌ "Olá pessoal, tudo bem?" - tempo perdido
+- ❌ Pedir subscrição ANTES de dar valor
+- ❌ Música intro sem valor
+
+---
+
+## 📊 Métricas Chave (YouTube Studio)
+
+### Dashboard Essenciais
+
+| Métrica | Fórmula | Benchmark | Acção se < Benchmark |
+|---------|---------|-----------|----------------------|
+| **AVD** | Tempo médio visualização / Duração vídeo | > 50% | Melhorar hook, cortar partes fracas |
+| **CTR** | Cliques / Impressões | > 8% | Testar thumbnail/título |
+| **Impressions** | Vezes thumbnail mostrado | Subir mês a mês | SEO, consistência uploads |
+| **Subscribers Rate** | Novos subs / Views | > 1% | CTAs mais claros, conteúdo mais valioso |
+| **Likes/Views** | Likes / Views | > 5% | Engagement, pedir likes (com razão) |
+| **Comments/Views** | Comments / Views | > 0.5% | Perguntas no vídeo, responder comments |
+
+### Análise Audiência
+
+```markdown
+**Demografia:** Ajustar conteúdo para maioria
+- Idade: 25-34 (60%) → Tom informal, memes
+- Género: 70% masculino → Topics, exemplos
+- Geografia: 80% Portugal → PT-PT, contextos locais
+
+**Quando Assistem:** Optimizar schedule uploads
+- Pico: Terça/Quinta 19h-21h → Upload 18h
+
+**Dispositivos:** 85% mobile → Testar tudo em telemóvel
+```
+
+---
+
+## 🛠️ MCP youtube-research (8/12 funcionais)
+
+### Ferramentas Funcionais
+
+| Ferramenta | Função | Parâmetros |
+|------------|--------|------------|
+| `search-videos` | Pesquisa avançada | query*, maxResults, regionCode, order, videoDuration |
+| `get-video-stats` | Estatísticas vídeo | videoId* |
+| `get-video-comments` | Comentários + replies | videoId*, maxResults, order, includeReplies |
+| `get-channel-stats` | Estatísticas canal | channelId* |
+| `analyze-channel-videos` | Análise performance | channelId*, maxResults, sortBy |
+| `get-trending-videos` | Trending por região | regionCode, maxResults, categoryId |
+| `get-video-categories` | Categorias disponíveis | regionCode |
+| `compare-videos` | Comparar múltiplos | videoIds[]* (2-10 vídeos) |
+
+### Ferramentas com Problemas (NÃO USAR)
+
+| Ferramenta | Estado | Problema |
+|------------|--------|----------|
+| `get-video-transcript` | ❌ | Não devolve output |
+| `enhanced-transcript` | ❌ | Transcrição vazia |
+| `get-key-moments` | ❌ | Depende de transcrição |
+| `get-segmented-transcript` | ❌ | Depende de transcrição |
+
+> [!warning] Transcrições via MCP
+> As ferramentas de transcrição do MCP youtube-research **NÃO FUNCIONAM**.
+> Usar sempre o script local `youtube_extractor.py` para transcrições.
+
+---
+
+## 📜 Transcrições (Script Local)
+
+**As transcrições via MCP não funcionam. Usar sempre o script local.**
+
+### Localização
+```
+/media/ealmeida/Dados/Dev/ClaudeDev/Claude-Scripts/youtube-transcript/youtube_extractor.py
+```
+
+### Uso Directo
+```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"
+```
+
+### Via Skill
+```
+/youtube https://youtube.com/watch?v=xxx
+```
+
+---
+
+## 📤 Upload de Vídeos (MCP youtube-uploader)
+
+### Configuração Inicial (uma vez)
+
+```
+1. mcp__youtube-uploader__authenticate
+   → Devolve URL OAuth2
+
+2. Abrir URL no browser → Login Google → Autorizar
+
+3. Copiar código do redirect (?code=xxx)
+
+4. mcp__youtube-uploader__accesstoken
+   → Parâmetro: code (só o código, não URL completo)
+
+5. Guardar channel_id devolvido
+```
+
+### Upload Completo
+
+```javascript
+mcp__youtube-uploader__upload_video({
+  file_path: "/caminho/completo/video.mp4",
+  channel_id: "UCxxx...",
+  title: "Título Optimizado SEO (< 100 chars)",
+  description: "Descrição completa com timestamps, links, keywords (min 200 palavras)",
+  tags: "tag1, tag2, tag3, tag4, tag5",
+  status: "public", // ou "private", "unlisted"
+  category_id: "22", // 22 = People & Blogs, 28 = Science & Technology
+  publish_at: "2026-02-05T18:00:00Z" // Opcional, agendamento
+})
+```
+
+### Categorias Principais
+
+| ID | Nome | Uso |
+|----|------|-----|
+| 1 | Film & Animation | Vídeos cinematográficos |
+| 10 | Music | Música, covers |
+| 20 | Gaming | Gameplays, reviews jogos |
+| 22 | People & Blogs | Vlogs, lifestyle |
+| 24 | Entertainment | Entretenimento geral |
+| 25 | News & Politics | Notícias, análise política |
+| 27 | Education | Tutoriais, cursos |
+| 28 | Science & Technology | Tech, ciência |
+
+---
+
+## 💡 Casos de Uso
+
+### 1. Análise Concorrência
+
+```javascript
+// Pesquisar top vídeos nicho
+mcp__youtube-research__search-videos({
+  query: "marketing digital portugal",
+  maxResults: 50,
+  order: "viewCount",
+  regionCode: "PT",
+  videoDuration: "medium" // 4-20 min
+})
+
+// Analisar canal concorrente
+mcp__youtube-research__analyze-channel-videos({
+  channelId: "UCxxx...",
+  maxResults: 50,
+  sortBy: "viewCount"
+})
+
+// Insights:
+// - Topics mais populares
+// - Duração média top performers
+// - Frequência uploads
+// - Engagement médio
+```
+
+### 2. Keyword Research
+
+```javascript
+// Pesquisar variações keyword
+mcp__youtube-research__search-videos({
+  query: "ganhar dinheiro online",
+  maxResults: 100,
+  order: "relevance"
+})
+
+// Analisar:
+// - Títulos mais usados
+// - CTR estimado (views / idade vídeo)
+// - Competição (quantos vídeos topic)
+```
+
+### 3. Trending Topics Portugal
+
+```javascript
+mcp__youtube-research__get-trending-videos({
+  regionCode: "PT",
+  maxResults: 50,
+  categoryId: "22" // People & Blogs
+})
+
+// Criar conteúdo relacionado com trending
+```
+
+---
+
+## 📚 Datasets Dify (Consulta Obrigatória)
+
+| Dataset | ID | Prioridade | Uso |
+|---------|----|-----------:|-----|
+| **Youtube Marketing** | `baa1b3e6-ebf0-4413-84b2-63d1164867ea` | 1 | Crescimento canal, algoritmo |
+| **Marketing Redes Sociais** | `66117552-348f-455d-9aca-2da722567693` | 2 | Estratégia vídeo, engagement |
+| **Marketing Digital** | `c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24` | 3 | Estratégia geral, métricas |
+
+### Como Consultar
+
+```javascript
+// Estratégias crescimento YouTube
+mcp__dify-kb__dify_kb_retrieve_segments({
+  dataset_id: "baa1b3e6-ebf0-4413-84b2-63d1164867ea",
+  query: "algoritmo youtube crescimento subscribers 2026"
+})
+
+// Optimização vídeos
+mcp__dify-kb__dify_kb_retrieve_segments({
+  dataset_id: "baa1b3e6-ebf0-4413-84b2-63d1164867ea",
+  query: "seo youtube tags thumbnails títulos CTR"
+})
+
+// Estratégia conteúdo vídeo
+mcp__dify-kb__dify_kb_retrieve_segments({
+  dataset_id: "66117552-348f-455d-9aca-2da722567693",
+  query: "video marketing engagement retention hook"
+})
+```
+
+### Quando Consultar
+- **Estratégia crescimento canal** (0-100K subs)
+- **Optimização títulos/thumbnails** (CTR < 8%)
+- **Análise concorrência** (pesquisa keywords)
+- **Melhores práticas upload** (SEO YouTube)
+- **Monetização** (AdSense, sponsors, produtos)
+
+---
+
+## 📈 Instrumentação Automática
+
+```sql
+INSERT INTO tblskill_agent_metrics (
+  type, name, duration_ms, status, staff_id,
+  kb_consulted, kb_cache_hit, tool_calls, project_id
+) VALUES (
+  'skill', '/youtube', {DURACAO_MS}, '{STATUS}', 25,
+  {KB_CONSULTADO}, {CACHE_HIT}, {TOOL_CALLS}, {PROJECT_ID}
+);
+```
+
+---
+
+**Versão**: 3.0.0 | **Data**: 2026-02-03 | **Autor**: Descomplicar®
+**Desk Task:** #1490 | **Standards:** Algoritmo YouTube 2026, Crescimento Orgânico
+**Script transcrições**: `/media/ealmeida/Dados/Dev/ClaudeDev/Claude-Scripts/youtube-transcript/youtube_extractor.py`
+**MCPs**: youtube-research (8/12 OK), youtube-uploader (requer auth)
+
+---
+
+
+## Quando NÃO Usar
+
+- Para tarefas fora do domínio de especialização desta skill
+- Quando outra skill mais específica está disponível
+- Para operações que requerem confirmação manual do utilizador
+
+
+## Protocolo
+
+1. Analisar requisitos da tarefa
+2. Verificar disponibilidade de ferramentas necessárias
+3. Executar operações de forma incremental
+4. Validar resultados antes de concluir
+5. Reportar status e próximos passos
+
+
+## Exemplos
+
+### Exemplo 1: Uso Básico
+```
+Input: [descrição da tarefa]
+Output: [resultado esperado]
+```
+
+### Exemplo 2: Uso Avançado
+```
+Input: [caso complexo]
+Output: [resultado detalhado]
+```