feat: refactor 30+ skills to Anthropic progressive disclosure pattern

- All SKILL.md files now <500 lines (avg reduction 69%)
- Detailed content extracted to references/ subdirectories
- Frontmatter standardised: only name + description (Anthropic standard)
- New skills: brand-guidelines, spec-coauthor, report-templates, skill-creator
- Design skills: anti-slop guidelines, premium-proposals reference
- Removed non-standard frontmatter fields (triggers, version, author, category)

Plugins affected: infraestrutura, marketing, dev-tools, crm-ops, gestao,
core-tools, negocio, perfex-dev, wordpress, design-media

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-03-12 15:05:03 +00:00
parent 9404af7ac9
commit 6b3a6f2698
397 changed files with 67154 additions and 17257 deletions

View File

@@ -1,14 +1,6 @@
---
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
description: Auditoria SEO completa com recomendacoes de optimizacao. Analisa SEO tecnico, conteudo, backlinks e desempenho.
---
# SEO Audit - Auditoria Completa
@@ -17,136 +9,71 @@ Skill para realizar auditorias SEO completas usando o stack de ferramentas insta
---
## 🎯 Quando Usar
## Contexto NotebookLM
- 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
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 tecnico, Core Web Vitals, backlinks, E-E-A-T>"
})
```
**Procedimento relacionado:** `PROC-DMARC-Email-Entregabilidade.md` -- consultar quando a auditoria envolve email deliverability.
---
## 📊 Google Updates 2026
## Quando Usar
- Auditar um site completo (tecnico + conteudo + performance)
- Verificar Core Web Vitals e ranking factors
- Analisar backlinks e autoridade de dominio
- Obter dados reais do Google Search Console
- Identificar oportunidades de optimizacao
- Comparar com concorrencia
---
## Google Updates 2026
### Core Algorithm Updates
| Update | Data | Impacto |
|--------|------|---------|
| **Helpful Content Q1** | Jan 2026 | Penaliza conteúdo AI de baixa qualidade |
| **Helpful Content Q1** | Jan 2026 | Penaliza conteudo 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) |
| **E-E-A-T Focus** | Q1-Q2 | Experiencia pratica obrigatoria |
| **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
1. **INP (Interaction to Next Paint)** -- Bom: < 200ms | Medio: 200-500ms | Mau: > 500ms
2. **E-E-A-T** -- Autor identificado com bio, credenciais verificaveis, experiencia real
3. **Page Experience Signals** -- HTTPS obrigatorio, intrusive interstitials penalizados
---
## 🔧 Ferramentas Disponíveis
## Workflow de Auditoria Completa
### 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)
### Passo 1: Analise Tecnica Basica (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
1. SEO Tools API -> /seo-audit -> Meta tags, headings, estrutura HTML
2. SEO Tools API -> /page-speed-analyzer -> Velocidade, sugestoes
3. Lighthouse -> run_audit -> Performance, SEO, Accessibility scores
```
**Checklist Crítico:**
**Checklist Critico:**
- [ ] Meta title (50-60 chars)
- [ ] Meta description (150-160 chars)
- [ ] H1 único com keyword
- [ ] H1 unico com keyword
- [ ] Canonical URL definido
- [ ] Robots.txt accessível
- [ ] Robots.txt acessivel
- [ ] Sitemap.xml presente
- [ ] HTTPS activo
- [ ] Mobile-friendly
@@ -154,66 +81,66 @@ curl "http://localhost:3000/competitor-analysis?url=URL&competitors=site1.com,si
### 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
1. Lighthouse -> get_core_web_vitals -> LCP, INP, CLS (mobile + desktop)
2. Lighthouse -> compare_mobile_desktop -> Identificar gaps
3. Lighthouse -> get_lcp_opportunities -> Sugestoes optimizacao
```
**Thresholds 2026:**
| Métrica | Bom | Necessita Melhoria | Mau |
| Metrica | 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)
### Passo 3: Analise de Conteudo (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
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
- [ ] Credenciais verificaveis
- [ ] Data publicacao/actualizacao
- [ ] Fontes citadas (links externos autoritativos)
- [ ] Experiência real demonstrada
- [ ] Experiencia 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
1. SEO Tools API -> /backlink-checker -> Backlinks basicos, DR/UR
2. SEO Ahrefs -> get_backlinks_list -> Lista detalhada (DR, anchor text)
3. SEO Ahrefs -> get_traffic -> Trafego 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)
**Metricas Autoridade:**
- **DR (Domain Rating)**: 0-100 (forca backlink profile)
- **UR (URL Rating)**: 0-100 (forca pagina especifica)
- **Backlinks**: Quantidade + qualidade (DR > 30)
- **Referring Domains**: Número de domínios únicos
- **Referring Domains**: Numero de dominios unicos
### 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
1. GSC -> get_search_analytics -> Queries, impressoes, CTR real (ultimos 90 dias)
2. GSC -> check_indexing_issues -> Problemas de indexacao
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
**Metricas GSC a Analisar:**
- **Impressoes vs Cliques**: CTR medio > 2%
- **Posicao media**: Top 3 para keywords principais
- **Cobertura**: % paginas indexadas vs submetidas
- **Mobile Usability**: Erros especificos mobile
### Passo 6: Concorrência (opcional, 2 min)
### Passo 6: Concorrencia (opcional, 2 min)
```
SEO Tools API /competitor-analysis Comparar com 2-3 concorrentes
SEO Tools API -> /competitor-analysis -> Comparar com 2-3 concorrentes
- Keywords gap
- Backlinks gap
- Content gap
@@ -221,220 +148,8 @@ SEO Tools API → /competitor-analysis → Comparar com 2-3 concorrentes
---
## 📄 Template de Relatório
## Propriedades GSC Disponiveis
```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/
@@ -445,103 +160,39 @@ https://alojadamaria.com/
https://e-commerce.descomplicar.pt/
```
### Limitações
---
## Notas Importantes
### Requisitos
- **SEO Tools API** deve estar a correr: `~/mcp-servers/seo-tools-api/start.sh`
- **GSC** requer autenticacao OAuth na primeira utilizacao
- **GA** requer ADC credentials configuradas
### Limitacoes
- 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)
- GSC data maximo: 16 meses historico
- Lighthouse scores variam +/- 5 pontos entre execucoes
---
## 📚 Datasets Dify (Consultar SEMPRE)
## References (conteudo detalhado)
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__notebooklm__notebook_query, 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
| Ficheiro | Conteudo |
|----------|----------|
| `references/template-relatorio-auditoria.md` | Template completo do relatorio com todas as seccoes e tabelas |
| `references/ferramentas-api.md` | Endpoints SEO Tools API, Lighthouse MCP, Ahrefs, GSC, GA |
---
## 📈 Instrumentação Automática
## Anti-Patterns
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}
);
```
- Auditar sem dados reais (nunca simular metricas)
- Ignorar gap mobile vs desktop
- Nao verificar se site esta no GSC antes de recolher dados
- Recomendacoes sem priorizacao (critico/importante/melhoria)
- Esquecer E-E-A-T na analise de conteudo
---
**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]
```
**Versao:** 2.1.0 | **Autor:** Descomplicar

