Configuración de la herramienta de Domain Rating para una hoja y un trabajo cron
Un flujo de trabajo que nadie tiene que recordar supera a uno que todos piensan hacer. Seis pasos te llevan desde una hoja en blanco hasta un trabajo mensual que registra su propio costo.
Equipo editorial de ASEOTools ·
Seis pasos, aproximadamente una hora
01
Inicia sesión y copia la clave
Usa el inicio de sesión de Google en /auth/google.php. El panel de control en /account.php contiene tu clave, que comienza con sk_ y llega con $100 de crédito.
02
Realiza una llamada de prueba gratuita
Ejecuta la acción de vista general sin clave contra tu propio dominio. Si obtienes un JSON con ok establecido en true, la ruta de red funciona.
03
Construye la lista de dominios
Una columna en una hoja, un dominio por fila, sin https ni rutas. Hasta 2.000 filas entran en una única solicitud bulk_dr.
04
Llama a bulk_dr desde la hoja o un script
Envía la lista como un valor GET unido por comas o como cuerpo POST. Almacena la respuesta en una segunda pestaña con una columna de fecha.
05
Programa para que se ejecute mensualmente
Ejecuta el trabajo unos días después del primero del mes, una vez que haya llegado la actualización mensual del índice. Una línea cron es suficiente. Verifica manualmente la salida del primer mes contra tres dominios que conozcas bien.
06
Registra los créditos y alerta cuando el saldo sea bajo
Cada respuesta autenticada lleva _credits con el costo y el saldo restante. Escribe ambos en una fila de registro y envíate un correo electrónico por debajo de un umbral que elijas.
Las piezas, listas para pegar
Intercambia por tu propia clave y nombres de archivo.
bash
# crontab: 06:00 on the 4th of each month
0 6 4 * * /usr/bin/curl -s -X POST \
-H "Authorization: Bearer sk_live_..." \
-d "domains=$(paste -sd, domains.txt)" \
"https://aseotools.com/api.php?action=bulk_dr" >> dr_log.jsonl
Mantén la clave fuera de la hoja
Coloca la clave en las propiedades de Apps Script, una variable de entorno o el almacén de credenciales de tu herramienta de automatización. Cualquier persona con acceso de edición a una hoja puede leer una clave escrita en una celda, y una clave filtrada gasta tu crédito.
Dónde falla esta configuración
El silencio es el fallo habitual. Un trabajo cron que da error parece igual a uno que funcionó.
Verifica el código HTTP. Un 401 significa que falta la clave o es incorrecta, y un 402 significa que se agotó el crédito, así que alerta por cualquiera de los dos y corrígelo antes de que venza el informe del mes siguiente.
Recuerda también que la paginación está limitada a 50.000 filas de profundidad, y que bulk_dr acepta hasta 2.000 dominios por llamada. Las listas más largas necesitan fragmentación, lo cual es un bucle adicional y cuesta un crédito por fragmento.
Prueba manualmente primero. Ejecuta la línea cron en una terminal, lee el archivo de registro y verifica que el saldo bajó exactamente por el costo que esperabas. Luego, mira cómo se comparan los números con un plan suite y decide con qué frecuencia ejecutarlo.
Versiona tu lista de dominios. Mantén el archivo en un repositorio o una unidad compartida con historial, para que cuando un número cambie en marzo puedas ver si la lista también cambió. Añade una columna de notas para los dominios que añadiste a propósito, como un nuevo competidor o un cliente que se registró ese mes. Trata la lista como datos con un propietario, porque el error más barato es el que detectas en una diferencia.
Dividir una lista larga en fragmentos
Las listas largas son donde una configuración elegante encuentra su límite. Una llamada masiva acepta hasta 2.000 dominios, por lo que una lista de 5.000 necesita tres solicitudes, y la división debe ocurrir antes de que se envíe la primera llamada.
Divide por una regla estable, como el orden ordenado de la columna de dominio. De esa manera, el mismo dominio cae en el mismo fragmento cada mes, y la comparación se mantiene.
Listas de más de 2.000 filas
Escribe cada fragmento en la hoja como su propio bloque, con el número de fragmento en la primera columna. Un fragmento fallido es entonces fácil de encontrar.
Cada fragmento cuesta un crédito, por lo que una lista de 5.000 filas asciende a 3 créditos por ejecución, lo que son $0.0003. Una herramienta de Domain Rating solo es tan útil como la lista que lee, así que mantén esa lista ordenada.
Si la lista crece más allá de 5.000 filas, reconsidera la estructura de la hoja misma. Una pestaña por mes mantiene cada ejecución legible cuando se acumulan las filas.
Reejecutar un fragmento fallido
Si el fragmento dos devuelve un error, reejecuta solo el fragmento dos. Reejecutar toda la lista gastaría créditos en filas que ya regresaron.
Registra el número de fragmento con el código de estado, para que la reejecución sea una línea en el registro, no una búsqueda en la hoja.
Mantener estable el mapa de fragmentos
Si el orden de la lista de dominios cambia, los fragmentos se mueven y una comparación mes a mes se rompe. Ordena la lista antes de dividirla, cada vez.
Almacena el mapa de fragmentos junto a la lista.
Una prueba simple: elige cualquier fragmento y cuenta sus filas contra la lista. Una discrepancia significa que el mapa se desvió, y eso es más barato de encontrar en la hoja que en el informe.
Costo de la rutina completa, con tamaños de ejemplo
Tamaños de lista hipotéticos, precios de acción publicados.
Tamaño de la lista
Llamadas por mes
Créditos
Dólares
200 dominios
1
1
$0.0001
5.000 dominios
3
3
$0.0003
5.000 dominios más 20 extracciones completas de backlinks
23
43
$0.0043
Qué confirmar antes de la primera ejecución programada
Prueba un fragmento manualmente y lee la respuesta completa
Confirma que el saldo bajó exactamente por los créditos que esperabas
Verifica el código de estado para cada fragmento, no solo para el primero
Compara tres dominios que conozcas bien con cifras que ya confíes
Establece una ruta de archivo de registro y decide quién lo lee cada mes
Escribe el nombre del propietario en la parte superior de la hoja
Qué contiene una línea de registro mensual útil
Un registro que solo dice ok no es mucho registro. Cada ejecución debe escribir una línea que una persona cansada pueda leer en diez segundos: la fecha, el fragmento, el estado, los créditos gastados y el saldo después de la llamada.
Hipotético: una línea que muestra el fragmento cuatro, estado 200, un crédito gastado y el saldo restante después de la llamada responde a la mayoría de las preguntas un mes después sin abrir la respuesta.
Campos dignos de registrar
Registra la fecha, el nombre de la lista, el número de fragmento, el código de estado, los créditos cobrados y el saldo después de la llamada. Esos seis campos cubren la mayoría de las preguntas un mes después.
Añade una nota de texto libre solo cuando una persona cambió algo manualmente.
Alertas que no gritan lobo
Alerta de inmediato por un 401 o un 402, ya que ambos significan que el trabajo no puede hacer su trabajo. Una advertencia de saldo bajo debe usar el umbral que elegiste, para que se active una vez y diga qué hacer a continuación.
Envía una alerta por ejecución, no una por fila, o la bandeja de entrada se convierte en ruido.
Preguntas de configuración
¿Funciona una Google Sheet como cliente?
Sí. La API es REST simple con CORS abierto y respuestas JSON, por lo que Apps Script o una llamada estilo IMPORTDATA pueden alcanzarla. Mantén la clave en las propiedades del script en lugar de en una celda que los colaboradores puedan leer.
¿Puedo usar esto con n8n o Make?
Sí, a través de un nodo de solicitud HTTP normal. Pasa la clave como un encabezado Authorization Bearer, analiza la respuesta JSON y escribe el campo _credits en tu registro para que puedas ver el gasto por ejecución.
¿Por qué el registro muestra un costo más alto de lo que esperaba para esta herramienta de Domain Rating?
Cuenta las llamadas, no solo el tamaño de la lista. Un fragmento por ejecución, un reintento o una llamada de prueba añaden su costo, y el campo _credits en cada respuesta da la cifra exacta para esa llamada.
¿Debería la clave estar en la línea cron en sí?
Es más simple, pero cualquiera que pueda leer el crontab puede leer la clave. Cargala desde un archivo con permisos restringidos o desde una variable de entorno configurada para el trabajo, y mantenla fuera de los registros compartidos.
Quién nota cuando el trabajo falla
Un trabajo mensual se ejecuta sin que nadie lo vigile. Ese es el punto de automatizarlo, y también es por qué un fallo puede permanecer sin ser notado durante semanas.
Nombra a la persona que lee el registro y a la persona que arregla el trabajo. Dos nombres superan a uno. Las vacaciones ocurren. El libro de ejecución explica cómo elegir la lista en primer lugar.
Tiempo dedicado a la configuración frente al mantenimiento
La primera ejecución toma la mayor parte de la hora, ya que la clave, la hoja y la llamada de prueba necesitan atención. Después de eso, la rutina debería necesitar un vistazo cada mes, no una reconstrucción.
Si el mantenimiento crece, la lista suele ser la causa. Una lista que cambia cada semana necesita un propietario, una versión y una regla para las adiciones.
Hacer visible un fallo
Una fila faltante en la salida es más fácil de ver que un error silencioso. Compara el recuento de filas con la longitud de la lista en cada ejecución, y escribe una advertencia cuando difieran.
Mantén esa advertencia en el mismo archivo de registro, para que la persona que lee el registro la vea primero.
Programación alrededor de la actualización del índice
El índice se actualiza aproximadamente una vez al mes, por lo que una ejecución el primer día del mes puede leer cifras de la construcción anterior. Ejecutar unos días después, como sugieren los pasos anteriores, da tiempo para que la actualización se asiente.
Elige el mismo día cada mes para que la serie se mantenga comparable, y escribe ese día en un comentario en la línea cron.
Cuándo dejar de automatizar
Un trabajo que se ejecuta una vez cada trimestre puede no justificar una línea cron. Una hoja y un recordatorio de calendario pueden ser suficientes, y una rutina semiautomatizada es peor que una manual clara.
Automatiza una vez que los mismos pasos se hayan ejecutado limpiamente durante varios ciclos seguidos.
