Manual de uso Rankias - Nivel técnico

Este manual describe casi todas las funcionalidades (otras son secretas para que nadie pueda replicar la herramienta) de Rankias, un sistema completo para entrenar y optimizar la presencia de tu negocio en los asistentes de inteligencia artificial como ChatGPT, Gemini, Perplexity, Google AI Overviews y otros modelos de lenguaje.

¿Qué es Rankias?

Rankias es una plataforma que permite entrenar activamente a las inteligencias artificiales sobre tu negocio. A través de un proceso automatizado, el sistema genera consultas, frases y preguntas que son «inyectadas» en los modelos de IA para que estos aprendan sobre tu empresa y te recomienden cuando los usuarios busquen productos o servicios relacionados.

El objetivo principal es convertir tu sitio web en una fuente de conocimiento referenciada en el ecosistema de respuestas generativas (AEO – Answer Engine Optimization), permitiendo que las IAs te mencionen y recomienden de forma natural.

Estructura General

La herramienta está organizada en 8 secciones principales que debes completar en orden para activar el sistema completo:

1. Entrenamiento IA – Configuración inicial (Solamente tienes que añadir URL y keywords «palabras clave a entrenar»)
2. Keywords IA Entrenando – Generación de frases por keyword que utilizamos también para entrenar
3. Búsquedas IA Entrenando – Generación de consultas semanales que utilizamos también para entrenar
4. Ideas IA Artículos – Generación de títulos de artículos para blog para que puedas generar nuevo contenido
5. Cobertura IA Sitemap – Análisis de cobertura de tu sitio
6. Auditoría IA Web – Diagnóstico técnico de tu sitio
7. Guía Optimización IA – Recomendaciones de optimización
8. Actividad IA Log – Registro de todas las acciones

1. Entrenamiento IA

Esta es la sección fundamental donde configuras los datos básicos para que el sistema comience a trabajar. Sin completar esta sección, el resto de funcionalidades estarán bloqueadas.

Funcionalidades Principales

Campo de URL

