Verbinden Sie eine eigens erstelle Website mit der SEOAsist Site API

Wenn Ihre Website nicht auf WordPress oder Shopify läuft (Next.js, Laravel, .NET, einfaches PHP…), können Sie eine kleine API hinzufügen und SEOAsist die SEO-Arbeit erledigen lassen. Nach der Verbindung werden Korrekturen für Titel, Beschreibung, Canonical, Robots, strukturierte Daten und Weiterleitungen serverseitig angewendet, Blogbeiträge veröffentlicht und llms.txt bleibt auf dem neuesten Stand. Kein Plugin, keine Pull-Requests.

#Voraussetzungen

• Sie können den Code der Website ändern (selbst, ein Entwickler oder ein KI-Coding-Assistent wie Claude oder Cursor).
• Sie können Umgebungsvariablen für die Website festlegen (.env oder Ihr Hosting-Panel).
• Sie besitzen Bearbeitungsrechte im Panel; andernfalls wird „Sie benötigen Bearbeitungsrechte hierfür.“ angezeigt.

#1. Installieren Sie die API auf Ihrer Website

1. Öffnen Sie die Website unter Websites und wechseln Sie zum Tab Korrektur-Kanäle.
2. Drücken Sie in der Karte SEOAsist Site API (eigens erstellte Websites) ganz oben auf Setup-Prompt.
3. Drücken Sie im Dialogfeld auf Kopieren und übergeben Sie den Text an Claude, Cursor oder den Entwickler, der an Ihrem Projekt arbeitet. Der Prompt enthält die vollständige Spezifikation sowie Details für diese Website (Website-URL, API-Basis-URL und, falls verbunden, das zugehörige GitHub-Repository).
4. Möchten Sie es lieber selbst codieren? Drücken Sie auf Entwickler-Leitfaden. Dieser enthält die Tabs Schritte, Spezifikation, Next.js, PHP und Testen mit Copy-Paste-Code zum Starten.

Ihre Website stellt vier Endpunkte unter einem Basis-Pfad bereit: GET /manifest, PUT /rules, POST /content und PUT /files. Details finden Sie in der Site API Referenz.

#2. Speichern Sie die URL und fügen Sie den Token hinzu

1. Geben Sie die API-Adresse in das Feld API-Basis-URL unten in der Karte ein. Der Standardvorschlag lautet https://<ihre-domain>/api/seoasist.
2. Drücken Sie auf Verbinden. Ein gelbes Feld mit dem Titel Token — wird nur jetzt angezeigt erscheint mit einer Zeile SEOASIST_SITE_TOKEN=sa_….
3. Drücken Sie auf Kopieren und fügen Sie diese Zeile zu den Umgebungsvariablen der Website hinzu. Starten Sie die Website anschließend neu oder führen Sie ein Re-Deployment durch.

#3. Testen Sie die Verbindung

1. Probieren Sie optional zuerst /manifest mit dem curl-Befehl unter Entwickler-Leitfaden → Testen aus.
2. Drücken Sie in der Karte auf Verbindung testen. SEOAsist ruft den Endpunkt /manifest auf und speichert die von Ihrer Website deklarierten Funktionen.
3. Bei Erfolg wird „Verbunden · Funktionen: … · N Regeln gesendet“ angezeigt. Alle aktivierten Regeln, die gewartet haben, werden sofort an die Website übertragen.

#Was passiert automatisch nach dem Verbinden?

Die Statuszeile zeigt die von Ihrer Website deklarierten Funktionen an: SEO-Regeln, Veröffentlichung von Inhalten und llms.txt / robots. Jede funktioniert für sich allein, und SEOAsist nutzt nur diejenigen, die Ihre Website auflistet.

Die Karte enthält außerdem zwei manuelle Schaltflächen: Regeln jetzt senden (N) und llms.txt senden. Die Schaltfläche für llms.txt erfordert, dass zuerst eine llms.txt-Datei im Tab KI-Zugriff generiert wurde.

#Auto-Fix auf der Zustand-Seite

Wenn die Site API mit der Funktion „SEO-Regeln“ verbunden ist, erscheint neben unterstützten Problemen auf der Seite Zustand eine Auto-Fix-Schaltfläche. Unterstützte Probleme: fehlende, zu lange, zu kurze oder doppelte Titel; fehlende, zu lange oder doppelte Meta-Beschreibungen; fehlende Canonicals oder Canonicals, die auf eine andere Seite verweisen; fehlendes html lang; als noindex markierte Seiten. Ein bewusstes noindex (zum Beispiel Tag- oder Thin-Content-Seiten, die sich nicht in der Sitemap befinden) wird durch Auto-Fix niemals auf index umgestellt.

