SEO & structured data

Next SEO

Componentes React sob licença MIT para dados estruturados em projetos Next.js

garmeeh/next-seoTypeScript8,496 as of 2026-08-02
By Jake Luo · Published 2 de ago. de 2026

Next SEO é uma biblioteca React sob licença MIT que renderiza dados estruturados do Schema.org —JSON-LD— dentro de um aplicativo Next.js, com componentes tipados para artigos, perguntas frequentes, produtos, trilhas de navegação, organizações e mais de duas dezenas de outros tipos. Sua linha atual estreitou de propósito: o README agora aponta para a própria API de metadados do Next.js para títulos e meta tags comuns, e mantém a biblioteca focada no JSON-LD que o framework não gera para você. Ela tira o trabalho repetitivo dos dados estruturados, não o julgamento sobre qual tipo cada página realmente é, nem sobre se os valores que você passa continuam verdadeiros.

O que o Next SEO é hoje

O Next SEO (github.com/garmeeh/next-seo) é uma biblioteca TypeScript, sob licença MIT e mantida desde 2018, que dá a um projeto Next.js componentes prontos para dados estruturados JSON-LD. Você importa um componente, passa props tipadas e ele renderiza a tag de script que diz a um buscador o que a página é: um artigo com autor e data, um produto com preço e política de devolução, um conjunto de perguntas frequentes, uma trilha de navegação, uma organização, um vídeo, uma vaga de emprego. O README documenta mais de duas dezenas deles, além de um primitivo JsonLdScript e uma biblioteca de processadores de entrada para os tipos de Schema.org que ele não cobre.

O fato mais interessante sobre o projeto é o que ele deixou de fazer. O Next SEO nasceu como a forma padrão de gerenciar títulos e meta tags no Next.js, quando o framework não tinha opinião sobre isso. Desde que o App Router trouxe uma API de metadados de primeira classe, quem faz esse trabalho é o próprio framework, e em vez de competir o README da biblioteca diz claramente para usar a função nativa nas meta tags comuns e reserva sua própria superfície para os dados estruturados, deixando os componentes antigos do Pages Router atrás de uma importação separada. Uma dependência que encolhe quando a plataforma absorve parte do trabalho dela é um sinal mais saudável do que uma que só cresce.

Onde os dados estruturados realmente ajudam

JSON-LD é um bloco de afirmações legíveis por máquina sobre uma página, colocado ao lado do texto para humanos. Não é um canal secreto e não transforma uma página fraca em forte. O que muda é o quanto sua página é legível para sistemas que precisam decidir, sem lê-la como uma pessoa leria, o que ela é e se vale reutilizá-la.

  • Elegibilidade para resultados ricos Alguns tipos podem mudar a aparência de um resultado na busca: avaliações, perguntas frequentes, produtos, eventos, receitas. A marcação correta torna uma página elegível; nunca obriga um buscador a exibir nada.
  • Legibilidade para motores de resposta Autor, data, entidade e pares de pergunta e resposta explícitos dão a um sistema de recuperação algo inequívoco para extrair, que é a metade mecânica da otimização para motores generativos.
  • Consistência interna Preencher um componente tipado obriga você a declarar quem escreveu uma página e quando, que é exatamente onde sites feitos à mão se contradizem em silêncio.

Para um SaaS pequeno ou uma loja, o conjunto útil é curto: um tipo de organização ou de aplicativo de software no site, tipos de artigo e de perguntas frequentes no conteúdo, trilhas de navegação para a estrutura, e tipos de produto e avaliação se você vende bens físicos. A biblioteca ainda aceita um nonce em cada script que renderiza, o que importa se você usa uma política de segurança de conteúdo estrita: o tipo de detalhe que custa uma tarde quando é feito à mão. O conceito em si está em marcação schema.

O que ele não faz

Dados estruturados não são uma alavanca de ranqueamento. O Google tem sido consistente em dizer que a marcação válida torna uma página elegível para certas apresentações em vez de posicioná-la mais acima, e nenhuma quantidade dela compensa uma página que ninguém tinha motivo para abrir. Trate como a diferença entre uma página que é entendida e uma que precisa ser adivinhada.

