claude-plugins/marketing/skills/seo-audit/SKILL.md

---
name: seo-audit
description: Comprehensive SEO audit and optimization recommendations. Analyzes technical
  SEO, content, backlinks, and performance. Use when user mentions "seo audit", "auditoria
  seo", "otimização", "ranking", "google search".
author: Descomplicar® Crescimento Digital
version: 2.0.0
quality_score: 75
user_invocable: true
desk_task: 1481
allowed-tools: Task
---

# SEO Audit - Auditoria Completa

Skill para realizar auditorias SEO completas usando o stack de ferramentas instalado. Best practices 2026.

---

## 🎯 Quando Usar

- Auditar um site completo (técnico + conteúdo + performance)
- Verificar Core Web Vitals e ranking factors
- Analisar backlinks e autoridade de domínio
- Obter dados reais do Google Search Console
- Identificar oportunidades de optimização
- Comparar com concorrência

---

## 📊 Google Updates 2026

### Core Algorithm Updates

| Update | Data | Impacto |
|--------|------|---------|
| **Helpful Content Q1** | Jan 2026 | Penaliza conteúdo AI de baixa qualidade |
| **Core Web Vitals 3.0** | Mar 2026 | INP substitui FID, thresholds mais rigorosos |
| **E-E-A-T Focus** | Q1-Q2 | Experiência prática obrigatória (not just expertise) |
| **Mobile-First Index** | Universal | 100% dos sites |

### Novos Ranking Factors 2026

1. **INP (Interaction to Next Paint)** - Substitui FID
   - Bom: < 200ms
   - Necessita melhoria: 200-500ms
   - Mau: > 500ms

2. **E-E-A-T** (Experience, Expertise, Authoritativeness, Trust)
   - Autor identificado com bio
   - Credenciais verificáveis
   - Experiência real demonstrada

3. **Page Experience Signals**
   - HTTPS obrigatório
   - Intrusive interstitials penalizados
   - Safe Browsing compliance

---

## 🔧 Ferramentas Disponíveis

### 1. SEO Tools API (http://localhost:3000)

```bash
# Auditoria básica
curl "http://localhost:3000/seo-audit?url=URL"

# Velocidade PageSpeed Insights style
curl "http://localhost:3000/page-speed-analyzer?url=URL"

# Backlinks + DR/UR
curl "http://localhost:3000/backlink-checker?url=URL"

# Rankings para keywords
curl "http://localhost:3000/rank-checker?url=URL&keywords=keyword1,keyword2"

# Optimização conteúdo on-page
curl "http://localhost:3000/content-optimization?url=URL"

# Internal linking structure
curl "http://localhost:3000/internal-linking?url=URL"

# Sitemap XML generator
curl "http://localhost:3000/sitemap-generator?url=URL"

# Análise concorrência
curl "http://localhost:3000/competitor-analysis?url=URL&competitors=site1.com,site2.com"
```

### 2. Lighthouse MCP

| Tool | Função | Output |
|------|--------|--------|
| `run_audit(url)` | Auditoria completa | Performance, SEO, A11y, Best Practices |
| `get_performance_score(url)` | Score performance | 0-100 |
| `get_core_web_vitals(url)` | LCP, INP, CLS | Mobile + Desktop |
| `get_accessibility_score(url)` | Acessibilidade | 0-100 + issues |
| `get_seo_analysis(url)` | Análise SEO técnico | Meta, headings, indexabilidade |
| `get_security_audit(url)` | Segurança | HTTPS, mixed content, headers |
| `compare_mobile_desktop(url)` | Comparação | Diferenças performance |
| `get_lcp_opportunities(url)` | Optimizações LCP | Preload, lazy load |
| `find_unused_javascript(url)` | JS não usado | Tamanhos, % savings |

### 3. SEO Ahrefs MCP (via API)

| Tool | Função | Dados |
|------|--------|-------|
| `get_backlinks_list(domain)` | Lista backlinks | DR, UR, anchor text |
| `keyword_generator(keyword, country)` | Ideias keywords | Volume, KD, CPC |
| `get_traffic(domain)` | Tráfego estimado | Visitas mensais, keywords |
| `keyword_difficulty(keyword)` | Dificuldade keyword | 0-100 (KD score) |

### 4. Google Search Console MCP

| Tool | Função | Dados Reais |
|------|--------|-------------|
| `list_properties` | Listar sites verificados | URLs properties |
| `get_search_analytics(site, period)` | Queries, cliques, CTR | Últimos 16 meses |
| `inspect_url_enhanced(site, url)` | Inspecionar URL | Indexação, mobile usability |
| `check_indexing_issues(site, urls)` | Problemas indexação | Erros, avisos |
| `get_sitemaps(site)` | Listar sitemaps | Status, URLs submetidos |