View File

@@ -0,0 +1,94 @@
# Ferramentas e APIs - SEO Audit
## 1. SEO Tools API (http://localhost:3000)
```bash
# Auditoria basica
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"
# Optimizacao conteudo 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"
# Analise concorrencia
curl "http://localhost:3000/competitor-analysis?url=URL&competitors=site1.com,site2.com"
```
## 2. Lighthouse MCP
| Tool | Funcao | 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)` | Analise SEO tecnico | Meta, headings, indexabilidade |
| `get_security_audit(url)` | Seguranca | HTTPS, mixed content, headers |
| `compare_mobile_desktop(url)` | Comparacao | Diferencas performance |
| `get_lcp_opportunities(url)` | Optimizacoes LCP | Preload, lazy load |
| `find_unused_javascript(url)` | JS nao usado | Tamanhos, % savings |
## 3. SEO Ahrefs MCP (via API)
| Tool | Funcao | Dados |
|------|--------|-------|
| `get_backlinks_list(domain)` | Lista backlinks | DR, UR, anchor text |
| `keyword_generator(keyword, country)` | Ideias keywords | Volume, KD, CPC |
| `get_traffic(domain)` | Trafego estimado | Visitas mensais, keywords |
| `keyword_difficulty(keyword)` | Dificuldade keyword | 0-100 (KD score) |
## 4. Google Search Console MCP
| Tool | Funcao | Dados Reais |
|------|--------|-------------|
| `list_properties` | Listar sites verificados | URLs properties |
| `get_search_analytics(site, period)` | Queries, cliques, CTR | Ultimos 16 meses |
| `inspect_url_enhanced(site, url)` | Inspeccionar URL | Indexacao, mobile usability |
| `check_indexing_issues(site, urls)` | Problemas indexacao | Erros, avisos |
| `get_sitemaps(site)` | Listar sitemaps | Status, URLs submetidos |
## 5. Google Analytics MCP
| Tool | Funcao | Metricas |
|------|--------|----------|
| `get_account_summaries` | Listar contas | Properties disponiveis |
| `run_report(property, metrics, dimensions)` | Relatorio custom | Sessions, users, bounce rate |
| `run_realtime_report(property)` | Tempo real | Utilizadores activos now |
## 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/
```
## Requisitos
- **SEO Tools API** deve estar a correr: `~/mcp-servers/seo-tools-api/start.sh`
- **GSC** requer autenticacao OAuth na primeira utilizacao
- **GA** requer ADC credentials configuradas (`gcloud auth application-default login`)
## Limitacoes
- Ahrefs API tem rate limiting (100 req/day free tier)
- GSC data maximo: 16 meses historico
- Lighthouse scores variam +/- 5 pontos entre execucoes (network dependent)

View File

