Conecte observaciones de rastreadores de IA, citaciones y tráfico de referencia

Cada página con apariciones de rastreadores y sin citación observada plantea una pregunta: ¿de quién es el problema, del equipo técnico, del editorial o de nadie por ahora? Este flujo de trabajo mantiene separadas cuatro capas de datos y responde después a esa pregunta página por página con una regla que se detiene en la primera coincidencia.

El problema GEO que resuelve

El atajo se produce dos veces: observado luego procesado, citado luego clicado. get_crawler_activity se construye a partir de un estado acotado de los bots y no de eventos HTTP conservados, y así lo indica: cada bot con sus fechas de primera y última observación más un recuento de apariciones de todo el histórico, y una nota explícita de que los eventos en bruto no están disponibles. Sin códigos de estado, sin cuerpos de respuesta, sin filas por página, sin parámetro de periodo. Y una sesión llegada desde una IA nunca identifica la citación que hay detrás del clic.

Los periodos también difieren por construcción, la fuente silenciosa de una mala aritmética. get_referrer_analytics termina su rango un día antes de hoy porque los datos de GA4 llegan con retraso, mientras que get_search_console_metrics y get_bing_metrics lo terminan hoy.

Las etapas del flujo de trabajo

1. Lea primero el estado de conexión. get_crawler_activity da el indicador de conexión y cada bot observado con su fecha de primera observación, su fecha de última observación y su recuento de apariciones de todo el histórico. Un bot cuya última observación es anterior a su periodo no tiene ninguna observación en el periodo actual dentro de esta capa, diga lo que diga la tabla de páginas.

2. Clasifique las páginas por actividad de rastreadores observada. get_page_performance devuelve las apariciones por ruta con hasta cinco bots principales por ruta, más un grupo explícito de cola larga. El límite de filas se topa en 100, así que compare las filas devueltas con el número total de grupos de páginas antes de leer una ausencia como un cero.

3. Añada el estado técnico de cada página. get_site_diagnostics devuelve las puntuaciones técnica, de contenido, AEO y de rendimiento de cada página monitorizada, el número de problemas abiertos por gravedad y la fecha de la última auditoría, empezando por las peores. Solo lee páginas monitorizadas, así que una ruta rastreada que nunca se registró no aparece nunca.

4. Añada las pruebas de citación y de tráfico de referencia. get_page_presence aporta el estado y el número de citaciones por página, get_source_urls recupera las URL citadas exactas y get_referrer_analytics devuelve las sesiones llegadas desde IA con sus principales páginas de destino. Pase el mismo periodo de prueba de 30 días a las dos herramientas de citación; el rango analítico puede terminar aun así un día antes por el retraso de GA4.

5. Cruce los datos y asigne las acciones. Haga la correspondencia sobre una clave normalizada de host y ruta, y califique cada ausencia con precisión: no devuelta, no observada, explícitamente no citada o no auditada.

Qué devuelve realmente una ejecución

Una ejecución válida devuelve cuatro poblaciones distintas: observaciones de bots, diagnósticos de páginas monitorizadas, pruebas de citación de las páginas en el periodo solicitado y sesiones llegadas desde IA en el rango analítico. Sus recuentos de filas pueden diferir incluso cuando todas las llamadas funcionan correctamente.

Leer esas filas como un embudo seguiría siendo incorrecto. Una página monitorizada puede no estar citada sin ser siquiera elegible para la citación, y una sesión de referencia nunca identifica la citación que la precedió. La fila accionable es una URL observada en una capa y ausente del siguiente inventario operativo, con esa ausencia calificada con precisión.

Cómo aprovechar los resultados

Una condición previa y después una regla de asignación.

La condición: si algún indicador connected se devuelve como false, el backlog contiene exactamente una tarea, conectar esa integración. Una tabla vacía procedente de una superficie desconectada no constituye un hallazgo. Otras dos ausencias tampoco son ceros: una página que falta en las principales páginas de destino quedó fuera de una lista truncada, y una que falta en la tabla de rastreadores puede estar en el grupo de cola larga. No divida nunca las citaciones entre las apariciones de rastreadores, aunque los periodos solicitados coincidan: sus poblaciones y sus sistemas de recogida son distintos.

La regla de asignación se aplica después a cada página con apariciones de rastreadores y sin citación. Deténgase en la primera coincidencia. Una ausencia total en get_site_diagnostics significa que no es una página monitorizada: regístrela y vuelva a ejecutar el análisis, porque tiene una URL no gestionada, no un diagnóstico. Una fecha de última auditoría null con puntuaciones null significa que nunca se auditó: ponga la auditoría en cola y deténgase. Uno o varios problemas CRITICAL abiertos la convierten en un ticket técnico, no en un brief de redacción. Puntuaciones presentes sin ningún problema CRITICAL abierto la convierten en una cuestión de contenido y autoridad, a cargo del equipo editorial.

El prompt completo

Quiero una auditoría de observabilidad de IA por página. Si monitorizo más de una marca, pregunta cuál usar. Mantén las peticiones de los rastreadores, el estado técnico, las citaciones y el tráfico de referencia de IA como cuatro capas distintas, nunca como un embudo. Utiliza los últimos 30 días. Pregúntame primero por mi host canónico y mis alias de URL, porque ninguna herramienta sabe qué hosts son míos.

1. Ejecuta get_crawler_activity. Indica el indicador connected y cada bot con su firstSeen, su lastSeen y sus apariciones de todo el histórico. Descríbelo como una vista del estado de los bots de todo el histórico, sin eventos en bruto ni códigos de estado, y señala todo bot cuyo lastSeen sea anterior al periodo.
2. Ejecuta get_page_performance sobre 30 días. Indica el indicador connected, el rango de fechas devuelto, las filas de páginas con sus apariciones y sus bots principales, y el grupo de cola larga. Compara las filas devueltas con el número total de grupos de páginas y señala cualquier truncamiento. Si la conexión está activa pero no se devuelve ninguna fila de página, indícalo en lugar de deducir que no hay rastreo.
3. Ejecuta get_site_diagnostics. Devuelve cada página monitorizada con sus cuatro puntuaciones, sus recuentos de problemas por gravedad y la fecha de la última auditoría. Trata una puntuación null como no auditada, nunca como cero.
4. Ejecuta get_page_presence con period 30 y después get_source_urls con period 30 cuando haga falta una URL citada exacta. Conserva cualquier ámbito de tema, etiqueta, proveedor o etapa del embudo en ambas llamadas. Usa NOT_CITED solo cuando lo devuelva la herramienta, y no dividas nunca las citaciones entre las apariciones de rastreadores.
5. Ejecuta get_referrer_analytics sobre 30 días, más get_search_console_metrics y get_bing_metrics por página si las conexiones están activas. Muestra cada rango de fechas devuelto y señala que el rango de GA4 termina un día antes.

Si algún indicador connected es false, detente y devuelve una sola tarea: conectar esa integración.

En caso contrario, construye la matriz sobre el host canónico y la ruta normalizada, y asigna después una acción a cada página rastreada sin citación, deteniéndote en la primera coincidencia. La ausencia en los diagnósticos del sitio significa registrarla como página monitorizada. Una fecha de última auditoría null y puntuaciones null significan poner la auditoría en cola. Un problema CRITICAL abierto significa crear un ticket técnico. En los demás casos, es trabajo editorial. Da a cada fila sus pruebas y su responsable.