### 5. Google Analytics MCP

| Tool | Função | Métricas |
|------|--------|----------|
| `get_account_summaries` | Listar contas | Properties disponíveis |
| `run_report(property, metrics, dimensions)` | Relatório custom | Sessions, users, bounce rate |
| `run_realtime_report(property)` | Tempo real | Utilizadores activos now |

---

## 📋 Workflow de Auditoria Completa

### Passo 1: Análise Técnica Básica (3 min)

```
1. SEO Tools API → /seo-audit → Meta tags, headings, estrutura HTML
2. SEO Tools API → /page-speed-analyzer → Velocidade, sugestões
3. Lighthouse → run_audit → Performance, SEO, Accessibility scores
```

**Checklist Crítico:**
- [ ] Meta title (50-60 chars)
- [ ] Meta description (150-160 chars)
- [ ] H1 único com keyword
- [ ] Canonical URL definido
- [ ] Robots.txt accessível
- [ ] Sitemap.xml presente
- [ ] HTTPS activo
- [ ] Mobile-friendly

### Passo 2: Core Web Vitals (2 min)

```
1. Lighthouse → get_core_web_vitals → LCP, INP, CLS (mobile + desktop)
2. Lighthouse → compare_mobile_desktop → Identificar gaps
3. Lighthouse → get_lcp_opportunities → Sugestões optimização
```

**Thresholds 2026:**

| Métrica | Bom | Necessita Melhoria | Mau |
|---------|-----|-------------------|-----|
| **LCP** | < 2.5s | 2.5-4s | > 4s |
| **INP** | < 200ms | 200-500ms | > 500ms |
| **CLS** | < 0.1 | 0.1-0.25 | > 0.25 |

### Passo 3: Análise de Conteúdo (3 min)

```
1. SEO Tools API → /content-optimization → On-page SEO, keyword density
2. SEO Tools API → /internal-linking → Estrutura links internos
3. SEO Ahrefs → keyword_generator → Keywords relacionadas, volume, KD
```

**Checklist E-E-A-T:**
- [ ] Autor identificado com bio
- [ ] Credenciais verificáveis
- [ ] Data publicação/actualização
- [ ] Fontes citadas (links externos autoritativos)
- [ ] Experiência real demonstrada

### Passo 4: Backlinks e Autoridade (2 min)

```
1. SEO Tools API → /backlink-checker → Backlinks básicos, DR/UR
2. SEO Ahrefs → get_backlinks_list → Lista detalhada Ahrefs (DR, anchor text)
3. SEO Ahrefs → get_traffic → Tráfego estimado mensal
```

**Métricas Autoridade:**
- **DR (Domain Rating)**: 0-100 (força backlink profile)
- **UR (URL Rating)**: 0-100 (força página específica)
- **Backlinks**: Quantidade + qualidade (DR > 30)
- **Referring Domains**: Número de domínios únicos

### Passo 5: Dados Reais GSC (3 min)

```
1. GSC → get_search_analytics → Queries, impressões, CTR real (últimos 90 dias)
2. GSC → check_indexing_issues → Problemas de indexação
3. GSC → get_sitemaps → Status sitemaps submetidos
```

**Métricas GSC a Analisar:**
- **Impressões vs Cliques**: CTR médio > 2%
- **Posição média**: Top 3 para keywords principais
- **Cobertura**: % páginas indexadas vs submetidas
- **Mobile Usability**: Erros específicos mobile

### Passo 6: Concorrência (opcional, 2 min)

```
SEO Tools API → /competitor-analysis → Comparar com 2-3 concorrentes
- Keywords gap
- Backlinks gap
- Content gap
```

---

## 📄 Template de Relatório

```markdown
# Relatório SEO - [DOMÍNIO]
**Data:** YYYY-MM-DD
**Versão:** 2.0 (2026 Standards)

---

## 🎯 Resumo Executivo

| Métrica | Valor | Status |
|---------|-------|--------|
| **Score Geral** | X/100 | 🟢 Bom / 🟡 Médio / 🔴 Crítico |
| **Core Web Vitals** | LCP Xs \| INP Xms \| CLS X | ✅ / ⚠️ / ❌ |
| **Backlinks** | X (DR: X) | 🟢 Bom / 🟡 Médio / 🔴 Fraco |
| **Problemas Críticos** | X | Lista abaixo |

---

## 1️⃣ Análise Técnica

### Meta Tags
- **Title**: [OK/NOK] - [Conteúdo]
- **Description**: [OK/NOK] - [Conteúdo]
- **Canonical**: [OK/NOK]
- **Open Graph**: [OK/NOK]

### Headings Structure
```
H1: [Texto] ✅
  H2: [Texto] ✅
    H3: [Texto] ✅
  H2: [Texto] ⚠️ (Sem keyword)
