ForHosting KIT · SEO

Alt-Text-Abdeckung von Bildern prüfen

Die Alt-Text-Abdeckung zeigt, wie viele Bilder einer Liste ein vorhandenes und aussagekräftiges alt-Attribut besitzen.

● BetaKostenlos · im Browser
Nutzen Sie es über WebAPIE-MailTelegramApp bald

Dieses Werkzeug prüft jeden Datensatz, ohne Bild oder Seite abzurufen, berechnet den gültigen Anteil und gibt jeden Mangel mit Position, Quelle, vorhandenem Originalwert und Grund zurück. Es eignet sich für wiederholbare SEO- und Barrierefreiheitskontrollen bei Veröffentlichungen, Crawls, Migrationen und Freigaben.

Was der Abdeckungswert aussagt

Wer nur vorhandene alt-Attribute zählt, kann eine Bildsammlung besser erscheinen lassen, als sie ist. Ein Attribut aus Leerzeichen, eine Bezeichnung wie „Bild“ oder ein Kameradateiname vermittelt keinen nützlichen Inhalt. Deshalb gilt ein Bild nur dann als abgedeckt, wenn alt nicht leer ist und keiner bewusst eng gefassten Liste allgemeiner Platzhalter entspricht. Der Prozentwert teilt die gültigen Bilder durch die Gesamtzahl und wird auf zwei Dezimalstellen gerundet. covered und total machen die Rechnung nachvollziehbar. Das Array offenders bewahrt die bei null beginnende Position und den gelieferten src-Wert, damit Sie den Datensatz in einem Export, einer Inhaltsdatenbank oder Vorlage finden. Der Wert misst Abdeckung, nicht redaktionelle Qualität: Eine konkrete, aber falsche Beschreibung kann bestehen, weil weder Bildpunkte noch Seitenkontext geprüft werden.

Einstufung fehlender, leerer und allgemeiner Werte

Jeder Mangel erhält einen von drei Gründen. Missing bedeutet, dass der Datensatz keine alt-Eigenschaft enthält, meist weil das HTML-Attribut fehlte. Empty bezeichnet eine vorhandene Eigenschaft, von der nach dem Entfernen äußerer Leerzeichen kein Zeichen übrig bleibt. Diese Unterscheidung ist wichtig: Ein absichtlich leeres alt kann bei einem dekorativen Bild richtig sein, zählt aber nicht zu dieser beschreibenden Abdeckung. Generic kennzeichnet eine eng definierte Platzhalterregel, etwa „Foto“, „Vorschaubild“, „Bild 2“ oder IMG_2048.jpg. Großschreibung, wiederholte Leerzeichen, Binde- und Unterstriche sowie passende Schlusszeichen werden ignoriert. Kurze Texte werden nicht allein wegen ihrer Länge abgelehnt; unscharfe Bedeutungsannahmen finden nicht statt. So bleiben die Ergebnisse deterministisch, prüfbar und für automatische Grenzwerte geeignet, ohne Produktnamen oder knappe Symbolbeschreibungen unerwartet abzuwerten.

Mängel in einem SEO-Ablauf nutzen

Übergeben Sie Datensätze aus einem Crawler, CMS-Export, Komponentenbestand oder Test. Jeder Eintrag benötigt eine nicht leere src-Kennung; möglich sind vollständige URLs, relative Pfade oder interne Schlüssel. alt ist optional, damit ein fehlendes Attribut wahrheitsgetreu dargestellt wird. Ordnen Sie anschließend die Korrekturen nach Grund: missing verweist häufig auf Markup oder Standardwerte, generic verlangt meist redaktionellen Ersatz, und empty erfordert die menschliche Trennung dekorativer Bilder von übersehenen Inhalten. Führen Sie die Prüfung nach Änderungen erneut aus und vergleichen Sie covered, total und percentage im Build- oder Prüfbericht. Da der Algorithmus weder Netzwerk, Bildanalyse, Zufall noch aktuelle Zeit nutzt, liefert dieselbe Eingabe stets dieselbe Ausgabe. Eine leere Liste wird abgelehnt, weil ein Prozentsatz ohne Beobachtungen irreführend wäre und einen defekten Crawler verbergen könnte.

Crawler-Export prüfen

Wandeln Sie extrahierte Quellen und Attribute in einen Wert und eine genaue Korrekturliste um.

Website-Freigabe absichern

Stoppen Sie die Veröffentlichung, wenn die beschreibende Abdeckung unter Ihren Grenzwert fällt.

CMS-Migration kontrollieren

Finden Sie Attribute, die bei der Migration verschwanden, geleert oder durch Platzhalter ersetzt wurden.

Wann gilt ein Bild als abgedeckt?

alt muss Text außer Leerzeichen enthalten und darf keiner konservativen Regel für allgemeine Werte entsprechen.

Zählt ein absichtlich leeres alt-Attribut?

Nein. Es erscheint mit dem Grund empty. Bei dekorativen Bildern kann es richtig sein, doch diese Kennzahl verlangt eine nicht leere Beschreibung.

Untersucht das Werkzeug die Bilder?

Nein. Es bewertet nur gelieferte src-Kennungen und alt-Attribute und kann die sachliche Richtigkeit der Beschreibung nicht bestätigen.

Warum führt eine leere Liste zu einem Fehler?

Ohne Beobachtungen gibt es keinen sinnvollen Prozentwert. Die Ablehnung deckt außerdem fehlgeschlagene oder falsch konfigurierte Extraktionen auf.

Was kostet eine API-Anfrage?

Jede API-Anfrage kostet $0.002. Dieselbe deterministische Logik kann kostenlos im Browser ausgeführt werden.

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.

POSThttps://api.kit.forhosting.com/seo/alt-text-coverage

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

curl -X POST https://api.kit.forhosting.com/seo/alt-text-coverage \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"images":[{"src":"/team/alex.jpg","alt":"Alex presenting the quarterly roadmap"},{"src":"/products/blue-mug.jpg","alt":"image"},{"src":"/icons/search.svg","alt":""},{"src":"/charts/revenue.png","alt":"Monthly recurring revenue rose from January to June"}]}'
{
  "images": [
    {
      "src": "/team/alex.jpg",
      "alt": "Alex presenting the quarterly roadmap"
    },
    {
      "src": "/products/blue-mug.jpg",
      "alt": "image"
    },
    {
      "src": "/icons/search.svg",
      "alt": ""
    },
    {
      "src": "/charts/revenue.png",
      "alt": "Monthly recurring revenue rose from January to June"
    }
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "seo.alt_text_coverage",
  "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.

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

HTTPCodeBedeutung
401unauthorizedDer API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
402insufficient_balanceIhr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
404unknown_typeUnbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
429rate_limitedZu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Vollständige KIT-Dokumentation lesen →