IA & GEO

AI Overview Tracker

Un AI Overview Tracker es el monitor automático de tu presencia en los bloques de AI Overview de Google Search. Rastrea, keyword a keyword y día a día, si Google te menciona en sus respuestas generativas, si te cita como fuente, qué fuentes externas compiten contigo, y detecta cambios de visibilidad en el tiempo. Es a Google AI Overview lo que un rank tracker es al ranking clásico: un vigilante persistente que te alerta cuando entra o sales del bloque.

A diferencia del SEO tradicional, en Google AI Overview no hay posiciones numéricas: solo hay presencia o ausencia. Pero esa presencia tiene grados: puedes ser citado (fuente visible), mencionado (Google escribe tu nombre en el texto), ausente (Google disparó el bloque pero sin ti) o nunca dispararse el bloque para esa búsqueda. El tracker convierte esa realidad variable en métricas accionables.

---

Qué es y para qué sirve

Google AI Overview ha capturado entre un 10-30% del volumen de búsqueda en sectores competitivos. Cuando Google lo dispara, la IA resume la respuesta sin enviarte tráfico: hace que el usuario no necesite clicar en tu web. O al contrario: si apareces citado, la IA te envía atención directa.

El AI Overview Tracker responde preguntas clave:

• ¿Para cuáles de mis keywords dispara Google AI Overview?
• Cuando lo dispara, ¿aparezco citado como fuente, o Google usa a mis competidores?
• ¿La IA me menciona en el texto pero sin citar mi dominio?
• ¿Qué dominios compiten conmigo en esas respuestas?
• ¿He perdido citación en una keyword donde antes estaba?

El resultado es un mapa vivo de tu vulnerabilidad (y oportunidad) en Google AI Overview que puedes monitorear sin intervención manual.

---

Cómo funciona, paso a paso

1. Defines las keywords: los términos de búsqueda sobre los que quieres vigilar tu presencia en Google AI Overview (p. ej. "mejores agencias de marketing", "alternativas a Slack", "qué es SEO").
2. Indicas tu dominio target y la geografía/idioma donde quieres monitorear.
3. Eliges la frecuencia: Solo cuando yo lo lance (por defecto), Semanal o Diaria (solo en planes Enterprise). Las keywords nuevas empiezan en Solo cuando yo lo lance: el análisis automático semanal (o diario) lo activas tú, al añadir la keyword o al importar una lista, y lo puedes cambiar después desde el panel de la keyword.
4. Antropus consulta Google Search en tiempo real y busca el bloque AI Overview para esa keyword en ese país/idioma.
5. Si existe el bloque, un parser automático detecta:
   • Si tu dominio aparece entre las fuentes del bloque (→ Cited)
   • Si Google escribe el nombre de tu marca en el texto, sin contar los enlaces, y no eres fuente (→ Mentioned)
   • Si el bloque existe pero tú no apareces (→ Absent)
6. Si Google no dispara AI Overview para esa keyword, se registra como No AI Overview.
7. Cada snapshot se almacena en el histórico. Si hay cambio significativo desde el anterior (entrar o salir de "Cited", por ejemplo), se marca para notificación.

El tracker corre en segundo plano según la frecuencia que elegiste (diaria o semanal) para cada keyword. Las que dejaste en Solo cuando yo lo lance no se analizan solas nunca: se analizan una vez al añadirlas y después solo cuando pulsas Re-analizar. Puedes re-chequear manualmente una keyword en cualquier momento, pero hay cooldown de 1 hora entre re-checks para proteger tu saldo de créditos.

---

Qué necesitas antes de empezar

---

Funciones / Vías de uso

Autenticación: Requiere módulo "seo" activo. Las keywords se aíslan por workspace (RLS: solo ves las tuyas).

---

Modos u opciones

Frecuencia de análisis (la eliges tú)

• Semanal (7 días): disponible en todos los planes. La activas tú. Se analiza sola cada semana y cada análisis gasta créditos.
• Diaria (24 horas): Solo Enterprise. Se analiza sola cada día y cada análisis gasta créditos. En otros planes no se puede elegir.
• Solo cuando yo lo lance (manual, por defecto): disponible en todos los planes. La keyword se analiza una vez al añadirla (lo lanzas tú) y después solo cuando pulsas "Re-analizar". El análisis automático la salta siempre: no gasta créditos por su cuenta.