Es werden Werte für die betroffenen Seiten des letzten Crawls (bis zu 40) erstellt. Die KI schreibt Titel und Beschreibungen: für jede Seite in der eigenen Sprache dieser Seite, basierend auf deren eigenem Titel, H1 und Beschreibung; auf mehrsprachigen Websites wird niemals der Titel einer anderen Seite oder Sprache geschrieben. Canonical-, lang- und robots-Werte werden berechnet. Sie werden als Regeln an Ihre Website gesendet und ein Verifizierungscrawl startet. Die erneute Ausführung für dasselbe Problem ersetzt die früheren Regeln. Mehr dazu unter Beabsichtigte Probleme und Auto-Fix.

#Veröffentlichungsregeln und Sprachen

• Erneutes Veröffentlichen desselben Beitrags: Wenn ein Beitrag bereits unter derselben Adresse (gleicher Slug und gleiche Sprache) veröffentlicht wurde, öffnet SEOAsist keine neue -2-Kopie, sondern aktualisiert den bestehenden Beitrag auf der Website.
• Sprachen: Ein Beitrag wird mit der Sprache seines Textes gesendet. Die Site API kann in jeder Sprache der Website veröffentlichen: in der Liste Website-Sprachen, falls Sie eine festgelegt haben, ansonsten in der Primärsprache plus den Sprachen, die Ihre Website als locales in /manifest meldet. Liegt die Sprache des Beitrags außerhalb dieser Werte, wird er nicht veröffentlicht, geht zurück zur Überprüfung und Sie erhalten eine Benachrichtigung „Nicht veröffentlicht, Sprachabweichung: …“. Davor liest SEOAsist das Manifest noch einmal aus; wenn Ihre Website also eine Sprache hinzugefügt hat, müssen Sie nicht erneut testen.
• Seitenaktualisierungen: Die Sprachprüfung betrachtet nur den zu sendenden Seitentext und vergleicht ihn mit der eigenen Sprache der Seite; Eigennamen im Text (Firmen- oder Produktnamen) zählen bei der Spracherkennung nicht. Seitenaktualisierungen werden niemals automatisch veröffentlicht; Sie veröffentlichen diese über den Editor.
• Automatische Veröffentlichung: Geplante und Live-Veröffentlichungen von Autopilot durchlaufen zuerst das Auto-Publish-Gate; ein Beitrag, der dieses nicht besteht, geht mit Angabe der Gründe zur Genehmigung. Die manuelle Veröffentlichung überspringt dieses Gate.
• Kunden-Freigabe: Wenn „Kunden-Freigabe vor Veröffentlichung erforderlich“ für die Organisation aktiviert ist, werden Beiträge und Seitenaktualisierungen über diesen Kanal erst dann live veröffentlicht, wenn der Kunde zustimmt; siehe Kunden-Freigabe.

#Verifizierung

• Die Statuszeile der Karte zeigt ein grünes Verbunden, die Funktions-Tags und „letzter Push N Regeln“.
• Öffnen Sie den Quelltext einer Ihrer Seiten („Seitenquelltext anzeigen“ im Browser). Der angewendete Titel oder die Meta-Beschreibung muss im HTML enthalten sein. Regeln sind dafür gedacht, serverseitig angewendet zu werden, nicht mit clientseitigem JavaScript.
• Wenn etwas fehlschlägt, wird der Status rot (Fehler) und die letzte Fehlermeldung wird in der Karte angezeigt. Siehe Verbindungsprobleme mit der Site API.

#FAQ

#Werden die Regeln auf meiner Website gelöscht, wenn ich die Verbindung trenne?

Nein. Trennen stoppt nur das Senden durch SEOAsist; die auf Ihrer Website gespeicherten Regeln bleiben unverändert erhalten.

#Was passiert, wenn ich die API-URL ändere?

Geben Sie die neue URL ein und drücken Sie auf URL speichern. Der Status ändert sich zu Wartet auf Test; führen Sie Verbindung testen erneut aus. Der Token bleibt gleich.

#Ändert sich meine Website, wenn keine Regeln vorhanden sind?

Das sollte nicht passieren. Die Spezifikation verlangt, dass jede Seite genau so gerendert wird wie bisher, wenn keine Regeln vorhanden sind, und der Setup-Prompt bittet ausdrücklich darum, bestehendes SEO-Verhalten nicht zu beeinträchtigen.

#Wie unterscheidet sich dies vom Pixel?

Sie teilen sich dieselben Regeln. Das Pixel wendet sie im Browser mit JavaScript an; die Site API wendet sie auf Ihrem Server an, sodass Suchmaschinen die Änderung direkt im HTML sehen. Die Site API kann außerdem Beiträge veröffentlichen und llms.txt schreiben.

#Kann ich eine lokale Entwicklungs-URL (localhost) verbinden?

Nein. SEOAsist ruft nur öffentlich erreichbare Adressen auf; localhost und private Netzwerkadressen werden abgelehnt. Installieren Sie die API auf Ihrer Live-Website.