Ir al contenido
SEO Uptr
SEO UptrRegistrarse

Receta

Monitor de enlaces perdidos: captura, diferencia, notificación

La gente pregunta cómo detectar enlaces rotos antes de que lo hagan los rankings. La respuesta es aburrida y fiable: guarda la lista cada semana y compárala con la anterior.

Puente de piedra con una tabla de madera faltante mostrando una brecha en la estructura

Lo que estás construyendo

Un trabajo programado (cron) que se ejecuta una vez por semana. Almacena la lista de tus dominios de referencia como un archivo con fecha, lo compara con el archivo anterior y publica la diferencia en un lugar donde una persona pueda verla. Ese es todo el sistema.

Obtenemos dominios, no URLs. Hay una razón. Una lista a nivel de dominio es pequeña, estable y económica, por lo que una comparación de dos archivos sigue siendo legible, mientras que las listas a nivel de URL cambian con cada rediseño y ocultan las pérdidas reales bajo el ruido. Cuando necesites detalles de página para un dominio perdido, solicita backlinks bajo demanda y paga 2 créditos por esa consulta.

Ejecútalo dos veces manualmente. La primera ejecución no tiene archivo previo, y la segunda demuestra que la comparación funciona. Verifica la salida frente a un enlace que sepas que eliminaste.

La receta

01

Elige la frecuencia

Semanal. Nuestro índice se actualiza aproximadamente una vez al mes, por lo que las ejecuciones diarias devuelven el mismo archivo la mayoría de los días. La ejecución semanal detecta la actualización dentro de los siete días en que ocurra.

02

Toma la captura

Llama a refdomains con per=1000 y escribe el JSON ordenado en un archivo con fecha. Una llamada, 2 créditos, independientemente del número de filas hasta 1.000.

03

Diferencia con la semana anterior

Compara los dos archivos con diff o jq. Las líneas que solo existen en el archivo antiguo son tus dominios perdidos.

04

Controla la alerta

Cuenta las líneas perdidas. Por debajo de tu línea SEV2, escribe una entrada de registro. Por encima, envía el mensaje. La tabla de severidad tiene los valores iniciales.

05

Verifica el estado de la respuesta

Si el estado es 402, se agotaron los créditos. Si es 401, la clave es incorrecta. Alerta en ambos casos, o tu monitor fallará en silencio.

El script

Bash, curl, jq. Reemplaza el webhook con el tuyo propio.

bash
#!/usr/bin/env bash
set -euo pipefail
KEY="sk_live_..."
DOM="yourdomain.com"
DIR="$HOME/linkwatch/$DOM"; mkdir -p "$DIR"
NEW="$DIR/$(date +%F).json"

code=$(curl -s -o "$NEW.raw" -w '%{http_code}' \
  "https://seouptr.com/api.php?action=refdomains&q=$DOM&per=1000&key=$KEY")
[ "$code" = 200 ] || { echo "api returned $code" >&2; exit 1; }
jq -e '.ok' "$NEW.raw" >/dev/null
jq -S . "$NEW.raw" > "$NEW" && rm "$NEW.raw"

