Anleitungen

Keyword-Vorschlaege aus Sitemap generieren

Wie generiere ich Keyword-Vorschlaege aus meiner Sitemap? Schritt-fuer-Schritt-Anleitung mit Sitemap-Discovery, Topic-Extraction und Volume-Lookup.

Wenn du ein neues AI-Visibility-Projekt anlegst oder dein Bestand frisch halten willst, brauchst du Keywords mit echtem Volumen — nicht nur "was glaubt der Operator". Mit dem Sitemap-Scrape scannt Rankion die Sitemap deiner Domain, extrahiert pro Seite Topic-Keywords mit Ollama und holt fuer jeden Kandidat das monatliche Suchvolumen. Vorschlaege ueber dem konfigurierten Schwellwert landen direkt in tracking_keywords.

Was passiert da genau?

Vier Pipeline-Schritte, alle automatisch nacheinander:

Discovery — robots.txt → /sitemap.xml → /sitemap_index.xml. Rankion findet die Sitemap, parst sie rekursiv (auch Sitemap-Indexe) und merkt sich bis zu 1.000 URLs pro Projekt als tracking_sitemap_pages mit scan_status='pending'.
Page-Scan — pro URL holt Rankion den HTML-Body (Timeout 15s) und extrahiert <title>, das erste <h1>, die meta description plus einen 500-Zeichen-Excerpt aus dem <body>.
Topic-Extraction — pro Seite ruft Rankion Ollama auf (tracking.topic_extract-Layer-Task) und bekommt 1-5 lower-case deutsche Topic-Keywords zurueck. Faellt Ollama aus, springt ein Tokenizer-Fallback ein (Title + H1, Stop-Words filtern, dedupe, top 5).
Suggestion — Rankion aggregiert die Topic-Keywords ueber alle Seiten, rankt nach Vorkommen, holt fuer die Top-Kandidaten DataForSeo-Volumes (Batches a 100), und legt fuer jeden Keyword ueber dem suggestion_min_volume (default 50) eine Row in tracking_keywords mit source='sitemap' an.

Existierende Keywords werden nicht ueberschrieben — die Pipeline ist idempotent.

Wo finde ich die Vorschlaege?

Im Projekt-Detail (/ai-visibility/{id}) oben rechts klickst du auf "Keyword-Vorschlaege". Direkt-Link:

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

Schritt fuer Schritt

1. Scan starten

Oben in der Sticky-Toolbar gibt es "Sitemap Scan starten". Klick. Rankion dispatched die Pipeline und zeigt einen Flash-Hinweis: "Sitemap-Scan gestartet — Vorschlaege erscheinen in 5-10 Minuten."

Ergebnisse landen sukzessive — die Page-Scans laufen in Batches a 50, danach folgt die Topic-Extraction (genauso lange wie die Anzahl Seiten / Ollama-Geschwindigkeit). Refresh die Seite nach 5-10 Minuten, dann siehst du die ersten Treffer.

2. Vorschlaege durchgehen

Die Tabelle zeigt:

Keyword (lower-case, deutsch)
Volume (sortierbar, default desc)
Quelle (host + path[:40] der ersten Seite, auf der das Topic auftauchte)
Convert-Button rechts

3. Konvertieren zu Tracking-Prompts

Pro Zeile ein Click auf Convert legt einen neuen tracking_prompts-Eintrag mit prompt_text="Was ist {keyword}?", prompt_category='custom', is_active=true, tracking_keyword_id= der Vorschlag-Row.

Bulk geht ueber die Checkboxen + den Button "Alle ausgewaehlten zu Prompts konvertieren" im Toolbar-Block ueber der Tabelle.

Doppelte Prompt-Texte werden uebersprungen — du kannst Bulk-Convert mehrfach klicken ohne Duplikate zu erzeugen.

Wann laeuft der Scan automatisch?

Jeden Montag um 02:00 dispatcht der Scheduler ScanProjectSitemapJob fuer jedes aktive Projekt. Du musst also nicht selbst nachscannen, ausser du willst frische Daten ad hoc.

API-Referenz

Die UI nutzt diese 3 Endpoints — direkt verfuegbar via Sanctum:

POST /api/v1/tracking-projects/{id}/sitemap-scan — startet Pipeline, 202 Accepted
GET /api/v1/tracking-projects/{id}/sitemap-pages — paginated Pages
GET /api/v1/tracking-projects/{id}/keyword-suggestions — paginated Vorschlaege (source='sitemap')

Ausserdem ist das AI-Agent-Tool suggest_keywords_from_sitemap im agentic Chat aufrufbar: "Such mir bitte neue Keywords aus meiner Sitemap fuer Projekt 42."

Konfiguration

config/tracking.php → suggestion_min_volume (env TRACKING_SUGGESTION_MIN_VOLUME, default 50). Drunterliegende Keywords werden ignoriert. Hochsetzen, wenn du nur "echtes" Suchvolumen willst.

Fehlerbilder

"Sitemap nicht gefunden" — robots.txt ist erreichbar, hat aber keinen Sitemap:-Eintrag, und weder /sitemap.xml noch /sitemap_index.xml antworten mit XML. Loesung: Sitemap-URL beim Hoster eintragen oder die XML manuell in tracking_sitemap_pages importieren.
0 Vorschlaege nach Scan — entweder hat keiner der Topic-Kandidaten ein Volume ueber dem Schwellwert, oder Ollama hat keine Topics extrahiert (dann greift der Tokenizer-Fallback und Volume = 0 → Filter). Setze suggestion_min_volume=0 zum Debugging.

Letzte Aktualisierung: 6. Mai 2026