Al añadir una keyword o importar una lista eliges la frecuencia en el desplegable Frecuencia; en el panel de cada keyword puedes cambiarla cuando quieras. Cambiar la frecuencia no analiza ni cobra nada por sí mismo. Pasar una keyword de Solo cuando yo lo lance a semanal o diaria hace que el análisis automático la vuelva a tener en cuenta en menos de un día, pero no la analiza hasta que haya pasado una semana (o un día, en diaria) desde su último análisis: si la analizaste hace poco, tendrá que esperar a que se cumpla ese plazo. No se puede cambiar la frecuencia de una keyword mientras se está re-analizando.

El Excel del tracker lleva la columna Frecuencia con "Semanal", "Diaria" o "Solo manual".

Cadencia mínima del plan

• Suelos por plan:
  • Free: 168h (7 días, fijo)
  • Lite: 168h (7 días)
  • Starter: 168h (7 días)
  • Pro: 72h (3 días)
  • Agency: 48h (2 días)
  • Enterprise: 24h (1 día, permite daily)

El tracker usa la cadencia más restrictiva: si bajas de Enterprise a Starter con keywords en diaria, siguen chequeándose cada 7 días (el suelo del plan). Las keywords en Solo cuando yo lo lance no se analizan solas con ningún plan.

Pausa / Reanudación

Puedes pausar una keyword para que no se chequee automáticamente, sin eliminarla. Útil cuando la temporada no es relevante o mientras haces cambios SEO.

Notificaciones (futuro)

Campo configurado: si hay cambio significativo (entrar en Cited, salir de Cited), se marca para alerta. Actualmente en beta.

Scope por proyecto

Puedes crear keywords asociadas a un proyecto específico. El listado se filtra por acceso a proyecto.

---

Datos o motores de IA que utiliza

AI Overview Tracker NO usa LLMs internos. Consulta directamente con Google Search en tiempo real. El análisis de presencia es determinístico (parsing local, sin IA).

No consulta ChatGPT, Claude, Gemini, Perplexity ni ningún otro motor generativo. Es puro rastreo de presencia en las respuestas de Google.

---

Cómo se calculan las métricas / Cómo se interpreta el resultado

Los 4 estados mutuamente excluyentes

Cada keyword, en cada snapshot, está en exactamente uno de estos estados:

Cálculo de presencia (Parser)

1. ¿El dominio target (o un subdominio) está entre las fuentes del bloque?
   (references, enlaces del texto y URLs que Google escribe en la respuesta)
   → Sí: CITED

2. Si no cited, ¿el texto del bloque, SIN enlaces, escribe el nombre de la marca?
   (palabra completa, nombre propio, nombres de la marca del proyecto)
   → Sí: MENTIONED

3. Si Google disparó AIO pero ninguno de lo anterior:
   → ABSENT

4. Si no hay bloque AIO en la SERP:
   → NO_AIO

Qué cuenta como «tu nombre escrito». Se lee el texto del AI Overview quitando los enlaces: el destino de los enlaces, las direcciones web, los dominios escritos («visita elevam.es») y las citas numeradas no cuentan como mención, aunque lleven tu nombre dentro. El texto de un enlace sí cuenta si es tu nombre escrito en la frase («Elevam Labs»). Las imágenes no son texto, nunca: el texto alternativo de un logo con tu nombre («») no cuenta, ni suelto ni dentro de un enlace, y tampoco si la imagen va por referencia («![Elevam][logo]») o como etiqueta HTML («<img … alt="Elevam">»).

Qué nombres se buscan.

