GEO, Schema e JSON-LD para Ser Citado por Motores de LLM

2026-05-20T00:00:00+00:00
geo, schema e json-ld pra engine llm-ready</h2>
como estruturar schema pra ser citado por motor generativo (AI Overviews, Perplexity, ChatGPT), não só pra rich result do google. o ponto que muda tudo no fim: json-ld limpo deixou de ser comida de crawler, virou o input que o NLWeb consome e devolve.</p>

a arquitetura central: @graph e @id</h3>
a diferença entre amador e estado da arte: blocos isolados de json-ld soltos versus um único grafo conectado. cada entidade declarada uma vez, com @id estável, e todo o resto referenciando por { "@id": "..." }</code>. um único bloco @graph por página, não múltiplos scripts brigando.</p>
regra de ancoragem do @id (convergência dos guias de 2026 e do W3C JSON-LD Best Practices):</p>
entidades persistentes do site, que valem em todas as páginas, ancoram na raiz do domínio com fragmento. Organization em dominio.com/#organization. WebSite em dominio.com/#website. Person dos autores em dominio.com/#nome.</p>
entidades de página ancoram na URL da própria página mais fragmento. Article em dominio.com/artigo#article. WebPage em dominio.com/artigo#webpage. BreadcrumbList em dominio.com/artigo#breadcrumb. a entidade de página referencia as persistentes por @id, nunca duplica o objeto.</p>
ordem importa pra parser menos sofisticado: declare as persistentes (Organization, WebSite, Person) antes das de página (WebPage, Article, BreadcrumbList). não é requisito W3C, é higiene de engenharia pra um parser linear resolver os nós na ordem certa.</p>
os três bugs clássicos de auditoria, todos evitáveis com @id disciplinado:</p>

colisão de @id: dois nós com o mesmo @id geram merge imprevisível, o parser funde as duas coisas numa só.</li>
referência órfã: um @id referenciado que não existe em nenhuma entidade do grafo.</li>
duplicação por CMS: Yoast e RankMath injetam cada um seu bloco isolado, gerando dois Organization ou dois WebSite com dados divergentes. é o argumento mais forte pra centralizar a geração de schema numa camada única em vez de delegar a plugin.</li>
</ul>
concordância tripla (o GEO-16 coloca HTML semântico acima até de dados estruturados na correlação com citação): o texto visível, o HTML semântico (headings, listas, tabelas) e o json-ld precisam dizer a mesma coisa. schema que descreve conteúdo não visível na página é ignorado na melhor hipótese, sinal de spam na pior.</p>
tipos de schema por atividade e prioridade em ia</h3>
fundação quase onipresente: Organization ou LocalBusiness pra entidade da marca, WebSite (declara o site e o SearchAction), WebPage por página ligando ao WebSite e à mainEntity, Person pra autores e porta-vozes, BreadcrumbList refletindo a arquitetura.</p>
atividade</th> tipos primários</th> adições prioritárias 2026</th></tr></thead>

site editorial, blog</td> Article, BlogPosting, NewsArticle</td> SpeakableSpecification, Claim</td></tr>
e-commerce</td> Product, Offer, AggregateRating, Review</td> Dataset pra catálogo</td></tr>
negócio local</td> LocalBusiness</td> DefinedTerm pra serviços</td></tr>
saas, software</td> SoftwareApplication, Service</td> Dataset pra changelog, NLWeb /ask</td></tr>
docs, base de conhecimento</td> TechArticle, HowTo, Dataset</td> DefinedTermSet, NLWeb /ask</td></tr>
conteúdo de autoridade, pesquisa</td> Article, Person</td> Statement, Claim, ClaimReview</td></tr>
vídeo próprio</td> VideoObject</td> ponte pra entidade do canal</td></tr>
</tbody></table>
hierarquia de prioridade pra visibilidade em ia:</p>
tipo</th> impacto em citação ia</th> rich result google</th> prioridade</th></tr></thead>

