E1 · Scanner com versão fixada
10 minRode o bloco "clonar e testar".
Pronto quando: a saída mostra ℹ tests 33, ℹ pass 33 e ℹ fail 0.
Aula 7 · 20 min
O diagnóstico do WebMCP Readiness: rodar e ler sem cair no "nota alta = ranking"
O WebMCP Readiness é o scanner aberto do INEMA: abre a página num navegador isolado, só lê, e devolve uma nota em quatro categorias. Nesta aula você roda o scanner na sua máquina, com versão fixada, contra a página de exemplo e contra o seu site, e aprende a ler o resultado como diagnóstico, não como promessa de ranking.
Começar a aula
Nesta aula você vai
- 1O scanner aberto, clonado com versão fixada
- 2Quatro categorias e a nota geral
- 3Falhas esperadas e falhas para corrigir já
- 4O que a nota não diz
Objetivo: rodar o WebMCP Readiness na sua máquina e ler o diagnóstico sem confundir nota com ranking.
01Da página ao plano de correção
Clique em cada bloco.
Clique em cada bloco do diagrama para ver o que ele faz.
Nas palavras do próprio scanner: SEO, GEO e AEO medem sinais observáveis; não garantem indexação, ranking ou citação por sistemas de IA.
02Instalar o scanner com versão fixada
Clona o repositório público inematds/webmcp-readiness numa pasta de ensaio, fixa o commit 3f3d1c8 (versão 2.2.2, de 24/09/2026), instala as dependências e roda os testes dele.
Terminal · clonar e testar
E=${TMPDIR:-/tmp}/ensaio-formacao-webmcp-base-v72
mkdir -p $E && cd $E
[ -d webmcp-readiness ] || git clone -q https://github.com/inematds/webmcp-readiness
cd webmcp-readiness && git checkout -q 3f3d1c8 && npm ci --no-audit --no-fund --silent
npm test 2>&1 | grep -E '^ℹ (tests|pass|fail) 'Exemplo do repositório
ℹ tests 33 ℹ pass 33 ℹ fail 0
Os 33 testes do próprio scanner passam. Se o número for outro, você não está no commit fixado.
node:internal/modules/package_json_reader:316
throw new ERR_MODULE_NOT_FOUND(packageName, fileURLToPath(base), null);
^
Error [ERR_MODULE_NOT_FOUND]: Cannot find package '@sparticuz/chromium' imported from /tmp/ensaio-formacao-webmcp-base-v72/webmcp-readiness/lib/readiness.mjs
at Object.getPackageJSONURL (node:internal/modules/package_json_reader:316:9)
saída: 1Sem as dependências do scanner instaladas, o Node não acha @sparticuz/chromium e para no import. Rode o bloco inteiro: o npm ci é parte dele.
03O scanner contra a página de exemplo
O readiness-local.mjs importa o scanner, aponta para o Chromium do kit e, só para a página em 127.0.0.1, libera endereço local (o scanner bloqueia rede privada por padrão).
Terminal · antes e depois
E=${TMPDIR:-/tmp}/ensaio-formacao-webmcp-base-v72
cd ~/projetos/formacao-webmcp-base-v72/kit
for p in antes depois; do node readiness-local.mjs $E/webmcp-readiness $p; echo "saída: $?"; doneExemplo do repositório
Readiness 2.2.2 · kit/site/antes.html · nota 48 (Precisa de ajustes) WebMCP 43 · SEO 53 · GEO 49 · AEO 49 falhas: 5 · avisos: 20 · ok: 5 · ferramentas WebMCP: 0 · document.modelContext no Chromium do scan: não [falha] webmcp · Ferramentas descobertas [falha] webmcp · Nomes e descrições [falha] webmcp · Parâmetros estruturados [falha] seo · Descrição nos resultados [falha] seo · URL canônica lembrete do próprio scanner: SEO, GEO e AEO medem sinais observáveis; não garantem indexação, ranking ou citação por sistemas de IA. saída: 0 Readiness 2.2.2 · kit/site/depois.html · nota 52 (Precisa de ajustes) WebMCP 43 · SEO 59 · GEO 56 · AEO 49 falhas: 5 · avisos: 18 · ok: 7 · ferramentas WebMCP: 0 · document.modelContext no Chromium do scan: não [falha] webmcp · Ferramentas descobertas [falha] webmcp · Nomes e descrições [falha] webmcp · Parâmetros estruturados [falha] seo · Descrição nos resultados [falha] seo · URL canônica lembrete do próprio scanner: SEO, GEO e AEO medem sinais observáveis; não garantem indexação, ranking ou citação por sistemas de IA. saída: 0
Zerar os 10 problemas da árvore subiu a nota só de 48 para 52. O Readiness mede outras coisas (descrição, canônica, ferramentas WebMCP); a árvore você confere com o arvore.mjs. As três falhas de WebMCP são esperadas: a página não registra ferramentas, e isso é o curso 2.
04O scanner num site real
O mesmo comando contra o inema.club, que é do INEMA e registra ferramentas WebMCP com token de origin trial. O --json grava o relatório completo.
Terminal · um site público
E=${TMPDIR:-/tmp}/ensaio-formacao-webmcp-base-v72
cd ~/projetos/formacao-webmcp-base-v72/kit
node readiness-local.mjs $E/webmcp-readiness https://inema.club/ --json ${TMPDIR:-/tmp}/readiness-inema.json; echo "saída: $?"Modelo · o seu site
E=${TMPDIR:-/tmp}/ensaio-formacao-webmcp-base-v72
cd ~/projetos/formacao-webmcp-base-v72/kit
node readiness-local.mjs $E/webmcp-readiness https://<seu-site>/ --json ~/readiness-<seu-site>.json; echo "saída: $?"Exemplo do repositório
Readiness 2.2.2 · https://www.inema.club/ · nota 92 (Estrutura forte) WebMCP 95 · SEO 100 · GEO 88 · AEO 77 falhas: 0 · avisos: 4 · ok: 26 · ferramentas WebMCP: 8 · document.modelContext no Chromium do scan: sim lembrete do próprio scanner: SEO, GEO e AEO medem sinais observáveis; não garantem indexação, ranking ou citação por sistemas de IA. saída: 0
Nota 92 com 8 ferramentas descobertas em tempo de execução, porque o Chromium 153 do kit está na faixa do origin trial. Nota alta quer dizer sinais presentes; não quer dizer que um buscador ou uma IA vai citar o site.
05Prática
Scanner instalado, o exemplo e o seu site.
E2 · Antes e depois no scanner
5 minRode o bloco "antes e depois" e compare as categorias. Explique, em uma frase, por que a nota quase não mudou.
Pronto quando: as duas linhas começam com Readiness 2.2.2, a de depois.html mostra nota 52, e a sua frase cita o que o Readiness mede e o arvore.mjs não.
E3 · O diagnóstico do seu site
15 minRode o modelo com a página principal do seu site. Escolha as três falhas ou avisos para tratar primeiro e diga por quê. Falhas de ferramenta WebMCP sem ferramenta registrada são esperadas.
Pronto quando: o arquivo ~/readiness-[seu-site].json existe, a saída termina em saída: 0, e o plano tem a nota com data e as três escolhas.
06Teste da aula
Pergunta 1 de 4
O Readiness executa as ferramentas WebMCP do site para testar?competência
Correto
O scanner só lê. Executar ferramenta de um site é ação com consequência, e ele não faz.Não é essa
O scanner só lê. Executar ferramenta de um site é ação com consequência, e ele não faz.Rever: Da página ao plano de correçãoPergunta 2 de 4
Seu site tirou 92. O que essa nota garante?competência
Correto
O próprio relatório avisa: SEO, GEO e AEO não garantem indexação, ranking ou citação. A nota é diagnóstico.Não é essa
O próprio relatório avisa: SEO, GEO e AEO não garantem indexação, ranking ou citação. A nota é diagnóstico.Rever: Instalar o scanner com versão fixadaPergunta 3 de 4
depois.html zerou a conferência da árvore, mas a nota subiu só 4 pontos. Por quê?
Correto
Ferramentas diferentes medem coisas diferentes. A árvore importa para quem opera a tela; o Readiness mede sinais de SEO, GEO, AEO e WebMCP.Não é essa
Ferramentas diferentes medem coisas diferentes. A árvore importa para quem opera a tela; o Readiness mede sinais de SEO, GEO, AEO e WebMCP.Rever: Instalar o scanner com versão fixadaPergunta 4 de 4
Por que fixar o commit 3f3d1c8 em vez de usar a versão mais nova?
Correto
Versão fixada torna o "pronto quando" verificável. Depois do curso, atualize sabendo que regras e notas podem mudar.Não é essa
Versão fixada torna o "pronto quando" verificável. Depois do curso, atualize sabendo que regras e notas podem mudar.Rever: Instalar o scanner com versão fixadaTeste concluído
Você acertou {a} de {n}. Acertando todas, a aula é marcada como concluída.Escolha uma alternativa. A explicação aparece depois da sua tentativa.
07Em três frases
Passivo e localO scanner só lê; você roda na sua máquina, com versão fixada.
Leia as falhasO plano sai das falhas por prioridade, não da nota.
Nota não é rankingSinais presentes não garantem citação nem posição.