• Los que declaras en el proyecto —la marca, el nombre de la ficha y los alias—, solo si el sitio de la keyword es el del proyecto. Una keyword de otro dominio del mismo workspace no usa la marca de este proyecto: se busca el nombre del propio dominio de esa keyword si tiene 5 letras o más (y en plataformas como Substack o WordPress.com, cada subdominio es un sitio distinto). Cuentan desde 3 letras; los de menos no se buscan. Si declaras la marca como un dominio («Booking.com»), se busca su nombre («Booking») y escribirlo en una frase cuenta, igual que el dominio entero escrito en una frase («booking.com»); con ruta, en un chip de cita o dentro de una dirección sigue siendo una cita; un alias con forma de dominio no se busca, porque un dominio escrito es una cita.
• La etiqueta del dominio de la keyword («tienda.elevam.es» → «elevam»), también si no es el de tu proyecto, solo si tiene 5 letras o más. «best.com» no se busca. En una plataforma como Substack la etiqueta es la tuya («elevam.substack.com» → «elevam»), nunca la de la plataforma.

Cómo se busca. Palabra completa, sin distinguir acentos, escrita como nombre propio. Cuenta si está escrito como lo declaraste, con mayúscula inicial en cada palabra o todo en mayúsculas: si declaras «Gym 24h», cuentan «Gym 24h», «Gym 24H» y «GYM 24H», pero no «gym 24H»; las cifras y signos como «ª» y «º» no cuentan como mayúscula ni minúscula. Si el mismo texto también escribe esas palabras alguna vez de otra forma que no cuenta, en minúscula («Mango» frente a «el mango») o con otra mayúscula («Impresión 3D: La impresión 3D permite…», «Agencia SEO: una agencia SEO te ayuda…»), las está usando como una frase corriente y no se sabe cuál es tu marca: no cuenta ni siquiera la vez que va como nombre propio, y sale «—». Una marca que Google escribe toda en minúsculas también sale «—». Una frase corriente como «cerrajeros 24H» o «muebles de 2ª mano» no cuenta como «Cerrajeros 24H» ni «Muebles de 2ª Mano»: sale «—». Los nombres de 3 letras (RIU, AXA) cuentan en mayúsculas o tal como los declaraste («Riu»), y nunca si el texto también los escribe en minúscula o de otra forma. Un nombre de varias palabras que declaras se encuentra también junto («NeoAttack») o unido por un guion («-», «–», «—»), un guion bajo, un punto medio, un «&», un apóstrofo o un «+», con hasta dos espacios a cada lado; un punto, una coma o un salto de línea no unen sus palabras («…SEO. Estudios…» no es «Seo Estudios»). Si el nombre que declaras lleva signos («Mr. Wonderful», «Clínica Dr. Pérez», «Mr. & Mrs. Smith»), cuenta además cuando sale escrito tal cual, sin distinguir mayúsculas ni acentos; esos signos no valen sueltos en cualquier hueco («…en cualquier clínica. Dr. Pérez…» no es «Clínica Dr. Pérez»). Si lo declaras con «&» («Pérez & Asociados»), se busca también con «y» y con «and». La etiqueta de un dominio con guion («clinica-dental») y un nombre que declaras con guion y sin espacios («Clinica-Dental») se encuentran solo juntos o con guion, no con espacio: «Clínica Dental Sanitas» no cuenta como nombrar a clinica-dental.es, porque son palabras corrientes, y el resultado es «—» (si quieres que cuente así, declara la marca con ese nombre, con espacio). Las formas cortas o partidas que no declaraste no cuentan como tu nombre («Ecocar» no es «Ecocar Fuerteventura»): declara también el nombre con el que Google suele escribir tu marca. Si en el texto sale una palabra distintiva de tu nombre (de 4 caracteres o más y que no sea una palabra genérica como «agencia» o «digital»), el resultado es «—», no «No»; si solo salen palabras cortas o genéricas («sol» de «Agencia Digital Sol»), no se toman por tu nombre y el resultado es «No».

En alemán. En las keywords con idioma alemán todos los sustantivos llevan mayúscula inicial, y por eso la mayúscula no distingue una marca de un sustantivo («Mallorca-Urlaub»: Urlaub significa vacaciones). Un nombre que sale solo del dominio de la keyword («mallorca-urlaub.de» → «Mallorca-Urlaub»), la marca que declaras como un dominio («autohaus.de» → «Autohaus», también si la ficha de la marca, rellenada automáticamente, trae la misma palabra, salvo que también lo hayas declarado con espacios, como «Auto Haus») o con guion y sin espacios («Mallorca-Urlaub») nunca da «Sí» en alemán: si sale en el texto, el resultado es «—»; si no sale, «No». El dominio entero escrito en una frase («…bei mallorca-urlaub.de buchen») sí cuenta. Los nombres que declaras con espacios siguen contando; el límite es que, si declaras como marca una palabra que además es un sustantivo alemán, no se puede distinguir de él.

