Saltar para o conteúdo principal
Use o GEO Score para verificar uma página que você quer que o ChatGPT cite. A pontuação é a parte do que uma pessoa lê na página, incluindo o texto dentro das imagens, que a busca do ChatGPT guarda na cópia que tem da página. direct dá a parte que o ChatGPT recebe quando ele mesmo abre a página, como quando alguém lhe passa a URL. Cada trecho que a busca do ChatGPT não guarda vem com a causa, e analysis transforma as causas em correções.

Pontuar uma página

A tarefa é aceita e entra na fila:
Leia o resultado com GET /v1/async/task/{id}, ou adicione webhook.url à solicitação e receba-o quando a tarefa terminar. A maioria das páginas leva de 1 a 3 minutos, então consulte a cada 10 a 15 segundos. A tarefa funciona como qualquer outra tarefa assíncrona, e o resultado fica em response. O esquema da solicitação está na referência da API.

Campos da solicitação

Qualquer outro campo retorna 400 VALIDATION_ERROR.

Como uma página é pontuada

  1. Acesso. O robots.txt é avaliado para OAI-SearchBot, ChatGPT-User e GPTBot. A página é obtida como cada um deles e como um navegador, a partir de um endereço dos EUA, de onde o ChatGPT-User obtém as páginas.
  2. O que uma pessoa lê. Um navegador em country renderiza a página e a rola até o fim, e o texto das imagens grandes é lido linha a linha. As linhas sobre o assunto próprio da página viram trechos. Menus, rodapés, outros produtos, avaliações de clientes, botões e anúncios ficam fora da pontuação.
  3. O que a busca do ChatGPT guarda. Um navegador renderiza a página como OAI-SearchBot, o rastreador que alimenta a busca do ChatGPT, a partir de um endereço dos EUA, sem deixar sair nenhuma solicitação de dados. A cópia é o texto do HTML que o servidor envia e o texto que os scripts da página desenham a partir dele, incluindo o texto oculto e o texto alternativo das imagens. O texto dentro das imagens e o conteúdo que a página carrega depois de abrir não estão nela, assim como não estão na busca do ChatGPT.
  4. O que o ChatGPT recebe ao abrir a página. O HTML que o ChatGPT-User recebe é lido como o leitor do ChatGPT o lê: o texto, o texto oculto e o texto alternativo das imagens, sem scripts. Uma imagem conta quando o ChatGPT consegue abri-la e lê-la: o HTML dá a imagem como src de um img, em JPEG, PNG ou WebP, num tamanho em que o texto continua legível.
  5. Se o ChatGPT abre a página. O ChatGPT de produção é solicitado duas vezes a abrir a página. As respostas não são pontuadas: mostram apenas se ele abriu a página.
  6. Posição de cada trecho. Um trecho é read quando a cópia da busca o contém, e missing com a causa caso contrário. direct o posiciona da mesma forma no que o ChatGPT recebe ao abrir a página. O código decide cada trecho, então uma página que não mudou recebe a mesma pontuação.

Ler o resultado

A página da OLIVE YOUNG acima dá este resultado, reduzido aos campos principais:

score

A parte dos trechos que a busca do ChatGPT guarda, de 0 a 100. Todos os trechos têm o mesmo peso. A pontuação é 0 quando o robots.txt deixa a página fora da busca do ChatGPT e quando o site recusa o rastreador da busca do ChatGPT. reading.score mantém a parte de antes de o robots.txt levar a pontuação a 0.

direct

O que o ChatGPT recebe quando ele mesmo abre a página, como quando alguém lhe passa a URL. direct.score é a parte dos trechos que estão no HTML que o ChatGPT-User recebe e nas imagens que o ChatGPT consegue abrir, e direct.read os conta. É 0 quando o ChatGPT não conseguiu abrir a página. As duas pontuações se separam onde a página escreve texto em imagens ou o desenha com scripts: a busca do ChatGPT não guarda texto dentro de imagens e guarda o que os scripts desenham a partir do HTML, enquanto o leitor do ChatGPT abre as imagens que consegue ler e não executa scripts. Uma página de produto de supermercado cuja tabela nutricional é um JPEG em tamanho original teve 56 na busca e 93 ao ser aberta diretamente.

access

search.refused é true quando o site recusa o rastreador da busca do ChatGPT, o que prende a pontuação em 0, e search.lines conta as linhas da cópia da busca. blockedBy é user_agent quando o site recusa o agente ChatGPT-User de qualquer endereço, openai_addresses quando atende esse agente a partir do nosso endereço e recusa os da OpenAI, e site quando recusa também um navegador. robots traz a linha do robots.txt que decide para cada agente da OpenAI, noindex informa uma diretiva noindex e onde ela foi definida, e probes lista o status que cada requisição recebeu.

reading.items[]

