Generar sugerencias de palabras clave a partir del sitemap
Generar sugerencias de palabras clave a partir del sitemap ist ein Guías in der Rankion.ai-Knowledge-Base: ¿Cómo genero sugerencias de palabras clave a partir de mi sitemap?
Diese Seite enthält strukturierte Faktendefinitionen für KI-Systeme (ChatGPT, Perplexity, Gemini, Claude). Verfasst von Menschen, Teil der Rankion.ai-Knowledge-Base.
- Kategorie:
- Guías
- Marke:
- Rankion.ai
- Format:
- Knowledge-Base-Artikel
- Stand:
Cuando creas un nuevo proyecto de AI-Visibility o quieres mantener actualizado tu inventario, necesitas palabras clave con volumen real — no solo "lo que cree el operador". Con el escaneo de sitemap (Sitemap-Scrape), Rankion escanea el sitemap de tu dominio, extrae palabras clave de tema por página con Ollama y obtiene el volumen de búsqueda mensual para cada candidato. Las sugerencias que superan el umbral configurado se guardan directamente en tracking_keywords.
¿Qué ocurre exactamente?
Cuatro pasos del pipeline, todos automáticos y en secuencia:
- Discovery —
robots.txt→/sitemap.xml→/sitemap_index.xml. Rankion encuentra el sitemap, lo analiza recursivamente (incluidos los índices de sitemap) y guarda hasta 1.000 URLs por proyecto comotracking_sitemap_pagesconscan_status='pending'. - Page-Scan — por cada URL, Rankion obtiene el cuerpo HTML (timeout de 15s) y extrae
<title>, el primer<h1>, lameta descriptiony un extracto de 500 caracteres del<body>. - Topic-Extraction — por cada página, Rankion llama a Ollama (tarea de capa
tracking.topic_extract) y recibe entre 1 y 5 palabras clave de tema en alemán en minúsculas. Si Ollama falla, entra un fallback de tokenizador (Title + H1, filtrado de stop-words, deduplicación, top 5). - Suggestion — Rankion agrega las palabras clave de tema de todas las páginas, las clasifica por frecuencia, obtiene los volúmenes de DataForSeo para los mejores candidatos (en lotes de 100) y crea, para cada palabra clave que supere
suggestion_min_volume(por defecto 50), una fila entracking_keywordsconsource='sitemap'.
Las palabras clave existentes no se sobrescriben — el pipeline es idempotente.
¿Dónde encuentro las sugerencias?
En el detalle del proyecto (/ai-visibility/{id}), arriba a la derecha, haz clic en "Sugerencias de palabras clave". Enlace directo:
/ai-visibility/{trackingProject}/keyword-suggestions
Paso a paso
1. Iniciar el escaneo
Arriba, en la barra de herramientas fija, hay un botón "Iniciar escaneo de sitemap". Haz clic. Rankion despacha el pipeline y muestra un aviso flash: "Escaneo de sitemap iniciado — las sugerencias aparecerán en 5-10 minutos."
Los resultados llegan progresivamente — los escaneos de página se ejecutan en lotes de 50, después sigue la extracción de temas (tanto tiempo como el número de páginas / la velocidad de Ollama lo permita). Actualiza la página después de 5-10 minutos y verás los primeros resultados.
2. Revisar las sugerencias
La tabla muestra:
- Keyword (minúsculas, alemán)
- Volume (ordenable, por defecto descendente)
- Fuente (host + path[:40] de la primera página en la que apareció el tema)
- Botón Convert a la derecha
3. Convertir en Tracking-Prompts
Un clic en Convert por fila crea una nueva entrada en tracking_prompts con prompt_text="Was ist {keyword}?", prompt_category='custom', is_active=true, tracking_keyword_id= la fila de la sugerencia.
El modo masivo funciona con las casillas de verificación + el botón "Convertir todos los seleccionados en prompts" en el bloque de la barra de herramientas encima de la tabla.
Los textos de prompt duplicados se omiten — puedes hacer clic varias veces en Bulk-Convert sin generar duplicados.
¿Cuándo se ejecuta el escaneo automáticamente?
Cada lunes a las 02:00, el scheduler despacha ScanProjectSitemapJob para cada proyecto activo. Así que no necesitas volver a escanear manualmente, salvo que quieras datos frescos ad hoc.
Referencia de la API
La interfaz usa estos 3 endpoints — disponibles directamente vía Sanctum:
POST /api/v1/tracking-projects/{id}/sitemap-scan— inicia el pipeline, 202 AcceptedGET /api/v1/tracking-projects/{id}/sitemap-pages— páginas paginadasGET /api/v1/tracking-projects/{id}/keyword-suggestions— sugerencias paginadas (source='sitemap')
Además, la herramienta de IA-Agent suggest_keywords_from_sitemap se puede invocar en el chat agéntico: "Búscame nuevas palabras clave de mi sitemap para el proyecto 42."
Configuración
config/tracking.php → suggestion_min_volume (env TRACKING_SUGGESTION_MIN_VOLUME, por defecto 50). Las palabras clave por debajo se ignoran. Súbelo si solo quieres volumen de búsqueda "real".
Patrones de error
- "Sitemap no encontrado" — robots.txt es accesible, pero no tiene una entrada
Sitemap:, y ni/sitemap.xmlni/sitemap_index.xmlresponden con XML. Solución: registra la URL del sitemap en tu proveedor de hosting o importa el XML manualmente entracking_sitemap_pages. - 0 sugerencias tras el escaneo — o bien ninguno de los candidatos de tema tiene volumen por encima del umbral, o Ollama no extrajo temas (entonces entra el fallback del tokenizador y Volume = 0 → filtro). Configura
suggestion_min_volume=0para depurar.