Pular para o conteúdo
PT · $
Acesso ao painel Comprar pacote
SEO Técnico

Fundamentos de SEO para JavaScript: Guia de Render, SSR e CSR

6 minutos de leitura

SEO para JavaScript é o trabalho de garantir que sites que geram conteúdo ou links com JavaScript sejam rastreados, executados e indexados corretamente pelos mecanismos de busca. Em um site construído com frameworks como React, Vue ou Angular, tudo pode parecer perfeito no seu navegador; mas o Googlebot processa a mesma página em condições diferentes e em duas etapas. Por isso, "funciona no meu computador" não é suficiente. Neste artigo, tratamos de como o Google processa o JavaScript, quais arquiteturas trazem quais riscos e o que você deve verificar na prática.

O que é SEO para JavaScript?

Em uma página web clássica, o servidor envia o conteúdo diretamente como HTML. Em sites com predominância de JavaScript, por outro lado, o servidor geralmente envia um esqueleto vazio e um pacote de scripts; o conteúdo real surge no navegador, depois que o script é executado. Do lado do mecanismo de busca, isso levanta a pergunta: o robô consegue executar o script e ver o conteúdo final, quando e com que grau de confiabilidade?

Hoje o Google consegue executar JavaScript; o problema é que essa capacidade não é incondicional nem instantânea. As seções a seguir mostram onde essa diferença aparece.

Como o Google processa o JavaScript?

Na documentação do Google, o processo é descrito em três etapas:

  1. Rastreamento (crawling): o Googlebot solicita o endereço, recebe a resposta HTML e verifica as regras do robots.txt.
  2. Renderização (rendering): a página é executada com uma versão atual do Chromium e o conteúdo final gerado pelo JavaScript é visto. Esta etapa entra em fila, ou seja, pode não acontecer imediatamente.
  3. Indexação: o texto e os links da página renderizada são adicionados ao índice; os novos links entram na fila de rastreamento.

Na prática: tudo o que está no HTML inicial é visto mais cedo e com mais confiabilidade. Conteúdo adicionado somente por JavaScript fica na fila de renderização e está sujeito a mais riscos; se o script apresentar erro, sofrer tempo limite ou for bloqueado, o conteúdo pode nunca ser visto.

Importante: mecanismos de busca diferentes do Google e alguns robôs de inteligência artificial podem não executar JavaScript tão bem quanto o Google. Oferecer o conteúdo crítico do seu site no HTML inicial é o caminho mais seguro também para esses robôs.

CSR, SSR e geração estática

MétodoComo funciona?Do ponto de vista do SEO
CSR (renderização no cliente)O navegador recebe o esqueleto vazio e o script gera o conteúdoA opção mais arriscada; o conteúdo depende da etapa de renderização
SSR (renderização no servidor)O servidor gera o HTML completo a cada requisição; depois o script assume no navegadorO conteúdo chega na primeira resposta; escolha forte para a maioria dos sites de conteúdo
SSG (geração estática)As páginas são geradas em HTML antes da publicaçãoRápido e confiável; ideal para conteúdo que não muda com frequência
HíbridoCombinação de SSR, SSG ou CSR conforme a páginaAbordagem comum em frameworks modernos; as páginas críticas devem usar SSR/SSG

O Google não recomenda mais, como solução permanente, a "renderização dinâmica" (servir HTML diferente para os robôs), que já foi sugerida antes; ele a descreve como uma solução provisória. Se você está iniciando um projeto novo, escolher SSR ou SSG também reduz a carga de manutenção. Consulte a documentação do framework que você usa (por exemplo, Next.js, Nuxt ou Astro) para ver como essas opções são oferecidas.

