Pular para o conteúdo
Delivery API
Antes de planejar em torno de um recurso, confira o status dos recursos.

GuiasBusca e saúde do site

Busca e respostas de IA

Dê a cada página meta tags completas e dados estruturados, e sirva sitemap.xml, robots.txt e llms.txt a partir do seu próprio domínio.

Esta página foi traduzida do inglês. Se houver qualquer diferença, vale a versão em inglês. Ler em inglês

O Atlas prepara tudo o que os mecanismos de busca e os assistentes de IA leem sobre o seu site. O seu site só precisa exibir isso.

Para O que você recebe
Cada página Um head pronto: título, descrição, robots, links canônicos e de idioma, tags Open Graph e X/Twitter, e JSON-LD
Dados estruturados Organization, WebSite, WebPage, Article, Product, BreadcrumbList e FAQPage, já com escape para uso em uma tag script
sitemap.xml Todas as páginas publicadas indexáveis do release no ar, com alternativas de idioma
robots.txt Permite os mecanismos de busca, aponta para o sitemap e, se você escolher, mantém os crawlers de IA de fora
llms.txt Um resumo simples do seu site e das páginas dele para assistentes de IA

As páginas e os arquivos de Development são sempre marcados com noindex, então um site de teste nunca aparece na busca.

  1. No Studio, abra SEO & redirects → Search & AI.
  2. Em Organization and summary, preencha Organization name, Logo, Profiles elsewhere (suas páginas sociais e da empresa, uma por linha) e What the site is about (até 500 caracteres).
  3. Escolha AI crawlers: Allow AI assistants to read the site ou Keep AI crawlers out.
  4. Clique em Save settings. O site no ar recebe as configurações com o próximo release.

O cartão llms.txt mostra uma prévia do arquivo e lista as páginas sem resumo. Structured data per page mostra exatamente o que uma página vai exibir, para o rascunho atual ou para a versão publicada.

Por página, a aba Page do editor de páginas acrescenta uma Canonical page (um caminho no seu site) e uma Sharing image (por padrão, a primeira imagem da página).

A resposta pages da Delivery API inclui head: { title, meta[], links[], jsonLd[] }. Mapeie-o para os metadados do seu framework e imprima os blocos JSON-LD em tags <script type="application/ld+json">. Os blocos já têm escape, mas faça o parse e reserialize-os no seu código em vez de confiar cegamente em qualquer saída de um CMS.

head é null com headProblem: "SITE_ADDRESS_MISSING" quando o ambiente não tem endereço de site no Atlas. Adicione o endereço do site desse ambiente no Studio.

Sirva os três arquivos a partir do seu próprio domínio, fazendo proxy deles no seu servidor, para que o token de entrega continue privado:

// app/robots.txt/route.ts (do the same for sitemap.xml and llms.txt)
export async function GET() {
const response = await fetch(
`${process.env.ATLAS_CMS_ORIGIN}/v1/delivery/environments/${process.env.ATLAS_ENVIRONMENT_ID}/robots.txt`,
{ headers: { Authorization: `PublishedConsumer ${process.env.ATLAS_DELIVERY_TOKEN}` } },
);
const headers = new Headers({
'content-type': response.headers.get('content-type') ?? 'text/plain',
});
const robotsTag = response.headers.get('x-robots-tag');
if (robotsTag) headers.set('x-robots-tag', robotsTag);
return new Response(await response.text(), { status: response.status, headers });
}

Quando os crawlers de IA estão bloqueados, o robots.txt bloqueia GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, Claude-SearchBot, anthropic-ai, PerplexityBot, Google-Extended, Applebot-Extended, CCBot e meta-externalagent.

A auditoria de SEO agora também verifica o que ajuda os assistentes de IA a citar as suas páginas: um H1 por página, ordem dos títulos, perguntas de FAQ com respostas, respostas cuja primeira frase é curta (40 palavras ou menos), texto alternativo das imagens, links canônicos, uma imagem de compartilhamento e um resumo no llms.txt. São sugestões, nunca bloqueios.

  • Os links canônicos devem apontar para um caminho do seu próprio site.
  • O llms.txt lista até 2.000 páginas.
  • Ainda não há conexão com o Google Search Console.