Documentation
Connect your marketing data to Claude, ChatGPT and other LLMs.
Full SEO Audit & Algorithm Updates
Dos herramientas complementarias disponibles en la página GSC Insights (/gsc/{id}/insights) — comparten las mismas fuentes de datos pero responden a preguntas diferentes.
1. Full SEO Audit (botón «Full SEO audit», arriba a la derecha)
Audit IA multi-prompts de la propiedad. Lanza 30+ prompts especializados en paralelo (curados desde el proyecto open-source claude-seo, MIT) cubriendo SEO técnico, contenido, schema, Core Web Vitals, backlinks, E-E-A-T, etc.
Lo que se audita (por categoría)
| Categoría | Ejemplos de prompts | Peso en el score global |
|---|---|---|
| Técnico | sitemap, hreflang, indexability, schema | 20 |
| Contenido | cluster, programmatic, e-commerce, geo | 20 |
| E-E-A-T | autor, trust, signals de expertise | 15 |
| CWV | page speed, SXO, performance | 15 |
| Schema | JSON-LD, datos estructurados | 10 |
| Local / Backlinks / Estrategia | maps, perfil de enlaces, páginas competidoras | 5 cada uno |
Signals colectados antes de lanzar el audit
- GSC: top 50 consultas, top 50 páginas, comparación periodo-vs-periodo (últimos 30d vs 30d anteriores), estado del sitemap, URL Inspection en la home
- Google Safe Browsing: check malware/phishing en la home
- PageSpeed Insights mobile: scores + Core Web Vitals + top oportunidades
- Fetch HTML home: title, H1, meta description, body text, datos estructurados
- Opcional (si claves API configuradas): scrape Firecrawl, datos backlinks DataForSEO
Lanzar un nuevo audit
- Haz clic en «Full SEO audit» (arriba a la derecha, botón morado)
- Modal se abre — haz clic en «Run audit»
- Espera 60-150 segundos (llamadas paralelas en batches de 6 con rate-limiting)
- Obtienes un score global, síntesis IA, cards detalladas por prompt
/admin/ai-usage si admin.Footer del modal — qué significan los números
Formato: Ran in 122.7s · 249 396 tokens · $0.0234 OpenRouter
- Duración: tiempo total wall-clock incluyendo los batches IA y la síntesis
- Tokens: input + output, sumado en todos los prompts + la síntesis final
- Coste: coste USD real devuelto por OpenRouter (campo
usage.cost) — NO una estimación
Cada card de prompt también muestra el modelo usado + su coste individual como pequeño badge junto al nombre del prompt.
Exportar y compartir el informe
Botones en footer:
- 📋 Copy markdown: informe completo al portapapeles, pega en Notion / Slack / email
- 📥 Download ▾:
.md(UTF-8 con BOM),.docx(vía pandoc, con TOC),.pdf(DomPDF, portada brandeada + score card) - ✉ Send by email: asunto + mensaje intro + checkboxes para adjuntar md/docx/pdf
Pestaña History
10 últimas runs por propiedad (auto-pruned más allá — mantiene la BD ligera). Haz clic en cualquier run pasado para recargarlo en la pestaña Current. Cada fila muestra score, verdict, duración, conteo de tokens, coste, modelo.
2. Google Algorithm Updates (anotaciones en el chart)
Google lanza 8-15 actualizaciones mayores de algoritmo al año (Core, Spam, Helpful Content, Reviews, Site Reputation Abuse). Pueden cambiar el tráfico 30-70 % en sitios impactados. El chart en /gsc/{id}/insights anota automáticamente cada update que cae dentro del rango de fechas visible.
Visual en el chart
- Una línea vertical punteada coloreada en la fecha de inicio del rollout (rojo = Core, naranja = Spam, azul = Helpful Content, morado = Reviews, gris = Site Reputation, cian = otro)
- Un badge redondo «G» arriba de la línea — clicable
Haz clic en la G — qué hay en el modal
- Badge type + fecha inicio rollout → fecha fin (si terminado)
- Nombre del update (ej.: «March 2026 core update»)
- Fuentes: de dónde se sacaron los datos (Google Status Dashboard, Search Central blog, SE Roundtable, seed manual)
- Síntesis IA en francés en 5 líneas: Qué / Targets / Impacto esperado / Acción / Delay de estabilización — generada por el mismo modelo IA GSC usado para los SEO audits
- Bloque tip «Cómo leer el impacto»
- Enlace directo al anuncio oficial Google
De dónde vienen los datos
Sincronización automática cada 24h (cron a 03:30) desde 3 fuentes mergeadas + deduplicadas por type + YYYY-MM:
| Fuente | Por qué la usamos | ¿Confirmado? |
|---|---|---|
| Google Search Status Dashboard | Oficial, fechas de rollout exactas, fuente primaria de verdad desde finales de 2024 | Sí |
| Google Search Central blog (RSS) | Contexto editorial oficial, descripciones más largas | Sí |
| Search Engine Roundtable (RSS) | Tercero, rápido — captura events «no confirmados» de volatilidad | Solo si matchea con fuente 1 o 2 |
FAQ
¿Por qué mi Full SEO audit está en «warning» con score 55 sin problema obvio?
Algunos prompts son intencionalmente estrictos — quieren signals que quizás no has configurado todavía (scrape Firecrawl, datos backlinks vía DataForSEO). Verifica la sección «Skipped» abajo: los prompts skipped no bajan el score, pero los errores sí. Si ves «skipped — requires Firecrawl key» puedes ignorar (el prompt no es aplicable) o configurar la clave en /admin/general → Integrations (admin solamente).
¿Por qué la síntesis dijo «0/X URLs indexadas»?
Bug viejo, fixed. El campo sitemap.contents[].indexed de Google está deprecated desde 2018 y siempre devuelve «0». El audit ahora strip este campo antes de enviar los datos a la IA + el system prompt prohíbe cualquier afirmación sobre la tasa de indexación.
¿Puedo desactivar prompts específicos?
Sí (admin solamente): pestaña /admin/general → Google Search Console. Cada prompt tiene un toggle enable/disable. También puedes enable/disable en lote por categoría.
¿Puedo lanzar un audit sin afectar mi cuota IA?
No — los audits siempre cuentan contra tu cuota mensual de tokens. Excepción: los admins pueden saltar el cooldown por propiedad con ?force=1 en la URL para tests, pero sigue consumiendo tokens.
¿Cómo añadir una update de Google que sé que ocurrió pero no aparece?
Dos opciones: (1) esperar la próxima sync diaria si es un anuncio fresco (probablemente aparecerá vía el Status Dashboard o Search Central RSS), (2) un admin puede editar manualmente el array HISTORICAL_SEED en app/Services/GoogleUpdatesSync.php y relanzar «Backfill 24m» en la pestaña /admin/general → GSC.