feat(marketing): adiciona plugin marketing (agents, skills, knowledge e metadados do projeto)
This commit is contained in:
@@ -0,0 +1,175 @@
|
||||
---
|
||||
name: seo-audit
|
||||
description: Auditoria SEO completa com recomendacoes de optimizacao. Analisa SEO tecnico, conteudo, backlinks e desempenho.
|
||||
layer: wiki
|
||||
---
|
||||
|
||||
# SEO Audit - Auditoria Completa
|
||||
|
||||
Skill para realizar auditorias SEO completas usando o stack de ferramentas instalado. Best practices 2026.
|
||||
|
||||
---
|
||||
|
||||
## 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 tecnico, Core Web Vitals, backlinks, E-E-A-T>"
|
||||
})
|
||||
```
|
||||
|
||||
**Procedimento relacionado:** `PROC-DMARC-Email-Entregabilidade.md` -- consultar quando a auditoria envolve email deliverability.
|
||||
|
||||
---
|
||||
|
||||
## 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 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 | Experiencia pratica obrigatoria |
|
||||
| **Mobile-First Index** | Universal | 100% dos sites |
|
||||
|
||||
### Novos Ranking Factors 2026
|
||||
|
||||
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
|
||||
|
||||
---
|
||||
|
||||
## Workflow de Auditoria Completa
|
||||
|
||||
### 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, sugestoes
|
||||
3. Lighthouse -> run_audit -> Performance, SEO, Accessibility scores
|
||||
```
|
||||
|
||||
**Checklist Critico:**
|
||||
- [ ] Meta title (50-60 chars)
|
||||
- [ ] Meta description (150-160 chars)
|
||||
- [ ] H1 unico com keyword
|
||||
- [ ] Canonical URL definido
|
||||
- [ ] Robots.txt acessivel
|
||||
- [ ] 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 -> Sugestoes optimizacao
|
||||
```
|
||||
|
||||
**Thresholds 2026:**
|
||||
|
||||
| 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: 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
|
||||
```
|
||||
|
||||
**Checklist E-E-A-T:**
|
||||
- [ ] Autor identificado com bio
|
||||
- [ ] Credenciais verificaveis
|
||||
- [ ] Data publicacao/actualizacao
|
||||
- [ ] Fontes citadas (links externos autoritativos)
|
||||
- [ ] Experiencia real demonstrada
|
||||
|
||||
### Passo 4: Backlinks e Autoridade (2 min)
|
||||
|
||||
```
|
||||
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
|
||||
```
|
||||
|
||||
**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**: Numero de dominios unicos
|
||||
|
||||
### Passo 5: Dados Reais GSC (3 min)
|
||||
|
||||
```
|
||||
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
|
||||
```
|
||||
|
||||
**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: Concorrencia (opcional, 2 min)
|
||||
|
||||
```
|
||||
SEO Tools API -> /competitor-analysis -> Comparar com 2-3 concorrentes
|
||||
- Keywords gap
|
||||
- Backlinks gap
|
||||
- Content gap
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 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 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 maxi
|
||||
@@ -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)
|
||||
@@ -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]
|
||||
```
|
||||
Reference in New Issue
Block a user