Yoast e Microsoft: um avanço importante na visibilidade do WordPress para a IA

O Yoast SEO 27.1, lançado a 3 de março de 2026, trouxe o Schema Aggregation: uma funcionalidade opcional que recolhe os dados estruturados que a Yoast já gera num site WordPress e os serve como um único grafo ligado. Os agentes de IA e outros consumidores podem ler as entidades do site a partir de alguns endpoints REST, em vez de percorrerem cada página.

Esta inovação foi desenvolvida em colaboração com a equipa Microsoft NLWeb. Segundo o artigo de lançamento da Yoast, a Yoast anunciou a colaboração com o NLWeb em novembro de 2025, e o trabalho contou com R.V. Guha, cofundador do Schema.org. A saída de schema de cada página não muda. Os mesmos dados são reorganizados ao nível do site.

#O que é o Yoast Schema Aggregation

O Schema Aggregation reúne todos os dados de schema de um site WordPress num grafo de entidades unificado. Em vez de obrigar os agentes de IA a visitar cada página, a Yoast disponibiliza um ponto de acesso central com os artigos, autores, produtos, organização e outras entidades do site. A Yoast chama a este resultado combinado “schemamap”.

Na prática, um agente de IA que lê um site WordPress com o endpoint ativo consegue obter os dados estruturados de um tipo de conteúdo inteiro num só pedido: informação sobre artigos, os respetivos autores, produtos, a organização e as relações entre eles. As entidades duplicadas são fundidas, por isso um autor que aparece em muitos artigos passa a ser um único registo Person ligado a todos esses artigos.

#Porque é que o Schema Aggregation ajuda sites grandes

O seu site WordPress funciona como uma biblioteca enorme. Na abordagem tradicional, um visitante (ou bot de IA) tinha de entrar em cada sala, abrir cada livro e ler cada página para perceber que informação a biblioteca continha. Com o Schema Aggregation, o visitante recebe à entrada o catálogo: um mapa do conteúdo da biblioteca, organizado por temas, autores e relações entre conceitos.

Para sites empresariais com centenas ou milhares de páginas, é aqui que a diferença mais pesa. Um rastreador que só chega a parte do site vê apenas parte do grafo de entidades, enquanto o schemamap lista o endpoint de cada tipo de conteúdo incluído.

#Como funciona o Schema Aggregation da Yoast

#Como funciona o grafo de entidades unificado

O Yoast Schema Aggregation agrega os tipos de dados schema.org presentes no site WordPress. Quando um utilizador configura o Yoast SEO no seu site, o plugin gera dados estruturados para vários tipos de conteúdo: artigos, autores, produtos, organizações, localizações e outros.

Tradicionalmente, estes dados estavam dispersos por páginas individuais. Um artigo tinha o schema Article, uma página de autor o schema Person, um produto o schema Product. O Schema Aggregation recolhe esta informação e liga-a num grafo coerente que pode ser processado como um todo. Alex Moss, Principal SEO da Yoast, descreveu este passo de fusão no X, citado pelo Search Engine Journal: “Funde entidades duplicadas para que o seu ‘Autor X’ ou ‘Artigo Y’ existam como um único nó” (tradução própria).

#O que devolvem os endpoints do agregador de schema

A referência da API para programadores documenta duas rotas REST:

1. GET /wp-json/yoast/v1/schema-aggregator/get-schema/{post_type}[/{page}] devolve as peças de schema agregadas de um tipo de conteúdo em JSON-LD, por exemplo post, page ou product. O número de página é opcional e começa em 1.
2. GET /wp-json/yoast/v1/schema-aggregator/get-xml devolve o schemamap: um índice XML que lista cada URL get-schema com a data da última modificação, a frequência de alteração e a prioridade.

Dividir a saída por tipo de conteúdo mantém as respostas num tamanho gerível. Por predefinição, uma página de resultados tem 1000 itens, e os tipos de conteúdo com peças de schema grandes têm 100. De origem, só product é tratado como tipo “big schema”, porque a marcação de produto inclui ofertas, preços e avaliações. As duas rotas enviam Cache-Control: max-age=300.

