🌱 Empieza aquí · Auditor de presencia en Maps (modo gratuito)

¿Tienes un negocio con local físico y no sabes qué tan bien apareces en Google Maps y en los buscadores? Esta semilla te instala un auditor de cabecera que revisa tu presencia local y te entrega una radiografía clara: un puntaje de 0 a 100 y la lista de qué arreglar primero. Y lo hace sin costo, apoyándose solo en mapas y APIs geográficas gratuitas. Nada de mensualidades.

Para ti (el humano)

Solo tienes que decir una frase. Abre esta carpeta con tu asistente (Claude Code o Cowork) y escríbele:

"Siembra esta semilla 🌱"

¿Otras formas de pedirlo? "instala esta semilla", "activa el auditor de Maps", "haz el setup de esto". Te entiende igual. De ahí en adelante tu asistente hace toda la parte técnica; tú no tocas nada. Vas a ver algunas palabras en inglés en la pantalla; ni caso, él te guía.

Cuando quieras usarlo, basta con darle el nombre o la página web del negocio. Si además llenas la plantilla de datos (una sola vez), te ahorras repetir la información en cada auditoría.

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 la presencia en Maps de un negocio). No es un hook (una automatización que se dispara sola ante eventos): 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 tal cual.

Los placeholders entre <...> los resuelves tú según la plataforma y el contexto del humano:

• <TU-RUTA-DE-AGENTES> → carpeta donde viven las definiciones de agentes del asistente.
  • Claude Code (usuario): ~/.claude/agents/ (recomendado; el agente queda disponible en todas las sesiones).
  • Por proyecto: .claude/agents/ dentro del proyecto (si el humano 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 y su plantilla

El kernel trae dos archivos:

• kernel/seo-maps.md — la definición del agente auditor (el método en sí).
• kernel/config-negocio.ejemplo.md — una plantilla para aterrizar los datos del negocio de ESTA persona.

Copia ambos a <TU-RUTA-DE-AGENTES>. Crea la carpeta si no existe.

mkdir -p <TU-RUTA-DE-AGENTES>
cp kernel/seo-maps.md <TU-RUTA-DE-AGENTES>/seo-maps.md
cp kernel/config-negocio.ejemplo.md <TU-RUTA-DE-AGENTES>/config-negocio.ejemplo.md

Solo seo-maps.md es el agente (trae encabezado con name:). El config-negocio.ejemplo.md es un archivo de datos que el agente lee, no un agente: por eso el asistente lo ignora como definición y solo queda ahí de referencia. Si prefieres, puedes guardarlo en otra carpeta y apuntarle al agente su ruta; funciona igual.

Paso 2 · Aterrizar los datos del negocio (un par de preguntas al humano)

Haz una copia de config-negocio.ejemplo.md llamada config-negocio.md (para no pisar la plantilla) y, con el humano, llena la tabla del punto 1 (nombre exacto, dirección completa, teléfono, giro, sitio web, ciudad). Pregúntale en lenguaje simple: "¿Cuál es el nombre, la dirección y el teléfono EXACTOS del negocio como quieres que aparezcan en internet?" y "¿Cuál es su página web y en qué ciudad o zona quieres competir?". Cuando delegues una auditoría, apúntale al agente la ruta de config-negocio.md.

Dos campos opcionales que ayudan pero no bloquean:

• API key gratuita de Geoapify (punto 2): desbloquea la búsqueda de puntos de interés cercanos. Si el humano no tiene, déjalo vacío; el agente omite ese paso y lo anota en las limitaciones.
• Checklist de industria (punto 3): si el humano tiene un checklist propio de su giro, apunta su ruta. Si no, el agente usa su checklist genérico.

Si el humano no tiene estos datos a la mano, no bloquees la siembra: el agente también acepta el nombre o la URL del negocio directo en la conversación.

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-maps.md && head -6 <TU-RUTA-DE-AGENTES>/seo-maps.md

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

---
name: seo-maps
description: Especialista en inteligencia de Maps en modo gratuito. ...
model: sonnet
maxTurns: 25
tools: Read, Bash, WebFetch, Glob, Grep, Write

Luego haz una prueba funcional real. Desde tu propia conversación, delega una auditoría chica:

Usa el agente seo-maps para auditar la presencia en Maps de [nombre o URL de un negocio del humano].

Qué esperar: que declare que trabaja en modo gratuito, que geocodifique la dirección con Nominatim, y que entregue un reporte con el Maps Health Score (0-100), el desglose por dimensión y una lista de acciones priorizadas. Si algún dato no lo puede verificar, debe marcarlo "por confirmar" en vez de inventarlo. Si en vez de eso te suelta un puntaje sin haber consultado nada o inventa reseñas, el agente no se instaló bien: confirma que copiaste el archivo a <TU-RUTA-DE-AGENTES> correcto (usuario vs. proyecto) y que el encabezado del Paso 3 se lee completo.

Cuando las dos 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 con el seo-maps" tu negocio (dale el nombre o la página web). En un rato te devuelve una radiografía con un puntaje de 0 a 100 y una lista de qué arreglar primero, de lo más urgente a lo menos. Si lees eso y piensas "ah, con razón no salía bien en el mapa", ya quedó. A partir de ahora tienes un auditor de presencia local que te dice, gratis, dónde estás parado y qué mover para subir. 🌱