Este es un post rápido para explicar cómo extraer la visibilidad de SISTRIX utilizando Screaming Frog, nuestra rana amiga.

Para poder seguir este post vas a necesitar:

• Una licencia de pago de Screaming Frog + Código Javascript
• Una licencia de pago de SISTRIX + API KEY

¡Vamos a ver cómo hacerlo!

Consideraciones previas

Para poder hacer estas llamadas a la API de SISTRIX, necesitamos usar la funcionalidad Custom Javascript, que nos permitirá añadir un fragmento de código en este lenguaje y Screaming Frog se encargará de ejecutarlo durante el rastreo.

Se puede trabajar en modo lista (con una lista concreta de urls) o con el modo crawl, para rastrear el sitio basado en su enlazado interno, su sitemap y lo que queramos.

¿Pero qué necesitamos configurar para que funcione bien? Lo siguiente:

• Para ejecutar fragmentos de JavaScript personalizados, el modo de renderizado de JavaScript debe estar habilitado a través de ‘Configuración > Spider > Renderizado’.
• Para exprimir los custom javascript hay que entender la diferencia entre snippet de acción (hacen algo pero no devuelven datos) y de extracción (devuelven datos).
• Puedes definir los tipos de contenido en los cuales se ejecutará. Por ejemplo:
  texto/html o imágenes.

En nuestro ejemplo, usamos fragmentos de tipo extracción y aplicados a texto/html, es decir, urls posicionables de las que queremos obtener datos de visibilidad de la api de SISTRIX.

Los pasos a seguir serían:

• Configurar el rastreo con Render JS
• Añadir Custom Javascript de tipo Extracción
• Elegir el modo que nos interese, lista o crawl
• Esperar a que termine de rastrear
• Ir a la pestaña Custom Javascript a ver el resultado o verlo desde la pestaña Internal que contiene todos los datos de rastreo
• Optativamente, descargar

Veamoslo paso a paso.

Configuración de base

Activamos rendering js

Después añadimos los snippets Js desde Custom Javascript, uno por cada dato a extraer

De manera adicional, se puede:

• Hacer pruebas previas al rastreo, para testar que los códigos funcionan
• Guardar dichos snippets en nuestra librería

Cómo extraer el dato de una fecha específica añadida a mano

Primer ejemplo: añadir la fecha a mano y que Screaming Frog recorra las urls para hacer las llamadas a la api de SISTRIX.

El código de ejemplo:

const API_KEY = 'ADD_YOUR_API_KEY';
const DATE = '2025-10-06';   // Date in format YYYY-MM-DD
const COUNTRY = 'es';         // 'es','us','uk','de','fr','it'...
const FORMAT = 'json';
const DATA_PATH = ['answer', 0, 'sichtbarkeitsindex', 0, 'value'];

function fetchVisibilityIndex() {
    const url = `https://api.sistrix.com/domain.sichtbarkeitsindex?api_key=${API_KEY}&country=${COUNTRY}&date=${DATE}&format=${FORMAT}&url=` + encodeURIComponent(document.URL);
    
    return fetch(url)
        .then(response => {
            if (!response.ok) {
                return response.text().then(text => { throw new Error(text) });
            }
            return response.json();
        })
        .then(data => {
            let result = data;
            for (let key of DATA_PATH) {
                if (result[key] !== undefined) {
                    result = result[key];
                } else {
                    throw new Error('Value not found in the API response');
                }
            }
            return seoSpider.data(result);
        })
        .catch(error => {
            console.error('Error al obtener el índice de visibilidad:', error);
            return seoSpider.error(error);
        });
}

return fetchVisibilityIndex();

Cómo extraer el dato de una fecha de forma dinámica (el último lunes)

Otra forma de atacar este objetivo es intentar hacerlo dinámico y que sea el propio código el que siempre ataque la fecha que más nos interesa: el último lunes, dado que es cuando se actualiza el índice de visibilidad semanal de SISTRIX.

Aquí no nos tendríamos que preocupar de añadir fechas, simplemente, una vez tenemos el código creado, lo podemos añadir en nuestra librería dentro de Screaming Frog y a golpe de clic, lo añadimos a un rastreo siempre que queramos.

El código de ejemplo:

const API_KEY = 'ADD_YOUR_API_KEY';

// Función para obtener el lunes anterior
function getPreviousMonday() {
    const today = new Date();
    const dayOfWeek = today.getDay(); // 0=Domingo, 1=Lunes, 2=Martes, etc.
    
    let daysToSubtract;
    
    if (dayOfWeek === 0) {
        // Si es domingo, el lunes anterior fue hace 6 días
        daysToSubtract = 6;
    } else if (dayOfWeek === 1) {
        // Si es lunes, queremos el lunes anterior (hace 7 días)
        daysToSubtract = 7;
    } else {
        // Para martes a sábado, restamos hasta llegar al lunes de esta semana
        daysToSubtract = dayOfWeek - 1;
    }
    
    const previousMonday = new Date();
    previousMonday.setDate(today.getDate() - daysToSubtract);
    
    return previousMonday.toISOString().split('T')[0];
}

const DATE = getPreviousMonday();  // Fecha del último lunes calculada dinámicamente
const COUNTRY = 'es';              // 'es','us','uk','de','fr','it'...
const FORMAT = 'json';
const DATA_PATH = ['answer', 0, 'sichtbarkeitsindex', 0, 'value'];

function fetchVisibilityIndex() {
    const url = `https://api.sistrix.com/domain.sichtbarkeitsindex?api_key=${API_KEY}&country=${COUNTRY}&date=${DATE}&format=${FORMAT}&url=` + encodeURIComponent(document.URL);
    
    return fetch(url)
        .then(response => {
            if (!response.ok) {
                return response.text().then(text => { throw new Error(text) });
            }
            return response.json();
        })
        .then(data => {
            let result = data;
            for (let key of DATA_PATH) {
                if (result[key] !== undefined) {
                    result = result[key];
                } else {
                    throw new Error('Value not found in the API response');
                }
            }
            return seoSpider.data(result);
        })
        .catch(error => {
            console.error('Error al obtener el índice de visibilidad:', error);
            return seoSpider.error(error);
        });
}

return fetchVisibilityIndex();

Resultado después de rastrear con Screaming Frog

Después de que Screaming Frog termina de rastrear las urls en modo lista o si has rastreado el sitio completo, podrás ir a la sección de Custom Javascript y verás los resultados ahí.

Ideas adicionales para tener en cuenta

La api de SISTRIX tiene muchos otros métodos que podríamos usar al igual que los comentados aquí, por ejemplo:

• domain.kwcount.seo: extraer el recuento de keywords posicionadas en top 100
• domain.kwcount.seo.top10: extraer el recuento de keywords posicionadas en top 10

Revisar todas las opciones que tiene la api nos permitiría hacer una integración bastante rápida para nuestros rastreos.

En segundo lugar, también podemos considerar integrar esta conexión con la api de SISTRIX en nuestros procesos regulares de rastreos SEO.

Por ejemplo, si hacemos rastreos periódicos:

• Configuramos los snippets js
• Creamos la programación del rastreo incluyendo esta conexión de API
• Configuramos para que se descarguen los datos en Drive
• Configuramos para que se notifique por email a quien queramos

Sin duda, tenemos un mar de posibilidades si sabemos integrar las distintas funcionalidades.

Si te interesa alguna cosa específica con APIS, comenta y ampliamos el post o hacemos nuevos

¡Gracias por leer hasta aquí!