===========================================================
SEO Title Roast & Einwand-Killer
===========================================================

Autor:   TheCodeAtlas.net
Tool:    SEO Title Roast & Einwand-Killer
Version: 1.0
Lizenz:  je nach Shop- / Download-Angabe (z. B. Free / kleines Tool)


-----------------------------------------------------------
1. Überblick
-----------------------------------------------------------

Dieses kleine SEO-Tool analysiert den <title>-Tag und die
Meta-Description einer URL und gibt dir eine ehrliche Einschätzung:

- Fehlt der Title komplett?
- Ist er viel zu kurz oder viel zu lang?
- Steht dort nur etwas Generisches wie „Startseite“ oder „Home“?
- Fehlt die Description oder ist sie völlig überladen?

Statt nur Zahlen zu zeigen, liefert das Tool zusätzlich:

- einen typischen „SEO ist doch egal“-Einwand
- eine leicht provokante Antwort darauf
- mindestens ein konkretes Praxisbeispiel für bessere Titles / Descriptions

Ideal für:

- eigene Projekte und Landingpages
- schnelle SEO-Checks
- Argumentationshilfe gegenüber Kunden („deshalb sollten wir den Title ändern“)


-----------------------------------------------------------
2. Funktionen im Überblick
-----------------------------------------------------------

- URL-Eingabe:
  - Eingabe mit oder ohne https:// möglich
  - Das Tool ergänzt https:// automatisch, falls nötig

- HTML-Abruf:
  - per cURL (GET-Request)
  - es wird nur der HTML-Quelltext geladen, kein schwerer Crawler

- Meta-Parsing:
  - <title>-Tag
  - <meta name="description" content="...">
  - Länge (Zeichenanzahl) von Title & Description

- Bewertung / Analyse:
  - kein Title gefunden
  - Title sehr kurz
  - Title sehr lang (potenziell abgeschnitten in den SERPs)
  - generische Titles (z. B. „Startseite“, „Home“, „Willkommen“)
  - keine Description
  - Description zu kurz oder zu lang

- Ausgaben:
  - Übersicht der erkannten Probleme (Badges)
  - „typischer Einwand“ (z. B. „Google baut sich das schon selbst zusammen“)
  - „Antwort“ im leicht provokanten, aber sachlichen Ton
  - konkrete Beispiel-Titles / Descriptions zur Inspiration

- UI:
  - modernes Dark-Theme im TheCodeAtlas-Stil
  - 2-spaltiges Layout: links URL-Eingabe, rechts Analyse
  - responsive dank Bootstrap 5


-----------------------------------------------------------
3. Installation
-----------------------------------------------------------

1) Datei hochladen
   - Lege die PHP-Datei z. B. als
     seo_title_roaster.php
     ab.

   - Typischer Pfad:
     /seo-title-roaster/seo_title_roaster.php

2) Aufruf im Browser
   - https://deine-domain.de/seo-title-roaster/seo_title_roaster.php

3) Optional:
   - Eintrag in deine zentrale Tool-Übersicht / Navigationsseite.


-----------------------------------------------------------
4. Systemvoraussetzungen
-----------------------------------------------------------

- Webserver mit:
  - PHP 7.4 oder höher (empfohlen: PHP 8+)
  - cURL-Erweiterung aktiviert

- Keine Datenbank notwendig
- Ausgehende HTTP-Requests müssen erlaubt sein, damit die URL
  abgerufen werden kann (Firewall / Hosting beachten).


-----------------------------------------------------------
5. Nutzung
-----------------------------------------------------------

1. Seite im Browser öffnen.
2. URL eingeben:
   - z. B. https://thecodeatlas.net/
   - oder: thecodeatlas.net (https:// wird ergänzt)
3. Auf „Prüfen & roasten“ klicken.
4. Das Tool lädt den HTML-Quelltext und zeigt:
   - aktuellen Title + Länge
   - aktuelle Meta-Description + Länge
   - erkannte Probleme (Badges)
   - typischer Einwand
   - Antwort (leicht provokant)
   - Beispiel-Titel/Description als Anregung

5. Ergebnisse interpretieren:
   - Wenn viele Warnungen auftauchen, lohnt sich eine Überarbeitung.
   - Beispieltext kann direkt als Basis für neue Varianten dienen.
   - Für Kunden-& Reports eignet sich das Tool gut als visuelle Hilfe.


-----------------------------------------------------------
6. Anpassungen
-----------------------------------------------------------

- Design:
  - Farben, Schriften und Abstände liegen im <style>-Block der
    PHP-Datei und können direkt angepasst werden.

- Einwand-Texte / Beispiele:
  - Die Texte für Einwände, Antworten und Beispiele sind in der
    Funktion analyseSeo() definiert.
  - Du kannst Formulierungen an dein eigenes Wording anpassen
    oder zusätzliche Fälle ergänzen.

- „Generische Title“-Erkennung:
  - Die Liste der generischen Begriffe (Startseite, Home, Index …)
    lässt sich in analyseSeo() erweitern oder verändern.

- Sprache:
  - Aktuell ist alles auf Deutsch ausgelegt.
  - Für eine englische Version kannst du eine zweite Datei anlegen
    und Texte im Analyse-Block übersetzen/anpassen.


-----------------------------------------------------------
7. Rechtliches & Hinweise
-----------------------------------------------------------

- Dieses Tool ist ein Hilfsmittel für SEO-Checks und ersetzt keine
  umfassende professionelle Analyse.
- Es werden keine Daten dauerhaft gespeichert; das HTML wird nur
  für die unmittelbare Auswertung genutzt.
- Nutzung auf eigene Verantwortung. Der Autor übernimmt keine Haftung
  für Schäden, die aus Nutzung oder Nichtnutzung resultieren.