A visão geral para programadores acrescenta que o schema de produtos do WooCommerce e o schema de downloads do Easy Digital Downloads entram automaticamente. O artigo de lançamento indica dois parceiros da Schema API cuja marcação também é incluída: The Events Calendar e WP Recipe Maker. Se tem uma loja WooCommerce, o catálogo de produtos chega ao endpoint sem código adicional.

Saiba mais sobre otimização GEO e LLMO para WordPress na WPPoland.

#O que é o Microsoft NLWeb

A colaboração com a Microsoft NLWeb é um elemento central desta iniciativa. O NLWeb (Natural Language Web) é um projeto aberto da Microsoft para criar interfaces de conversação em sites. O repositório NLWeb contém uma implementação de referência em Python com licença MIT e descreve-se como um conjunto de protocolos abertos com código de exemplo.

Cada instância NLWeb suporta um método central chamado ask, que envia uma pergunta em linguagem natural a um site e devolve JSON construído com o vocabulário Schema.org. Cada instância funciona também como servidor MCP. O repositório resume a relação assim: “o NLWeb está para o MCP/A2A como o HTML está para o HTTP” (tradução própria).

O papel da Yoast é a camada de dados. O schemamap é uma fonte pronta para uma instância NLWeb, e a página da funcionalidade da Yoast diz que os programadores podem usar o endpoint em conjunto com o repositório NLWeb no GitHub. Um site WordPress não passa a responder sozinho a perguntas em linguagem natural depois de ligar o interruptor. Alguém tem de correr o NLWeb, carregar os dados numa das bases vetoriais que ele suporta (Qdrant, Milvus, Postgres, Elasticsearch, Azure AI Search, Snowflake ou Cloudflare AutoRAG) e ligar um modelo de linguagem.

#O Schema Aggregation melhora a visibilidade na pesquisa com IA

#Como é que a IA muda a indexação de sites

O SEO tradicional centrava-se em otimizar conteúdo para motores de pesquisa como o Google. O Schema Aggregation é um passo rumo à otimização para sistemas de IA e para assistentes de voz.

Alex Moss resumiu a mudança no X, de novo citado pelo Search Engine Journal: “Um agente já não precisa de rastrear todas as páginas individuais para perceber o seu significado” (tradução própria). Para a estratégia de SEO, isto significa que a imagem das suas entidades ao nível do site passa a ser algo que publica, em vez de algo que um rastreador tem de reconstruir.

Em vez de se concentrarem apenas nos motores de pesquisa tradicionais, os proprietários de sites têm agora de pensar na forma como o seu conteúdo será lido pelos sistemas de IA. O Schema Aggregation é um passo nesse sentido, porque expõe os dados que a Yoast já gera num formato pensado para esses sistemas.

#O que exige o AEO (Answer Engine Optimization)

O Schema Aggregation encaixa na transição do SEO tradicional para o AEO, a otimização para motores de resposta. Uma parte crescente das pesquisas termina num assistente de IA que dá uma resposta direta em vez de uma lista de links azuis.

Para aparecer como fonte nestas respostas, o seu site precisa de:

1. Dados estruturados completos: o schemamap expõe-nos, mas só pode expor o que as suas páginas já declaram.
2. Autoridade temática: o grafo de entidades mostra a abrangência e a profundidade da sua cobertura de temas específicos.
3. Atribuição de autoria: perfis de autor ligados ao conteúdo suportam o E-E-A-T (experiência, especialização, autoridade, confiabilidade).

#Que vantagens traz o Schema Aggregation aos sites WordPress

Para os proprietários de sites WordPress, o Yoast Schema Aggregation oferece várias coisas:

1. Uma imagem mais clara para os sistemas de IA: um agente lê um grafo sem duplicados em vez de juntar marcação de muitas páginas.
2. Um interruptor, sem reconstrução: a página da funcionalidade diz que não é preciso instalar nada de novo nem usar ferramentas adicionais.
3. Definições de privacidade respeitadas: só é partilhado conteúdo público e indexável, e as páginas privadas ou ocultas ficam de fora.
4. Compatibilidade com o NLWeb: o schemamap pode alimentar diretamente uma instância NLWeb.

