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

name, description, author, version, quality_score, user_invocable, desk_task, allowed-tools

name	description	author	version	quality_score	user_invocable	desk_task	allowed-tools
seo-audit	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".	Descomplicar® Crescimento Digital	2.0.0	75	true	1481	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)

# 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

# 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

// 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)

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]