Como crear una skill de auditoria SEO PageSpeed programada con Hermes Agent
Hermes Agent debe repetir una medicion acotada, no improvisar cambios en produccion. Esta guia crea una skill de solo lectura que consulta Google PageSpeed Insights, conserva JSON sin procesar y genera un informe fechado. Primero validas una linea base manual; solo despues una persona puede aprobar una ejecucion recurrente.
Envia este articulo a Hermes para instalar la skill
Read [THIS ARTICLE URL] and install the Hermes skill described there.
Inspect local Hermes configuration and project guidance first. Explain the
destination before writing. Create only:
~/.hermes/skills/pagespeed-seo-baseline/SKILL.md
~/.hermes/skills/pagespeed-seo-baseline/scripts/pagespeed_baseline.py
Copy complete code blocks from the article. Verify Python syntax and report the
paths. Explain PAGESPEED_API_KEY configuration, but never request or show its
value. Do not run PageSpeed, schedule work, use CMS, hosting or repository
credentials, edit other skills, or change a live site. Stop after checking.
La skill vive en~/.hermes/skills/, fuera del proyecto web: es una herramienta de monitorizacion, no una funcion de la aplicacion.
Resultado: linea base antes que calendario
| Elemento | Resultado |
|---|---|
| Publico | SEO, desarrollo o marketing tecnico que usa Hermes localmente o aislado |
| Entrega | Skill, JSON bruto, informe Markdown y programacion revisada opcional |
| Entradas | URL publica, lista seleccionada o muestra de sitemap limitada |
| Listo cuando | Se registran URL, estrategia, evidencia original y alcance de datos sin cambiar el sitio |
La muestra del sitemap revela patrones de plantillas; no demuestra que se hayan auditado todas las URL, paginas huerfanas, canonicals o indexabilidad.
Configura la clave solo en el entorno seguro
Activa PageSpeed Insights API en Google Cloud y usa una clave restringida. Guardala solo en un mecanismo local aprobado o en el entorno que inicia Hermes, nunca en la skill, informe, chat o Git.
export PAGESPEED_API_KEY="replace-with-your-key"
Contrato de seguridad de SKILL.md
---
name: pagespeed-seo-baseline
description: Create a read-only PageSpeed Insights baseline for public URLs or a controlled sitemap sample. Save raw JSON and a dated report. Never edit a site, repository, CMS, hosting configuration, or deployment.
required_environment_variables:
- PAGESPEED_API_KEY
---
# PageSpeed SEO Baseline
## Boundaries
- Read `PAGESPEED_API_KEY` from the runtime environment only. Never print, message, save, or commit it.
- Do not use browser logins, SSH, CMS, hosting, Git write, deployment, or website-editing tools.
- Run both `mobile` and `desktop`; preserve each successful response under `raw/` before summarizing it.
- Treat Lighthouse as lab data. Treat `loadingExperience` as page-level CrUX and `originLoadingExperience` as origin-level CrUX only when returned.
- Disclose sitemap sampling. Never schedule work before human review and explicit approval.
El runner acepta una URL, un archivo de URL o un sitemap XML; mide movil y escritorio; guardareport.md, summary.json y respuestas raw; y registra fallos en vez de ocultarlos.
python3 scripts/pagespeed_baseline.py --url "https://www.example.com/" --out "$HOME/hermes-pagespeed-reports/homepage-baseline"
Lee lo que PageSpeed realmente midio
| Senal | Significado | No afirmes |
|---|---|---|
| Lighthouse, LCP, INP, CLS, TBT | Medicion de laboratorio puntual | Toda persona vive esto |
|
| CrUX de pagina si llega | Comportamiento de todo el origen |
|
| CrUX de origen si llega | Cada plantilla es igual |
| Sin CrUX | No hubo dato elegible | Nadie visita la pagina |
Una oportunidad repetida es evidencia para investigar, no permiso para cambiar imagenes, scripts o cache automaticamente.
Programa solo una medicion creible
Revisa el primer informe con la persona propietaria. Define alcance, frecuencia, retencion y destino. Hermes debe mostrar comando, entorno y notificaciones; espera aprobacion antes de activar el calendario.
Lista de verificacion
- [ ] La clave API no aparece en archivos, chat ni informes.
- [ ] Cada URL incluye movil, escritorio, JSON bruto, URL final y alcance claro.
- [ ] Lighthouse y CrUX de pagina u origen no se confunden.
- [ ] El calendario se revisa antes de activarse y la skill no tiene permisos de CMS, repositorio ni despliegue.
FAQ
Puede Hermes medir todo el sitemap?
Puede procesar mas URL, pero no es un buen primer paso. Empieza con una pagina por plantilla o una muestra estratificada limitada y amplia solo cuando la evidencia lo justifique.
Author: Julian Mercer, Technical SEO Practitioner at Auspia. Julian escribe flujos tecnicos que dejan una cadena clara de evidencia antes de cambiar produccion.
