🌱 Empieza aquí · Auditoría SEO con datos reales de Google

¿Alguna vez te dijeron que tu sitio "va lento" o que "no aparece en Google", pero nadie te mostró un número que lo respalde? Esta semilla te instala un auditor que deja de adivinar: va directo a las herramientas gratuitas de Google y te trae los datos de usuarios reales —qué tan rápido carga tu sitio para la gente de verdad, con qué te encuentran, cuánto tráfico llega de buscadores— para que sepas exactamente qué arreglar primero.

Para ti (el humano)

Instalar es una frase. Abre esta carpeta con tu asistente (Claude Code o Cowork) y escríbele:

Dile a tu asistente: siembra esta semilla 🌱

¿Otras formas de pedirlo? "instala esta semilla", "haz el setup de esto", "ponme esto a funcionar". Te entiende igual. De ahí en adelante, tu asistente hace toda la parte técnica.

Lo único que sí necesitas conseguir tú (es gratis) es al menos una "llave" para hablar con Google. Piénsala como un boleto de entrada gratuito:

Lo mínimo (Nivel 0): una API key gratuita de Google. Con eso ya mides la velocidad y la experiencia de carga reales de tu sitio. Se saca en la consola de Google Cloud, activando la "PageSpeed Insights API". Tu asistente te puede guiar paso a paso si se lo pides.
Para más (Niveles 1 y 2): si además quieres ver tus búsquedas top y tu tráfico orgánico, hay que darle permiso de lectura a tu Search Console y a tu Analytics (GA4). Es más setup, pero también gratis. Puedes empezar con el Nivel 0 y sumar los demás después.

Si al principio solo tienes la API key, no pasa nada: el auditor trabaja con lo que haya y te dice claramente hasta dónde pudo llegar.

Para el asistente que siembra 🤖

Eres el asistente que va a instalar esta semilla. Es un agente (un subagente al que se le delega la misión de auditar el SEO con las APIs de Google). No es un hook (automatización que se dispara sola): no hay que registrar nada en settings.json ni dar permisos de ejecución (chmod) — es un archivo de definición en texto, no un script. Sigue estos pasos.

El placeholder <TU-RUTA-DE-AGENTES> lo resuelves tú según la plataforma:

Claude Code (usuario): ~/.claude/agents/ (recomendado; queda disponible en todas las sesiones del usuario).
Por proyecto: .claude/agents/ dentro del proyecto (si solo lo quiere ahí).
Cowork: la carpeta de configuración equivalente (~/.claude/agents/ si comparte el mismo directorio de config).

Paso 1 · Copiar la definición del agente

Copia kernel/seo-google.md a <TU-RUTA-DE-AGENTES>. Crea la carpeta si no existe.

mkdir -p <TU-RUTA-DE-AGENTES>
cp kernel/seo-google.md <TU-RUTA-DE-AGENTES>/seo-google.md

Paso 2 · Confirmar credenciales disponibles (una conversación con el humano)

Este agente NO trae credenciales; usa las que el humano configure. Pregúntale, en simple:

"¿Ya tienes una API key gratuita de Google (PageSpeed Insights API activada)?" — habilita el Nivel 0. Si no la tiene, ofrécele guiarlo: se crea en Google Cloud Console → APIs y servicios → Credenciales → Crear API key, y luego se activa "PageSpeed Insights API".
"¿Quieres además datos de Search Console y de Analytics (GA4)?" — habilitan Niveles 1 y 2. Requieren OAuth o una cuenta de servicio con permiso de lectura sobre esas propiedades. Es más setup; se puede dejar para después.

Guarda la API key en una variable de entorno (nombre sugerido: GOOGLE_PAGESPEED_API_KEY) — por ejemplo en un .env local o en las variables del sistema—, nunca dentro del archivo del agente ni en un sitio que se comparta. Anota el nombre exacto que usaste: el agente lo necesita para encontrar la key al auditar (si usas el nombre sugerido, la localiza sola). Si el humano solo tiene la key, está perfecto: se arranca en Nivel 0.

Nota sobre la ruta de aprendizajes. El agente guarda lo que aprende en ~/.claude/agents/learnings/ (sección Mejora continua, al final de seo-google.md). Esa ruta está escrita para una siembra de usuario en ~/.claude/. Si sembraste en otro lado (por proyecto, o un Cowork con otro directorio de config), abre el archivo copiado y alinea esas dos rutas para que apunten a la carpeta de config real.

Paso 3 · VERIFICACIÓN post-siembra (obligatoria)

Primero confirma que el archivo quedó en su lugar y que su encabezado se lee bien:

ls -la <TU-RUTA-DE-AGENTES>/seo-google.md && head -6 <TU-RUTA-DE-AGENTES>/seo-google.md

Salida esperada — el archivo existe y su encabezado empieza así:

---
name: seo-google
description: "Auditor de SEO que trae datos REALES de los usuarios de Google: ..."
tools: Read, Bash, Write, Glob, Grep
model: sonnet

Luego haz una prueba funcional real (Nivel 0, la que casi siempre está disponible). Con la API key configurada, delega desde tu conversación:

Usa el agente seo-google para auditar los Core Web Vitals de https://ejemplo.com.

Qué esperar: el agente anuncia hasta qué nivel puede llegar, ejecuta una llamada real a PageSpeed/CrUX, y devuelve una tabla de Core Web Vitals (LCP, INP, CLS) con su semáforo y una nota de la fuente (dato de campo vs. laboratorio). Si trae números con su fuente citada y NO inventa datos cuando algo falla, el agente quedó vivo. ✅

Si el agente no aparece / no se puede invocar: confirma que copiaste el archivo al <TU-RUTA-DE-AGENTES> correcto (usuario vs. proyecto) y que el encabezado del Paso 3 se lee completo.
Si reporta "sin credenciales": falta la API key en el entorno; ayúdalo a configurarla (Paso 2) y repite la prueba.
Si CrUX responde sin datos (404): es normal en sitios con poco tráfico en Chrome; el agente debe caer al dato de laboratorio de PageSpeed y aclarar que es laboratorio, no campo.

Cuando las verificaciones den lo esperado, la siembra está completa. Reporta al humano en una línea, sin tecnicismos.

¿Cómo sé que funcionó? (para el humano)

Fácil: pídele a tu asistente que "audite tu sitio con el seo-google" y dale tu dirección web. En un rato te devuelve un tablero claro: qué tan rápido carga tu sitio para tus usuarios de verdad (con colores tipo semáforo), y —si conectaste Search Console y Analytics— con qué palabras te encuentran, qué páginas rankean y cuánta gente llega de buscadores. Todo con datos reales de Google, no adivinanzas. Si ves ese tablero con sus números y sus fuentes, ya quedó. A partir de ahí tienes un auditor SEO de cabecera que te dice, con evidencia, qué arreglar primero. 🌱

Auditoría SEO con datos reales de Google