Cuando no se puede saber. Si el bloque no trae texto, o no hay ningún nombre que buscar, el análisis no dice «no te nombra»: queda sin dato, y el estado no pasa a Mentioned. No hay ningún nombre que buscar cuando no has declarado la marca y el dominio tiene menos de 5 letras; en una keyword de un dominio distinto al del proyecto no se usa la marca del proyecto, y se busca el nombre del propio dominio de esa keyword si tiene 5 letras o más. Tampoco lo dice si tu nombre sí está escrito pero solo de un modo que la regla no deja contar (por ejemplo, todo en minúscula, como una palabra corriente, con otras mayúsculas que las declaradas («cerrajeros 24H» para «Cerrajeros 24H»), el mismo texto que lo escribe de las dos formas («La impresión 3D» junto a «Impresión 3D»), un nombre de 3 letras en otra grafía que la declarada, o repartido en palabras de un modo que la regla no une, por ejemplo con espacio cuando solo vale junto o con guion, o una palabra distintiva suelta de un nombre que declaraste, como «Ecocar» de «Ecocar Fuerteventura», o el «&» leído como «and» o «y» en el nombre de un dominio, como «Pull&Bear» para pullandbear.com, o, en una keyword en alemán, un nombre que sale solo del dominio de la keyword o que declaras como dominio o con guion y sin espacios): no se puede asegurar si es tu marca, así que queda sin dato y el estado tampoco pasa a Mentioned. Si en un análisis no se pueden leer los nombres de tu proyecto (un fallo puntual), solo se busca el de tu dominio, no se afirma «No te nombra» y el detalle de la keyword lo avisa. En el detalle de la keyword verás «Te nombra en el texto: Sí / No / —»: «No» solo sale si ningún nombre aparece en el texto, sin enlaces ni imágenes, de ningún modo. Y verás «Te cita sin nombrarte» cuando eres fuente y el resultado es «No».

Límites que conviene conocer. La regla lee cómo está escrito el nombre, no de qué habla el texto, así que hay tres casos en los que puede salir «Sí» sin que Google hable de tu marca. (1) Una marca que es una frase corriente («Clínica dental», «Peluquería canina») cuenta cuando Google la escribe al empezar una frase, con la mayúscula que declaraste, y no la escribe en ningún otro sitio de otra forma; si el mismo texto dice también «una clínica dental», sale «—». Para evitarlo, declara la marca con un elemento que la distinga («Clínica dental Sanitas»). (2) Cuando el nombre sale del dominio de la keyword, escrito todo en mayúsculas puede coincidir con una sigla corriente («pymes.es» y «PYMES»), y si la etiqueta del dominio es un lugar («granada.es») siempre se escribe con mayúscula inicial: la regla no puede distinguir tu marca de la palabra corriente ni protegerte de ello. (3) Un nombre que declaras en minúscula con una mayúscula dentro («cerrajeros 24H») cuenta escrito exactamente así.

Desde cuándo. Esta regla vale para los análisis nuevos, desde la actualización de octubre de 2026: cada análisis lleva el sello de la regla con la que se contó. Los análisis anteriores no se recalculan: conservan la regla antigua y cada keyword se corrige sola en su siguiente análisis automático. Si en ese análisis el estado es otro y la regla nueva lo explica (con la regla antigua, esa misma respuesta de Google habría dado el estado que tenías antes), no se cuenta como cambio de Google: no aparece en «Cambios recientes» y el historial, en pantalla y en el Excel, lo marca como «regla nueva». Si en un análisis no se pueden leer los nombres de tu proyecto y por eso dejas de estar Mencionado, o si no se pudieron leer en el análisis anterior y por eso el estado de ahora es otro, no se puede asegurar que lo causara Google y ninguna regla cambió: tampoco se cuenta como cambio de Google, y el historial lo marca «nombres sin leer», no «regla nueva». Un cambio que la regla no puede causar, como que aparezca o desaparezca el AI Overview, sí es de Google y se cuenta como siempre.