```

### Velocidade
- **Mobile**: X/100 - [LCP Xs | INP Xms | CLS X]
- **Desktop**: X/100 - [LCP Xs | INP Xms | CLS X]
- **Bloqueio Principal**: [JS/CSS/Imagens]

---

## 2️⃣ Core Web Vitals

### Comparação Mobile vs Desktop

| Métrica | Mobile | Desktop | Diferença |
|---------|--------|---------|-----------|
| LCP | X.Xs | X.Xs | +X.X% |
| INP | Xms | Xms | +X% |
| CLS | X | X | +X% |

### Oportunidades LCP
1. **Preload imagem hero** - Savings: X KB
2. **Lazy load below-fold** - Savings: X KB
3. **Optimizar servidor**: TTFB > 600ms

### Oportunidades INP
1. **Reduzir JS não usado**: X KB (X% savings)
2. **Code splitting**: Carregar só necessário
3. **Web Workers**: Tarefas pesadas off main thread

---

## 3️⃣ Conteúdo e E-E-A-T

### On-Page SEO

| Factor | Status | Nota |
|--------|--------|------|
| Keyword no title | ✅ / ❌ | |
| Keyword no H1 | ✅ / ❌ | |
| Keyword primeiros 100 chars | ✅ / ❌ | |
| Alt text imagens | ✅ / ⚠️ / ❌ | X/Y com alt |
| Internal linking | ✅ / ⚠️ / ❌ | X links internos |
| External links | ✅ / ⚠️ / ❌ | X links autoritativos |

### E-E-A-T Score

| Critério | Status | Observação |
|----------|--------|------------|
| Autor identificado | ✅ / ❌ | |
| Bio com credenciais | ✅ / ❌ | |
| Data publicação | ✅ / ❌ | |
| Experiência demonstrada | ✅ / ❌ | |
| Fontes citadas | ✅ / ❌ | X links externos |

---

## 4️⃣ Backlinks e Autoridade

### Perfil de Links

| Métrica | Valor | Benchmark |
|---------|-------|-----------|
| **Domain Rating (DR)** | X | > 30 bom |
| **URL Rating (UR)** | X | > 20 bom |
| **Backlinks Totais** | X | |
| **Referring Domains** | X | > 50 bom |
| **DoFollow vs NoFollow** | X% / X% | > 60% DoFollow ideal |

### Top 5 Backlinks

| Domínio | DR | Anchor Text | DoFollow |
|---------|-----|-------------|----------|
| site1.com | 75 | [Texto] | Sim |
| site2.com | 62 | [Texto] | Sim |
| ... | ... | ... | ... |

### Oportunidades
1. **Guest posts** em sites DR > 40
2. **Broken link building** (X links quebrados encontrados)
3. **Recuperar menções não linkadas** (X menções)

---

## 5️⃣ Search Console (Dados Reais)

### Performance Últimos 90 Dias

| Métrica | Valor | Variação vs período anterior |
|---------|-------|------------------------------|
| **Cliques** | X | +X% / -X% |
| **Impressões** | X | +X% / -X% |
| **CTR Médio** | X% | +X pp |
| **Posição Média** | X | +X / -X |

### Top 10 Queries

| Query | Cliques | Impressões | CTR | Posição |
|-------|---------|------------|-----|---------|
| query1 | X | X | X% | X |
| query2 | X | X | X% | X |
| ... | ... | ... | ... | ... |

### Oportunidades CTR
- **Posição 4-10, CTR < 5%**: Optimizar meta description
- **Posição 11-20**: Targets fáceis para top 10
- **Alta impressão, baixo CTR**: Melhorar title/description

### Indexação

| Estado | Páginas | Acção Necessária |
|--------|---------|------------------|
| ✅ Indexadas | X | - |
| ⚠️ Excluídas | X | Investigar |
| ❌ Erros | X | Corrigir urgente |

**Problemas Críticos:**
1. [Erro 404]: X páginas
2. [Robots bloqueado]: X páginas
3. [Soft 404]: X páginas

---

## 6️⃣ Recomendações Prioritárias

### 🔴 Crítico (Fazer AGORA)
1. [ ] **[Problema]** - [Impacto] - [Solução]
2. [ ] **[Problema]** - [Impacto] - [Solução]

### 🟡 Importante (Fazer esta semana)
1. [ ] **[Problema]** - [Impacto] - [Solução]
2. [ ] **[Problema]** - [Impacto] - [Solução]

### 🟢 Melhoria (Fazer este mês)
1. [ ] **[Problema]** - [Impacto] - [Solução]
2. [ ] **[Problema]** - [Impacto] - [Solução]

---

## 📊 Roadmap Optimização (Q1-Q2 2026)

### Mês 1: Fundação Técnica
- [ ] Corrigir todos os problemas críticos
- [ ] Optimizar Core Web Vitals (target: All green)
- [ ] Implementar E-E-A-T básico (autor, datas, bio)

### Mês 2: Conteúdo e Autoridade
- [ ] Actualizar conteúdo underperforming (posição 11-20)
- [ ] Criar conteúdo para keywords gap vs concorrência
- [ ] Campanha backlinks (target: +10 DR > 30)

### Mês 3: Consolidação e Escala
- [ ] Monitorizar rankings e ajustar
- [ ] Expandir internal linking
- [ ] Criar cluster de conteúdo para keywords principais

---

## 🔧 Ferramentas Utilizadas

- ✅ SEO Tools API (localhost:3000)
- ✅ Lighthouse MCP
- ✅ SEO Ahrefs MCP
- ✅ Google Search Console MCP
- ✅ Google Analytics MCP (opcional)

---

**Próxima Auditoria**: [Data + 3 meses]
```