@@ -0,0 +1,195 @@
# Template Relatorio Auditoria SEO
```markdown
# Relatorio SEO - [DOMINIO]
**Data:** YYYY-MM-DD
**Versao:** 2.0 (2026 Standards)
---
## Resumo Executivo
| Metrica | Valor | Status |
|---------|-------|--------|
| **Score Geral** | X/100 | Bom / Medio / Critico |
| **Core Web Vitals** | LCP Xs | INP Xms | CLS X | OK / Aviso / Critico |
| **Backlinks** | X (DR: X) | Bom / Medio / Fraco |
| **Problemas Criticos** | X | Lista abaixo |
---
## 1. Analise Tecnica
### Meta Tags
- **Title**: [OK/NOK] - [Conteudo]
- **Description**: [OK/NOK] - [Conteudo]
- **Canonical**: [OK/NOK]
- **Open Graph**: [OK/NOK]
### Headings Structure
```
H1: [Texto] OK
H2: [Texto] OK
H3: [Texto] OK
H2: [Texto] Aviso (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
### Comparacao Mobile vs Desktop
| Metrica | Mobile | Desktop | Diferenca |
|---------|--------|---------|-----------|
| 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 nao usado**: X KB (X% savings)
2. **Code splitting**: Carregar so necessario
3. **Web Workers**: Tarefas pesadas off main thread
---
## 3. Conteudo e E-E-A-T
### On-Page SEO
| Factor | Status | Nota |
|--------|--------|------|
| Keyword no title | OK / NOK | |
| Keyword no H1 | OK / NOK | |
| Keyword primeiros 100 chars | OK / NOK | |
| Alt text imagens | OK / Aviso / NOK | X/Y com alt |
| Internal linking | OK / Aviso / NOK | X links internos |
| External links | OK / Aviso / NOK | X links autoritativos |
### E-E-A-T Score
| Criterio | Status | Observacao |
|----------|--------|------------|
| Autor identificado | OK / NOK | |
| Bio com credenciais | OK / NOK | |
| Data publicacao | OK / NOK | |
| Experiencia demonstrada | OK / NOK | |
| Fontes citadas | OK / NOK | X links externos |
---
## 4. Backlinks e Autoridade
### Perfil de Links
| Metrica | 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
| Dominio | DR | Anchor Text | DoFollow |
|---------|-----|-------------|----------|
| site1.com | 75 | [Texto] | Sim |
| ... | ... | ... | ... |
### Oportunidades
1. **Guest posts** em sites DR > 40
2. **Broken link building** (X links quebrados encontrados)
3. **Recuperar mencoes nao linkadas** (X mencoes)
---
## 5. Search Console (Dados Reais)
### Performance Ultimos 90 Dias
| Metrica | Valor | Variacao vs periodo anterior |
|---------|-------|------------------------------|
| **Cliques** | X | +X% / -X% |
| **Impressoes** | X | +X% / -X% |
| **CTR Medio** | X% | +X pp |
| **Posicao Media** | X | +X / -X |
### Top 10 Queries
| Query | Cliques | Impressoes | CTR | Posicao |
|-------|---------|------------|-----|---------|
| query1 | X | X | X% | X |
| ... | ... | ... | ... | ... |
### Oportunidades CTR
- **Posicao 4-10, CTR < 5%**: Optimizar meta description
- **Posicao 11-20**: Targets faceis para top 10
- **Alta impressao, baixo CTR**: Melhorar title/description
### Indexacao
| Estado | Paginas | Accao Necessaria |
|--------|---------|------------------|
| Indexadas | X | - |
| Excluidas | X | Investigar |
| Erros | X | Corrigir urgente |
---
## 6. Recomendacoes Prioritarias
### Critico (Fazer AGORA)
1. [ ] **[Problema]** - [Impacto] - [Solucao]
2. [ ] **[Problema]** - [Impacto] - [Solucao]
### Importante (Fazer esta semana)
1. [ ] **[Problema]** - [Impacto] - [Solucao]
2. [ ] **[Problema]** - [Impacto] - [Solucao]
### Melhoria (Fazer este mes)
1. [ ] **[Problema]** - [Impacto] - [Solucao]
2. [ ] **[Problema]** - [Impacto] - [Solucao]
---
## Roadmap Optimizacao (Q1-Q2 2026)
### Mes 1: Fundacao Tecnica
- [ ] Corrigir todos os problemas criticos
- [ ] Optimizar Core Web Vitals (target: All green)
- [ ] Implementar E-E-A-T basico (autor, datas, bio)
### Mes 2: Conteudo e Autoridade
- [ ] Actualizar conteudo underperforming (posicao 11-20)
- [ ] Criar conteudo para keywords gap vs concorrencia
- [ ] Campanha backlinks (target: +10 DR > 30)
### Mes 3: Consolidacao e Escala
- [ ] Monitorizar rankings e ajustar
- [ ] Expandir internal linking
- [ ] Criar cluster de conteudo para keywords principais
---
## Ferramentas Utilizadas
- SEO Tools API (localhost:3000)
- Lighthouse MCP
- SEO Ahrefs MCP
- Google Search Console MCP
- Google Analytics MCP (opcional)
---
**Proxima Auditoria**: [Data + 3 meses]
```