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:
- Rastreamento (crawling): o Googlebot solicita o endereço, recebe a resposta HTML e verifica as regras do
robots.txt. - 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.
- 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étodo | Como funciona? | Do ponto de vista do SEO |
|---|---|---|
| CSR (renderização no cliente) | O navegador recebe o esqueleto vazio e o script gera o conteúdo | A 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 navegador | O 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ção | Rápido e confiável; ideal para conteúdo que não muda com frequência |
| Híbrido | Combinação de SSR, SSG ou CSR conforme a página | Abordagem 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ê
- 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.
- 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.
- 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.
- 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.
- Verificação do índice: pesquise, entre aspas, uma frase da página com
site:seudominio.compara 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.