Skip to content

SEO Guide

Jump to bottom
Neylon Santos edited this page Jun 17, 2025 · 1 revision

🔍 Guia Completo de SEO

Este guia documenta as otimizações de SEO implementadas no Contramaré e serve como referência para manter as boas práticas em todo o site.

📋 Índice

✅ Melhorias Implementadas

🔌 Plugins Essenciais de SEO

O Contramaré utiliza um conjunto de plugins Jekyll otimizados para SEO:

  • jekyll-seo-tag: Gera automaticamente meta tags estruturadas
  • jekyll-sitemap: Cria e mantém um sitemap.xml atualizado
  • jekyll-redirect-from: Gerencia redirecionamentos sem perder SEO
  • jekyll-compress-images: Otimiza imagens automaticamente durante o build

⚙️ Configurações Avançadas

No arquivo _config.yml, foram adicionadas configurações específicas para SEO:

# Configurações SEO
seo:
  type: Person
  name: Neylon Santos
  links:
    - https://neylon.xyz

social:
  name: Contramaré
  links:
    - https://contramare.com.br
    - https://x.com/contramare_page

google_analytics: G-RQ21K77JYG
google_site_verification: # Código de verificação do Search Console

🏷️ Meta Tags e Structured Data

O arquivo _includes/head.html foi aprimorado com:

  • JSON-LD Schema.org: Markup estruturado para melhor entendimento dos crawlers
  • Canonical URLs: Prevenção de conteúdo duplicado
  • Preload de recursos críticos: Carregamento otimizado de recursos importantes
  • Meta tags geográficas: Otimização para o mercado brasileiro
  • Apple Touch Icon e Theme Color: Melhor experiência para dispositivos Apple
  • Meta tags específicas para artigos: Informações estruturadas para posts

Exemplo de implementação:

<!-- Markup estruturado para artigo -->
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "BlogPosting",
  "headline": "{{ page.title }}",
  "datePublished": "{{ page.date | date_to_xmlschema }}",
  "author": {
    "@type": "Person",
    "name": "{{ site.author }}"
  }
}
</script>

📝 Estrutura Semântica dos Posts

O layout _layouts/post.html foi otimizado com:

  • Microdata Schema.org: Markup estruturado inline
  • Breadcrumb navigation: Trilha de navegação com structured data
  • Posts relacionados: Sistema de linking interno para melhor indexação
  • Tags semânticas: Uso de tags HTML5 como <main>, <article>, <section> 
<article itemscope itemtype="https://schema.org/BlogPosting">
  <meta itemprop="author" content="{{ site.author }}">
  <meta itemprop="datePublished" content="{{ page.date | date_to_xmlschema }}">
  <h1 itemprop="headline">{{ page.title }}</h1>
  <div itemprop="articleBody">
    {{ content }}
  </div>
</article>

🤖 robots.txt Otimizado

Arquivo personalizado para melhor controle de crawling:

User-agent: *
Allow: /
Sitemap: https://contramare.com.br/sitemap.xml
# Regras específicas para assets e diretórios

📰 Feed RSS Avançado

Sistema de feed RSS implementado e otimizado:

  • Plugin jekyll-feed: Configurado para máxima compatibilidade
  • Limite de 20 posts: Mantendo o feed leve e atualizado
  • Conteúdo completo: Posts inteiros em vez de apenas resumos
  • Feed automático: Disponível em /feed.xml
  • Metadados completos: Informações detalhadas para cada post

Configuração no _config.yml:

feed:
  posts_limit: 20
  excerpt_only: false
  collections:
    posts:
      path: "/feed.xml"

🔍 Página 404 Otimizada

Página de erro 404 otimizada para:

  • Meta tags específicas: Evita impacto negativo em métricas de SEO
  • Links de navegação: Facilita a recuperação do usuário
  • Posts recentes: Mantém o engajamento mesmo em páginas de erro
  • Tracking de erros: Monitoramento para identificar problemas

🎯 Próximos Passos Essenciais

1. Google Search Console

Passos para configuração:

  1. Acesse o Google Search Console
  2. Adicione o domínio contramare.com.br
  3. Verifique propriedade via HTML tag ou DNS
  4. Copie o código de verificação para _config.yml: 
    google_site_verification: "seu-código-aqui"

2. Google Analytics 4