Organization + sameAs Wikidata</td> fundação do grafo</td> indireto</td> 1</td></tr>
FAQPage</td> alto pra extração</td> depreciado maio 2026</td> 2</td></tr>
Article, BlogPosting</td> alto</td> Discover, Top Stories</td> 3</td></tr>
BreadcrumbList</td> médio-alto</td> breadcrumb visual</td> 4</td></tr>
Product + Offer</td> alto em e-commerce</td> rich result ativo</td> 5</td></tr>
DefinedTerm</td> autoridade semântica</td> nenhum</td> 6</td></tr>
Dataset</td> alto pra conteúdo com dados</td> nenhum</td> 7</td></tr>
</tbody></table>
tipos novos e subusados que valem o esforço: DefinedTerm e DefinedTermSet (glossários e vocabulário técnico de nicho, registra termo proprietário no grafo e desambigua o que não existe no Wikidata, extremamente subutilizado, é como você se firma como referência definitiva de um termo). Dataset (virou tipo de primeira classe porque alimenta pipeline RAG diretamente, todo artigo com tabela de métrica deveria declarar um nó Dataset referenciado pelo Article, com license e temporalCoverage). Claim, Statement, ClaimReview (crescendo com fact-checking integrado a llm, pra conteúdo editorial e de pesquisa). SoftwareSourceCode (marca conteúdo como referência técnica, não editorial). VideoObject (subestimado, o youtube é uma das fontes mais citadas por ia). SpeakableSpecification (sinaliza qual trecho do html é mais adequado pra extração direta, via cssSelector, vai no Article ou WebPage apontando pro resumo e os H2).</p>
o @graph de referência</h3>
{</span></span>
  "</span>@context</span>"</span>:</span> "</span>https://schema.org</span>"</span>,</span></span>
  "</span>@graph</span>"</span>:</span> [</span></span>
    {</span></span>
      "</span>@type</span>"</span>:</span> "</span>Organization</span>"</span>,</span></span>
      "</span>@id</span>"</span>:</span> "</span>https://exemplo.com/#organization</span>"</span>,</span></span>
      "</span>name</span>"</span>:</span> "</span>Exemplo</span>"</span>,</span></span>
      "</span>url</span>"</span>:</span> "</span>https://exemplo.com</span>"</span>,</span></span>
      "</span>sameAs</span>"</span>:</span> [</span>"</span>https://www.wikidata.org/wiki/Q000000</span>"</span>]</span>,</span></span>
      "</span>knowsAbout</span>"</span>:</span> [</span>"</span>generative engine optimization</span>"</span>,</span> "</span>schema.org</span>"</span>,</span> "</span>json-ld</span>"</span>]</span></span>
    }</span>,</span></span>
    {</span></span>
      "</span>@type</span>"</span>:</span> "</span>WebSite</span>"</span>,</span></span>
      "</span>@id</span>"</span>:</span> "</span>https://exemplo.com/#website</span>"</span>,</span></span>
      "</span>url</span>"</span>:</span> "</span>https://exemplo.com</span>"</span>,</span></span>
      "</span>publisher</span>"</span>:</span> {</span> "</span>@id</span>"</span>:</span> "</span>https://exemplo.com/#organization</span>"</span> }</span>,</span></span>
      "</span>potentialAction</span>"</span>:</span> {</span></span>
        "</span>@type</span>"</span>:</span> "</span>SearchAction</span>"</span>,</span></span>
        "</span>target</span>"</span>:</span> "</span>https://exemplo.com/busca?q={query}</span>"</span>,</span></span>
        "</span>query-input</span>"</span>:</span> "</span>required name=query</span>"</span></span>
      }</span></span>
    }</span>,</span></span>
    {</span></span>
      "</span>@type</span>"</span>:</span> "</span>Person</span>"</span>,</span></span>
      "</span>@id</span>"</span>:</span> "</span>https://exemplo.com/#alberto</span>"</span>,</span></span>
      "</span>name</span>"</span>:</span> "</span>Alberto</span>"</span>,</span></span>
      "</span>sameAs</span>"</span>:</span> [</span>"</span>https://www.wikidata.org/wiki/Q000001</span>"</span>]</span>,</span></span>
      "</span>knowsAbout</span>"</span>:</span> [</span>"</span>arquitetura de dados</span>"</span>,</span> "</span>llm tooling</span>"</span>]</span></span>
    }</span>,</span></span>
    {</span></span>
      "</span>@type</span>"</span>:</span> "</span>WebPage</span>"</span>,</span></span>
      "</span>@id</span>"</span>:</span> "</span>https://exemplo.com/artigo#webpage</span>"</span>,</span></span>
      "</span>url</span>"</span>:</span> "</span>https://exemplo.com/artigo</span>"</span>,</span></span>
      "</span>isPartOf</span>"</span>:</span> {</span> "</span>@id</span>"</span>:</span> "</span>https://exemplo.com/#website</span>"</span> }</span>,</span></span>
      "</span>speakable</span>"</span>:</span> {</span></span>
        "</span>@type</span>"</span>:</span> "</span>SpeakableSpecification</span>"</span>,</span></span>
        "</span>cssSelector</span>"</span>:</span> [</span>"</span>.resumo</span>"</span>,</span> "</span>h2</span>"</span>]</span></span>
      }</span></span>
    }</span>,</span></span>
    {</span></span>
      "</span>@type</span>"</span>:</span> "</span>Article</span>"</span>,</span></span>
      "</span>@id</span>"</span>:</span> "</span>https://exemplo.com/artigo#article</span>"</span>,</span></span>
      "</span>headline</span>"</span>:</span> "</span>titulo do artigo</span>"</span>,</span></span>
      "</span>isPartOf</span>"</span>:</span> {</span> "</span>@id</span>"</span>:</span> "</span>https://exemplo.com/artigo#webpage</span>"</span> }</span>,</span></span>
      "</span>author</span>"</span>:</span> {</span> "</span>@id</span>"</span>:</span> "</span>https://exemplo.com/#alberto</span>"</span> }</span>,</span></span>
      "</span>publisher</span>"</span>:</span> {</span> "</span>@id</span>"</span>:</span> "</span>https://exemplo.com/#organization</span>"</span> }</span>,</span></span>
      "</span>datePublished</span>"</span>:</span> "</span>2026-06-15</span>"</span>,</span></span>
      "</span>dateModified</span>"</span>:</span> "</span>2026-06-15</span>"</span>,</span></span>
      "</span>mentions</span>"</span>:</span> [</span>{</span> "</span>@id</span>"</span>:</span> "</span>https://exemplo.com/artigo#dataset-metricas</span>"</span> }</span>]</span></span>
    }</span>,</span></span>
    {</span></span>
      "</span>@type</span>"</span>:</span> "</span>Dataset</span>"</span>,</span></span>
      "</span>@id</span>"</span>:</span> "</span>https://exemplo.com/artigo#dataset-metricas</span>"</span>,</span></span>
      "</span>name</span>"</span>:</span> "</span>metricas de schema e citacao por IA 2026</span>"</span>,</span></span>
      "</span>isPartOf</span>"</span>:</span> {</span> "</span>@id</span>"</span>:</span> "</span>https://exemplo.com/artigo#article</span>"</span> }</span>,</span></span>
      "</span>license</span>"</span>:</span> "</span>https://creativecommons.org/licenses/by/4.0/</span>"</span>,</span></span>
      "</span>temporalCoverage</span>"</span>:</span> "</span>2024/2026</span>"</span></span>
    }</span>,</span></span>
    {</span></span>
      "</span>@type</span>"</span>:</span> "</span>BreadcrumbList</span>"</span>,</span></span>
      "</span>@id</span>"</span>:</span> "</span>https://exemplo.com/artigo#breadcrumb</span>"</span>,</span></span>
      "</span>itemListElement</span>"</span>:</span> [</span></span>
        {</span> "</span>@type</span>"</span>:</span> "</span>ListItem</span>"</span>,</span> "</span>position</span>"</span>:</span> 1</span>,</span> "</span>name</span>"</span>:</span> "</span>home</span>"</span>,</span> "</span>item</span>"</span>:</span> "</span>https://exemplo.com</span>"</span> }</span>,</span></span>
        {</span> "</span>@type</span>"</span>:</span> "</span>ListItem</span>"</span>,</span> "</span>position</span>"</span>:</span> 2</span>,</span> "</span>name</span>"</span>:</span> "</span>artigo</span>"</span>,</span> "</span>item</span>"</span>:</span> "</span>https://exemplo.com/artigo</span>"</span> }</span></span>
      ]</span></span>
    }</span></span>
  ]</span></span>
}</span></span></code></pre>
leia esse grafo como um banco de entidades, não uma lista de tags. Organization, WebSite e Person existem uma vez. WebPage e Article apontam pra elas. Dataset pendura no Article. é isso que um motor generativo costura quando monta a resposta e decide a quem atribuir.</p>
implementação por plataforma</h3>
o princípio que não muda: o @graph é artefato de dados, não de UI. serializado uma vez a partir da fonte da verdade, presente onde o consumidor olha antes de qualquer execução de cliente. pra web, o consumidor é um crawler que lê o html inicial, então json-ld no html que chega antes do js rodar, server-side sempre, nunca via useEffect ou componentDidMount. pra nativo, não existe crawler lendo a tela do app, o vetor é o endpoint que o backend expõe (NLWeb /ask e /mcp).</p>
fonte da verdade comum: modele o domínio como entidades e relações, não como páginas. defina tipos com schema de validação na linguagem do backend (JSON Schema, Pydantic em python, Zod ou schema-dts em ts, serde em rust, Codable em swift, kotlinx.serialization em kotlin). cada entidade com identificador interno estável que mapeia um a um pro @id. registre provenance, data de atualização, idioma e flags de confiança, que servem tanto pro json-ld quanto pro RAG. centralize a geração num módulo único (ex lib/schema), funções puras que recebem a entidade interna e devolvem o objeto json-ld validado. é esse módulo que mata a duplicação de plugin.</p>
next.js (app router, padrão atual): schema em server component, nunca client component. schema-dts é o pacote oficial do google oss, type-only, sem custo de runtime, cerca de 100 mil downloads/semana, compatível com schema.org v30, suporta @graph e @id stubs. dois layers: layout raiz (app/layout.tsx) pras persistentes, page component pras de página. pra blog e editorial prefira SSG ou ISR sobre SSR puro, o schema é gerado no build ou na revalidação. next-seo + schema-dts cobre a maioria dos casos.</p>
//</span> app/blog/[slug]/page.tsx, Server Component</span></span>
import</span> type</span> {</span> Graph</span>,</span> WithContext</span> }</span> from</span> '</span>schema-dts</span>'</span></span>
export</span> default</span> async</span> function</span> ArticlePage</span>(</span>{</span> params</span> }</span>)</span> {</span></span>
  const</span> post</span> =</span> await</span> getPost</span>(</span>params</span>.</span>slug</span>)</span></span>
  const</span> schema</span>:</span> WithContext</span><</span>Graph</span>></span> =</span> {</span></span>
    '</span>@context</span>'</span>:</span> '</span>https://schema.org</span>'</span>,</span></span>
    '</span>@graph</span>'</span>:</span> [</span>{</span></span>
      '</span>@type</span>'</span>:</span> '</span>Article</span>'</span>,</span></span>
      '</span>@id</span>'</span>:</span> `</span>https://exemplo.com/blog/</span>${</span>params</span>.</span>slug</span>}</span>#article</span>`</span>,</span></span>
      headline</span>:</span> post</span>.</span>title</span>,</span></span>
      author</span>:</span> {</span> '</span>@id</span>'</span>:</span> '</span>https://exemplo.com/#alberto</span>'</span> }</span>,</span></span>
      publisher</span>:</span> {</span> '</span>@id</span>'</span>:</span> '</span>https://exemplo.com/#organization</span>'</span> }</span>,</span></span>
      datePublished</span>:</span> post</span>.</span>publishedAt</span>,</span></span>
      dateModified</span>:</span> post</span>.</span>updatedAt</span>,</span></span>
    }</span>]</span>,</span></span>
  }</span></span>
  return</span> (</span></span>
    <</span>></span></span>
      <</span>script</span> type</span>=</span>"</span>application/ld+json</span>"</span></span>
        dangerouslySetInnerHTML</span>=</span>{</span>{</span> __html</span>:</span> JSON</span>.</span>stringify</span>(</span>schema</span>)</span> }</span>}</span> /></span></span>
    </</span>></span></span>
  )</span></span>
}</span></span></code></pre>
spa pura (vite, cra): problema não resolvido de forma confiável, a maioria dos crawlers de ia não executa js. conteúdo estático vai direto no index.html ou via react-helmet-async no build. conteúdo dinâmico precisa de pre-rendering (Prerender.io, Rendertron) ou migração pra meta-framework com ssr. backends de outras linguagens (rails, django, laravel, go, php): idêntico, gere o @graph no servidor e imprima a tag script no template antes de servir.</p>
rust e wasm, dois cenários: rust no servidor (axum, actix, leptos ssr) é o caso fácil e mais forte. modele as entidades com serde, derive Serialize, serialize o @graph pra string ao renderizar, injeta a tag script no html. é a forma mais limpa porque a fonte da verdade e o serializador são a mesma linguagem fortemente tipada.</p>
#</span>[</span>derive</span>(</span>serde</span>::</span>Serialize</span>)</span>]</span></span>
struct</span> Article</span><</span>'</span>a</span>></span> {</span></span>
    #</span>[</span>serde</span>(</span>rename </span>=</span> "</span>@type</span>"</span>)</span>]</span> kind</span>:</span> &</span>'</span>a</span> str</span>,</span></span>
    #</span>[</span>serde</span>(</span>rename </span>=</span> "</span>@id</span>"</span>)</span>]</span> id</span>:</span> String</span>,</span></span>
    headline</span>:</span> &</span>'</span>a</span> str</span>,</span></span>
    author</span>:</span> IdRef</span><</span>'</span>a</span>></span>,</span>     //</span> { "@id": "..." }</span></span>
    publisher</span>:</span> IdRef</span><</span>'</span>a</span>></span>,</span></span>
    #</span>[</span>serde</span>(</span>rename </span>=</span> "</span>datePublished</span>"</span>)</span>]</span> published</span>:</span> &</span>'</span>a</span> str</span>,</span></span>
}</span></span>
//</span> serde_json::to_string(&graph) vira o conteudo da <script type="application/ld+json"></span></span></code></pre>
rust compilado pra wasm no browser cai no mesmo poço da spa: se o wasm monta a página no cliente, o crawler não vê. a saída é renderizar no servidor (leptos, dioxus com ssr) ou pre-renderizar. wasm client-side não resolve descoberta por ia sozinho, o wasm é ótimo pra lógica do app, não pra entregar schema a crawler.</p>
swift/ios, kotlin/android, nativo: o ponto que a maioria dos guias erra, não existe crawler lendo a UI de um app nativo, botar json-ld numa SwiftUI view ou Composable não gera visibilidade. o que torna conteúdo nativo descobrível por ia é do lado servidor: o backend expõe o mesmo @graph via web e via endpoint estruturado, o app consome esse backend (Codable, kotlinx.serialization), e o mesmo backend serve o json-ld pra crawlers e o /ask e /mcp pra agentes. o Google App Indexing (deep link e ViewAction no AndroidManifest) foi descontinuado, universal links e app links continuam úteis pra abrir o app a partir de uma URL mas isso é roteamento, não descoberta semântica. o SO (macos, ios, linux) é irrelevante pra camada de schema, que é sempre servidor + html ou endpoint.</p>
plataforma</th> onde o schema vive</th> mecanismo</th></tr></thead>

