---
name: seo-report
description: Relatorio de auditoria SEO completo com Lighthouse, Google Search Console e exportacao para Google Docs. Analisa Core Web Vitals, desempenho, SEO on-page e gera recomendacoes accionaveis.
---

# Skill: /seo-report

Gera relatorio SEO completo com dados de multiplas fontes e exporta automaticamente para Google Docs.

---

## Contexto NotebookLM

ANTES de executar, consultar notebook para contexto especializado:

| Notebook | ID | Consultar quando |
|----------|-----|-----------------|
| Marketing Digital PT | `4c595973` | Sempre |

```
mcp__notebooklm__notebook_query({
  notebook_id: "4c595973-ba10-420a-a3bf-e4389e424ad3",
  query: "<adaptar ao contexto — ex: auditoria SEO, relatorio performance, recomendacoes tecnicas>"
})
```

**Procedimento relacionado:** `PROC-DMARC-Email-Entregabilidade.md` -- consultar quando o relatorio envolve email deliverability.

---

## Trigger

`/seo-report <url>` ou `/seo-report <url> <email_destino>`

---

## Exemplos

```bash
# Relatorio basico (envia para emanuelalmeidaa@gmail.com)
/seo-report https://descomplicar.pt

# Relatorio para cliente especifico
/seo-report https://cliente.pt cliente@email.com

# Relatorio com analise concorrencia
/seo-report https://site.pt --competitors=concorrente1.pt,concorrente2.pt
```

---

## Fontes de Dados

| Fonte | Dados Recolhidos | Tempo |
|-------|------------------|-------|
| **Lighthouse (Desktop)** | Performance, SEO, Accessibility, Best Practices | ~30s |
| **Lighthouse (Mobile)** | Core Web Vitals, INP, comparacao mobile/desktop | ~30s |
| **Lighthouse (Optimizacoes)** | Oportunidades LCP, JS nao usado, images optimization | ~15s |
| **GSC** | Cliques, impressoes, CTR, posicao media, top queries, tendencia 90 dias | ~10s |
| **SEO Tools API** | Meta tags, imagens, alt text, links internos/externos, estrutura HTML | ~5s |
| **Ahrefs (opcional)** | DR, UR, backlinks, referring domains | ~10s |

**Tempo Total:** ~1m40s (sem concorrencia) | ~3m (com 2 concorrentes)

---

## Workflow

1. Validar URL de entrada
2. Verificar se site esta no GSC (skip se nao)
3. Executar auditorias em paralelo:
   - Lighthouse Desktop + Mobile
   - Core Web Vitals
   - SEO Tools API
   - GSC Analytics (se disponivel)
   - Ahrefs (se habilitado)
4. Processar e formatar dados
5. Gerar relatorio Markdown
6. Criar Google Doc e partilhar
7. Retornar link do documento

---

## Estrutura do Relatorio

O relatorio final tem 8 seccoes:

1. **Sumario Executivo** -- Top 5 descobertas + accao imediata recomendada
2. **Pontuacoes Globais** -- Desktop vs Mobile (Performance, SEO, A11y, Best Practices)
3. **Core Web Vitals** -- LCP, INP, CLS com oportunidades de optimizacao
4. **GSC Analytics** -- Performance overview, top queries, oportunidades CTR (ultimos 90 dias)
5. **Analise On-Page** -- Meta tags, imagens SEO, internal linking
6. **Backlinks e Autoridade** -- DR, UR, top backlinks, estrategia
7. **Plano de Accao** -- Priorizado (critico/importante/melhoria) com impacto e esforco
8. **Roadmap Trimestral** -- Fundacao tecnica -> Conteudo e autoridade -> Consolidacao

---

## Propriedades GSC Disponiveis

```
sc-domain:descomplicar.pt
https://emanuelalmeida.pt/
https://carstuff.pt/
https://solarfvengenharia.com/
https://aquisevende.pt/
https://alojadamaria.com/
https://e-commerce.descomplicar.pt/
```

---

## Notas Tecnicas

### Requisitos
- SEO Tools API a correr: `~/mcp-servers/seo-tools-api/start.sh`
- Google Workspace MCP configurado
- GSC authentication (OAuth primeira vez)

### Erros Comuns
- **Site nao em GSC:** Relatorio gerado sem dados GSC (aviso incluido)
- **Lighthouse timeout:** Retry automatico (3x)
- **Ahrefs rate limit:** Skip backlinks, aviso no relatorio

---

## References (conteudo detalhado)

| Ficheiro | Conteudo |
|----------|----------|
| `references/template-relatorio.md` | Template completo do relatorio com todas as tabelas e seccoes |
| `references/implementacao-tecnica.md` | Workflow mermaid, codigo JS, funcoes GSC, notas tecnicas |

---

## Anti-Patterns

- Gerar relatorio sem dados reais (sempre usar MCPs)
- Ignorar gap mobile/desktop
- Nao priorizar recomendacoes (tudo parece igual)
- Esquecer de verificar se site esta no GSC antes de tentar recolher dados
- Relatorio sem accoes concretas e estimativas de impacto

---

**Versao:** 2.1.0 | **Autor:** Descomplicar

---

## Healing Log

Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.

```jsonl
{"date":"","issue":"","fix":"","source":"user|auto"}
```

*Adicionar nova linha após cada erro corrigido.*