Problemas de SEO com JavaScript mais comuns

  • Conteúdo crítico chegando apenas por JS: título, descrição do produto, preço e texto principal correm risco se não estiverem no HTML inicial.
  • Arquivos JS/CSS bloqueados pelo robots.txt: o robô não consegue renderizar a página corretamente. Não bloqueie scripts importantes; para aprender essas regras, veja nosso guia de robots.txt.
  • Navegação que não usa links reais: elementos que funcionam apenas com evento de clique não são links rastreáveis.
  • Conteúdo carregado ao rolar ou clicar: o Googlebot não rola nem clica na página; o conteúdo que fica atrás do botão "mostrar mais" pode não ser visto.
  • Endereços baseados em hash (#): o identificador de fragmento (#/produtos) não é considerado uma página diferente.
  • Conteúdo que carrega tarde ou com erro: respostas lentas de API, tempo limite ou erro de script podem deixar o conteúdo vazio durante a renderização.
  • Gestão incorreta de meta tags: title, description e canonical que não são gerados corretamente para cada página.

Links e estrutura de URL

Para descobrir links, o Google observa o atributo href do elemento <a>. Os dois exemplos abaixo fazem a mesma coisa visualmente, mas apenas o primeiro é rastreável:

<!-- Rastreável -->
<a href="https://hitbot.org/urunler/ayakkabi">Calçados</a>

<!-- Não rastreável: sem href, apenas um ouvinte de evento -->
<span onclick="git('/urunler/ayakkabi')">Calçados</span>

Em aplicações de página única (SPA), ao navegar entre páginas, use a History API do navegador para criar um endereço real e único para cada visualização. Cada endereço deve entregar o mesmo conteúdo também quando aberto diretamente (atualização da página ou link compartilhado). Para a lógica geral dos links internos, veja nosso artigo sobre a estratégia de links internos.

Códigos de status, noindex e canonical

Este é o ponto mais negligenciado em aplicações JavaScript:

  • Páginas de erro: um endereço inexistente, em uma SPA, pode exibir "Página não encontrada" e ainda retornar HTTP 200. Isso é um soft 404. Faça o servidor retornar um 404 real ou adicione noindex na visualização de erro. Para detalhes, veja nosso artigo sobre erros 404 e SEO.
  • Noindex e JavaScript: se o HTML original tiver noindex, o Google pode pular a renderização da página; nesse caso, tentar remover o noindex com JavaScript não funciona. Nas páginas que devem ser indexadas, não coloque noindex no HTML inicial.
  • Canonical: sempre que possível, escreva-o no HTML inicial. Ele pode ser adicionado com JavaScript, mas dois canonicals conflitantes (um no HTML e outro no script) confundem o Google. Para a lógica do canonical, consulte nosso guia de canonical.
  • Redirecionamentos: prefira o redirecionamento HTTP feito no servidor a um redirecionamento por JavaScript; explicamos as diferenças em nosso artigo sobre 301 e 302.

Como testar o que o Google vê

  1. Compare o código-fonte: no navegador, compare "Exibir código-fonte da página" (HTML bruto) com a visualização Elements (DOM renderizado) das ferramentas do desenvolvedor. Se o texto principal aparece apenas na segunda, o conteúdo depende do JS.
  2. Inspeção de URL: no Search Console, inspecione o endereço, clique em "Testar URL ao vivo" e veja, em "Ver página testada", o HTML renderizado pelo Google e a captura de tela.
  3. Teste sem JavaScript: desative o JavaScript no navegador e abra a página. Se nada aparecer, o robô também verá uma página vazia na primeira etapa.
  4. Recursos que não carregam: na Inspeção de URL, verifique se há scripts ou chamadas de API bloqueados ou que não foram carregados.
  5. Verificação do índice: pesquise, entre aspas, uma frase da página com site:seudominio.com para confirmar se o conteúdo está indexado.

Se as páginas não estiverem sendo indexadas, relacione os status do Search Console com nosso guia de problemas de indexação para restringir a causa.

Checklist antes da publicação

Se você trabalha com uma equipe de desenvolvimento, marque como "sim / não" os itens abaixo antes de cada publicação importante:

  • O título, o texto principal e a imagem principal da página estão na primeira resposta HTML?
  • Cada página tem title e description exclusivos e uma tag canonical que aponta para o próprio endereço?
  • Os links do menu e da paginação são <a href> reais?
  • Os endereços inexistentes retornam um 404 real?
  • Os principais arquivos JS e CSS não estão bloqueados pelo robots.txt?
  • A página mostra pelo menos o conteúdo principal com o JavaScript desativado?
  • Quando há erro de script ou lentidão de API, a página fica vazia ou exibe um conteúdo de reserva razoável?
  • Quando uma nova rota é criada, ela entra no sitemap?

Essa lista é útil tanto em um site novo quanto em uma reformulação de design ou de infraestrutura de um site existente. Se a pessoa responsável pelo SEO compartilhar a lista no início do desenvolvimento, o custo de correção cai muito; afinal, depois que a arquitetura é definida, trocar o método de renderização é o trabalho mais caro.

Desempenho e JavaScript

Pacotes pesados de JavaScript pesam não só para o robô, mas também para o usuário. Scripts grandes podem piorar o atraso de interação (INP) e o tempo de carregamento (LCP). Divisão de código (code splitting), remoção de código não utilizado, limitação de scripts de terceiros e adiamento de scripts não críticos são passos básicos. Para as métricas, veja nosso guia de Core Web Vitals; para trabalhos gerais de velocidade, consulte nossos métodos de aumento da velocidade de página. Para a documentação oficial do Google, consulte os fundamentos de SEO para JavaScript.

Perguntas frequentes

O Google entende JavaScript completamente?

Em grande parte, sim, mas a renderização significa uma fila adicional e um atraso. Oferecer o conteúdo crítico no HTML inicial é o caminho mais seguro.

React ou Vue são ruins para SEO?

Não. O problema não é o framework, e sim a forma como o conteúdo é entregue. Com SSR ou geração estática, é possível fazer um SEO saudável com esses frameworks.

Devo usar renderização dinâmica?

O Google não a recomenda como solução de longo prazo. Em projetos novos, SSR ou SSG são escolhas mais adequadas.

O lazy loading prejudica o SEO?

Não, se for bem implementado. Use o carregamento nativo do navegador e não exija interação do usuário para que o conteúdo apareça, pois o Googlebot não clica nem rola a página.

Conclusão

A essência do SEO para JavaScript é esta: tudo o que você quer que o Google veja deve estar acessível no momento em que o robô visita a página. Coloque o conteúdo no HTML inicial, use links e endereços reais, retorne os códigos de status corretos, não bloqueie scripts importantes e valide regularmente a página renderizada com a Inspeção de URL. Se você incluir esses hábitos na sua lista de verificação de SEO técnico, a maioria dos problemas será detectada antes de chegar ao ar.

Faltam cliques na sua palavra-chave?

O HitBot gera sessões reais que pesquisam a palavra-chave que pretende, encontram o seu site e clicam nele. O resultado acumula-se no Search Console como impressões e cliques.

Outros artigos