Clase 8 · 20 min
El agente se equivoca de maneras previsibles: afirma sin comprobar, suma mal, rompe lo que funcionaba, usa la clave que encontró. Cada falla real del proyecto de SEO de INEMA se volvió una línea en el registro de fallas y una regla en el AGENTS.md. Esta lección muestra las fallas, la corrección mínima de cada una y cierra el curso con tu plan.
Comenzar la lección
Objetivo: reconocer las fallas reales de los agentes en SEO y aplicar las reglas: API solo con autorización, secreto fuera del repo, comprobar antes de afirmar.
Toca cada bloque.
Una línea por falla: fecha, qué se rompió, corrección mínima, prompt o infra.
Haz clic en cada paso. Todas están en el FALHAS.md del proyecto.
Un plan hecho por un agente decía que el sitio no tenía Search Console: solo buscó en el código. La corrección fue verificar el registro TXT del DNS antes de afirmar que no existía.
El mismo día, el agente sugirió instalar un paquete de un procesador distinto al de la máquina. Regla: verificar la arquitectura antes de sugerir un paquete.
La exportación semanal sumó las impresiones de la marca por la combinación consulta + página, y la parte pasó a ser mayor que el total. La corrección fue sumar solo por la consulta.
Otro script contó como enriquecida toda ficha presente en el archivo, sin leer el campo que decía si lo era. En los dos casos: un número imposible que una verificación simple habría detectado.
Un cambio visual dejó el índice de cursos como "solo búsqueda", y las 310 fichas perdieron el único enlace interno en el HTML del servidor. La corrección fue un índice plegado, sin cambio visual.
Regenerar un área del sitio con un generador antiguo desharía una corrección de canónico hecha a mano. La regla quedó escrita: no regenerar encima.
El primer envío a IndexNow con una clave recién publicada devolvió 403; reenviar unos minutos después lo resolvió (infra). La clave de IndexNow es pública por diseño; la de Bing Webmaster es secreto.
Regla del método: API de pago solo con autorización explícita para esa finalidad, y aviso a los buscadores solo con URLs que respondan 200.
Copia el FALHAS.md a la raíz del proyecto. Ejecuta el barrido antes de cada push.
# FALHAS | fecha | qué se rompió | corrección mínima | prompt \| infra | |---|---|---|---| | 2026-10-02 | IndexNow devolvió 403 SiteVerificationNotCompleted en el 1.er envío (clave recién publicada) | reenviar después de ~4 min | infra | | 2026-10-02 | /cursos/ pasó a ser "solo búsqueda" y las fichas perdieron el único enlace interno renderizado en el servidor | índice colapsado (details) con enlaces simples debajo de la búsqueda | prompt | | 2026-09-24 | la exportación semanal sumó las impresiones de la marca por query+page (la parte quedó mayor que el total) | sumas solo por la dimensión query | prompt | | 2026-09-23 | el plan decía "sin Search Console" (buscó solo en el código) | revisar el DNS TXT antes de afirmar la ausencia | prompt |
echo ".env" >> .gitignore git check-ignore -v .env # confirma que el .env está ignorado git grep -niIE "(api[_-]?key|apikey|secret|token)[[:space:]]*[:=]" # busca valor de clave en lo que va al repo
$ git check-ignore -v .env .gitignore:1:.env .env $ git grep -niIE "(api[_-]?key|apikey|secret|token)[[:space:]]*[:=]" avisar.sh:1:curl "https://ssl.bing.com/webmaster/api.svc/json/SubmitUrlBatch?apikey=$BING_API_KEY" rodar.sh:2:export BING_API_KEY=9f3a1c0000000000000000000000beef
Repositorio de prueba armado para la clase; la clave es falsa.
$BING_API_KEY, una referencia a la variable. Está bien.Tú eres quien responde al agente. La conversación es ficción; las reglas vienen del método inemaSEO.
Elige tu respuesta. El comentario aparece enseguida y la conversación sigue según tu elección.
En el proyecto de SEO de las clases anteriores.
Crea el FALHAS.md en la raíz y registra 3 fallas que ya viste cometer a un agente (en este curso o antes), cada una con la corrección mínima y si fue prompt o infra. Lleva la regla de cada una al AGENTS.md.
Listo cuando: el FALHAS.md tiene 3 líneas en el formato fecha | qué se rompió | corrección mínima | prompt o infra, y el AGENTS.md ganó al menos una regla nueva que salió de ellas.
Corre el barrido en el proyecto y en cada repositorio donde trabajó un agente. Revisa el .gitignore.
Listo cuando: git check-ignore -v .env muestra la regla del .gitignore, y el barrido no encuentra ningún valor de clave escrito (solo referencias a variables).
La explicación aparece después de tu respuesta.
Pregunta 1 de 4
El agente dice que el sitio "no tiene Search Console" porque no encontró nada en el código. ¿Qué pedir?competencia
Pregunta 2 de 4
La suma de la marca quedó mayor que el total de impresiones. ¿Cuál es la corrección mínima?
Pregunta 3 de 4
¿Cuál de estas claves puede quedar visible en el sitio sin problema?
Pregunta 4 de 4
El escaneo encontró el valor de una clave escrito en un script ya commiteado. ¿Qué hacer?
Elige una alternativa. La explicación aparece después de tu intento.
Cuatro niveles y los ejercicios de cada uno. Toca un ejercicio para ver el "listo cuando".
línea, compuertas y AGENTS.md
2 ejercicios
AGENTS.md en la raíz y una vuelta de la máquina en papel.
Ver la claseauditor y extracción (clases 2 y 3)
2 ejercicios
Lista de hallazgos con evidencia y una extracción con control.
Ver la claselote y meta (clases 4 y 5)
2 ejercicios
Lote con dry-run y marcador; página por el loop y por la compuerta.
Ver la claseinforme, herramientas y reglas (clases 6 a 8)
2 ejercicios
Informe semanal con propuestas aprobadas y FALHAS.md vivo.
Ver la claseLa base: sin compuertas escritas, automatizar SEO es publicar mal más rápido.
Requiere el AGENTS.md. Los agentes que solo leen van antes que los que escriben; el mapa muestra la clase 2, el plan de abajo lista todas.
Requiere los niveles anteriores. Escribir en el sitio solo con dry-run, meta de nivel 3 y compuerta antes del push.
El observador cierra la máquina cada semana, y cada falla nueva se vuelve regla.
Máquina, lectura, escritura y rutina. Solo sube de nivel cuando el "listo cuando" del anterior sea verdad.
Después de este curso viene el curso 6: el método como servicio para clientes.
Elige la fecha de inicio y cuánto tiempo tienes por semana.