Pular para o conteúdo

Como o scanner decide

Como o scanner decide

Três vereditos, regras abertas. Se algum parecer errado, avise: é esse o feedback que melhora o scanner.

Pronto
A página registra ao menos uma ferramenta WebMCP, o linter não acha erros nelas e a nota de prontidão para agentes é 70 ou mais. Avisos, como um nome longo, não impedem.
Quase
A página registra ferramentas, mas ao menos uma tem um erro do linter (invalid-name, duplicate-name, missing-description, invalid-input-schema, invisible-unicode, ou um tamanho acima do limite rígido), ou a nota fica abaixo de 70.
Ainda não
A página não registra nenhuma ferramenta WebMCP. Mostramos quantos tokens um agente gastaria lendo a página no lugar delas.

Como um scan roda

  1. Abrimos a página num Chrome headless no nosso servidor, sem cookies e sem login.
  2. Antes de os scripts da página rodarem, adicionamos um host WebMCP, para que a página registre as ferramentas como faria no navegador de um agente. Ele também aceita os antigos navigator.modelContext e provideContext, para que sites feitos com eles ainda mostrem suas ferramentas.
  3. Depois que a página carrega e as ferramentas se estabilizam, lemos nome, descrição, schema de entrada e anotações de cada uma e passamos o linter.
  4. Os tokens são estimados a partir do texto da página: os caracteres divididos por quatro.
  5. Para a nota, o mesmo navegador busca o robots.txt, o llms.txt, o sitemap, a versão em Markdown, os headers Link, o índice de Agent Skills e o catálogo de APIs do site (3 s cada, mesma origem, sem cookies) e guarda só se cada um existe.
  6. A nota, de 0 a 100: WebMCP 50 (ferramentas 25, sem erros de lint 15, toda ferramenta descrita 5, toda ferramenta anotada 5), custo para agentes 15 (cheio com ferramentas; senão, pela contagem de tokens da página), legível 20 e encontrável 15 (5 por verificação).
  7. Um resultado vale por 10 minutos; cada visitante pode iniciar um scan novo por minuto.

Todas as regras do linter, com os motivos

Acha que um veredito está errado? Abra uma issue com o link do scan.