✔ Fertigung ab Stückzahl 1 ✔ Sofortpreis nach Upload ✔ Lieferzeit meist 3 bis 7 Werktage

Teutoprint SEO Assistant – Dokumentation

Der Teutoprint SEO Assistant ist ein AI-gestütztes WordPress-Plugin zur strukturierten Analyse und gezielten Optimierung der internen Verlinkung. Im Fokus stehen nachvollziehbare Ergebnisse, hohe inhaltliche Qualität sowie eine konsequent optimierte Nutzung der OpenAI API zur Minimierung von Tokenkosten.

Das Plugin arbeitet vollständig kontrolliert: Es werden keine Inhalte automatisch verändert. Alle Vorschläge werden zur manuellen Prüfung bereitgestellt.


1. Systemübersicht

Der SEO Assistant besteht aus drei zentralen Komponenten:

  • Analyse-Engine: Lokale Auswertung aller Inhalte ohne API-Nutzung
  • Bewertungslogik: Ermittlung inhaltlicher Zusammenhänge und Prioritäten
  • AI-Generierung: Erstellung konkreter Link- und Textvorschläge über die OpenAI API

Durch diese Trennung wird sichergestellt, dass API-Aufrufe ausschließlich dort erfolgen, wo sie tatsächlich Mehrwert liefern.


2. Funktionsweise im Detail

2.1 Analysephase

Im ersten Schritt wird die gesamte Website strukturiert erfasst. Dabei werden alle relevanten Inhalte (Seiten, Beiträge) analysiert und intern aufbereitet.

Erfasst werden unter anderem:

  • Seitentitel und Inhalte
  • thematische Schwerpunkte
  • bestehende interne Verlinkungen
  • Struktur und Hierarchie

Auf Basis dieser Daten erkennt das System:

  • Seiten ohne interne Verlinkung (Orphan Pages)
  • schwach vernetzte Inhalte
  • thematische Überschneidungen

2.2 Bewertungsphase

Die analysierten Inhalte werden in Beziehung zueinander gesetzt. Dabei entsteht ein internes Modell Ihrer Website-Struktur.

Im Gegensatz zu einfachen SEO-Plugins erfolgt die Bewertung nicht auf Basis einzelner Keywords, sondern über den inhaltlichen Kontext der Seiten.

Ziel ist die Identifikation sinnvoller Verknüpfungen, die sowohl für Suchmaschinen als auch für Nutzer logisch nachvollziehbar sind. —

2.3 Generierungsphase (AI)

Auf Grundlage der Bewertung erzeugt das Plugin konkrete Vorschläge für:

  • interne Verlinkungen
  • passende Anchor-Texte

Die Generierung erfolgt über die OpenAI API, jedoch stark optimiert:

  • reduzierte Prompt-Größe
  • strukturierte Eingabedaten
  • gezielte Nutzung statt Massenanfragen

Das Ergebnis sind präzise, kontextbasierte Vorschläge mit minimalem Tokenverbrauch.


3. Installation

  1. ZIP-Datei des Plugins herunterladen
  2. In WordPress hochladen: Plugins → Installieren → Plugin hochladen
  3. Plugin aktivieren
  4. Einstellungen öffnen

4. Ersteinrichtung

4.1 API-Key hinterlegen

Tragen Sie Ihren OpenAI API-Key in den Plugin-Einstellungen ein. Ohne API-Key ist keine Generierung möglich. —

4.2 Initiale Analyse starten

Nach der Einrichtung sollte eine vollständige Analyse der Website durchgeführt werden. Dieser Vorgang erfasst alle Inhalte und erstellt die interne Datenbasis. —

4.3 Hintergrundverarbeitung

Die weitere Verarbeitung erfolgt über eine interne Queue und wird durch WP-Cron gesteuert. Dadurch werden Timeouts vermieden und große Websites stabil verarbeitet.


5. Bedienung

5.1 Dashboard

Das Dashboard bietet eine Übersicht über:

  • Analysefortschritt
  • Anzahl erkannter Inhalte
  • offene Vorschläge
  • Verarbeitungsstatus

5.2 Vorschläge verwalten

Für jede Seite werden konkrete Vorschläge angezeigt. Jeder Vorschlag enthält:

  • Zielseite
  • Anchor-Text
  • Kontextbezug

Mögliche Aktionen:

  • Übernehmen
  • Bearbeiten
  • Neu generieren
  • Verwerfen

Es erfolgt keine automatische Umsetzung ohne Bestätigung. —

5.3 Filter und Priorisierung

Vorschläge können gezielt gefiltert und priorisiert werden, beispielsweise nach:

  • Seiten
  • Relevanz
  • Status

6. Token-Optimierung

Ein wesentliches Merkmal des Plugins ist die effiziente Nutzung der OpenAI API.

Dies wird erreicht durch:

  • lokale Voranalyse ohne API
  • reduzierte Datenübertragung
  • Wiederverwendung vorhandener Ergebnisse
  • gezielte statt flächendeckender Generierung

Dadurch bleiben die Kosten auch bei größeren Websites kontrollierbar.


7. Caching

Das Plugin speichert Analyse- und Generierungsergebnisse lokal zwischen.

Neue API-Aufrufe erfolgen nur, wenn:

  • Inhalte geändert wurden
  • eine erneute Generierung manuell ausgelöst wird

8. Queue-System

Alle aufwendigen Prozesse werden in eine interne Warteschlange (Queue) überführt.

Die Abarbeitung erfolgt schrittweise im Hintergrund:

  • keine Serverüberlastung
  • keine Timeout-Probleme
  • skalierbar für große Websites

9. Orphan Pages

Seiten ohne interne Verlinkung werden automatisch erkannt und priorisiert behandelt.

Diese Inhalte erhalten gezielte Vorschläge zur Einbindung in die bestehende Struktur.


10. Keyword-Überschneidungen

Das Plugin identifiziert Inhalte mit ähnlichen Themen und potenzieller Konkurrenz untereinander.

Ziel ist eine klare Struktur:

  • Vermeidung interner Konkurrenz
  • gezielte Verlinkung statt Kannibalisierung

11. Sicherheit und Kontrolle

  • keine automatische Inhaltsänderung
  • keine externen Tracking-Dienste
  • vollständige Kontrolle über alle Vorschläge

12. Systemanforderungen

  • WordPress 6.x oder höher
  • PHP 8.0 oder höher
  • gültiger OpenAI API-Key

13. Best Practices

  • zuerst vollständige Analyse durchführen
  • Orphan Pages priorisieren
  • Vorschläge prüfen und gezielt übernehmen
  • bei neuen Inhalten regelmäßig neu analysieren

14. Fehlerbehebung

Keine Vorschläge vorhanden:
Analyse noch nicht abgeschlossen oder Queue läuft noch

API-Fehler:
API-Key prüfen oder Verbindung testen

Langsame Verarbeitung:
WP-Cron prüfen oder echten Cronjob verwenden


15. Lizenz

Dieses Plugin wird unter der GPLv2 bereitgestellt. Anpassungen und Weiterentwicklungen sind zulässig, sofern der ursprüngliche Urheber genannt wird.

<< zurück zu Teutoprint Software