Passos para implementação:

  1. Crie uma conta no Google Analytics
  2. Configure uma propriedade para contramare.com.br
  3. Copie o ID de medição (formato G-XXXXXXXXXX)
  4. Adicione ao _config.yml: 
    google_analytics: "G-XXXXXXXXXX"

3. Imagens Otimizadas

Crie e otimize estas imagens essenciais:

  • contramare-social-image.jpg (1200x630px): Imagem padrão para redes sociais
  • author.jpg: Foto do autor para rich snippets
  • Favicon em múltiplos tamanhos: 16x16, 32x32, 180x180 (Apple), 192x192 (Android)

4. Template para Novos Posts

Utilize o template SEO-friendly para novos posts:

---
layout: post
title: "Título SEO-friendly (máx 60 chars)"
description: "Meta descrição atrativa (150-160 chars)"
image: '/assets/uploads/post_images/imagem-otimizada.jpg'
categories: Reflexões
tags: [reflexão, crescimento, autocontrole]  # máx 5 tags
date: 2025-01-15 07:00:00 -0300
---

Conteúdo do post com pelo menos 2 links internos para outros posts...

📊 Checklist de SEO por Post

⏳ Antes de Publicar:

  • Título: Máximo 60 caracteres, contém palavra-chave principal
  • Descrição: 150-160 caracteres, text atrativo que gera cliques
  • Imagem: 1200x630px, nome de arquivo descritivo, alt text
  • Categorias: Máximo 2, use categorias existentes
  • Tags: Máximo 5, relevantes para o conteúdo
  • H2/H3: Estrutura clara de subtítulos com palavras-chave
  • Links internos: Pelo menos 2 para outros posts do blog
  • Densidade de palavra-chave: Entre 1-2% do conteúdo
  • Call-to-action: Incluído na conclusão do post

📨 Após Publicar:

  • Google Search Console: Solicitar indexação do novo URL
  • Redes sociais: Compartilhar com imagem otimizada
  • Internal linking: Adicionar links para o novo post em posts antigos
  • Monitor performance: Acompanhar métricas no Google Analytics

🔧 Comandos Úteis

Testar Posts em Draft:

bundle exec jekyll serve --drafts

Gerar Sitemap e Feed:

bundle exec jekyll build
# Sitemap disponível em _site/sitemap.xml
# Feed RSS disponível em _site/feed.xml

Otimizar Imagens:

# As imagens são comprimidas automaticamente durante o build
bundle exec jekyll build

📈 Métricas para Acompanhar

Google Search Console:

  • Impressões e cliques: Visibilidade nas buscas
  • CTR médio: Meta ideal superior a 2%
  • Posição média: Ranking das palavras-chave
  • Erros de rastreamento: Problemas técnicos

Google Analytics:

  • Tempo na página: Meta superior a 2 minutos
  • Taxa de rejeição: Meta inferior a 70%
  • Páginas por sessão: Meta superior a 1.5
  • Usuários recorrentes: Fidelização de leitores

🚀 Otimizações de Performance

✅ Implementadas:

  • Preload de fontes críticas: Carregamento otimizado de tipografia
  • Compressão SASS: CSS minificado
  • Lazy loading: Carregamento preguiçoso de imagens
  • Headers de segurança: Configurações para melhor segurança

🔜 Futuras:

  • Service Worker: Para cache e funcionamento offline
  • WebP: Formato de imagem moderno e eficiente
  • Critical CSS: CSS crítico inline para carregamento acima da dobra

📚 Recursos Adicionais

Ferramentas de SEO:

Documentação:

🔄 Integração com o Sistema Modular

O SEO do Contramaré é totalmente compatível com o Sistema de Funcionalidades Modulares. Quando uma funcionalidade é desativada:

  1. Os posts não aparecem nos resultados de busca (protegidos)
  2. Os links são removidos do sitemap automaticamente
  3. As meta tags são ajustadas para evitar indexação de conteúdo indisponível

🎯 Resultado Esperado

Com estas implementações, o Contramaré está otimizado para:

  • Indexação rápida pelos mecanismos de busca
  • Melhor ranking nas páginas de resultados
  • Maior CTR com rich snippets atraentes
  • Melhor experiência para o usuário
  • Performance superior em dispositivos móveis e desktop

Para mais informações sobre a implementação técnica, consulte a Arquitetura Técnica do projeto.

Custom footer

Clone this wiki locally