Como adicionar dados estruturados (schema JSON-LD) ao meu site com Claude Code ou Codex?

Peça ao agente para gerar o JSON-LD nos templates a partir dos mesmos dados que cada página mostra, só com tipos e valores visíveis ao leitor, renderizado no servidor. Escreva essa regra no CLAUDE.md ou no AGENTS.md para toda página nova seguir. Depois teste a URL publicada, não o código, no Teste de pesquisa aprimorada do Google.

Fatos

O Google recomenda o JSON-LD entre os 3 formatos de dados estruturados que aceita, quando a configuração do site permite. (Google Search Central: Introduction to structured data markup)
As diretrizes do Google mandam não marcar conteúdo que o leitor não vê, e itens sem as propriedades obrigatórias não ficam qualificados para resultados aprimorados. (Google Search Central: General structured data guidelines)
O Google diz que nenhum schema.org especial é necessário para aparecer nos AI Overviews ou no Modo IA, e que os dados estruturados devem bater com o texto visível. (Google Search Central: AI features and your website)
A marcação Organization vai na página inicial ou numa página sobre a empresa, não tem propriedade obrigatória, e o logo precisa ter no mínimo 112x112 pixels. (Google Search Central: Organization structured data)
O Claude Code carrega o CLAUDE.md do projeto em toda sessão, ao lado de uma memória automática de até 200 linhas ou 25KB. (Claude Code docs: How Claude remembers your project)
O Codex lê o AGENTS.md antes de qualquer trabalho e junta os arquivos de instruções até 32 KiB por padrão. (OpenAI Codex docs: Custom instructions with AGENTS.md)

Quais tipos de schema pedir ao agente?

Peça o tipo que corresponde ao que cada página mostra, e nada além:

Página	Tipo de schema	Propriedades principais
Inicial ou sobre	Organization (ou LocalBusiness)	name, url, logo, sameAs
Guia ou post de blog	Article	headline, author, datePublished, dateModified, publisher
Página de produto	Product	name, offers com o preço que a página mostra
Página com perguntas e respostas visíveis	FAQPage	Só as perguntas impressas na página

Que prompt dar ao Claude Code ou ao Codex?

Dê um conjunto de regras que ele aplique a todos os templates, proibindo valores inventados:

Adicione dados estruturados em JSON-LD a este site.
- Gere nos templates das páginas a partir dos mesmos dados que a página mostra.
  Nunca fixe no código um valor que a página não exibe.
- Organization (name, url, logo, sameAs) só na página inicial.
- Article nos guias e posts: headline, author, datePublished,
  dateModified (a última mudança real), publisher = a Organization.
- Product, LocalBusiness ou FAQPage só onde esse conteúdo está visível.
- Se um valor não existe, deixe a propriedade de fora. Não invente.
- Renderize no servidor, num <script type="application/ld+json">.
- Liste cada página alterada e os tipos que ela passou a ter.

Onde colocar a regra para as páginas novas também terem schema?

No arquivo de instruções que o agente carrega sozinho. O Claude Code lê o ./CLAUDE.md ou o ./.claude/CLAUDE.md no início de cada sessão, e o /init cria uma primeira versão. O Codex lê o AGENTS.md da raiz do projeto antes de qualquer trabalho. Uma regra curta ali mantém a próxima página igual à anterior.

Como conferir que o agente não inventou nada?

Teste a URL publicada no Teste de pesquisa aprimorada e compare cada valor com a página que o leitor vê. O teste por URL roda o JavaScript da página, o que o código colado não faz. Depois use a Inspeção de URL do Search Console para confirmar que o Google achou a marcação. Um teste válido só prova a sintaxe; os valores você confere.

Dados estruturados fazem o ChatGPT ou a IA do Google citar meu site?

Sozinhos, não. O Google diz que AI Overviews e Modo IA não pedem schema especial, e não garante resultados aprimorados para marcação válida. Um JSON-LD correto ajuda os buscadores a entender quem você é e o que a página é; o que é citado continua sendo a resposta escrita na página.

Passo a passo

Liste os tipos de página. Inicial, sobre, guias, produtos: um tipo de schema para cada.
Passe o prompt ao agente. Peça o JSON-LD nos templates a partir dos dados da própria página, sem valores inventados.
Grave a regra. Coloque no CLAUDE.md ou no AGENTS.md para as próximas páginas seguirem.
Revise o diff e faça o deploy. Confira que os valores vêm dos dados da página, não de texto fixo.
Teste a URL em produção. Rode o Teste de pesquisa aprimorada na página publicada e depois a Inspeção de URL no Search Console.

Erros comuns

Deixar o agente preencher notas, preços ou autores que a página não mostra.
Marcar FAQPage com perguntas que não aparecem na página.
Testar código colado em vez da URL publicada, perdendo o que o JavaScript renderiza.
Atualizar o dateModified a cada build, e não quando o conteúdo mudou.

Como o easyIndex resolve

O easyIndex nunca mexe no seu site: seu agente de código escreve as páginas e o schema, e o easyIndex audita cada página quando ela é enviada e confere de novo no site em produção depois do deploy, inclusive se ela tem JSON-LD e uma data real de atualização. O passo só conclui com essa evidência, não com o relato do agente.

Perguntas frequentes

JSON-LD, Microdata ou RDFa?

JSON-LD. O Google aceita os três e recomenda o JSON-LD quando a configuração do site permite.

O agente pode injetar o JSON-LD com JavaScript?

O Google processa o JSON-LD presente depois da renderização, mas a marcação renderizada no servidor é mais segura para rastreadores que não rodam JavaScript.

A Organization vai em todas as páginas?

O Google pede na página inicial ou numa página sobre a empresa; as outras podem citá-la como publisher.

Funciona igual no Cursor ou em outro agente?

Sim. Qualquer agente que edite seus templates segue o mesmo prompt; só muda o nome do arquivo de instruções.

Continue lendo

Verificado em 13 de outubro de 2026.