• Qué es: La URL principal de tu sitio web (ej: https://tudominio.com) con o sin www. dependerá de como lo tienes
• Cómo funciona: El sistema usa esta URL para analizar tu sitio, extraer contenido, generar resúmenes y crear las consultas de entrenamiento
• Requisitos: Debe ser una URL válida y accesible públicamente
• Validación: El sistema valida que la URL sea accesible y no esté en lista negra (anti-SSRF)

Campo de Keywords (palabras clave a entrenar)

• Qué es: Palabras clave que definen tu negocio o servicios principales, por ejemplo, si tu web ofrece servicios de cerrajeros en Alicante, las palabras clave potenciales podrían ser: Cerrajero urgente 24 horas en Alicante, Cerrajero para abrir puerta en Alicante, etc. Es mejor añadir la zona porque si solo trabajas en Alicante, no te interesa perder tiempo en enfocarte en Barcelona por ejemplo porque no ofreces servicio allí.
• Cómo funciona: Cada keyword se expande en múltiples frases y preguntas que se usan para entrenar a las IAs
• Límites por plan:
  • Starter: 2 keywords máximo
  • Pro: 5 keywords máximo
  • Business: 15 keywords máximo
  • Elite: 20 keywords máximo
• Ejemplos: «restaurante italiano en Valladolid», «abogado penalista en Murcia», «clínica dental en Sevilla», etc.

Botón «🚀 Guardar & Iniciar Entrenamiento»

• Función: Guarda la configuración y activa el proceso de entrenamiento automático
• Proceso que ejecuta:
  1. Valida que haya al menos 1 keyword
  2. Verifica que no se exceda el límite del plan
  3. Guarda la URL y keywords en la base de datos
  4. Registra la fecha de alta de cada keyword (para historial y mejor entrenamiento)
  5. Encola un trabajo en background para preparar el entrenamiento
  6. Genera un resumen del sitio web (título, descripción, H1, H2, texto)
  7. Inicia la generación de frases para keywords IA, búsquedas IA y ideas IA
• Bloqueos de seguridad:
  • Lock anti-doble clic: Evita que se ejecute dos veces en 60 segundos
  • Rate limiting: Máximo 4 operaciones openRankias por minuto por usuario
  • Circuit breaker: Si hay errores, bloquea temporalmente las llamadas a la API

Proceso en Background (automático)

Cuando guardas el entrenamiento, el sistema automáticamente:

1. Prepara el resumen del sitio: Descarga la página principal y extrae:
   • Título de la página (<title>)
   • Meta descripción
   • H1 y H2 principales
   • Texto principal (hasta 4000 caracteres)
2. Genera frases de Búsquedas IA: Crea consultas semanales basadas en el contenido de tu sitio
3. Genera frases de Keywords IA: Para cada keyword, genera 5 frases/preguntas variadas
4. Genera ideas IA artículos: Para cada keyword, genera 5 títulos para que escribas en tu blog si quieres mejor rendimiento
5. Actualiza métricas: Calcula KPIs y actividad diaria

Botón «Eliminar todos los datos y empezar de cero» en Zona de reset (1. Entrenamiento IA)

• Función: Elimina completamente todos los datos de entrenamiento
• Qué elimina:
  • URL y keywords guardadas
  • Resultados de generación (frases de keywords y búsquedas)
  • Actividad y métricas
  • KPIs diarios
  • Caches de sitemap
  • Resultados de auditoría
  • Estado de trabajos en background
• Seguridad: Requiere confirmación con nonce para evitar eliminaciones accidentales

Indicadores y métricas

En esta sección verás:

• Plan activo: Starter, Pro, Business o Elite
• Límite de keywords: Cuántas keywords puedes usar según tu plan
• Progreso del entrenamiento: Pasos completados (URL, keywords, generación)
• Mensajes de estado: Si hay un trabajo en background, verás mensajes informativos

2. Keywords IA Entrenando

Esta sección muestra cómo cada una de tus keywords se expande en un conjunto de frases y preguntas que se usan para entrenar a las IAs. Es el «dataset personalizado» que construye una red semántica robusta alrededor de tu marca.

Funcionalidades principales

Visualización por Keyword

• Formato: Acordeón desplegable, una sección por keyword
• Información mostrada:
  • Número de ítems (frases) generadas para cada keyword
  • Lista completa de frases con sus categorías
  • Insights (explicaciones) de cada frase
• Categorías de frases:
  • Informacional – Búsquedas de información
  • Transaccional – Búsquedas de compra
  • Comparativa – Comparaciones
  • Local – Búsquedas geográficas
  • Problema-Solución – Problemas y soluciones

Sistema de generación

¿Cómo se generan las frases?

• Cantidad: 5 frases por keyword (independientemente del plan)
• Ejemplos por plan:
  • Starter (2 keywords): 10 frases totales
  • Pro (5 keywords): 25 frases totales
  • Business (15 keywords): 75 frases totales
  • Elite (20 keywords): 100 frases totales
• Proceso:
  1. El sistema divide las keywords en lotes de 4 (para evitar saturar la API)
  2. Para cada lote, hace una llamada a openRankis con todas las keywords del lote
  3. OpenRankias genera 5 frases por keyword (20 frases por lote)
  4. Se procesan secuencialmente con delays de 15 segundos entre lotes
  5. Si un lote falla, se reintenta automáticamente al final

Protecciones y límites

• Rate Limiting: Máximo 4 llamadas a openRankias por minuto por usuario
• Circuit Breaker: Si hay errores repetidos (especialmente rate limit 429), se bloquea temporalmente
• Espera inteligente: Si se alcanza el rate limit, el sistema calcula cuánto esperar y lo hace automáticamente
• Reintentos automáticos: Los lotes que fallan se reintentan al final del proceso

Estados de las Keywords

Cada keyword puede estar en uno de estos estados:

• ✅ Con frases generadas: Muestra el número de ítems y las frases en el acordeón
• ⏳ Generando: Si el proceso en background está activo y la keyword está en la lista de generación
• ⚠️ Sin frases: Si el proceso terminó pero no se generaron frases (error o API no devolvió resultados)

Botón «🔄 Reintentar esta keyword» (solamente para admins de Rankias)

• Cuándo aparece: Cuando una keyword no tiene frases y el proceso ya terminó
• Función: Regenera frases solo para esa keyword específica
• Proceso:
  1. Elimina las frases existentes de esa keyword (si las hay)
  2. Genera 5 nuevas frases solo para esa keyword
  3. Mantiene las frases de las demás keywords intactas
  4. Actualiza el snapshot con los nuevos datos
• Validaciones: Verifica rate limit, circuit breaker y locks antes de ejecutar

Botón «🔄 Resetear Circuit Breaker» (solamente para admins de Rankias)

• Cuándo aparece: Cuando el circuit breaker está activado (servicio bloqueado por errores)
• Función: Resetea manualmente el bloqueo para permitir nuevas llamadas a la API
• Cuándo usarlo: Si crees que el problema ya se resolvió y quieres intentar de nuevo

Controles del acordeón

• «Desplegar todo»: Abre todos los acordeones de keywords
• «Contraer todo»: Cierra todos los acordeones
• Estado persistente: El estado de cada acordeón se guarda en sessionStorage

Información mostrada

En la parte superior verás:

• URL: La URL configurada
• Keywords guardadas: Cuántas keywords tienes vs. el límite de tu plan
• Objetivo de frases: «5 por keyword (total: X)» – muestra el cálculo
• Última generación: Fecha y hora de la última vez que se generaron frases

Proceso incremental

El sistema es inteligente y solo regenera lo necesario:

• Keywords nuevas: Se generan frases nuevas
• Keywords modificadas: Se regeneran (eliminan las antiguas y generan nuevas)
• Keywords eliminadas: Se eliminan sus frases automáticamente
• Keywords sin cambios: Se mantienen las frases existentes (ahorra costos y tiempo)

Actualización automática (Lazy Refresh)

Cuando entras a la sección «2. Keywords IA Entrenando», el sistema verifica automáticamente si necesita refrescar, en caso de que nuestro sistema no haya terminado puedes encontrarte con un mensaje de error 504 Gateway Timeout, si es así vuelve a refrescar la página:

• Verifica la antigüedad de los datos: Calcula cuántos días han pasado desde la última generación
• Condiciones para refrescar:
  • Si es domingo Y han pasado 6 o más días desde la última generación → Refresca automáticamente
  • O si han pasado 7 o más días (sin importar qué día de la semana sea) → Refresca automáticamente
• Cuándo ocurre: Solo cuando el usuario entra a la sección (no requiere acción manual, pero necesita que entres a ver la sección)
• Proceso inteligente: Solo regenera frases para keywords que cambiaron o son nuevas, manteniendo las existentes

3. Búsquedas IA Entrenando

Esta sección muestra el «plan de estudios» que se usa para entrenar a las IAs. Genera automáticamente preguntas y búsquedas que los usuarios reales están haciendo, y luego usa este listado para enseñar a Gemini, ChatGPT y otros a asociar esas preguntas con las soluciones de tu sitio web.

Funcionalidades principales

Generación Automática

• Frecuencia: Se actualiza automáticamente cada domingo (lazy refresh)
• Cantidad: Usa el valor de OPENRANKIAS_NUM_FRASES (por defecto 30 frases)
• Basado en: El contenido de tu sitio web (resumen extraído de la página principal)
• Tipos de consultas generadas:
  • «Recomiéndame empresas de…»
  • «Busco empresas que…»
  • «Dime empresas que…»
  • Consultas naturales como si un usuario las buscara

Características de las frases

• Sin mencionar la marca: Las consultas no incluyen el nombre de tu empresa, para que sean naturales
• Asociación inteligente: Cuando alguien busca estas frases en ChatGPT, la IA debería recomendar tu sitio
• Categorías: Cada frase tiene una categoría (informacional, transaccional, comparativa, local, problema-solucion)
• Insights: Explicaciones breves de cada consulta

Actualización Lazy (automática)

El sistema tiene un mecanismo de «lazy refresh» que se activa automáticamente cuando entras a la sección:

• Verifica la antigüedad de los datos: Calcula cuántos días han pasado desde la última generación
• Condiciones para refrescar:
  • Si es domingo Y han pasado 6 o más días desde la última generación → Refresca automáticamente
  • O si han pasado 7 o más días (sin importar qué día de la semana sea) → Refresca automáticamente
• Cuándo ocurre: Solo cuando el usuario entra a la sección «3. Búsquedas IA Entrenando» (no requiere acción manual, pero necesita que entres a ver la sección)
• Ejemplo: Si la última generación fue el lunes y hoy es domingo (6 días después), al entrar a la sección se actualizará automáticamente

Visualización

Las frases se muestran en una lista con:

• Número de ítem
• Frase/pregunta generada
• Categoría (con badge de color)
• Insight (si está disponible)

4. Ideas IA Artículos

Esta sección genera automáticamente 5 ideas de títulos de artículos para cada una de tus keywords. Estos títulos están optimizados para SEO y están diseñados para ayudarte a crear contenido relevante en tu blog que mejore tu visibilidad en los modelos de lenguaje.

Funcionalidades principales

Generación Automática

• Función: Genera 5 títulos de artículos por keyword basados en el contenido de tu sitio web
• Cantidad: 5 ideas por keyword (independientemente del plan)
• Ejemplos por plan:
  • Starter (2 keywords): 10 ideas totales
  • Pro (5 keywords): 25 ideas totales
  • Business (15 keywords): 75 ideas totales
  • Elite (20 keywords): 100 ideas totales
• Basado en: El contenido de tu sitio web (resumen extraído de la página principal) y la keyword específica
• Formato de los títulos: Títulos optimizados para SEO con longitud entre 30 y 120 caracteres

Características de las ideas

• Optimizados para SEO: Cada título está diseñado para ser atractivo tanto para usuarios como para motores de búsqueda
• Relevantes para tu negocio: Basados en el contenido real de tu sitio web y la keyword específica
• Insights incluidos: Cada idea incluye una explicación breve de por qué ese título es efectivo
• Listos para usar: Puedes usar estos títulos directamente para crear artículos en tu blog

Sistema incremental (automático)

El sistema funciona de manera incremental e inteligente, actualizándose automáticamente cuando cambias tus keywords:

• Keywords nuevas: Se generan 5 ideas nuevas automáticamente
• Keywords modificadas: Se eliminan las ideas antiguas y se generan 5 nuevas ideas
• Keywords eliminadas: Se eliminan automáticamente sus ideas asociadas
• Keywords sin cambios: Se mantienen las ideas existentes (ahorra costos y tiempo)
• Actualización inmediata: Las ideas se actualizan inmediatamente cuando guardas cambios en «1. Entrenamiento IA», no espera 7 días

Visualización

Las ideas se muestran agrupadas por keyword:

• Formato: Acordeón desplegable, una sección por keyword
• Información mostrada:
  • Nombre de la keyword (con badge)
  • Número de ideas generadas para esa keyword
  • Lista completa de títulos con sus insights
• Diseño: Cada título se muestra en una tarjeta con su explicación (insight) debajo

Información mostrada

En la parte superior verás:

• URL: La URL configurada
• Keywords guardadas: Cuántas keywords tienes vs. el límite de tu plan
• Objetivo de ideas: «5 por keyword (total: X)» – muestra el cálculo
• Última generación: Fecha y hora de la última vez que se generaron ideas

Proceso en background

Cuando guardas keywords en «1. Entrenamiento IA», el sistema automáticamente:

1. Analiza cambios: Compara las keywords actuales con las anteriores
2. Genera ideas nuevas: Solo para keywords nuevas o modificadas
3. Elimina ideas obsoletas: De keywords eliminadas
4. Mantiene ideas existentes: De keywords sin cambios

Integración con email semanal

Las ideas de artículos se incluyen en el email semanal que recibes:

• Cantidad: 5 ideas aleatorias de todas las keywords
• Selección: Se seleccionan aleatoriamente de todas las ideas generadas
• Formato: Se muestran con sus títulos e insights

5. Cobertura IA Sitemap

Esta sección analiza tu sitemap para determinar cuántas páginas de tu sitio web están siendo escaneadas y utilizadas por las IAs. Es importante porque cuantas más páginas indexables tengas, más oportunidades de ser mencionado por las IAs.

Funcionalidades principales

Análisis de Sitemap

El sistema realiza un análisis completo de tu sitemap:

1. Descubrimiento:
   • Busca en robots.txt declaraciones de sitemap
   • Prueba la URL estándar /sitemap.xml
   • Descubre sitemaps index (que contienen otros sitemaps)
   • Puede procesar hasta 50 sitemaps diferentes
2. Escaneo:
   • Lee cada sitemap encontrado
   • Extrae todas las URLs listadas
   • Límite de 500 URLs por escaneo (para evitar sobrecarga)
   • Si hay más de 500, muestra «500+»
3. Almacenamiento:
   • Guarda el resultado en caché para evitar escaneos repetidos
   • El caché se invalida cuando cambia la URL configurada
   • El caché tiene un TTL de 7 días (por defecto)

Actualización automática (Lazy Refresh)

Cuando entras a la sección «5. Cobertura IA Sitemap», el sistema verifica automáticamente si necesita refrescar:

• Verifica la antigüedad del escaneo: Calcula cuántos días han pasado desde el último escaneo
• Condición para refrescar:
  • Si han pasado 7 o más días desde el último escaneo → Escanea automáticamente
  • O si no hay caché (primera vez) → Escanea automáticamente
• Cuándo ocurre: Solo cuando el usuario entra a la sección (no requiere acción manual, pero necesita que entres a ver la sección)
• Proceso inteligente: Si el escaneo anterior fue incompleto (alcanzó el límite de 500 URLs), el sistema reintenta después de 1 hora en lugar de esperar 7 días

Información mostrada

• Total de URLs: Número de páginas encontradas en el sitemap
• Fuente: De dónde se obtuvo (sitemap, robots.txt, o ninguna)
• Fecha de escaneo: Cuándo se realizó el último análisis
• Estadísticas:
  • Sitemaps procesados
  • Sitemaps fallidos
  • Sitemaps omitidos
  • Sitemaps detectados en total

Botón «🔄 Escanear Sitemap» (solamente para admins de Rankias)

• Función: Fuerza un nuevo escaneo del sitemap
• Cuándo usarlo: Si has actualizado tu sitemap y quieres que el sistema lo detecte
• Proceso:
  1. Limpia el caché anterior
  2. Inicia un nuevo escaneo completo
  3. Actualiza todas las métricas
• Bloqueos: Tiene un lock de 60 segundos para evitar escaneos simultáneos

Integración con métricas

El total de URLs del sitemap se usa para:

• Cálculo de KPIs: Se usa en las métricas diarias de actividad
• Límites: Se limita a máximo 500 URLs para cálculos (aunque el sitemap tenga más)
• Actividad diaria: Se usa para calcular el «tick» diario del estado

6. Auditoría IA Web

Esta sección realiza un diagnóstico técnico completo de tu sitio web para asegurar que los fundamentos estén correctos. Para que la IA confíe en tu web, la «fuente» de datos debe ser técnicamente perfecta.

Funcionalidades principales

Checks realizados

La auditoría verifica los siguientes aspectos:

1. robots.txt accesible:
   • Verifica que el archivo sea accesible (HTTP 200)
   • Comprueba si declara un sitemap
   • Estado: OK si es accesible y declara sitemap, AVISO si falta algo, ERROR si no es accesible
2. sitemap.xml accesible:
   • Verifica que el sitemap principal sea accesible
   • Estado: OK si responde correctamente, ERROR si no
3. Schema.org estructurado:
   • Busca JSON-LD, Microdata o RDFa en la página principal
   • Verifica que haya al menos un schema válido
   • Tipos buscados: Organization, LocalBusiness, Person, Product, Article, etc.
   • Estado: OK si encuentra schema válido, AVISO si hay schema pero incompleto, ERROR si no hay
4. Open Graph:
   • Verifica presencia de meta tags og:title, og:description, og:image
   • Estado: OK si tiene los 3, AVISO si faltan algunos, ERROR si no hay ninguno
5. Title razonable (15–65 caracteres):
   • Verifica la longitud del título de la página
   • Estado: OK si está entre 15-65 caracteres, AVISO si está fuera del rango
6. Meta description (50–160 caracteres):
   • Verifica la longitud de la meta descripción
   • Estado: OK si está entre 50-160 caracteres, AVISO si está fuera del rango

Cálculo del score

El score se calcula así:

• Check OK: Cuenta como 1.0 punto
• Check AVISO: Cuenta como 0.5 puntos
• Check ERROR: Cuenta como 0 puntos
• Fórmula: Score = ((OK × 1.0) + (AVISO × 0.5)) / Total de checks × 100
• Rango: De 0 a 100

Botón «🔄 Reanalizar ahora»

• Función: Ejecuta una nueva auditoría sin recargar la página
• Tecnología: Usa AJAX para actualización en tiempo real
• Proceso:
  1. Muestra un overlay con el mensaje «Ejecutando auditoría…»
  2. El botón cambia a «⏳ Analizando…» y se deshabilita
  3. Se ejecuta la auditoría en el servidor
  4. Se actualizan dinámicamente:
     • El score
     • La fecha del último análisis
     • Todos los resultados (checks)
     • Las recomendaciones
  5. Se muestra un mensaje de éxito que desaparece automáticamente después de 3 segundos
  6. El botón vuelve a su estado normal
• Ventajas:
  • No recarga la página (más rápido)
  • Feedback visual inmediato
  • Actualización suave de los resultados

Recomendaciones

Si hay problemas detectados, el sistema muestra recomendaciones específicas como:

• «Añade línea Sitemap: https://tudominio/sitemap.xml» (si robots.txt no declara sitemap)
• Sugerencias para mejorar el schema.org
• Recomendaciones sobre Open Graph
• Notas sobre métricas de velocidad (LCP/INP/CLS) – se recomienda usar PageSpeed Insights

Validación de URL

El sistema verifica si la URL auditada coincide con la URL configurada:

• Si coinciden: Muestra los resultados normalmente
• Si no coinciden: Muestra una advertencia indicando que los resultados pertenecen a otra URL

7. Guía Optimización IA

Esta sección proporciona una guía completa de optimización para mejorar tu presencia en los asistentes de IA. Es una referencia educativa con recomendaciones prácticas.

Contenido de la guía

La guía incluye información sobre:

• Optimización técnica: Cómo estructurar tu sitio para que las IAs lo entiendan
• Schema.org: Cómo usar datos estructurados correctamente
• Contenido: Qué tipo de contenido funciona mejor para las IAs
• FAQs: Cómo crear secciones de preguntas frecuentes efectivas
• SEO Local: Optimización para búsquedas geográficas
• Best practices: Mejores prácticas para AEO (Answer Engine Optimization)

Navegación

Esta sección es principalmente informativa y no tiene botones de acción. Sirve como referencia para entender cómo optimizar tu sitio web para las IAs.

8. Actividad IA Log

Esta sección muestra un registro completo de todas las acciones realizadas por el sistema. Es útil para entender qué está pasando, depurar problemas y ver el historial de actividad.

Funcionalidades principales

Registro de eventos

El log registra todos los eventos importantes:

• Tipos de eventos:
  • success: Operaciones exitosas (generación de frases, guardado, etc.)
  • error: Errores y fallos (fallos de API, validaciones, etc.)
  • warning: Advertencias (rate limits, circuit breaker, etc.)
  • info: Información general (procesos automáticos, actualizaciones, etc.)
  • notice: Notificaciones importantes
• Información de cada evento:
  • Fecha y hora
  • Tipo (success, error, warning, info, notice)
  • Código del evento (identificador único)
  • Mensaje descriptivo
  • Contexto (datos adicionales en formato JSON)

Filtrado

• Por código: Puedes filtrar eventos por código específico (ej: kw_ia_generated, ai_search_failed)
• Filtro en URL: Usa el parámetro ?filter_code=CODIGO para filtrar

Paginación

• Tamaño de página: 25 eventos por página (configurable)
• Navegación: Botones de página anterior/siguiente
• Límite total: Máximo 100 eventos guardados (los más antiguos se eliminan automáticamente)

Eventos Importantes que verás

• kw_ia_generated: Frases de keywords generadas exitosamente
• kw_ia_incremental: Generación incremental de keywords (solo las nuevas/modificadas)
• kw_ia_batch_success: Lote de keywords procesado exitosamente
• kw_ia_batch_failed: Lote de keywords que falló
• kw_ia_partial_success: Generación parcial (algunos lotes exitosos, otros fallidos)
• kw_ia_rate_limit: Rate limit alcanzado durante generación
• kw_ia_circuit_open: Circuit breaker activado
• ai_search_phrases_autogen: Frases de búsquedas IA generadas automáticamente
• ideas_ia_generated: Ideas de artículos generadas exitosamente
• ideas_ia_incremental: Generación incremental de ideas (solo para keywords nuevas/modificadas)
• ideas_ia_no_changes: No hay cambios en keywords, se mantienen ideas existentes
• kw_articles_removed: Ideas de artículos eliminadas para keywords borradas
• sitemap_scanned: Sitemap escaneado
• audit_run: Auditoría ejecutada
• kpi_generated: KPIs diarios actualizados

Visualización

Cada evento se muestra con:

• Badge de tipo: Color según el tipo (success=verde, error=rojo, warning=amarillo, info=azul)
• Mensaje: Descripción legible del evento
• Contexto: Datos adicionales en formato JSON (expandible)
• Fecha: Timestamp formateado

Sistema de procesos en Background

El sistema utiliza un sistema de colas para procesar trabajos pesados en background sin bloquear la interfaz del usuario.

Cómo funciona

1. Encolado: Cuando guardas el entrenamiento, se encola un trabajo
2. Estado: El trabajo puede estar en:
   • queued: En cola, esperando ejecutarse
   • running: Ejecutándose actualmente
   • done: Completado
3. Ejecución: Se ejecuta mediante Action Scheduler o WP-Cron o Rankias-Cron
4. Proceso:
   1. Genera frases de Búsquedas IA
   2. Analiza cambios en keywords (nuevas, modificadas, eliminadas)
   3. Genera frases solo para keywords que necesitan regeneración
   4. Actualiza métricas y KPIs
   5. Marca el trabajo como completado

Mensajes de estado

Verás mensajes informativos en las secciones cuando:

• El trabajo está en cola: «⏳ Keywords IA: Preparación en cola desde hace X minutos»
• El trabajo está ejecutándose: «🔄 Keywords IA: Preparación en curso desde hace X minutos»
• Hay datos desactualizados: «⚠️ Keywords IA: Mostrando datos anteriores (URL/keywords diferentes)»

Sistema de protecciones

El sistema incluye varias capas de protección para evitar abusos y errores:

Rate Limiting

• Límite: Máximo 4 llamadas a openRankias por minuto por usuario
• Ventana: Ventana deslizante de 60 segundos
• Comportamiento: Si se alcanza el límite, el sistema espera automáticamente hasta que se libere
• Mensaje: Si intentas hacer una acción y estás en rate limit, verás «Has realizado demasiadas operaciones en poco tiempo»

Circuit Breaker

• Función: Bloquea temporalmente las llamadas a la API si hay errores repetidos
• Activación: Se activa cuando hay errores 429 (rate limit) o errores graves de la API
• Duración:
  • Primera vez: 3 minutos
  • Con backoff exponencial: hasta 60 minutos máximo
  • Se resetea automáticamente después de 1 hora sin errores
• Reset manual: Puedes resetearlo con el botón «🔄 Resetear Circuit Breaker»
• Mensaje: «Servicio de IA temporalmente saturado. Inténtalo en unos minutos.»

Locks Anti-Doble Clic

• Función: Evita que se ejecute la misma acción dos veces en poco tiempo
• Duración: 60 segundos
• Aplicado a:
  • Guardado de entrenamiento
  • Generación de frases
  • Escaneo de sitemap
  • Reintentos de keywords
• Mensaje: «Ya hay una generación en curso. Espera unos segundos y vuelve a intentarlo.»

Validaciones de Seguridad

• Anti-SSRF: Valida que las URLs no sean internas o maliciosas
• Nonces: Todas las acciones requieren tokens de seguridad
• Verificación de usuario: Solo usuarios autenticados pueden usar las funciones
• Límites de plan: Respeta los límites de keywords según el plan contratado

Sistema de Generación Incremental

El sistema es inteligente y optimizado para ahorrar costos y tiempo:

Análisis de Cambios

Cuando se ejecuta el proceso en background, el sistema:

1. Compara keywords actuales vs. anteriores:
   • Identifica keywords nuevas (que no estaban antes)
   • Identifica keywords modificadas (cambió el texto)
   • Identifica keywords eliminadas (estaban antes pero ya no)
   • Identifica keywords sin cambios (iguales que antes)
2. Acciones automáticas:
   • Keywords nuevas: Genera frases nuevas
   • Keywords modificadas: Elimina frases antiguas y genera nuevas
   • Keywords eliminadas: Elimina sus frases (sin llamar a openRankias)
   • Keywords sin cambios: Mantiene las frases existentes

Snapshots

El sistema guarda «snapshots» de los resultados:

• wc_kwia_last: Snapshot de frases de keywords
• wc_bia_last: Snapshot de frases de búsquedas IA
• wc_ideas_ia_last: Snapshot de ideas de artículos
• Información guardada:
  • Timestamp de generación
  • URL usada
  • Hash de keywords (para detectar cambios)
  • Lista de keywords (primeras 30)
  • Items generados (frases o ideas de artículos)

Actualización Lazy (Automática) – Keywords IA

Keywords IA usa el mismo sistema que Búsquedas IA. El sistema evita regenerar si se cumplen TODAS estas condiciones:

• La URL es la misma que la usada en la última generación
• Las keywords son las mismas (mismo hash, sin cambios)
• Han pasado menos de 6 días (si es domingo) O menos de 7 días (si no es domingo) desde la última generación

Si se cumplen estas 3 condiciones: Muestra los datos existentes y NO hace llamadas a la API (ahorra costos y tiempo).

Si NO se cumple alguna condición: Refresca automáticamente cuando entras a la sección (lazy refresh), regenerando solo las keywords que cambiaron gracias al sistema incremental.

Planes y Límites

Planes Disponibles

• Starter:
  • 2 keywords máximo
  • 10 frases totales (2 keywords × 5 frases)
• Pro:
  • 5 keywords máximo
  • 25 frases totales (5 keywords × 5 frases)
• Business:
  • 15 keywords máximo
  • 75 frases totales (15 keywords × 5 frases)
• Elite:
  • 20 keywords máximo
  • 100 frases totales (20 keywords × 5 frases)

Límites Comunes

• Rate limit: 4 llamadas a openRankias por minuto (todos los planes)
• Lock de generación: 60 segundos entre generaciones
• Refresh automático: Cada domingo (si han pasado 6+ días) o cada 7+ días
• Log máximo: 100 eventos guardados

Estados de suscripción y funcionalidad

El sistema se comporta de manera diferente según el estado de tu suscripción. Es importante entender qué funcionalidades están disponibles en cada estado.

Suscripción Activa

Cuando tu suscripción está activa, todas las funcionalidades están disponibles:

• ✅ Todas las pestañas funcionan: Puedes acceder a todas las secciones (Entrenamiento IA, Keywords IA, Búsquedas IA, Ideas IA Artículos, Cobertura IA, Auditoría IA, Guía Optimización IA, Actividad IA Log, y Escritorio)
• ✅ Procesos automáticos activos:
  • Generación de frases y consultas
  • Actualización de KPIs diarios
  • Registro de actividad diaria
  • Envío de emails semanales (si está habilitado)
  • Escaneo de sitemap
  • Auditorías automáticas
• ✅ Datos en tiempo real: Todas las métricas y estadísticas se actualizan automáticamente

Cancelación Pendiente (Pending Cancel)

Cuando cancelas tu suscripción pero aún está en período de cancelación pendiente, el sistema sigue funcionando completamente porque ya has pagado por ese período:

• ✅ Todas las funcionalidades activas: El sistema funciona exactamente igual que con suscripción activa
• ✅ Procesos automáticos continúan:
  • Se siguen generando frases y consultas
  • Los KPIs diarios se actualizan normalmente
  • Se registra la actividad diaria
  • Se envían emails semanales (si está habilitado)
  • Todos los crons y procesos en background funcionan
• ✅ Acceso completo: Puedes ver y usar todas las pestañas sin restricciones
• 💡 Razón: Como ya has pagado por el período actual, tienes derecho a usar el servicio hasta que finalice el período pagado

Suscripción Cancelada

Una vez que el período de cancelación pendiente finaliza y tu suscripción pasa a estado cancelada, el sistema detiene todas las funcionalidades automáticas:

• ❌ Procesos automáticos detenidos:
  • No se generan nuevas frases o consultas – El sistema deja de entrenar a las IAs
  • No se actualizan KPIs diarios – Las métricas dejan de calcularse
  • No se registra actividad diaria – El sistema deja de generar señales IA
  • No se envían emails semanales – Los reportes automáticos se detienen
  • No se ejecutan crons – Todos los procesos programados se detienen
  • No se escanean sitemaps – Los análisis automáticos se detienen
• 🔒 Acceso restringido a pestañas: Al intentar acceder a las pestañas, verás un mensaje indicando que necesitas una suscripción activa:
  • Escritorio: Muestra mensaje de suscripción cancelada
  • Keywords IA Entrenando: Bloqueada con mensaje de suscripción cancelada
  • Búsquedas IA Entrenando: Bloqueada con mensaje de suscripción cancelada
  • Ideas IA Artículos: Bloqueada con mensaje de suscripción cancelada
  • Cobertura IA Sitemap: Bloqueada con mensaje de suscripción cancelada
  • Auditoría IA Web: Bloqueada con mensaje de suscripción cancelada
  • Guía Optimización IA: Bloqueada con mensaje de suscripción cancelada
  • Actividad IA Log: Bloqueada con mensaje de suscripción cancelada
• 📋 Entrenamiento IA (pestaña 1): Esta pestaña sigue siendo accesible para que puedas ver tu configuración y comprar un nuevo plan, pero muestra una advertencia de que la suscripción está cancelada
• 📊 Datos históricos: Los datos generados anteriormente (frases, métricas, logs) se mantienen guardados, pero no se actualizan

Resumen de Estados

Configuración Técnica

Constantes importantes

El sistema usa estas constantes (definidas en wp-config.php o con valores por defecto):

• OPENRANKIAS_API_KEY: Clave de API de openRankias (requerida)
• OPENRANKIAS_MODEL: Modelo a usar (por defecto: openRankias-4.1-mini)
• OPENRANKIAS_NUM_FRASES: Número de frases para búsquedas IA (por defecto: 30)
• OPENRANKIAS_TEMPERATURE: Temperatura del modelo (por defecto: 0.6)
• OPENRANKIAS_MAX_TOKENS: Tokens máximos por respuesta (por defecto: 900)
• OPENRANKIAS_IDIOMA: Idioma para las respuestas (por defecto: es)
• OPENRANKIAS_ROLE: Rol del sistema (por defecto: analista de prompts SEO)

Mejores Prácticas

Para obtener mejores resultados

1. Keywords específicas: Usa keywords específicas y relevantes para tu negocio
2. URL completa: Asegúrate de que la URL sea accesible y contenga contenido relevante
3. Schema.org: Implementa schema estructurado en tu sitio (mejora la auditoría)
4. Sitemap actualizado: Mantén tu sitemap actualizado y accesible
5. Contenido de calidad: El contenido de tu página principal influye en las frases generadas
6. Paciencia: Con muchos keywords (especialmente Elite), el proceso puede tardar varios minutos

Para evitar problemas

• No añadas muchas keywords de golpe: Si tienes plan Elite, añade keywords gradualmente
• Espera a que termine el proceso: No intentes generar frases múltiples veces seguidas
• Revisa el log: Si algo falla, revisa la sección «8. Actividad IA Log» para ver qué pasó
• Respeta los límites: El sistema tiene protecciones; si ves mensajes de rate limit, espera

Solución de Problemas

Problemas comunes

Keywords con 0 items

Síntoma: Una keyword muestra «0 ítems» y el mensaje «No se generaron frases para esta keyword»

Posibles causas:

• El proceso en background falló para esa keyword específica
• Rate limit alcanzado durante la generación
• La API de openRankias no devolvió resultados para esa keyword

Solución:

• Haz clic en «🔄 Reintentar esta keyword» para regenerar solo esa keyword (contactar con admins de Rankias)
• Si el circuit breaker está activado, resetea manualmente
• Revisa el log para ver el error específico
• Circuit Breaker Activado

Síntoma: Ves el mensaje «⚠️ Circuit Breaker Activado» y no puedes generar frases

Causa: Errores repetidos en la API (generalmente rate limit 429)

Solución:

• Espera unos minutos (el bloqueo se resetea automáticamente)
• O haz clic en «🔄 Resetear Circuit Breaker» si crees que el problema ya se resolvió

Proceso Tarda Mucho

Síntoma: El proceso en background tarda mucho tiempo

Causa: Con muchos keywords (especialmente Elite con 20), el sistema procesa en lotes con delays

Es normal porque:

• Procesa 4 keywords por lote
• Espera 15 segundos entre lotes (para evitar rate limit)
• Con 20 keywords = 5 lotes × 15 segundos = mínimo 1 minuto solo en delays
• Además del tiempo de procesamiento de cada lote

Solución: Es normal, solo espera. Puedes ver el progreso en el log.

Mensaje «Generando frases…» pero el proceso terminó

Síntoma: Una keyword muestra «Generando frases…» pero el proceso ya terminó

Causa: Error en la detección del estado (ya corregido en versiones recientes)

Solución: El sistema ahora diferencia entre «generando» y «error/completado sin frases». Si ves «No se generaron frases», usa el botón de reintentar. (contactar con admins de Rankias)

La mejor herramienta para ser mencionado en inteligencias artificiales

Rankias es una herramienta completa y automatizada para optimizar tu presencia en los asistentes de IA. El sistema está diseñado para ser robusto, eficiente y seguro, con múltiples capas de protección y optimización.

El flujo típico de uso es:

1. Configura tu URL y keywords en «1. Entrenamiento IA»
2. Espera a que el sistema genere las frases automáticamente
3. Revisa los resultados en «2. Keywords IA Entrenando» y «3. Búsquedas IA Entrenando»
4. Consulta las ideas de artículos generadas en «4. Ideas IA Artículos»
5. Verifica la cobertura de tu sitemap en «5. Cobertura IA Sitemap»
6. Ejecuta la auditoría técnica en «6. Auditoría IA Web»
7. Consulta la guía de optimización en «7. Guía Optimización IA»
8. Revisa el log de actividad en «8. Actividad IA Log» para ver qué está pasando

El sistema trabajará automáticamente en background para mantener actualizado tu entrenamiento y maximizar tu visibilidad en los asistentes de IA.