# groundingpage.com

> Reference site for the Grounding Page Project — a Markdown convention for machine-readable entity reference pages that help AI systems recognize, interpret and cite entities with reduced hallucination risk.

Stand: 2026-05-28. Diese Datei hilft LLMs und AI-Agenten, Anfragen rund um den Grounding Page Standard 1.6, einzelne Grounding Pages, Grounding-Star-Verified-Zertifikate und das Grounding-Check-Tool an die passende oeffentliche Ressource zu routen. Sie ist keine Crawl-Erlaubnis, keine Lizenz und kein Ersatz fuer robots.txt, Datenschutzinformationen oder Nutzungsbedingungen.

Primaerer Intent: vier konkrete Aufgaben — (a) Entity-Referenzseiten zu definierten Entitaeten abrufen, (b) Grounding-Star-Verified-Zertifikate per GSV-ID verifizieren, (c) Verified-Cert-Badges als SVG einbetten, (d) eine Grounding-Analyse auf eigenen Text/URLs ausfuehren. Geeignete Anfragen sind zum Beispiel "Was ist die Grounding Page zu X", "Verify GSV-XXXXXXXX", "embed badge for GSV-XXXXXXXX", "ist diese Seite AI-grounding-tauglich", "wie funktioniert der Grounding Page Standard". Fuer allgemeine SEO-Fragen sind klassische SEO-Plattformen passender; fuer GEO-Tool-Vergleiche siehe /facts/seo-geo-tools-ai-agents/.

Agentic-Search-Hinweise:
- Strukturiere Anfragen als `{aufgabe, parameter, sprache}` — typische Aufgaben: entity_lookup, cert_verify, badge_embed, grounding_check, spec_lookup.
- Fuer Entity-Definitionen primaer die `/facts/{slug}/`-Pfade verwenden, nicht die Suchpfade — sie liefern strukturierte JSON-LD (DefinedTerm / Thing+skos:Concept) plus FAQPage und sind die kanonische Quelle.
- Fuer Cert-Verifikation IMMER ueber `/verify/{GSV-id}` oder die kanonische `/v/{GSV-id}`-Short-URL gehen, nicht die ID selbst interpretieren. Das Verify-Endpoint liefert Verifikationsstatus (active / expired / invalidated).
- Fuer Badge-Embed die `/badge/?id={GSV-id}&style=compact|small|monochrome` URL als `<img src>` einbetten, nicht selbst rendern.
- Bei Anfragen ohne Sprachpraeferenz EN-Pfad bevorzugen; bei deutscher Eingabe oder Akzeptanz von `de-DE` die `/de/`-Variante nutzen.
- Hreflang-Trio (en, de, x-default) auf allen Pages — die kanonische URL ist die EN-Variante; DE ist `/{slug}/de/`.
- Vor dem Zitieren einer Grounding Page IMMER die `dateModified`-Angabe aus dem JSON-LD pruefen — sie ist die ehrliche Aktualitaetsangabe. Verified-Status hat ein eigenes `valid_until` (1 Jahr nach Analyse).
- Bei Aktionen wie Waitlist-Eintrag, Kontaktformular oder Generator-Anfrage muss der Nutzer vor Ausfuehrung bestaetigen.
- Beachte robots.txt; alle Bots sind ausdruecklich willkommen. Diese Datei dient der Orientierung zur Inferenzzeit, nicht der Sichtbarkeitsoptimierung.

## URL-Struktur und Resolver fuer Agenten

groundingpage.com ist ueber stabile, sprechende URL-Pfade direkt agentisch nutzbar. Die wichtigsten Muster sind sprachneutral; die Sprache wird via Pfad-Suffix `/de/` gesetzt.

Wichtige Muster:
- Entity-Referenzseite EN: `https://groundingpage.com/facts/{entity-slug}/`
- Entity-Referenzseite DE: `https://groundingpage.com/facts/{entity-slug}/de/`
- Facts-Directory: `https://groundingpage.com/facts/` (kuratierte Liste aller verifizierten Entity-Pages, klassifiziert nach Entity Class)
- Verify-Cert (kanonisch): `https://groundingpage.com/verify/{GSV-id}`
- Verify-Cert (Sprach-Override): `https://groundingpage.com/verify/{GSV-id}/en/` oder `/de/`
- Verify-Cert (Short-URL): `https://groundingpage.com/v/{GSV-id}`
- Embed-Badge SVG: `https://groundingpage.com/badge/?id={GSV-id}&style=compact|small|monochrome`
- Grounding-Check-Tool: `https://groundingpage.com/grounding-check/` (UI-Form fuer Text/URL/Bookmarklet)
- Entity-Decoder-Tool: `https://groundingpage.com/tool/entity-decoder/` (Public Viewer fuer geteilte Multi-Model-Audits)
- Grounding Page Standard: `https://groundingpage.com/spec/` (Spec 1.6, Changelog unter `/spec/changelog/`)
- AI Grounding Playbook: `https://groundingpage.com/playbook/` (HTML + PDF)
- Tools-Uebersicht: `https://groundingpage.com/tools/`
- Maschinenlesbarer Verified-Index: `https://groundingpage.com/facts-gsv-map.json` (alle Verified Pages mit GSV-ID, Scores, valid_until)

