claude-plugins/marketing/skills/youtube/SKILL.md

---
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]
```