#Porque é que a Yoast se integra com o NLWeb

#O que Alain Schlesser diz sobre a integração com o NLWeb

Alain Schlesser, Principal Architect da Yoast, resumiu a filosofia por trás da funcionalidade no artigo de lançamento: “Não pode parar a onda da IA, mas pode orientá-la. A nossa integração com o NLWeb devolve-lhe o controlo” (tradução própria).

Esta afirmação reflete a abordagem da Yoast à IA. Em vez de tratar a inteligência artificial apenas como uma ameaça, a Yoast procura dar aos utilizadores de WordPress mais controlo sobre a forma como o seu conteúdo é lido e resumido.

O Schema Aggregation responde às preocupações de muitos proprietários de sites com o papel crescente da IA no tratamento da informação. Em vez de deixar que os sistemas de IA interpretem o conteúdo do site como entenderem, a Yoast dá aos webmasters uma ferramenta para apresentarem a informação de forma controlada.

#Como controlar o que a IA diz sobre a sua marca

Sem dados estruturados claros, os modelos de linguagem podem gerar descrições imprecisas ou incompletas do seu negócio. O schemamap é o sítio onde declara que factos sobre a sua organização, os seus serviços e o seu conteúdo são autoritativos. O que ele diz depende dos dados que introduz na Yoast, por isso as definições da organização e dos autores merecem uma revisão cuidada.

#Requisitos e verificação do Schema Aggregation na Yoast

#Que versões do Yoast SEO e do WordPress são necessárias

Para usar o Yoast Schema Aggregation, precisa de:

• Yoast SEO versão 27.1 ou mais recente. O endpoint faz parte do plugin gratuito e também está incluído no Yoast SEO Premium, no Yoast WooCommerce SEO e no Yoast SEO AI+.
• Uma versão de WordPress e PHP suportada pelo plugin atual. A 14 de outubro de 2026, o diretório de plugins do wordpress.org lista o Yoast SEO 28.7, que exige WordPress 6.9 e PHP 7.4.
• A saída de schema da Yoast ativa. O artigo de ajuda avisa que o endpoint não funciona sem ela.
• Conteúdo publicado, público e indexável (artigos, produtos, autores).

#Como ativar o endpoint de agregação de schema

A funcionalidade vem desligada por predefinição. No primeiro início de sessão depois da atualização, a Yoast mostra um pequeno guia com o mesmo interruptor. Para a ativar manualmente:

1. No painel do WordPress, abra Yoast SEO.
2. Vá a Definições.
3. Em Funcionalidades do site, abra Ferramentas de IA.
4. Ative Endpoint de agregação Schema. Um visto roxo indica que está ativo.
5. Clique em Guardar alterações.

Em sites geridos por código, a visão geral para programadores dá o equivalente programático: WPSEO_Options::set( 'enable_schema_aggregation_endpoint', true );. O mesmo interruptor desliga a funcionalidade a qualquer momento.

#Que dados estruturados completar primeiro

O endpoint só consegue agregar o que a Yoast já sabe, por isso complete os dados de onde ele parte:

• Perfis de autor completos, com fotografias e biografias que demonstrem experiência e conhecimento
• Dados da organização nas definições da Yoast, incluindo logótipo, morada e contactos
• Schema de produtos, se tiver uma loja WooCommerce
• Dados de localização, se tiver um negócio físico
• Schema de FAQ para artigos que respondem a perguntas frequentes
• Schema de HowTo para tutoriais e guias passo a passo

#Como verificar se o Schema Aggregation funciona

Para confirmar que a funcionalidade está a funcionar no seu site:

1. Abra https://oseusite.pt/wp-json/yoast/v1/schema-aggregator/get-xml (com o seu domínio). Deve ver uma entrada por cada tipo de conteúdo público.
2. Siga um dos URL listados, por exemplo .../get-schema/post, e confirme que os seus artigos, autores e organização aparecem em JSON-LD.
3. Abra /robots.txt. A Yoast acrescenta uma linha Sitemap: que aponta para o endereço get-xml.
4. Com acesso à shell, corra wp yoast aggregate_site_schema post, que imprime o mesmo JSON-LD no terminal.
5. Use o Schema Visualizer da Yoast para ver o grafo.

