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
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
- 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.
- O que uma pessoa lê. Um navegador em
countryrenderiza 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. - 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.
- 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
srcde umimg, em JPEG, PNG ou WebP, num tamanho em que o texto continua legível. - 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.
- Posição de cada trecho. Um trecho é
readquando a cópia da busca o contém, emissingcom a causa caso contrário.directo 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
srcdoimgque 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 temstatus: "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.