PREV=$(ls "$DIR"/*.json | grep -v "$NEW" | tail -1 || true)
[ -n "$PREV" ] && diff <(cat "$PREV") <(cat "$NEW") > "$DIR/last.diff" || true
La ausencia no es una alerta

Un dominio que falta en el índice del mes puede haber sido eliminado de nuestro rastreo, no por el sitio que enlazaba. Confirma los importantes manualmente antes de escribir a nadie. No afirmamos que una diferencia pruebe que un enlace ha desaparecido.

Qué cuesta (portafolio hipotético)

Ejemplo: 20 sitios de clientes, una ejecución por semana, 4 ejecuciones al mes. Precios basados en las tarifas por llamada.
PasoCréditos por ejecuciónEjecuciones al mesCréditos al mes
refdomains para 20 sitios404160
bulk_dr para los 20 juntos144
Consulta de backlinks en 3 dominios marcados6424
Total188 créditos, aproximadamente $0.019
Fronde de helecho con una hoja marchita emergiendo de suelo húmedo

Diferenciar un enlace perdido de un parpadeo

La mayoría de las falsas alarmas en la vigilancia de enlaces perdidos son parpadeos. Un enlace desaparece de una captura y vuelve en la siguiente, y probablemente nunca se fue. Los rastreadores pierden páginas. Las actualizaciones tienen retraso. Una simple diferencia no puede distinguir esto de una pérdida real, así que construye la alerta para tolerar una semana de ausencia antes de que se active.

Mantén un dominio en lista de espera antes de declararlo perdido

Pon un dominio en una lista de pendientes la primera semana que desaparezca. Si sigue faltando una semana después, promuévelo a perdido. Eso cuesta una semana de latencia y elimina la mayoría de las falsas alarmas que provienen de un solo rastreo defectuoso.

Mantén la lista de pendientes como un archivo plano junto a las capturas. Borra una entrada manualmente cuando el dominio vuelva, para que la lista se mantenga lo suficientemente corta como para ser legible.

Espera que las etiquetas de perdido y nuevo se intercambien

Algunas herramientas marcan el mismo enlace como perdido, luego como nuevo, y luego como perdido nuevamente en varios ciclos de actualización. Cualquiera que verifique enlaces manualmente ha visto esto. Trata un intercambio como ruido a menos que el dominio permanezca fuera durante toda la ventana de espera.

Nuestro índice se actualiza aproximadamente una vez al mes. Una diferencia entre dos archivos semanales adyentes puede mostrar un movimiento que es realmente una actualización que aterriza. Compara las medianas, como sugiere la página de severidad, antes de considerar algo una tendencia.

Por qué un informe de Search Console no es suficiente

El informe de enlaces de Search Console es gratuito y vale la pena leerlo. Sin embargo, no lista todos los enlaces hacia ti, ni te dirá cuándo un enlace que tenías el mes pasado ha desaparecido. Úsalo como una segunda fuente junto a la captura.

Ejecuta ambos. Donde difieran, la discrepancia en sí misma es una pista que merece una verificación manual.

Camino de piedra antiguo con ladrillos desplazados creando escalones irregulares

Migraciones y los enlaces que apuntan a páginas movidas

Las migraciones son una fuente común de enlaces perdidos. Una migración puede dejar enlaces apuntando a direcciones que ya no responden. El daño suele provenir de redirecciones rotas y señales de página perdidas, no del movimiento en sí. Verifica los enlaces antes del cambio. Conoce qué páginas externas apuntan a cuáles de tus URLs.

Mapea primero las URLs de destino

Obtén la lista de tus páginas que reciben enlaces y trata cada una como una promesa. Cualquier cambio necesita una redirección 301 hacia su equivalente nuevo más cercano. Un enlace dirigido a una página de producto retirada no debería aterrizar en la página de inicio, porque eso gasta la señal en la página incorrecta.

Digamos que tienes 40 URLs enlazadas y una nueva estructura. Mantén una tabla con la dirección antigua, la nueva y los dominios enlazadores que registraste. Una fila sin dirección nueva es un enlace perdido esperando ocurrir.

Vigila las semanas posteriores al cambio

Los recuentos de pérdidas suelen aumentar durante unas semanas después de una migración mientras el índice se actualiza. Una lista creciente en esa ventana es esperada solo si las redirecciones están en su lugar. Verifica manualmente una muestra de los dominios perdidos, una dirección a la vez.

Verifica las redirecciones 301 con una verificación de estado en las direcciones antiguas. Un 200 simple en una URL antigua, o una cadena de varios saltos, merece un ticket el mismo día.

Cuando el problema es el destino

Si los mismos dominios desaparecen mientras sus páginas aún te enlazan en un navegador, el destino es el probable problema. Confirma que tu dirección responde, no está bloqueada y devuelve el mismo contenido que antes.

Si todos los dominios perdidos pertenecen a un proveedor o una red, la causa es más probable que esté en su lado. Anótalo y sigue adelante en lugar de perseguirlo.

Leer la diferencia sin tropezar con ella

Una diferencia es tan clara como los archivos detrás de ella. Dos exportaciones pueden diferir en orden, espacios en blanco y disposición de campos. El ruido no es movimiento. Normaliza ambos archivos antes de comparar, para que las líneas que ves sean las que realmente cambiaron.

La receta ya ordena las claves con jq -S, lo que elimina la mayor parte de ese ruido. El resto proviene del orden de las filas, y un orden estable lo corrige.

Demuestra que la diferencia es silenciosa con entrada idéntica

Ejecuta la comparación dos veces en el mismo archivo. Un resultado vacío es la línea base que deseas. Si esa ejecución no está vacía, corrige la normalización antes de confiar en cualquier alerta, porque cada resultado posterior depende de ello.

Haz la misma verificación después de cualquier cambio en el script, como un nuevo valor de per. Un tamaño de página nuevo puede reordenar filas y producir una diferencia sin contenido real.

Cuenta pérdidas y ganancias por separado

Informa del recuento de pérdidas y del recuento de ganancias como dos números. Un cambio neto de cero puede ocultar treinta pérdidas y treinta ganancias, que son semanas muy diferentes. Digamos que perdiste 30 y ganaste 30 en una semana. El neto es cero, sin embargo, la lista de pérdidas aún merece una mirada.

Mantén las ganancias fuera del mensaje de alerta. Son útiles para la prospección, pero no determinan si hay algo malo.

Guarda el archivo de diferencia con la captura

La receta escribe last.diff en cada ejecución. Guárdalo junto a la captura con fecha. Cuando alguien pregunte por qué se activó una alerta, el archivo responde sin una nueva ejecución, y una nueva ejecución puede no reproducir el resultado porque el índice ha cambiado desde entonces.

Almacena los archivos de diferencia tanto como almacenes las capturas. Eliminar uno de ellos rompe la cadena de evidencia para esa semana.

Casos extremos

¿Necesito también una exportación de Search Console?
Search Console muestra los enlaces que Google te reporta, una lista diferente a la nuestra. Usa ambas si puedes. La nuestra funciona en cualquier dominio que indiques, por lo que un solo script puede vigilar tu propio sitio, un cliente, un proveedor o un competidor.
¿Qué pasa si mi dominio tiene más de 1.000 dominios de referencia?
Navega con page y per. Cada llamada se cobra una vez por hasta 1.000 filas, y la paginación profunda está limitada a 50.000 filas. Un sitio con 5.000 dominios de referencia requiere cinco llamadas, diez créditos, o $0.001.
¿Puedo verificar backlinks antiguos que fueron desindexados?
Solo podemos mostrar lo que está en nuestro propio índice en la última actualización. Si un enlace estaba en la captura del mes pasado y no está en esta, trátalo como una pista para verificar, no como un veredicto. Consulta el manual de tráfico.

Antes de confiar en la primera diferencia

  • Existen dos capturas, ambas ordenadas con la misma ordenación y orden.
  • La ventana de espera está documentada, por ejemplo, dos semanas perdidas.
  • Las ramas 401 y 402 envían una alerta a una persona.
  • Cinco dominios de la lista de pérdidas fueron verificados manualmente.
  • Cualquier migración o relanzamiento está marcado en el gráfico antes de la ejecución.