---

## ⚠️ Notas Importantes

### Requisitos
- **SEO Tools API** deve estar a correr: `~/mcp-servers/seo-tools-api/start.sh`
- **GSC** requer autenticação OAuth na primeira utilização
- **GA** requer ADC credentials configuradas (`gcloud auth application-default login`)

### Propriedades GSC Disponíveis
```
sc-domain:descomplicar.pt
https://emanuelalmeida.pt/
https://carstuff.pt/
https://solarfvengenharia.com/
https://aquisevende.pt/
https://alojadamaria.com/
https://e-commerce.descomplicar.pt/
```

### Limitações
- Ahrefs API tem rate limiting (100 req/day free tier)
- GSC data máximo: 16 meses histórico
- Lighthouse scores variam ±5 pontos entre execuções (network dependent)

---

## 📚 Datasets Dify (Consultar SEMPRE)

Consultar os seguintes datasets via MCP para complementar análises:

| Dataset | ID | Uso |
|---------|----|----|
| **SEO (Search Engine Optimization)** | `b93c6475-2f22-412e-ba9d-666eb081b872` | Técnicas SEO avançadas, updates Google |
| **Neil Patel** | `6ff761b3-a054-435c-8fc3-a6e6c3a0afaf` | Link building, conteúdo, estratégias |
| **Marketing de Conteúdo** | `061f19a3-d4b6-4383-9f44-620742167201` | Criação conteúdo, E-E-A-T |
| **Marketing Digital** | `c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24` | Estratégia geral, métricas |

### Como Consultar

```javascript
// Pesquisar técnicas SEO técnico
mcp__dify-kb__dify_kb_retrieve_segments({
  dataset_id: "b93c6475-2f22-412e-ba9d-666eb081b872",
  query: "core web vitals INP optimization 2026"
})

// Estratégias link building Neil Patel
mcp__dify-kb__dify_kb_retrieve_segments({
  dataset_id: "6ff761b3-a054-435c-8fc3-a6e6c3a0afaf",
  query: "backlinks guest posting strategies"
})

// E-E-A-T implementation
mcp__dify-kb__dify_kb_retrieve_segments({
  dataset_id: "061f19a3-d4b6-4383-9f44-620742167201",
  query: "google EEAT author credibility"
})
```

### Quando Consultar
- Após identificar problemas técnicos (buscar soluções específicas)
- Antes de recomendar estratégia de backlinks
- Para validar best practices 2026

---

## 📈 Instrumentação Automática

Esta skill grava métricas automaticamente para análise PDCA.

### Query para Gravar (executar no final)

```sql
INSERT INTO tblskill_agent_metrics (
  type, name, duration_ms, status, staff_id,
  kb_consulted, kb_cache_hit, tool_calls, project_id
) VALUES (
  'skill', '/seo-audit', {DURACAO_MS}, '{STATUS}', 25,
  {KB_CONSULTADO}, {CACHE_HIT}, {TOOL_CALLS}, {PROJECT_ID}
);
```

---

**Versão:** 2.0.0 | **Autor:** Descomplicar® | **Data:** 2026-02-03
**Desk Task:** #1481 | **Best Practices:** 2026 Google Standards

---


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