E1 · Scanner con versión fija
10 minCorre el bloque "clonar y probar".
Listo cuando: la salida muestra ℹ tests 33, ℹ pass 33 y ℹ fail 0.
Clase 7 · 20 min
El diagnóstico de WebMCP Readiness: ejecutarlo y leerlo sin caer en el "nota alta = ranking"
WebMCP Readiness es el scanner abierto de INEMA: abre la página en un navegador aislado, solo lee, y devuelve una nota en cuatro categorías. En esta clase ejecutas el scanner en tu máquina, con versión fijada, contra la página de ejemplo y contra tu sitio, y aprendes a leer el resultado como diagnóstico, no como promesa de ranking.
Comenzar la clase
En esta clase vas a
- 1El scanner abierto, clonado con versión fijada
- 2Cuatro categorías y la nota general
- 3Fallas esperadas y fallas para corregir ya
- 4Lo que la nota no dice
Objetivo: ejecutar WebMCP Readiness en tu máquina y leer el diagnóstico sin confundir nota con ranking.
01De la página al plan de corrección
Haz clic en cada bloque.
Haz clic en cada bloque del diagrama para ver qué hace.
En palabras del propio scanner: SEO, GEO y AEO miden señales observables; no garantizan indexación, ranking ni citación por sistemas de IA.
02Instalar el scanner con versión fija
Clona el repositorio público inematds/webmcp-readiness en una carpeta de ensayo, fija el commit 3f3d1c8 (versión 2.2.2, del 24/09/2026), instala las dependencias y corre sus pruebas.
Terminal · clonar y probar
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) 'Ejemplo del repositorio
ℹ tests 33 ℹ pass 33 ℹ fail 0
Las 33 pruebas del propio scanner pasan. Si el número es otro, no estás en el commit fijado.
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: 1Sin las dependencias del scanner instaladas, Node no encuentra @sparticuz/chromium y se detiene en el import. Corre el bloque completo: el npm ci es parte de él.
03El scanner contra la página de ejemplo
El readiness-local.mjs importa el scanner, apunta al Chromium del kit y, solo para la página en 127.0.0.1, habilita la dirección local (el scanner bloquea la red privada por defecto).
Terminal · antes y después
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: $?"; doneEjemplo del repositorio
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
Eliminar los 10 problemas del árbol subió la nota solo de 48 a 52. El Readiness mide otras cosas (descripción, canónica, tools WebMCP); el árbol lo revisas con el arvore.mjs. Las tres fallas de WebMCP son esperadas: la página no registra tools, y eso es el curso 2.
04El scanner en un sitio real
El mismo comando contra inema.club, que es del INEMA y registra tools WebMCP con token de origin trial. El --json guarda el reporte completo.
Terminal · un sitio 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 · tu sitio
E=${TMPDIR:-/tmp}/ensaio-formacao-webmcp-base-v72
cd ~/projetos/formacao-webmcp-base-v72/kit
node readiness-local.mjs $E/webmcp-readiness https://<tu-sitio>/ --json ~/readiness-<tu-sitio>.json; echo "saída: $?"Ejemplo del repositorio
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 con 8 tools descubiertas en tiempo de ejecución, porque el Chromium 153 del kit está en el rango del origin trial. Una nota alta quiere decir que las señales están presentes; no quiere decir que un buscador o una IA vaya a citar el sitio.
05Práctica
Scanner instalado, el ejemplo y tu sitio.
E2 · Antes y después en el scanner
5 minCorre el bloque "antes y después" y compara las categorías. Explica, en una frase, por qué la nota casi no cambió.
Listo cuando: las dos líneas empiezan con Readiness 2.2.2, la de depois.html muestra nota 52, y tu frase cita lo que el Readiness mide y el arvore.mjs no.
E3 · El diagnóstico de tu sitio
15 minCorre el modelo con la página principal de tu sitio. Elige las tres fallas o avisos que tratarás primero y explica por qué. Las fallas de tool WebMCP sin tool registrada son esperadas.
Listo cuando: el archivo ~/readiness-[tu-sitio].json existe, la salida termina en saída: 0, y el plan tiene la nota con fecha y las tres elecciones.
06Prueba de la lección
Pregunta 1 de 4
¿El Readiness ejecuta las tools WebMCP del sitio para probarlas?competencia
Correcto
El scanner solo lee. Ejecutar una tool de un sitio es una acción con consecuencias, y él no lo hace.No es esa
El scanner solo lee. Ejecutar una tool de un sitio es una acción con consecuencias, y él no lo hace.Repasar: De la página al plan de correcciónPregunta 2 de 4
Tu sitio sacó 92. ¿Qué garantiza esa nota?competencia
Correcto
El propio reporte avisa: SEO, GEO y AEO no garantizan indexación, ranking ni citación. La nota es un diagnóstico.No es esa
El propio reporte avisa: SEO, GEO y AEO no garantizan indexación, ranking ni citación. La nota es un diagnóstico.Repasar: Instalar el scanner con versión fijaPregunta 3 de 4
depois.html eliminó los problemas de la revisión del árbol, pero la nota subió solo 4 puntos. ¿Por qué?
Correcto
Herramientas distintas miden cosas distintas. El árbol importa para quien opera la pantalla; el Readiness mide señales de SEO, GEO, AEO y WebMCP.No es esa
Herramientas distintas miden cosas distintas. El árbol importa para quien opera la pantalla; el Readiness mide señales de SEO, GEO, AEO y WebMCP.Repasar: Instalar el scanner con versión fijaPregunta 4 de 4
¿Por qué fijar el commit 3f3d1c8 en vez de usar la versión más nueva?
Correcto
Una versión fijada hace verificable el "listo cuando". Después del curso, actualiza sabiendo que las reglas y las notas pueden cambiar.No es esa
Una versión fijada hace verificable el "listo cuando". Después del curso, actualiza sabiendo que las reglas y las notas pueden cambiar.Repasar: Instalar el scanner con versión fijaPrueba completada
Acertaste {a} de {n}. Si aciertas todas, la clase se marca como completada.Elige una alternativa. La explicación aparece después de tu intento.
07En tres frases
Pasivo y localEl scanner solo lee; tú lo ejecutas en tu máquina, con la versión fijada.
Lee las fallasEl plan sale de las fallas por prioridad, no de la nota.
La nota no es un rankingQue las señales estén presentes no garantiza citación ni posición.