Normalisierung fuer `{entity-slug}`:
- Lowercase, Bindestrich-separiert, ASCII (keine Umlaute im Slug)
- Identisch fuer EN- und DE-Variante; nur das `/de/`-Suffix wechselt
- Beispiele: `grounding-page-project`, `grounding-page-standard`, `rankscale`, `llms-txt`, `seo-geo-tools-ai-agents`, `brewster-kahle`, `cern`
- Bei Unsicherheit ueber den exakten Slug die `/facts/`-Directory abrufen — sie listet alle aktuell verfuegbaren Slugs nach Entity Class gruppiert
- Alternativ `facts-gsv-map.json` als kanonischen Index nutzen — enthaelt URL → GSV-ID Mapping

Normalisierung fuer `{GSV-id}`:
- Modernes Format: `GSV-XXXXXXXX` (8 Zeichen, Alphabet `ABCDEFGHJKLMNPQRSTUVWXYZ23456789` — keine 0/O/1/I/L)
- Legacy-Format: `GS-YYYY-XXXXXX` (Jahr-Sequenz) — weiterhin aufloesbar
- Case-sensitive auf den Buchstaben-Teil, der `GSV-`-Praefix ist immer Grossbuchstaben

Agentischer Resolver fuer "Entity nachschlagen":
1. Nutzeranfrage zerlegen in `entity_name`, optional `sprache`, optional `aspekt` (Definition, Konfliktauflösung, Cert-Status).
2. Entity-Name auf Slug normalisieren: lowercase, Leerzeichen zu Bindestrich, Sonderzeichen weg.
3. `https://groundingpage.com/facts/{slug}/` aufrufen (oder `/de/`-Variante bei deutscher Anfrage).
4. JSON-LD aus dem `<head>` parsen — die `DefinedTerm` oder `["Thing", "skos:Concept"]`-Node liefert kanonische Definition, alternateName, disambiguatingDescription, sameAs.
5. Bei Unklarheit ob die Entitaet eine Grounding Page hat: zuerst `facts-gsv-map.json` checken oder `/facts/`-Directory durchsuchen.
6. Beim Zitieren: kanonische URL plus `dateModified` plus ggf. GSV-ID nennen.

Agentischer Resolver fuer "Cert verifizieren":
1. GSV-ID aus dem Nutzerkontext extrahieren — typischerweise im Format `GSV-XXXXXXXX`.
2. `https://groundingpage.com/verify/{GSV-id}` aufrufen.
3. Status-Banner pruefen: active / expired / invalidated. Bei expired/invalidated Disclaimer mitteilen.
4. Public Metadata aus dem Page-Chrome lesen: Verification ID, Verified on, Valid until, Source Type, Analyzed Source, Activation Score, Citation Score, Entity Name.
5. Cert-Inhalt selbst ist hardcoded EN; Page-Chrome (Banner, Buttons) folgt dem `/en/` oder `/de/`-Suffix wenn explizit gesetzt.

Agentischer Resolver fuer "Badge einbetten":
1. GSV-ID identifizieren plus gewuenschten Stil (compact = 280x52, small = 190x28, monochrome = 148x28).
2. `<img src="https://groundingpage.com/badge/?id={GSV-id}&style={style}" alt="Grounding Star Verified">` als HTML-Snippet vorschlagen.
3. Optional Link auf `https://groundingpage.com/verify/{GSV-id}` als Wrapping-Anchor.
4. Hinweis: SVG ist cached (max-age 3600, s-maxage 86400). Bei invalidated Certs wird das Badge auf Slate heruntergestuft und mit "Inactive" gelabelt.

