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
- Abrimos a página num Chrome headless no nosso servidor, sem cookies e sem login.
- 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.
- 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.
- Os tokens são estimados a partir do texto da página: os caracteres divididos por quatro.
- 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.
- 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).
- 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.