O que coloca uma biblioteca dessas firmemente do lado de construir, não do lado de crescer. Uma página perfeitamente marcada ainda precisa de uma pergunta que valha responder, de um motivo para alguém linkar e de irmãs suficientes para somar um tema. Se você está escolhendo o que publicar em vez de como anotar, SEO para um site novo é a decisão anterior, e open-seo é o lado de pesquisa do mesmo trabalho: este é o lado da renderização.

Uma observação em primeira mão sobre publicar schema

Na AgentCeres —o time de crescimento com IA em agentceres.com— escrevemos nosso JSON-LD à mão no App Router em vez de usar uma biblioteca, então isto é uma comparação do outro lado da escolha. Nosso erro não foi de sintaxe. Nossas páginas de perguntas e respostas emitiam originalmente o tipo QAPage, que parece a escolha óbvia, e estava errado: esse tipo descreve páginas em que visitantes publicam respostas concorrentes, e as nossas são escritas por nós. Trocamos para FAQPage. Nada na página mudou além da veracidade daquilo que a marcação afirmava, e uma biblioteca teria renderizado o tipo errado com a mesma limpeza do certo.

A segunda lição custou mais. Marcação é um conjunto de afirmações, e afirmações envelhecem em silêncio, porque quando isso acontece nada parece quebrado na página. Cada página das nossas seções /ask, /glossary e /grow é uma entrada tipada em controle de versão com uma bateria de testes que quebra o build diante de um link interno morto, um título meta longo demais ou uma data de publicação ausente, de modo que os valores que alimentam o schema não conseguem desviar sem que alguém perceba. O Next SEO compra sintaxe correta e economiza tempo real; nada compra fatos corretos além de decidir quais deles não podem ser digitados duas vezes. Essa distinção é a maior parte do que o nosso especialista em conteúdo de SEO faz cumprir.

FAQ

Ainda preciso do Next SEO com o App Router?
Para títulos, descrições e tags Open Graph comuns, não: a própria API de metadados do framework cobre isso, e o README da biblioteca diz exatamente isso. Para JSON-LD ele continua sendo uma conveniência real: props tipadas, padrões sensatos e uma opção de nonce ganham de montar à mão objetos aninhados do Schema.org, principalmente em tipos de produto, avaliação ou vaga com muitos campos obrigatórios.
Dados estruturados melhoram o ranqueamento?
Não diretamente. Eles tornam páginas elegíveis para apresentações mais ricas nos resultados e mais fáceis de interpretar por sistemas de recuperação, o que pode aumentar cliques e citações, mas não é um fator de ranqueamento em que se apoiar. Uma página com marcação perfeita e nada que valha ler continua invisível, então isso entra no fim de um fluxo de conteúdo e não no começo.
Posso escrever o JSON-LD à mão em vez de usar uma biblioteca?
Pode, e para um punhado de tipos de página é bem razoável: no fim, uma tag de script com um objeto JSON é tudo o que um componente renderiza. Nós fazemos exatamente isso. A troca é manutenção: schema escrito à mão desvia das mudanças do Schema.org e dos seus próprios dados, enquanto um componente tipado transforma um campo obrigatório ausente em erro de compilação em vez de omissão silenciosa.
Quais tipos de schema importam para um SaaS pequeno ou uma loja?
Menos do que a maioria dos guias sugere. Um tipo de organização no site inteiro, um tipo de aplicativo de software ou de produto para o que você vende, tipos de artigo no conteúdo real, tipos de perguntas frequentes onde você de fato responde perguntas, e trilhas de navegação. Lojas devem acrescentar tipos de produto, avaliação e política de devolução, que são os que mudam visivelmente um resultado. Todo o resto pode esperar até existir uma página que realmente precise.
Related projects
OpenSEOAlternativa de código aberto ao Semrush e ao Ahrefs — pesquisa de palavras-chave, backlinks e auditorias de site em um modelo pay-as-you-goDocusaurusGerador de sites estáticos de código aberto para documentação, publicado pela MetaPayloadCMS headless e framework de aplicação de código aberto, nativo do Next.js, que instala na pasta app que você já temWebstudioConstrutor visual de sites open source —uma alternativa ao Webflow que você mesmo hospeda

You built it. Now grow it.

AgentCeres is a managed AI marketing team — specialists draft the SEO, social, and outreach that fill your links, you approve what ships. 14-day free trial, from $39/month.

Start free trialMore projects