Honestidad del parser: Usa palabra completa para evitar falsos positivos. Así, "elevam" en "teletrabajamiento" no marca como "mentioned". Y dominio corto genérico ("best.com" → "best" de 4 letras) se descarta para no marcar "mentioned" por apariciones casuales en el texto.

Cambios significativos

El sistema detecta transiciones importantes:

• Entrar en Cited (absent/mentioned/no_aio → cited): mejora major.
• Salir de Cited (cited → absent/mentioned/no_aio): regresión.
• Cambios entre Mentioned y Absent: también relevantes pero de impacto menor.

Cada snapshot almacena deltaFromPrevious si hay cambio significativo, para triggers de notificación futura.

Métricas agregadas (Summary)

Sobre el conjunto de keywords trackeadas:

---

Cómo leer el informe / Los resultados

Dashboard principal

Encabezado:

• Título "AI Overview Tracker" + descripción + botones "Add keyword" / "Import keywords".

KPI Cards (5 tarjetas):

• Tracked keywords (ej. "47 palabras clave · 40 chequeadas, 7 pendientes")
• Cited (ej. "8 keywords · 20% de chequeadas")
• Mentioned (ej. "12 keywords · 30%")
• Absent (ej. "15 keywords · 37.5%")
• No AI Overview (ej. "5 keywords · 12.5%")

Status Trend Bar:

• Barra horizontal con cuatro segmentos coloreados (Cited verde, Mentioned amarillo, Absent rojo, No_aio gris).
• Leyenda: "Current snapshot · 40 keywords checked".

Tabla de Keywords:

Columnas principales:

• Keyword: texto de búsqueda. Clickable → abre drawer lateral.
• País · Idioma: ubicación del monitoreo (ej. "ES · es").
• Status: chip de estado (Cited/Mentioned/Absent/No_aio) o "Pending" si nunca se chequeó.
• Source domains: dominios que cita Google para esa keyword. Mostrados los primeros 2, "+N" si hay más.
• Competitors: dominios externos citados (tus rivales en el bloque). Lista compacta.
• Last check: fecha del último snapshot, "—" si nunca, "Running…" si en ejecución.
• Details: botón para abrir drawer.

Filtros encima:

• Search por keyword (text).
• Status (All/Cited/Mentioned/Absent/No_aio).
• Country.
• Language.
• Last check (Any time / Today / Last 7d / Last 30d / Never checked).

Secciones inferiores (grid 2 columnas):

• Recent changes: Lista de cambios significativos detectados en el histórico (vacío si no hay histórico; placeholder mientras se carga).
• Keyword opportunities: Top 6 oportunidades (keywords absent/mentioned con fuentes competidoras citadas). Tabla con: Keyword, Issue, Priority, Action.

Drawer lateral (Detalle de keyword)

Al clickear una keyword:

Header sticky:

• Keyword (h2)
• Chip de estado + país · idioma + "Last checked X hours ago" o "Never checked"
• Botones: "Re-check" (activa POST manual), "Remove" (DELETE).

Frecuencia:

• Desplegable para cambiar la frecuencia de la keyword (Semanal, Diaria solo en Enterprise, Solo cuando yo lo lance), con una línea que explica qué hace la opción elegida. Al cambiarla sale un aviso "Frecuencia cambiada a …". Está desactivado mientras la keyword se re-analiza.

Recommended Action:

• Consejos estratégicos según el estado:
  • Cited: "Bien hecho. Mantén la autoridad de esa página."
  • Mentioned: "Tu marca aparece pero sin citación. Mejora las señales de entidad."
  • Absent: "Google no te cita. Crea/actualiza contenido autoridad para esa keyword."
  • No_aio: "Google no genera IA para esa búsqueda todavía."

Source domains:

• Lista completa con URLs y títulos. Tu dominio resaltado en verde.

Competing sources:

• Chips de dominios externos (competidores citados).

AI Overview excerpt:

• Bloque scrollable con el markdown del bloque AI Overview (truncado a 2400 caracteres). Border gris.

History:

• Tabla de snapshots previos (últimos 60), ordenada descendente (más recientes arriba).
• Columnas: Date · Time, Status, etiqueta "cambió" (si deltaFromPrevious) o "regla nueva" (si la regla nueva explica el cambio de estado y no se cuenta como de Google), o "nombres sin leer" (si los nombres del proyecto no se pudieron leer, en ese análisis o en el anterior, y eso explica el cambio).
• Clickeable para ver snapshot antiguo completo.

Empty States

• Sin proyecto: "Select a project".
• Sin keywords: "No keywords tracked yet. Start by adding your first keyword."
• Tabla vacía tras filtros: "No keywords match the filters."
• Recent changes sin histórico: Skeletons + "No changes yet. Monitoring active."
• Opportunities sin oportunidades: "No open opportunities. You're cited on all checked keywords."

---

Cuánto suele tardar

Cooldown: 1 hora entre re-checks manuales de la misma keyword (para proteger tu saldo de créditos y evitar abuso). La hora cuenta desde el último intento, también si falló.

---

Cuánto consume (créditos)

AI Overview Tracker se cobra a precio de coste. Cada check tiene un coste fijo en créditos.

Por operación

1 check (captura Google + análisis) ≈ 0.02 créditos

Qué dispara cobros

1. Crear keyword: No cobra por crearla; su primer análisis se lanza al añadirla (también si la dejas en Solo cuando yo lo lance) y ese análisis sí cuenta como un check.
2. Re-check manual (POST /keywords/:id): Cobra aproximadamente 0.02 créditos (pre-check de saldo antes).
3. Chequeo automático (≤50 keywords vencidas por cadencia): Cobra aproximadamente 0.02 créditos × N keywords ejecutadas. Las keywords en Solo cuando yo lo lance quedan fuera: nunca las analiza ni las cobra.
4. Bulk import (hasta 100 keywords): Cobra aproximadamente 0.02 créditos por cada una por su primer análisis, y después según la frecuencia que elijas para la lista.
5. Cambiar la frecuencia de una keyword: No cobra.
6. Un análisis que falla: el proveedor de datos cobra la consulta aunque no devuelva nada que medir, y a ti se te cobra a coste, exactamente lo que cobra el proveedor (sin margen). Cuenta como fallo cuando el proveedor contesta con un error y también cuando contesta con una respuesta vacía (no es lo mismo que "Sin AI Overview": ahí la página de Google llegó y no traía el bloque, y es un dato válido). Si el proveedor no informa de lo que costó, no se cobra nada. La misma consulta nunca se cobra dos veces.

Cuando un análisis falla

• Se ve en el panel de la keyword: una línea gris, "Último intento fallido (fecha): motivo. Se cobra a coste lo que cobra el proveedor.". Desaparece en cuanto un análisis sale bien.
• El análisis automático no insiste sin límite: tras el primer fallo vuelve a intentarlo en la siguiente pasada del análisis automático (corre una vez al día, así que será al día siguiente); desde el segundo fallo seguido espera a la cadencia normal de la keyword (la que hayas elegido o el suelo de tu plan).
• El "Re-analizar" manual espera 1 hora desde el último intento, haya salido bien o mal: un análisis que falla no se puede repetir sin freno.
• "Re-analizar seleccionadas" y la importación lanzan los análisis de 5 en 5, no todos a la vez.
• Si la consulta se hizo pero el resultado no se pudo guardar, se te avisa ("Se hizo la consulta pero no se pudo guardar el resultado. Podrás volver a intentarlo dentro de una hora.") y la consulta se cobra una sola vez.

Qué NO cobra

• Listar keywords (GET).
• Ver detalle + histórico (GET).
• Filtrar, buscar, reordenar (UI puro).
• Eliminar keyword (DELETE).

Factores que afectan coste total

1. Frecuencia: Semanal = 52 checks/año. Diaria = 365 checks/año. Solo cuando yo lo lance = ninguno automático (solo los que tú pidas).
2. Cantidad de keywords: N keywords × ~0.02 cr/check.
3. Plan: Define el suelo mínimo de cadencia (no puedes ir más rápido aunque quieras).

Estimación antes de lanzar: El UI te muestra coste estimado. Si te falta saldo, rechaza la acción (402 Capacity).

---

Disponibilidad y límites por plan

