Zum Inhalt springen
covey

Eine Seite erklärt im Kopf ihres HTML-Dokuments selbst, unter welcher Adresse sie gefunden werden will. Ein Agent für die Suchmaschinenoptimierung kann diesen Canonical dort ablesen und für https://example.com/blog/agenten feststellen, dass die Seite genau diese Adresse deklariert. Ob Google derselben Angabe gefolgt ist, steht allerdings an keiner Stelle der Seite.

Von außen ist die Wahl von Google unsichtbar

Google kann als Canonical eine andere Adresse wählen als die deklarierte. Die Beschreibung des Search-Console-Plugins im covey-Plugin-Pack nennt diesen Fehler von außen unsichtbar und sagt, dass er die Adresse still kostet. Ein Agent, der Titel, Canonical und hreflang liest, sieht deshalb allein die Hälfte, die die Seite über sich selbst sagt.

Die andere Hälfte kennt Google, und erreichbar ist sie über die URL Inspection API der Search Console. Deren Antwort führt zwei Felder nebeneinander: userCanonical für die deklarierte Adresse und googleCanonical für die von Google ausgewählte. Laut Schnittstellenbeschreibung von Google fehlt googleCanonical bei einer nicht indexierten Seite und userCanonical bei einer Seite ohne deklarierte Adresse.

Die Aktion inspect_url stellt beide Canonicals nebeneinander

In covey ruft das Plugin searchconsole diese Schnittstelle über die Aktion inspect_url auf. Jeder Aufruf untersucht genau eine Adresse. Der Agent schickt dazu {"inspection_url":"https://example.com/blog/agenten"}. Die Property ergänzt das Plugin aus dem Eintrag searchconsole_url, sofern der Agent keine eigene site_url mitgibt. Die Meldungen fordert das Plugin auf Deutsch an, solange der Aufruf keinen anderen Sprachcode nennt.

Zurück kommen google_canonical und user_canonical mit dem Urteil über die Indexierung. Dazu gehören der Abdeckungsstatus, der Stand der robots.txt und der Zeitpunkt des letzten Crawls sowie die bekannten Sitemaps und ein Link auf den Bericht in der Search Console. Damit sieht der Agent für dieselbe Adresse, was die Seite verlangt und was Google daraus gemacht hat.

Die Abweichung spricht das Plugin selbst aus

Zwei Felder nebeneinander überlassen den Befund einem Vergleich, den der Agent selbst ziehen müsste. Der Kommentar im Quelltext verlangt dagegen, dass niemand ihn beim Lesen der Antwort übersehen kann. Sind beide Felder gefüllt und verschieden, legt das Plugin deshalb ein drittes Feld canonical_abweichung an. Es formuliert den Befund als Satz: Google hat die eine Adresse gewählt, die Seite deklariert die andere, und indexiert ist dann eine andere als die deklarierte Adresse.

Die Anleitung des Plugins im Prompt des Agenten verlangt, dieses Feld als Erstes zu lesen.

Wählt Google im Beispiel https://example.com/blog/ki-agenten, während die Seite auf https://example.com/blog/agenten verweist, steht genau dieser Satz in der Antwort. Der Agent kann ihn in seinen Bericht übernehmen. Verglichen wird der Text beider Adressen nach dem Entfernen umgebender Leerzeichen. Schon ein abweichender Schrägstrich am Ende gilt deshalb als Abweichung.

Der Preis ist ein Kontingent von 2000 Aufrufen am Tag

Laut Einrichtungsanleitung des Plugins darf inspect_url 2000 Mal je Property und Tag laufen. Ein täglicher Lauf über eine Website mit 50 Seiten verbraucht davon 2,5 Prozent. Ein Agent, der auf derselben Website jede Adresse alle 15 Minuten untersucht, käme dagegen auf 4800 Aufrufe am Tag. Ist das Kontingent erschöpft, meldet das Plugin den HTTP-Status 429 und nennt die Grenze im Fehlertext. Die Anleitung im Prompt rät dem Agenten, die Aktion auf Adressen mit einer offenen Frage zu richten.

Das Plugin meldet jede Aktion unter einem eigenen Namen wie searchconsole:inspect_url. Eine Guard Rail kann deshalb gerade diese Aktion verbieten oder an eine Freigabe binden. Die übrigen lesenden Aktionen bleiben davon unberührt.

Der Befund braucht beide Felder, die einzige schreibende Aktion meldet Sitemaps

Fehlt eines der beiden Felder, entsteht kein Feld canonical_abweichung. Bei einer nicht indexierten Seite liest der Agent dann das Urteil und den Abdeckungsstatus. Am Canonical selbst ändert der Agent über dieses Plugin nichts, denn dessen einzige schreibende Aktion submit_sitemap meldet Google eine Sitemap.

Der Zugang läuft über ein Dienstkonto und den lesenden Bereich

Eingerichtet wird der Zugang mit einem Dienstkonto. Dessen JSON-Schlüssel liegt unter searchconsole_token, und in der Search Console ist es als Nutzer der Property eingetragen. In der ACCESS.md des Agenten steht dazu die Zeile - system: searchconsole scope: read. Dieser lesende Bereich reicht für die Frage nach dem Canonical. Für https://example.com/blog/agenten hält der Agent danach beide Adressen und den Satz über ihren Unterschied in derselben Antwort.

Zurück zur Übersicht