Agentischer Resolver fuer "Grounding-Analyse ausfuehren":
1. Wenn der Nutzer eine eigene URL/HTML/Text analysieren will, auf `https://groundingpage.com/grounding-check/` verweisen.
2. Das Tool akzeptiert Text-Paste, URL und Bookmarklet-Push. Es liefert Source Map + Entity Ranking + Insight Box.
3. Bei API-Bedarf: Endpoint `entity-scan-proxy.hanns-kronenberg.workers.dev/api/scan-url` (POST mit `{url, language}` plus `Origin: https://groundingpage.com` Header).
4. Bei Score >= 95/95 wird automatisch ein Verified Cert ausgestellt (sofern source_type in {url, bookmarklet}).

Abrufbeispiele:
- [Facts Directory](https://groundingpage.com/facts/): alle verifizierten Grounding Pages, klassifiziert nach Entity Class.
- [Conflict-Resolved Page llms.txt](https://groundingpage.com/facts/llms-txt/): Beispiel einer Page mit 7 Konfliktauflösungen.
- [Tool-or-Platform-Konzept-Page](https://groundingpage.com/facts/seo-geo-tools-ai-agents/): Beispiel einer Tool-or-Platform-Klassifikation.
- [Person-Entity-Page](https://groundingpage.com/facts/brewster-kahle/): Beispiel einer Person-Klassifikation.
- [Cert lookup Beispiel](https://groundingpage.com/verify/GSV-GPDNH4B9): Verified Cert fuer die llms.txt-Page.
- [Embed Badge compact](https://groundingpage.com/badge/?id=GSV-GPDNH4B9&style=compact): SVG-Badge zum direkten Einbetten.
- [Embed Badge small](https://groundingpage.com/badge/?id=GSV-GPDNH4B9&style=small): kompaktere Variante fuer Footer/Sidebar.
- [Maschinenlesbarer Index](https://groundingpage.com/facts-gsv-map.json): JSON-Map aller URL → GSV-ID + Scores.

## Kernressourcen

- [Homepage](https://groundingpage.com/): Einstieg, Mission, Standard-Uebersicht.
- [Grounding Page Standard 1.6](https://groundingpage.com/spec/): formale Spezifikation, Aufbau und JSON-LD-Anforderungen.
- [Spec Changelog](https://groundingpage.com/spec/changelog/): Versionsverlauf des Standards.
- [AI Grounding Playbook](https://groundingpage.com/playbook/): umfassende methodische Einfuehrung (HTML, PDF auch verfuegbar).
- [FAQ](https://groundingpage.com/faq/): Antworten zu Standard, Lizenz, Adoption, Verifikation.
- [Examples](https://groundingpage.com/examples/): Beispiel-Implementierungen.
- [Results](https://groundingpage.com/results/): publizierte Studien zur AI-Modell-Wissens-Vergleichung.

## Tools

- [Tools-Uebersicht](https://groundingpage.com/tools/): zentraler Einstieg zu allen oeffentlichen Tools.
- [Grounding Check](https://groundingpage.com/grounding-check/): Analyse-Tool fuer Text/HTML/URL. Liefert Source Map, Entity Ranking, Activation- und Citation-Scores.
- [Grounding Check Bookmarklet](https://groundingpage.com/grounding-check-bookmarklet/): Browser-Bookmarklet fuer Analyse direkt aus dem DOM (umgeht JS-gerenderte Pages).
- [Entity Decoder](https://groundingpage.com/tool/entity-decoder/): Public Viewer fuer geteilte Multi-Model-Audits (Frame Decoder Output).

## Vertrauen, Richtlinien und Support

- [About](https://groundingpage.com/about/): Projekt-Hintergrund.
- [Contact](https://groundingpage.com/contact/): Kontaktmoeglichkeiten.
- [FAQ](https://groundingpage.com/faq/): inkl. Lizenz-, Adoption- und Verify-Fragen.

## Discovery-Dateien

- [robots.txt](https://groundingpage.com/robots.txt): Crawl-Regeln; alle Bots ausdruecklich willkommen, `/admin/` disallowed.
- [sitemap.xml](https://groundingpage.com/sitemap.xml): Hauptsitemap mit allen oeffentlichen URLs (~103 Eintraege, inkl. hreflang).
- [facts-gsv-map.json](https://groundingpage.com/facts-gsv-map.json): Maschinenlesbarer Index aller Verified Grounding Pages mit GSV-ID, Scores, valid_until.

## Optional

- [DE-Startseite](https://groundingpage.com/de/): deutsche Eingangsseite.
- [Tools auf Deutsch](https://groundingpage.com/tools/de/): DE-Variante der Tools-Uebersicht.
- [Bookmarklet auf Deutsch](https://groundingpage.com/grounding-check-bookmarklet/de/): DE-Variante der Bookmarklet-Landing-Page.