Como conferir o item certo do Wikidata antes do sameAs

Nome parecido não é o mesmo conceito

O item certo do Wikidata é o que descreve o mesmo conceito da sua página, e o rótulo sozinho não garante isso. O QID é o identificador do item, a letra Q seguida de números, e existe justamente porque nomes se repetem. O sameAs, pela definição da schema.org, aponta para uma página que indica sem ambiguidade a identidade do item. Quando o QID está errado, o seu schema passa a afirmar, com todas as letras, que o seu termo é outra coisa.

O erro é fácil de cometer e difícil de ver. O validador da schema.org e o teste de resultados avançados conferem o formato da URL, não o que o item é. Nenhum dos dois avisa que o QID aponta para um município ou para uma decisão judicial. Só lendo o rótulo e a descrição do item isso aparece.

Os erros que encontrei em um dia

Em 25 de setembro de 2026, conferi 15 QIDs em uma chamada da API e encontrei seis apontando para o conceito errado, incluindo dois no meu próprio grafo. Os QIDs vieram de três lugares: o knowsAbout e os verbetes da agência, os exemplos de um guia de schema em inglês que aparece entre os primeiros resultados da busca por knowsAbout e Wikidata, e a resposta de uma IA à mesma pergunta.

Os dois primeiros não são conceitos vizinhos, são coisas sem nenhuma relação com marketing. Os três do meu lado e o da IA são o tipo mais comum: um conceito próximo com nome parecido.

O caso do AIO é o mais instrutivo. O item tem o rótulo "artificial intelligence optimization", que é exatamente a expansão da sigla. A descrição, porém, fala em princípios usados para melhorar sistemas de IA, ou seja, otimizar a IA, e não otimizar conteúdo para ela. Por isso o verbete de AIO, quando for publicado, sai sem sameAs para o Wikidata.

A descrição, porém, fala em princípios usados para melhorar sistemas de IA, ou seja, otimizar a IA, e não otimizar conteúdo para ela.

Lucas Ferraz, especialista em SEO

A conferência em lote pela API

A ação wbgetentities da API do Wikidata devolve o rótulo e a descrição de vários QIDs em uma chamada só, e é assim que confiro tudo antes de publicar. Os ids vão separados por barra vertical, e o parâmetro languages escolhe os idiomas. O trecho abaixo roda no console do navegador aberto em qualquer página do wikidata.org, sem chave e sem biblioteca.

const ids = ['Q180711', 'Q97171941', 'Q134083964', 'Q1047808'];
const url = 'https://www.wikidata.org/w/api.php?action=wbgetentities'
  + '&format=json&props=labels|descriptions&languages=en|pt-br'
  + '&ids=' + ids.join('|');
const j = await (await fetch(url)).json();
for (const id of ids) {
  const e = j.entities[id];
  console.log(id, e.labels?.en?.value, '|', e.descriptions?.en?.value);
}

A saída é uma linha por item, com rótulo e descrição. Leio a descrição de cada uma contra o conceito que a página define. Quando a descrição fala de outra coisa, procuro o item certo pela busca wbsearchentities, que devolve os candidatos com a descrição ao lado, e só então troco o QID.

Quando a descrição não basta?

Para conceito, a descrição resolve quase sempre, mas instance of e subclass of desempatam os casos em que dois itens parecem certos. A propriedade P31 diz de que tipo é o item, e a P279 diz de que conceito ele é subclasse. Um item que seja "instância de" uma área do conhecimento ou "subclasse de" otimização para buscadores é um bom sinal para um termo de SEO. Um item que seja instância de município ou de caso judicial encerra a dúvida na hora.

Três checagens entram na minha lista, além da descrição:

• O item não pode ser página de desambiguação. Ele serve para navegação e não representa conceito nenhum.
• O mesmo @id não pode carregar dois QIDs em lugares diferentes. No meu grafo, o verbete de UX dizia um item e o knowsAbout dizia outro.
• O formato do endereço deve ser o mesmo em todo o site. Uso /wiki/Q… nos dois domínios, e a troca para /entity/ seria uma decisão única, para o grafo inteiro.

O que corrigi no meu grafo?

Dois QIDs do knowsAbout da agência apontavam para um conceito vizinho, e os dois foram trocados no mesmo dia. A experiência do usuário passou de Q11248500 para Q1047808, e a auditoria de SEO passou de Q28136775 para Q97371007. O verbete de UX já emitia o item certo, e a divergência só apareceu porque o knowsAbout passou a usar o mesmo @id do verbete, como descrevi no texto sobre knowsAbout ligado ao glossário.

Para o erro não voltar, o tema da agência passou a ter um mapa de QIDs conferidos por verbete. Quando o campo do verbete traz outro item do Wikidata, o mapa vence, e o mesmo termo sai com o mesmo QID na página do verbete e no knowsAbout. A data da conferência fica registrada no próprio código.

Conferir a cada uso

O Wikidata é editado pela comunidade, e um QID conferido hoje pode ter o rótulo ou a descrição alterados amanhã. Itens duplicados são mesclados, descrições são refinadas e conceitos novos ganham item próprio. A conferência não é um passo de implantação, é um passo de manutenção. Rodo a mesma chamada em lote a cada revisão do schema, e todo QID novo só entra depois de passar por ela.