Canonical-Tag prüfen
Die Funktion liest den eingefügten HTML-Quelltext einer Seite und prüft den Canonical-Tag: ob er vorhanden, als absolute URL geschrieben und nicht mehrfach mit unterschiedlichem Ziel gesetzt ist. Für alle, die vor der Veröffentlichung sicherstellen wollen, dass eine Seite auf sich selbst oder bewusst auf eine andere Version verweist.
Im Browser ausführen – kostenlos
Läuft direkt in Ihrem Browser – kostenlos. Ihre Datei verlässt Ihren Browser nicht und wird an keinen Server übertragen.
Wofür der Canonical-Tag steht
Der Canonical-Tag sagt Suchmaschinen, welche URL als die maßgebliche Version einer Seite gelten soll, wenn derselbe Inhalt unter mehreren Adressen erreichbar ist, etwa mit und ohne Parameter am Ende der URL. Fehlt er oder zeigt er auf die falsche Adresse, kann eine Suchmaschine die falsche Version in den Ergebnissen bevorzugen, während die eigentlich gewünschte Seite kaum sichtbar bleibt und Besucher auf der falschen Variante landen.
Typische Fehler, die die Funktion findet
Erkannt werden ein fehlender Canonical-Tag, ein relativer statt absoluter Pfad, mehrere widersprüchliche Canonical-Tags auf derselben Seite sowie ein Canonical-Tag, der auf eine andere Domain oder ein anderes Protokoll verweist, etwa http statt https. Jeder Fund wird mit der betroffenen Zeile aus dem eingefügten Quelltext angezeigt, damit die Korrektur im eigenen System zügig gelingt, ohne die Ursache erst mühsam suchen zu müssen.
Kostenlos, direkt im Browser
Sie fügen den Quelltext ein, den Sie über „Seitenquelltext anzeigen“ im Browser erhalten; die Prüfung läuft anschließend vollständig auf Ihrem Gerät, der Text verlässt Ihren Browser nicht. Die manuelle Nutzung ist kostenlos und ohne Limit, unabhängig davon, wie viele Seiten Sie nacheinander prüfen und wie oft am Tag. Wer stattdessen eine URL angeben möchte, die automatisch abgerufen wird, nutzt dafür die API-Anfrage für $0.002.
Anwendungsfälle
Neue Filterseite eines Onlineshops
Bäckerei Hoffmann e. K. prüft eine neue Filterseite mit URL-Parametern und stellt sicher, dass der Canonical-Tag auf die parameterfreie Hauptversion der Seite zeigt.
Umzug von http auf https
Nach dem Wechsel auf https prüft Thomas Müller stichprobenartig mehrere Seiten, um sicherzustellen, dass kein Canonical-Tag noch auf die alte http-Adresse verweist.
Zweite Sprachversion einer Seite
Anna Hoffmann prüft, ob die deutsche Seite versehentlich auf die englische Version als Canonical verweist, statt auf sich selbst.
Häufige Fragen
Was passiert, wenn der Canonical-Tag fehlt?
Suchmaschinen wählen dann selbst eine bevorzugte Version, wenn derselbe Inhalt unter mehreren URLs erreichbar ist. Ein gesetzter Canonical-Tag nimmt diese Entscheidung stattdessen bewusst vorweg.
Erkennt die Funktion mehrere widersprüchliche Canonical-Tags?
Ja, das ist einer der häufigsten gefundenen Fehler, insbesondere wenn ein CMS und ein Plugin unabhängig voneinander jeweils einen eigenen Tag einfügen.
Muss der Canonical-Tag auf die eigene Seite zeigen?
Nicht zwingend. Bei absichtlich doppeltem Inhalt kann er auf eine andere, bevorzugte Version zeigen. Die Funktion prüft die technische Korrektheit, nicht die inhaltliche Absicht dahinter.
Was kostet es, wenn ich nur die URL angebe?
$0.002 pro Anfrage über die API. Mit eingefügtem Quelltext bleibt die Prüfung kostenlos.
Ist für die kostenlose Nutzung ein Konto nötig?
Nein. Ein Konto ist für die Nutzung im Browser nicht vorgesehen.
Für Entwickler — API-Zugang
Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.
Endpunkt
Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.
Aufruf aus Ihrem Stack
curl -X POST https://api.kit.forhosting.com/seo/canonical-check \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://ejemplo.com"}'const res = await fetch("https://api.kit.forhosting.com/seo/canonical-check", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"url": "https://ejemplo.com"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/seo/canonical-check",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"url": "https://ejemplo.com"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/seo/canonical-check", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"url":"https://ejemplo.com"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"url":"https://ejemplo.com"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/seo/canonical-check", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Beispiel-Anfrage
{
"url": "https://ejemplo.com"
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "seo.canonical_check",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.
Preis
Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.
Fehler
| HTTP | Code | Bedeutung |
|---|---|---|
401 | unauthorized | Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer). |
402 | insufficient_balance | Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht. |
404 | unknown_type | Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog. |
429 | rate_limited | Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt. |