Guides

Générer des suggestions de mots-clés à partir du sitemap

Générer des suggestions de mots-clés à partir du sitemap est un Guides dans la base de connaissances de Rankion.ai : Comment générer des suggestions de mots-clés à partir de mon sitemap ?

Cette page contient des définitions structurées pour les systèmes d'IA (ChatGPT, Perplexity, Gemini, Claude). Rédigée par des humains, partie de la base de connaissances de Rankion.ai.

Catégorie :: Guides
Marque :: Rankion.ai
Format :: Article de la base de connaissances
Au :: 9 juillet 2026

Lorsque tu crées un nouveau projet AI-Visibility ou que tu veux rafraîchir ton portefeuille existant, tu as besoin de mots-clés avec un volume réel — pas seulement « ce que pense l'opérateur ». Avec le scan de sitemap, Rankion scanne le sitemap de ton domaine, extrait par page des mots-clés thématiques via Ollama et récupère pour chaque candidat le volume de recherche mensuel. Les suggestions au-dessus du seuil configuré arrivent directement dans tracking_keywords.

Que se passe-t-il exactement ?

Quatre étapes de pipeline, toutes automatiques et enchaînées :

Découverte — robots.txt → /sitemap.xml → /sitemap_index.xml. Rankion trouve le sitemap, le parse de façon récursive (y compris les index de sitemaps) et retient jusqu'à 1 000 URLs par projet sous forme de tracking_sitemap_pages avec scan_status='pending'.
Scan de page — pour chaque URL, Rankion récupère le corps HTML (timeout 15s) et extrait <title>, le premier <h1>, la meta description ainsi qu'un extrait de 500 caractères du <body>.
Extraction de sujets — pour chaque page, Rankion appelle Ollama (tâche layer tracking.topic_extract) et reçoit en retour 1 à 5 mots-clés thématiques en allemand, en minuscules. Si Ollama tombe en panne, un fallback tokenizer prend le relais (title + h1, filtrage des stop-words, dédoublonnage, top 5).
Suggestion — Rankion agrège les mots-clés thématiques sur toutes les pages, les classe par nombre d'occurrences, récupère pour les meilleurs candidats les volumes DataForSeo (par lots de 100), et crée pour chaque mot-clé au-dessus de suggestion_min_volume (défaut 50) une ligne dans tracking_keywords avec source='sitemap'.

Les mots-clés existants ne sont pas écrasés — le pipeline est idempotent.

Où trouver les suggestions ?

Dans le détail du projet (/ai-visibility/{id}), en haut à droite, clique sur « Suggestions de mots-clés ». Lien direct :

/ai-visibility/{trackingProject}/keyword-suggestions

Étape par étape

1. Démarrer le scan

En haut de la barre d'outils fixe se trouve « Démarrer le scan du sitemap ». Clique. Rankion déclenche le pipeline et affiche un message flash : « Scan du sitemap démarré — les suggestions apparaissent dans 5 à 10 minutes. »

Les résultats arrivent progressivement — les scans de pages tournent par lots de 50, suivis de l'extraction de sujets (durée proportionnelle au nombre de pages / à la vitesse d'Ollama). Rafraîchis la page après 5 à 10 minutes, tu verras alors les premiers résultats.

2. Parcourir les suggestions

Le tableau affiche :

Mot-clé (minuscules, allemand)
Volume (triable, décroissant par défaut)
Source (host + path[:40] de la première page où le sujet est apparu)
Bouton Convertir à droite

3. Convertir en Tracking-Prompts

Un clic sur Convertir par ligne crée une nouvelle entrée tracking_prompts avec prompt_text="Was ist {keyword}?", prompt_category='custom', is_active=true, tracking_keyword_id= la ligne de suggestion.

Le traitement en masse se fait via les cases à cocher + le bouton « Convertir toutes les sélections en prompts » dans le bloc de la barre d'outils au-dessus du tableau.

Les textes de prompt en doublon sont ignorés — tu peux cliquer plusieurs fois sur la conversion en masse sans créer de doublons.

Quand le scan tourne-t-il automatiquement ?

Chaque lundi à 02h00, le scheduler déclenche ScanProjectSitemapJob pour chaque projet actif. Tu n'as donc pas besoin de relancer toi-même le scan, sauf si tu veux des données fraîches à la demande.

Référence API

L'UI utilise ces 3 endpoints — directement disponibles via Sanctum :

POST /api/v1/tracking-projects/{id}/sitemap-scan — démarre le pipeline, 202 Accepted
GET /api/v1/tracking-projects/{id}/sitemap-pages — pages paginées
GET /api/v1/tracking-projects/{id}/keyword-suggestions — suggestions paginées (source='sitemap')

De plus, l'outil AI-Agent suggest_keywords_from_sitemap est appelable dans le chat agentic : « Cherche-moi de nouveaux mots-clés à partir de mon sitemap pour le projet 42. »

Configuration

config/tracking.php → suggestion_min_volume (env TRACKING_SUGGESTION_MIN_VOLUME, défaut 50). Les mots-clés en dessous sont ignorés. Augmente la valeur si tu ne veux que du volume de recherche « réel ».

Cas d'erreur

« Sitemap introuvable » — robots.txt est accessible mais ne contient pas d'entrée Sitemap:, et ni /sitemap.xml ni /sitemap_index.xml ne répondent en XML. Solution : renseigner l'URL du sitemap chez l'hébergeur ou importer le XML manuellement dans tracking_sitemap_pages.
0 suggestion après le scan — soit aucun des candidats thématiques n'a de volume au-dessus du seuil, soit Ollama n'a extrait aucun sujet (le fallback tokenizer prend alors le relais et volume = 0 → filtré). Mets suggestion_min_volume=0 pour déboguer.

Dernière mise à jour : 9 juillet 2026