O Google Rich Results Test continua útil, mas verifica a marcação de URL individuais. Não lê o endpoint de agregação. Estas verificações fazem parte da manutenção de sites WordPress, sobretudo depois de atualizações de plugins.

#Controlos para programadores no agregador de schema da Yoast

A referência de filtros documenta o que pode ser alterado em código. Na prática, contam cinco áreas.

#Que tipos de conteúdo e tipos de schema o agregador inclui

Por predefinição, o agregador processa todos os tipos de conteúdo públicos: artigos, páginas e tipos de conteúdo personalizados. O filtro wpseo_schema_aggregator_post_types reduz ou alarga essa lista, por exemplo para deixar um tipo de conteúdo técnico fora do schemamap.

Os tipos de schema são organizados em contextos. A visão geral para programadores lista Website, Content, Commerce, Entity, Event, Data, Medical, Action, Enumeration, Meta e Website meta. Os tipos de ação, de enumeração e meta são filtrados por predefinição. Correspondem à própria hierarquia do schema.org: uma Action descreve algo que um agente pode fazer, e uma Enumeration é uma lista fixa de valores, como um estado de disponibilidade. Nenhuma das duas descreve algo de que o seu site trata. Dois filtros alteram o mapeamento: wpseo_schema_aggregator_elements_context_map substitui-o por completo, e wpseo_schema_aggregator_elements_context_map_{context} ajusta um contexto. Uma wpseo_schema_aggregator_filtering_strategy personalizada pode decidir peça a peça o que entra.

#Como funcionam a cache e a paginação

Cada tipo de conteúdo tem a sua própria cache, e a cache é limpa automaticamente quando um artigo é atualizado. wpseo_schema_aggregator_cache_enabled desliga a cache, e wpseo_schema_aggregator_cache_ttl define a duração em segundos.

A duração predefinida aparece descrita de forma diferente em dois sítios. A visão geral liga-a ao número de artigos do site, enquanto a referência de filtros a liga ao tamanho da resposta. Se o tempo importa na sua configuração, defina o TTL explicitamente em vez de confiar numa das descrições. O tamanho das páginas tem filtros próprios: wpseo_schema_aggregator_per_page (predefinição 1000), wpseo_schema_aggregator_per_page_big (predefinição 100) e wpseo_schema_aggregator_big_schema_post_types (predefinição product).

#Como o schemamap é anunciado no robots.txt

A Yoast anuncia o schemamap no robots.txt com uma diretiva de sitemap normal, como mostra a referência da API:

Sitemap: https://example.com/wp-json/yoast/v1/schema-aggregator/get-xml

Os rastreadores que leem linhas de sitemap encontram o endpoint sem qualquer outro link. Se preferir partilhar o endereço apenas com parceiros específicos, o filtro wpseo_disable_robots_schemamap remove a linha. As entradas do schemamap usam daily como frequência de alteração e 0.8 como prioridade, ajustáveis com wpseo_schema_aggregator_schemamap_changefreq e wpseo_schema_aggregator_schemamap_priority.

#O que contêm os registos Article e Person agregados

O agregador enriquece alguns registos para além da marcação da página. Nos artigos, os filtros wpseo_article_enhance_* controlam três acréscimos: o corpo do artigo, o excerto e as palavras-chave. Com as predefinições, é usado o excerto, e o texto do corpo só é acrescentado quando não existe excerto. Esse corpo perde o HTML e os shortcodes e é limitado por article_body_max_length, cuja predefinição é 500. As categorias só se tornam palavras-chave se categories_as_keywords for ativado.

Nas pessoas, a melhoria person_job_title está ativa por predefinição, por isso o cargo de um autor pode seguir com o registo Person. Os filtros wpseo_person_enhance_* controlam-na.

#Que comandos WP-CLI o agregador acrescenta

A funcionalidade traz dois comandos:

wp yoast aggregate_site_schema post --page=1
wp yoast clear_schema_aggregator_cache post