Next.js, Nuxt, SvelteKit, Astro</td> server component / ssr / ssg</td> tag script no html inicial</td></tr>
Rails, Django, Laravel, Go, PHP</td> template no servidor</td> tag script no html inicial</td></tr>
SPA pura (Vite, CRA)</td> index.html ou pre-render</td> html servido, não cliente</td></tr>
Rust servidor (axum, leptos ssr)</td> serde no handler</td> tag script no html inicial</td></tr>
Rust/wasm no cliente</td> pré-render ou ssr</td> nunca só no cliente</td></tr>
Swift/iOS, Kotlin/Android</td> backend que o app consome</td> endpoint, /ask e /mcp</td></tr>
desktop macos/linux</td> backend que o app consome</td> endpoint, /ask e /mcp</td></tr>
</tbody></table>
validação contínua no CI/CD: schema quebra em silêncio, mudança de estrutura no CMS que corrompe um @id só aparece semanas depois quando as citações somem. adicione lint antes de cada deploy. Schema Markup Validator (validator.schema.org) valida sintaxe contra o vocabulário. Rich Results Test verifica elegibilidade dos rich results que ainda existem (Product, Review, Event). em ts, schema-dts pega erro em compile-time. trate o @graph como contrato, @id instável quebra o NLWeb tanto quanto quebraria um schema GraphQL.</p>
FAQPage: o que morreu em 7 de maio de 2026</h3>
deprecação em três datas, todas num aviso pequeno no topo da doc de FAQ structured data do google, sem blog post nem explicação. 7 de maio de 2026: os rich results de FAQ pararam de aparecer. junho de 2026: removidos o filtro de aparição, o relatório no Search Console e o suporte no Rich Results Test. agosto de 2026: removido o suporte na API do Search Console.</p>
o que continua: FAQPage segue tipo schema.org totalmente válido. o google depreciou a feature de exibição, não a marcação. a própria doc do google diz que dados estruturados não usados não causam problema, você pode deixar a marcação no lugar, e ela continua sendo rastreada por Bingbot, PerplexityBot e crawlers de RAG que indexam a web aberta. o schema nunca fez o trabalho, o conteúdo sempre fez. clear, direct, question-led content é um dos sinais mais fortes pra citação em ia, e FAQPage diz ao modelo de forma explícita “aqui está a pergunta, aqui está a resposta, esta fonte disse isso”. um estudo da Ahrefs de fevereiro de 2026 achou que só 38% das páginas citadas em AI Overviews ranqueiam no top 10 da busca tradicional, ou seja os sinais que ganham citação em ia não são os mesmos que ganham ranking clássico.</p>
decisão prática: mantenha FAQPage onde pergunta e resposta são reais, úteis e visíveis na página. remova só se a marcação aponta pra conteúdo que não existe mais, ou se a seção era magra e foi posta só pra enfeite de SERP. arquive o histórico de aparição de FAQ antes do sunset.</p>
NLWeb e MCP: o site vira endpoint conversacional</h3>
lançado pela microsoft no Build 2025, criado por R.V. Guha (a mesma pessoa por trás de RSS, RDF e Schema.org). early adopters: Shopify, Snowflake, O’Reilly, Tripadvisor, Eventbrite, Hearst. transforma um site em servidor MCP com dois endpoints.</p>
/ask, REST que aceita query em linguagem natural e devolve json estruturado em schema.org. o usuário pergunta “qual o preço enterprise” e recebe um json com o dado real, não um link pra formulário de contato.</p>
/mcp, endpoint agent-to-agent sobre o Model Context Protocol (o mesmo MCP da anthropic). torna o site descobrível e chamável por agentes como o Operator da OpenAI ou o Project Mariner do Google, sem raspar html.</p>
os argumentos da api são iguais nos dois, a diferença é o formato do objeto de retorno (pra /mcp é objeto MCP). a implementação de referência é stateless, pra manter contexto entre chamadas você gerencia os prompts anteriores e reusa pra montar a query nova.</p>
a implicação: json-ld limpo deixou de ser só comida de crawler, é o input que o NLWeb consome e o formato que devolve. um @graph bem construído com @id estável e entidades conectadas vira uma api conversacional sem reescrever o backend. os melhores resultados vêm de sites já estruturados como listas de itens (receitas, eventos, lugares, produtos). dado de junho 2026: cada endpoint NLWeb é nativamente também um ChatGPT app, suporta A2A além de MCP, e o stack de referência aceita PostgreSQL com pgvector como retriever nativo. repositório migrou pra nlweb-ai/NLWeb (python, com AskAgent, AgentFinder, DataFinder, ModelRouter), antes em github.com/microsoft/NLWeb.</p>
POST https://exemplo.com/ask</span></span>
Content-Type: application/json</span></span>
</span>
{ "query": "quem escreveu sobre GEO neste site?", "site": "https://exemplo.com" }</span></span></code></pre>
por que isso é o vetor do nativo: pra um app swift ou kotlin sem versão web, expor um NLWeb /ask e /mcp sobre os dados é o que torna o conteúdo descobrível por agentes. é a ponte entre o grafo e o mundo agêntico.</p>
robots.txt, user agents de ia, llms.txt</h3>
se você quer ser citado por ia, mantenha destravados os user agents de llm no robots.txt. bloquear deve ser decisão estratégica (ex conteúdo pago), sabendo que remove você de um canal de aquisição em crescimento.</p>
User-agent: GPTBot</span></span>
Allow: /</span></span>
User-agent: OAI-SearchBot</span></span>
Allow: /</span></span>
User-agent: PerplexityBot</span></span>
Allow: /</span></span>
User-agent: ClaudeBot</span></span>
Allow: /</span></span>
User-agent: Google-Extended</span></span>
Allow: /</span></span>
User-agent: CCBot</span></span>
Allow: /</span></span></code></pre>
GPTBot e OAI-SearchBot são da OpenAI, PerplexityBot da Perplexity, ClaudeBot da Anthropic, Google-Extended controla uso em Gemini, CCBot é o CommonCrawl.</p>
llms.txt, o veredito honesto: é real, é um índice em markdown de URLs importantes, não é mecanismo de bloqueio nem de ranking. o google não usa e não planeja usar (Gary Illyes e John Mueller já desinflaram o hype). alguns crawlers de llm e ferramentas de RAG têm suporte experimental, sem consenso de mercado. trate como camada opcional de discoverability, depois que json-ld, sitemaps e html semântico estiverem prontos, nunca como prioridade.</p>
arquitetura de dados em quatro camadas (engine llm-ready)</h3>
camada 1, conteúdo e entidades, a fonte da verdade. modele o domínio como entidades e relações (Organization, Product, Feature, UseCase, Persona, Article, FAQ, Release). defina tipos, campos, enums, constraints e o significado de null e unknown com schema de validação. cada entidade com identificador estável único mapeável um a um com o @id. registre provenance, data de atualização, flags de confiança, idioma e público-alvo. é o grafo interno da aplicação, independente de schema.org.</p>
camada 2, exposição pública, json-ld + html semântico. traduz o grafo interno pra schema.org. cada entidade persistente vira um nó com @id estável baseado no identificador interno, numa biblioteca compartilhada. cada template de página vira o @graph parcial. injete via ssr, ssg ou isr no html inicial. garanta a concordância tripla.</p>
camada 3, retrieval e indexação pra llm, o RAG. crie índices vetoriais onde cada chunk carrega o texto, a referência ao @id da entidade, o tipo (Article, FAQ, Doc), data de atualização e idioma. use o mesmo vocabulário de identificadores em todo lugar (organizationId, productId, articleId) pro llm costurar resposta coerente entre json-ld, documentos internos e api. pra dados tabulares (preços, specs) mantenha tabelas e jsons com schema definido e exponha pro RAG e via tools.</p>
camada 4, aplicação e engine, llm + tools + front-end. defina tools com schema de entrada e saída claro expondo operações sobre as entidades (buscarProductById, listarFaqsPorTema, obterResumoArticle). use o llm em structured output ou tool calling com validação de schema, reduz alucinação e acopla a resposta ao grafo. no front-end trate a resposta do llm como visão sobre o grafo, não verdade em si: sempre exiba a fonte, use os @id pra montar links, breadcrumbs e cards.</p>
o princípio que amarra as quatro: o mesmo modelo de entidade vive no json-ld público, no backend, no contrato das tools e nos tipos do front-end. o front-end nunca inventa tipo, consome entidade tipada, componente de UI é função de entidade + contexto. e instrumente observabilidade: logue quando o llm cita uma entidade por @id e quais páginas usou, compare com referrals de AI Overviews e ChatGPT pra ver se mudança de schema reflete em mais citação.</p>
sinais de qualidade que amplificam o schema</h3>
dois pontos com fonte: citar outras fontes dentro do seu conteúdo aumenta a chance de você ser citado por ia, sinaliza rigor epistêmico (método Quotation Addition do paper GEO). conteúdo com dados específicos e verificáveis, estatística com atribuição clara, recebe citação preferencial sobre afirmação vaga (Statistics Addition, achado de 30 a 40% mais visibilidade com estatística original).</p>
síntese: lidere com resposta (TL;DR ou key takeaways no topo), parágrafos compactos, headings e listas descritivas, marque o que é afirmação versus opinião, mantenha um único H1 e hierarquia lógica de H2/H3, json-ld válido com datePublished/dateModified/author/breadcrumb, schema batendo com o conteúdo visível, fontes primárias citadas inline com seção de referências.</p>
checklist consolidado</h3>