Validación server-side:

• Crear keyword: Rechaza POST si count >= maxKeywords (402 "AIO_LIMIT").
• Crear sin frequency: se guarda "manual" (Solo cuando yo lo lance). El análisis automático semanal hay que pedirlo con frequency="weekly".
• Crear con frequency="daily": Rechaza si plan ≠ "enterprise" (402 "AIO_DAILY_NOT_ALLOWED").
• Cambiar la frecuencia (PATCH /keywords/:id con { "frequency": "weekly" | "daily" | "manual" }): mismo tope que al crear ("daily" solo Enterprise, 402 "AIO_DAILY_NOT_ALLOWED"); "weekly" y "manual" valen en todos los planes. Un valor que no sea ninguno de los tres devuelve 400.
• Chequeo automático: Respeta el suelo la cadencia de tu plan del plan.
• Re-check manual: Enfuerza cooldown 1 hora (429 si menos).

Downgrade: Si bajas de plan, no borra keywords existentes. Solo impide agregar nuevas hasta estar dentro del límite o actualizar plan. el sistema sigue ejecutando los existentes (con la cadencia del nuevo plan).

---

Errores y casos frecuentes

Errores comunes (y soluciones)

Edge cases (comportamiento honesto)

1. Dominio muy corto ("best.com" → etiqueta "best" = 4 letras):

   • No marca "mentioned" aunque aparezca en texto (anti-falso-positivo).
   • Requiere un nombre declarado en el proyecto (≥3 letras) o citación directa.

2. Subdomios propios (blog.tudominio.es, shop.tudominio.es):

   • Parser normaliza a root domain.
   • Detecta como "cited" en cualquier subdominio.

3. Palabra incompleta ("teletrabajamiento" contiene "trabajo" pero no palabra completa):

   • Match word-boundary regex: no marca "mentioned".

4. Sin referencias en AIO (bloque sin fuentes):

   • Almacena sources = [].
   • Status = "absent" o "mentioned" (según si el texto escribe tu nombre).

5. Bloque AIO vacío (markdown = ""):

   • Fallo raro en el análisis. Status = "absent" (safe fallback) y "Te nombra en el texto" sin dato ("—").

6. Keyword pausada pero no eliminada:

   • Se salta automáticamente.
   • Histórico preservado.
   • Al reanudar, re-chequea si cadencia vencida.

7. Fallo parcial del chequeo (50 keywords, 3 fallan):

   • Devuelve: { ok: true, checked: 47, failed: 3, skippedNoBalance: 0 }.
   • Las 47 se persistieron. Las 3 se reintentan al siguiente tick (24h).

8. Bulk import >100 keywords:

   • UI limita a primeros 100.
   • Backend rechaza si suma supera cap.

9. Downgrade sin eliminar keywords:

   • Keyword no se borra.
   • POST rechaza nuevas si supera límite.
   • El sistema sigue ejecutando las existentes (con nueva cadencia).

10. Sin histórico previo:

    • Primer check = baseline. deltaFromPrevious = null (no dispara alerta).
    • Segundo check compara con primero → puede marcar delta.

Distinción crítica: No_aio vs. Absent

• No_aio: Google no disparó AI Overview para esa keyword.
• Absent: Google SÍ disparó AI Overview, pero tu dominio no aparece.

Esta distinción es fundamental para estrategia: si es "no_aio", no hay competencia IA que ganar. Si es "absent", hay competencia visible (otros están citados).

---

Notas finales

AI Overview Tracker es una herramienta de vigilancia pura, no de análisis generativo. No usa LLMs, no analiza sentimiento ni calidad de respuesta: solo detecta presencia y cambios en las búsquedas de Google.

Diseño por retención: el coste accesible y la cadencia configurable por plan hacen que sea accesible incluso en Starter, sin disparar costes operacionales en planes bajos.

Honestidad de datos: el parser no inventa presencia que no hay, respeta word-boundary, y marca "no_aio" cuando Google no dispara (en lugar de confundirlo con "absent"). El histórico de snapshots es auditable.

Referencia de métricas y definiciones detalladas: consulta el Glosario de métricas si necesitas fórmulas exactas o detalles de otros KPIs de Antropus.