O primeiro imprime o JSON-LD de um tipo de conteúdo na saída padrão, o que facilita guardar uma fotografia do estado antes e depois de uma alteração. O segundo limpa a cache de um tipo de conteúdo, ou de todos quando omite o argumento.

#Que papel têm os dados estruturados em SEO, GEO e AEO

#Como é que a IA está a mudar a pesquisa

O desenvolvimento do Yoast Schema Aggregation insere-se numa tendência mais ampla na evolução da pesquisa. Cada vez mais utilizadores recorrem a assistentes de IA para encontrar informação, fazer perguntas e tomar decisões. Os motores de pesquisa tradicionais também estão a integrar IA, o que muda a forma como os resultados são apresentados.

Neste contexto, os dados estruturados tornam-se uma parte central da estratégia de SEO. Os sites que oferecem informação clara e organizada num formato que os sistemas de IA conseguem ler ficam em melhor posição do que os que dependem apenas da otimização tradicional.

#Qual é a diferença entre SEO, GEO e AEO

As fronteiras entre o SEO tradicional, o GEO (Generative Engine Optimization) e o AEO (Answer Engine Optimization) estão a esbater-se. Os dados estruturados servem as três disciplinas:

• SEO: os dados estruturados ao nível da página continuam a ser importantes para os resultados de pesquisa clássicos
• GEO: um grafo de entidades dá aos motores generativos uma fonte estruturada quando resumem conteúdo
• AEO: as respostas diretas dos assistentes de IA apoiam-se em dados que conseguem verificar e atribuir

#O WordPress está preparado para a pesquisa com IA

O Yoast Schema Aggregation reforça a posição do WordPress como plataforma fácil de manter e de expandir. A colaboração com a equipa NLWeb mostra que o ecossistema WordPress está a trabalhar nos desafios trazidos pela IA.

Para empresas e criadores de sites, o ponto prático é que a camada de dados de que os agentes de IA precisam pode ser ligada num site WordPress existente, sem o reconstruir.

#Schema Aggregation face ao schema por página

#Como funciona o schema por página

Na abordagem tradicional aos dados estruturados, cada página tinha o seu próprio conjunto de dados de schema. Os bots dos motores de pesquisa tinham de visitar cada página individualmente para perceber o seu conteúdo. Este processo era lento e nem sempre levava a uma compreensão completa da estrutura do site.

Os principais limites desta abordagem eram:

• Rastreio incompleto de sites grandes
• Perda de contexto entre páginas relacionadas
• A mesma entidade descrita de novo em cada página
• Nenhum sítio único onde ver as relações entre entidades

#Vantagens de um endpoint único de schema

O Schema Aggregation simplifica este processo ao centralizar os dados. Um agente de IA consegue obter uma imagem completa do site sem visitar cada página. A nova abordagem oferece:

• Eficiência: um schemamap que lista tudo o que o site expõe
• Completude: todos os conteúdos públicos e indexáveis dos tipos incluídos estão cobertos
• Contexto: as relações entre entidades são preservadas e tornadas explícitas
• Atualização: a cache de um tipo de conteúdo é limpa quando um dos seus artigos é atualizado

#Resumo

O Yoast Schema Aggregation, desenvolvido com a equipa Microsoft NLWeb, dá aos sites WordPress uma visão dos seus dados estruturados ao nível do site. É gratuito, opcional e ativa-se num único sítio, e expõe os mesmos dados que a Yoast já gera em cada página, fundidos e sem duplicados.

Para os proprietários de sites WordPress, a qualidade desse grafo depende dos dados por trás dele: perfis de autor completos, dados da organização e informação de produtos. Para os programadores, os filtros e os comandos WP-CLI permitem decidir que tipos de conteúdo entram, quanto tempo as respostas ficam em cache e se o schemamap é anunciado no robots.txt.

Vamos acompanhar a forma como os agentes de IA e as instâncias NLWeb usam o schemamap. Entretanto, atualize o Yoast SEO, ative o endpoint e veja o que o seu endereço get-xml devolve.

Precisa de ajuda para preparar o seu site WordPress para a pesquisa com IA? Contacte a WPPoland para uma consultoria de SEO, GEO e AEO.