Pitch: Meu site renderizava tudo no client e o Google só via "Carregando…": como resolvi no Next.js
Ajudo a manter o Brasil Afora, um catálogo gratuito de bolsas, olimpíadas e programas pra estudantes brasileiros. É projeto voluntário, sem fins lucrativos, feito com Next.js (App Router), Postgres e TanStack Query.
Em setembro a gente subiu o sitemap e o Search Console começou a mostrar impressões. Só que as páginas de cada oportunidade, que são justamente as que deveriam aparecer pra buscas tipo "bolsa X inscrições 2027", ficavam na página 2 e boa parte nem era indexada.
Fui olhar o que o Googlebot recebia:
curl -s -A "Mozilla/5.0 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)" \
https://brasilafora.org/oportunidades/internacionais/<id> | grep -c "<h1"
Zero. O HTML inicial tinha umas 40 palavras e um "Carregando oportunidade…". A página era um componente client que buscava o registro com useQuery depois de montar. Pro usuário funcionava, mas o primeiro HTML era um esqueleto vazio. O Google até renderiza JavaScript, mas pra site novo e sem autoridade isso costuma virar "rastreada, mas não indexada".
A correção foi ler o registro no servidor e entregar pro React Query como initialData, sem reescrever a página. A page virou um server component:
export default async function NationalOpportunityDetailsPage(
props: PageProps<"/oportunidades/nacionais/[id]">
) {
const { id } = await props.params;
if (!(await getOpportunityMetadata("national", id))) {
notFound();
}
return (
<NacionalInfo
id={id}
initialOpportunity={await getNationalOpportunityForPage(id)}
/>
);
}
E o hook que a página já usava só ganhou um parâmetro:
export const useNationalOpportunityByIdQuery = (
id: string,
initialData?: NationalOpportunity
) =>
useQuery({
queryKey: opportunityQueryKeys.nationalById(id),
queryFn: () => getNationalOpportunityById(id),
enabled: id.length > 0,
initialData,
});
Um cuidado que me salvou: a leitura do servidor fica num módulo só (src/server/opportunity-detail.ts), e a rota /api/opportunities/[id] usa o mesmo leitor. Assim o objeto que a página recebe no servidor é exatamente o que o client buscaria depois, e não aparece diferença de hidratação nem lógica duplicada.
Aproveitei pra arrumar duas coisas que eu nem sabia que estavam erradas. Oportunidade escondida ou inexistente devolvia 200 com um texto "não encontrado". Agora chama notFound() e devolve 404 de verdade. E os títulos passaram pro formato de busca, "<nome>: inscrições, prazo e requisitos", em vez de só o nome.
Depois do deploy, o mesmo curl devolve umas 470 palavras e um h1. No Search Console as impressões diárias subiram um pouco (de 15–25 por dia no fim de setembro pra 20–60 em outubro), mas ainda é cedo pra dizer quanto é a correção e quanto é só o Google conhecendo o site.
Duas coisas que ainda não resolvi e queria opinião: as URLs ainda são UUID (/oportunidades/internacionais/<uuid>), e eu não sei se vale migrar pra slug agora ou se isso só bagunça o que já foi indexado. E algumas bolsas têm duas páginas (uma curada e uma do banco), cada uma com canonical pra si mesma. Imagino que o certo seja apontar o canonical da duplicada pra curada, mas se alguém já passou por isso, conta como foi.
Fonte: https://brasilafora.org