Construya un sistema de alerta sobre el retroceso de las citaciones a partir de instantáneas comparables

Una página con pocas citaciones de IA en el periodo actual puede haberlas perdido o no haber tenido nunca ninguna, y un solo estado no permite saberlo. Compare dos periodos explícitos de la misma duración y guarde después el resultado fechado para que las ejecuciones posteriores sigan siendo auditables.

El problema GEO que resuelve

Un número bajo de citaciones parece una caída, así que la página entra en la cola de actualización. Pero cada estado de presencia de página describe únicamente el periodo de prueba solicitado: WORKING, NEEDS_ATTENTION, NOT_CITED y DISCOVERED indican cuántas pruebas existen dentro de él, no por qué cambió el recuento. Una actualización programada solo sobre un periodo puede gastar tiempo de redacción en una página que nadie citó en ninguno de los dos.

Un periodo responde a qué se cita ahora; dos periodos contiguos de la misma duración responden a qué ha cambiado. Eso es también lo que distingue este flujo de trabajo de la medición de una campaña: no se presupone ninguna intervención ni fecha de lanzamiento. Se ejecuta según un calendario y comprueba si el terreno que ya tenía se está erosionando.

Las etapas del flujo de trabajo

1. Cartografíe el estado actual de las citaciones. get_page_presence devuelve las URL monitorizadas y descubiertas con su estado, su total de citaciones, sus preguntas únicas, su posición media y sus proveedores dentro del periodo solicitado. Use los últimos 30 días completos.

2. Reconstruya el periodo anterior. Llame de nuevo a get_page_presence con fechas de inicio y fin explícitas para los 30 días inmediatamente anteriores y compare después URL por URL. La herramienta no devuelve una serie temporal y el registro de páginas monitorizadas es el actual, así que guarde la pareja obtenida para permitir la auditoría y conservar cualquier cambio de configuración posterior.

3. Lea la variación que calcula la herramienta. get_source_trends compara los dominios de origen con el periodo inmediatamente anterior de la misma duración y devuelve, por dominio, las menciones actuales, las menciones anteriores y la variación porcentual. La fila de su propio dominio da la dirección a escala del sitio, y los dominios de terceros que más crecen son candidatos a desplazarle. Clasifica por citaciones actuales, así que un dominio hundido puede quedar fuera de las filas, y la variación es null cuando el periodo anterior no tenía ninguna citación.

4. Lea las pruebas del entorno. get_source_urls filtrado por su dominio muestra qué páginas están citadas, get_source_domains el panorama que las rodea y get_content_opportunities los prompts en los que se menciona a los competidores y a usted no. Aplique a los tres las mismas fechas y filtros del periodo actual. Una página competidora muy presente es una candidata a desplazarle, no un reemplazo demostrado.

Qué devuelve realmente una ejecución

Una ejecución válida devuelve una fila actual y una anterior por URL normalizada, cada una con las fechas de su periodo, su número de citaciones y su estado. Una página con una citación ahora y una antes está estable; una página con una ahora y cuarenta antes está en caída. El estado actual por sí solo no permite distinguirlas.

Las llamadas reconstruyen los periodos de prueba, pero no la configuración histórica de las páginas monitorizadas. Conserve la exportación emparejada cuando cambien las URL, para que un cambio de registro no se lea como un retroceso de las citaciones.

Cómo aprovechar los resultados

Redacte solo lo que confirme la comparación. Una URL entra en la cola de actualización cuando dos instantáneas separadas por al menos 30 días muestran que su número de citaciones cae a la mitad o menos, o cae a cero desde tres o más. Ordene la cola por el número de citaciones de la instantánea más antigua, de mayor a menor: eso es lo que realmente perdió. Las caídas menores, y todo lo que se apoye en una sola instantánea, van a la lista de vigilancia y no se redactan en este ciclo.

Guarde cada ejecución como una pareja fechada de periodos. La consulta puede repetirse mientras se conserven las pruebas subyacentes, pero la pareja guardada preserva el conjunto exacto de páginas monitorizadas y el registro de la decisión.

Antes de redactar, compruebe si alguna URL de la cola se redirigió o se renombró desde la instantánea anterior: una página movida pierde citaciones sin degradarse. Conserve los pasajes citados y las URL estables cuando edite.

El prompt completo

Quiero detectar el retroceso de las citaciones y construir un plan de actualización de contenido. Lista las marcas que monitorizo y, si hay más de una, pregunta cuál usar. Explica lo que revela cada paso.

1. Define dos periodos contiguos de 30 días completos en UTC: el actual y el inmediatamente anterior. Ejecuta get_page_presence una vez para cada uno con startDate y endDate explícitos, conservando cualquier ámbito de tema, etiqueta, proveedor o etapa del embudo. Agrupa cada resultado por estado y conserva la URL, el número de citaciones, las preguntas únicas, los proveedores y las fechas exactas. Si las dos llamadas no devuelven ninguna página, dime que la marca no tiene páginas monitorizadas ni dominio configurado y detente.
2. Compara los dos resultados de presencia de páginas URL por URL sobre el conjunto monitorizado actual. Lista los movimientos de recuento y de estado, y señala las URL presentes en un solo resultado para investigar el registro o la URL, en lugar de hablar de retroceso. Pide una instantánea guardada solo para detectar cambios de configuración de la monitorización, no porque los periodos de prueba no estén disponibles.
3. Llama a get_source_trends para el periodo actual de 30 días con los mismos filtros. Indica las menciones actuales, las menciones anteriores y la variación de mi propio dominio, y después los dominios de terceros con mayores ganancias como candidatos a desplazarme. Interpreta una variación null como una ausencia de citaciones en el periodo anterior, no como estabilidad. Si mi dominio no aparece en las filas, indícalo y usa la comparación de periodos por página como única prueba de tendencia. Llama después a get_topics y repite el análisis sobre los dos o tres identificadores de tema que más me importan.
4. Obtén las URL de origen filtradas por mi dominio, después los dominios de origen y después las oportunidades de contenido, todo con las fechas y filtros exactos del periodo actual. Nombra las fuentes competidoras más presentes y los prompts en los que tengo margen, calificando cualquier reemplazo o causalidad como hipótesis sin confirmar. Una lista vacía significa que no hay pruebas en ese ámbito, no una mejora.
5. Construye la cola. Una URL solo está en caída confirmada cuando las dos instantáneas están separadas por al menos 30 días y su recuento cayó a la mitad o menos, o a cero desde tres o más. Ordena esas URL por el recuento de la instantánea más antigua, de mayor a menor; todo lo demás pasa a candidatas de revisión o a la lista de vigilancia. Da a cada entrada sus pruebas y una actualización concreta que probar.
6. Pregunta qué URL de la cola se redirigieron, se fusionaron o se renombraron desde la instantánea anterior y retíralas de las caídas confirmadas: una página movida pierde citaciones sin degradarse.