Uma entrada por trecho: reading.locations conta os trechos por where e mostra o que falta corrigir depois que o ChatGPT consegue abrir a página. causes[] agrupa os trechos ausentes por causa.

analysis

summary informa a pontuação, o maior problema e a pontuação com os problemas confirmados corrigidos (potential). direct diz o que o ChatGPT recebe quando ele mesmo abre a página, ou quem o impede de abri-la e a correção. Cada entrada de issues[] traz a causa (detail), a correção (fix), os trechos que ela custa (facts), as evidências e os pontos que tira da pontuação. Os problemas de acesso que prendem a pontuação em 0 vêm primeiro, e o resto segue por pontos. basis é confirmed: a nossa própria leitura da página (o HTML, as renderizações, as imagens, o robots.txt, as respostas HTTP) mostra o problema. O texto de analysis está em inglês.

markdown

A página como uma pessoa a vê, em Markdown, com o texto das imagens no lugar das imagens. O conteúdo próprio da página, que a pontuação verifica, aparece sob os seus títulos e rótulos. Os menus, as avaliações e as outras partes ao redor ficam recolhidos numa linha cada. Cada trecho que a busca do ChatGPT não guarda é marcado no seu lugar com _(missing: …)_ e o motivo, e o cabeçalho informa quantos trechos o ChatGPT recebe ao abrir a página. O cabeçalho e as marcas ficam na língua da página: inglês, coreano, japonês, chinês, espanhol, francês, alemão ou português, e inglês para qualquer outra. Uma página em português mostra _(ausente: …)_. Um trecho da página da OLIVE YOUNG, que está em inglês:

screenshot

As quatro primeiras telas da página como uma pessoa a vê, em JPEG: uma janela de 1366×900, capturada no topo depois de rolar a página até o fim. url é a sua própria chave de acesso e abre o arquivo até expiresAt, 30 dias após a tarefa. Uma página cuja imagem não pôde ser capturada vem sem screenshot, e uma imagem que não pôde ser salva tem status: "failed".

rendering

A página renderizada para agentes de IA. A cópia é o HTML que o navegador de uma pessoa desenhou, sem scripts, com o texto de cada imagem acrescentado ao seu texto alternativo, a alternativa em texto que a WCAG pede para uma imagem de texto. rendering.score é a parcela dos trechos que a cópia tem no seu texto: o que recebe um agente de IA a quem a cópia é servida, sem abrir nenhuma imagem. rendering.read os conta e reading.items[].rendering marca cada trecho; a cópia em si não faz parte do resultado. A página da OLIVE YOUNG acima tem os seus 55 trechos na cópia, uma pontuação de 100: o texto das imagens de ingredientes e de perguntas frequentes como texto alternativo, e os preços e avaliações que os scripts carregam.
rendering não aparece quando nenhum navegador conseguiu mostrar a página ou o HTML desenhado é grande demais.

Ler a pontuação corretamente

  • A busca do ChatGPT trabalha com uma cópia da página feita pelo seu rastreador: o texto do HTML e o que os scripts desenham a partir dele, sem o texto dentro das imagens nem o que a página carrega depois de abrir. A cópia é do último rastreamento, então uma mudança só chega à busca do ChatGPT depois que o rastreador visita a página de novo.
  • Quando o ChatGPT abre uma página por conta própria, ele lê o HTML que o servidor envia. Ele não executa scripts, lê o texto alternativo das imagens e só abre uma imagem pelo src do img que esse HTML dá. A OpenAI reutiliza por cerca de 30 minutos uma página que já abriu.
  • A pontuação só muda quando a página ou a forma como ela é renderizada muda. De quinze páginas pontuadas três vezes cada, dez variaram 3 pontos ou menos. Uma página que mostra partes diferentes a cada visita varia mais.
  • O GEO Score cobre o que o ChatGPT tem de uma página. Quais páginas a busca do ChatGPT escolhe para cada pergunta é o que os monitores GEO acompanham.

Erros e cobrança

Uma tarefa concluída custa 10 créditos pela página e 5 por imagem cujo texto é lido, até 12 imagens: images.read no resultado. Uma imagem que o host recusa ou que não pôde ser lida (images.unread) é gratuita. Se sua conta leu a mesma imagem nos últimos 90 dias, essa leitura é reutilizada (images.reused) por 2 créditos. O envio reserva 70 créditos, o máximo de uma página, e a conclusão cobra o que a tarefa usou. Uma tarefa que falha não é cobrada. Veja Créditos e limites.

Recusas no envio

Os erros de autenticação, concorrência e taxa são os mesmos de qualquer tarefa. Veja Erros.

Tarefas com falha

Uma tarefa com falha tem status: "FAILED" e uma string error que começa pelo código:

Próximos passos

Citation Analysis

Veja quais fontes moldaram uma resposta.

Monitores GEO

Acompanhe sua marca nos motores de IA em uma programação.