um único bloco @graph por página.</li>
persistentes (Organization, WebSite, Person) declaradas uma vez, ancoradas na raiz com #, na camada global.</li>
entidades de página (WebPage, Article, Product, BreadcrumbList) ancoradas na URL + #fragmento, referenciando as persistentes por @id.</li>
ordem: persistentes antes das de página.</li>
sameAs pra Wikidata em Organization e Person.</li>
knowsAbout em Organization e Person com os tópicos de autoridade reais.</li>
mentions pra entidades secundárias importantes.</li>
SpeakableSpecification em Article e WebPage, cssSelector do resumo e dos H2.</li>
Dataset quando há dados tabulares ou métricas, com license e temporalCoverage.</li>
DefinedTerm pra vocabulário proprietário sem entrada no Wikidata.</li>
dateModified real e atualizado a cada edição.</li>
json-ld no html inicial via ssr/ssg/isr, nunca via useEffect. em nativo, via endpoint.</li>
tipagem do schema na linguagem do backend (schema-dts no ts, serde no rust, Pydantic no python).</li>
concordância tripla: texto visível, html semântico e json-ld dizendo a mesma coisa.</li>
semantic html em paridade: article, section, nav, aside, headings na hierarquia certa.</li>
GPTBot, OAI-SearchBot, PerplexityBot, ClaudeBot, Google-Extended, CCBot destravados no robots.txt.</li>
validado no Schema Markup Validator e Rich Results Test, com lint no CI/CD.</li>
NLWeb /ask e /mcp como próximo passo, depois do grafo estável. vetor obrigatório pra app nativo sem versão web.</li>
llms.txt como reforço secundário, por último.</li>
web/wasm client-side e spa: pré-render ou ssr, nunca confiar no cliente pra entregar schema a crawler.</li>
</ol>
ferramentas</h3>
validação: Schema Markup Validator (validator.schema.org, api pra CI), Rich Results Test (google), schema-dts (npmjs.com/package/schema-dts, tipos ts do google oss), Google Search Console (com filtro de AI Overviews). geração: next-seo (metadados e componentes de schema pra next.js), NLWeb reference implementation (github.com/microsoft/NLWeb, repo atual nlweb-ai/NLWeb). monitoramento de visibilidade em ia (categoria emergente, validar antes de adotar): share of citation e share of voice em AI Overviews, referrals de chat.openai.com e perplexity.ai comparando antes e depois de mudanças de schema.</p>
bibliografia (eixos)</h3>
papers: Aggarwal et al, GEO: Generative Engine Optimization, KDD 2024 (doi 10.1145/3637528.3671900, preprint arxiv 2311.09735); Kumar et al, AI Answer Engine Citation Behavior, an Empirical Analysis of the GEO-16 Framework, arxiv 2509.10762 (set 2025, fonte do “metadata e frescor, html semântico, dados estruturados”, odds ratio 4,2, 78% citação cross-engine); Chen et al, Generative Engine Optimization: How to Dominate AI Search, arxiv 2509.08919; GEO-SFE: Structural Feature Engineering for GEO, arxiv 2603.29979 (mar 2026).</p>
schema e google: Google Search Central, Mark Up FAQs with Structured Data (com o aviso de deprecação de 7 mai 2026); Introdução a dados estruturados; Schema.org versão atual e SpeakableSpecification e Statement; W3C JSON-LD 1.1 Best Practices (github.com/w3c/json-ld-bp).</p>
FAQPage deprecation: Search Engine Land (Google to no longer support FAQ rich results, mai 2026); Search Engine Journal (Google Drops FAQ Rich Results From Search); Elementera AI.</p>
NLWeb e web agêntica: Microsoft Source (Introducing NLWeb, 2025); nlweb-ai/NLWeb; NLWeb.ai docs; InfoWorld (NLWeb: Tapping MCP for natural language web search).</p>
schema e llm: Search Engine Roundtable (Schema Helps Microsoft’s LLMs, citação de Fabrice Canel no SMX Munich); Search Engine Land (How schema markup fits into AI search, without the hype); Search Engine Journal (Structured Data and Ranking, John Mueller, sem boost de ranking).</p>
implementação: google/schema-dts; Google Open Source Blog (schema-dts turns 1.0); Enodo (Modern JSON-LD implementation in 2025); Mike Bifulco (Structured data JSON-LD for Next.js sites).</p>
llms.txt: Limy.ai (LLMs.txt in 2026, documenta que o google não usa).</p>
seo e webassembly</h2>
conteúdo de terceiro, não é material meu. fonte: artigo “The Future of SEO with WebAssembly” da gtechme (gtechme.com/insights/webassembly-seo-future-challenges), agência de desenvolvimento web nos eua. em inglês, originalmente com call-to-action de venda da gtechme, removido. fica aqui só a espinha técnica, por ser adjacente aos clusters de wasm e útil pra quem publica conteúdo em wasm.</p>
tese central: wasm dá velocidade quase nativa no browser (edição de imagem, mapas 3d, analytics pesado, criptografia, sem round-trips de servidor), o que ajuda core web vitals e reduz bounce. mas ranqueamento depende de crawlers descobrirem, renderizarem e entenderem a página, e wasm não resolve crawlability por padrão.</p>
o problema de opacidade: se conteúdo ou links importantes só aparecem depois que um script cliente roda, ou se o html entrega cascas vazias preenchidas só por um boot de wasm, o crawler pode ver conteúdo “fino”. se a informação só existe na memória depois que uma função wasm executa, o crawler pode nunca vê-la.</p>
correção (rendering híbrido): entregar html renderizado no servidor ou estático pra páginas-chave, com texto, headings e links significativos no primeiro load, só então sobrepor wasm pro trabalho pesado. tratar js e wasm como complementares: js cuida da camada de ui e do glue (links e texto crawláveis), wasm cuida da parte intensiva. tratar hidratação e interatividade como progressive enhancement.</p>
padrões que funcionam: pré-renderizar título, meta tags, canonical, structured data e conteúdo primário sem rodar scripts. code-split (carregar módulos wasm só nas rotas que precisam, reduz payload inicial e melhora core web vitals). expor dados crawláveis (se wasm gera texto/detalhes importantes, também renderizar no servidor ou embutir no html). instrumentar tracking na fronteira js, porque algumas libs de analytics não capturam interações dentro do módulo wasm.</p>
frameworks: usar server components ou ssr pra páginas de conteúdo e hidratar só onde necessário (react, vue, svelte com island architecture). o princípio é comum: entregar html indexável, depois acoplar interatividade.</p>
medição: benchmark antes e depois, acompanhar lcp, inp e cls com dados de campo, e cruzar com análise de logs pra confirmar frequência de crawl e latência de render.</p>
contexto declarado no artigo (não verificado de forma independente): menção a WebAssembly 3.0 com garbage collection e multi-threading padronizados, e a afirmação de que googlebot executa wasm mas com limites de recursos, podendo atrasar ou completar parcialmente o render, o que reforça manter uma versão estática do conteúdo pra indexação confiável. o artigo cita tarefas em wasm “até 600% mais rápidas que scripts tradicionais”, número de marketing da própria agência, registrar com a ressalva.</p>
a ponte com o resto: isso é exatamente o que [[geo-schema-json-ld]] resolve do lado do schema. wasm client-side cai no mesmo poço da spa pura, o crawler não vê. a saída é ssr/pré-render mais json-ld no html inicial.</p>
Brenner Cruvinel - geo

GEO, Schema e JSON-LD para Ser Citado por Motores de LLM
