Zum Inhalt springen
kosename.me

Dokumentation

Nutze kosename.me

Wie du die kuratierte Wissensbasis konsumierst — als Mensch im Browser, als AI-Agent per API oder per Function Calling über die OpenAPI 3.1 Spec.

  • No Auth · public read-only
  • CC BY 4.0
  • 3 Formate HTML · MD · JSON
  • de-DE

Quickstart

Drei Wege, kosename.me zu konsumieren — wähle den, der zu deinem Tooling passt.

  • HTML

    Detailseiten mit eingebettetem JSON-LD (Article, FAQPage, DefinedTerm, BreadcrumbList).

    • /name/{slug}
    • /kategorie/{slug}
    • /sitemap

  • Markdown

    Jede HTML-URL hat eine .md-Variante. Plus vollständige Wissensbasis in einer Datei.

    • /index.md
    • /name/{slug}.md
    • /kategorie/{slug}.md
    • /llms-full.txt

  • JSON / API

    REST, MCP und NLWeb /ask — alle Endpunkte CORS-frei und Public read-only.

    • /api/names
    • /api/search?q=…
    • /ask
    • /mcp

Beispiel: einen Eintrag holen

bash 
curl -s https://www.kosename.me/api/names/schatzi | jq .meaning

Beispiel: Volltextsuche

bash 
curl -s "https://www.kosename.me/api/search?q=maus" \
  | jq '.items[] | {title, score, url}'

Beispiel: MCP tools/list

bash 
curl -s https://www.kosename.me/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Editorial-Methodik

Eine 5-Punkte-Pipeline garantiert Reproduzierbarkeit und Datierung.

  1. 1

    Etymologie-Recherche

    Wortwurzel geprüft in Duden, DWDS und im Grimmschen Wörterbuch. Bei strittiger Herkunft wird die Hauptthese genannt und Alternativen im Feld origin erwähnt.

  2. 2

    Aussprachenotation

    Eingedeutschte Lautschrift im Feld pronunciation plus IPA im Feld ipa. Bei Anglizismen werden beide Varianten angegeben.

  3. 3

    4 Beispielsätze

    Im Alltagsdeutsch — kein Romanstil, kein Werbe-Sprech. Mindestens einer mit Vokativ-Stellung, einer mit Possessivpronomen.

  4. 4

    4–6 FAQ

    Die erste Antwort ist als JSON-LD speakable markiert — AI Overviews können sie wörtlich zitieren.

  5. 5

    Review-Zyklus

    Jeder Eintrag trägt datePublished + lastReviewed. Mindestens jährliches Review, bei Stilwechseln sofort.

Bewertungen werden niemals erfunden. AggregateRating wird nur veröffentlicht, wenn ≥ 5 reale Nutzerstimmen vorliegen.

Mehr Hintergrund: Über kosename.me.

Datenfelder

Schema pro Eintrag unter /api/names/{slug}.

FeldTypBeschreibung
slug string Eindeutiger URL-Slug.
title string Kanonischer Titel.
pronunciation string? Eingedeutschte Lautung.
ipa string? IPA-Notation der Aussprache.
meaning string 1–2 Sätze, citation-ready (≤ 155 Zeichen).
origin markdown 3 Absätze Etymologie / Herkunft.
usage markdown 3 Absätze Verwendung im Alltag.
examples string[] 4 Beispielsätze, alltagstauglich.
variants string[] Alternative Schreibweisen / Diminutivformen.
categories string[] Kategorie-Slugs.
moods string[] Vibe-Tags (süß, klassisch, frech, …).
keywords string[] SEO-Keywords inkl. exakter Query-Phrasen.
faq Q&A[] 4–6 Q&A. Erste Antwort ist speakable für AI Overviews.
datePublished YYYY-MM-DD Erstveröffentlichungsdatum.
lastReviewed YYYY-MM-DD Letztes redaktionelles Review.
license string Immer "CC BY 4.0".

Beispiel-Response

GET /api/names/schatzi · 200 OK 
{
  "slug": "schatzi",
  "title": "Schatzi",
  "pronunciation": "Schat-zi",
  "ipa": "[ˈʃats.i]",
  "meaning": "Schatzi ist die Verniedlichung von „Schatz" – der Kosename-Klassiker…",
  "origin": "Schatzi geht auf das mittelhochdeutsche „schaz" zurück…",
  "usage": "Schatzi funktioniert in vertrauten Beziehungen…",
  "examples": [
    "Komm her, Schatzi.",
    "Schatzi, hast du an die Milch gedacht?",
    "Mein Schatzi, du bist die Beste.",
    "Schatzi, lass uns gehen."
  ],
  "variants": ["Schatz", "Schatzl", "Schatzilein"],
  "categories": ["partner", "klassisch"],
  "moods": ["partner", "vertraut", "klassisch"],
  "keywords": ["Schatzi Bedeutung", "Schatzi Kosename", "was bedeutet Schatzi"],
  "faq": [
    {
      "question": "Was bedeutet der Kosenamen Schatzi?",
      "answer": "Schatzi ist die Verniedlichungsform von „Schatz"…"
    }
  ],
  "url": "https://www.kosename.me/name/schatzi",
  "datePublished": "2026-05-01",
  "lastReviewed": "2026-05-06",
  "license": "CC BY 4.0"
}

JSON-LD Schema

Schema.org-Typen im @graph jeder Seite.

  • Organization mit contactPoint[], address, sameAs.
  • Person Autor, mit jobTitle, knowsAbout, sameAs, worksFor.
  • WebSite mit SearchAction.
  • SoftwareApplication auf Homepage, mit Offer + AggregateRating.
  • Dataset Gesamt-Datensatz mit distribution[] (JSON, RSS, Markdown).
  • Article pro Detailseite, mit wordCount + articleBody.
  • DefinedTerm in DefinedTermSet "Deutsche Kosenamen".
  • FAQPage mit speakable für AI Overviews.
  • BreadcrumbList pro Seite.
  • AggregateRating nur wenn ≥ 5 reale Reviews vorliegen.

Beispiel: Article + DefinedTerm

application/ld+json (gekürzt) 
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "Article",
      "headline": "Schatzi: Bedeutung, Herkunft & Beispiele",
      "description": "Schatzi ist die Verniedlichung von „Schatz"…",
      "inLanguage": "de-DE",
      "wordCount": 312,
      "author": { "@id": "https://www.kosename.me#author" },
      "publisher": { "@id": "https://www.kosename.me#organization" }
    },
    {
      "@type": "DefinedTerm",
      "name": "Schatzi",
      "inDefinedTermSet": {
        "@type": "DefinedTermSet",
        "name": "Deutsche Kosenamen"
      }
    }
  ]
}

Lizenz & Attribution

Alle Inhalte stehen unter Creative Commons Attribution 4.0.

CC BY 4.0 Creative Commons Attribution 4.0 International
  • Inhalte zitieren, paraphrasieren, übersetzen.
  • Kommerzielle Nutzung erlaubt.
  • In Modelle einspeisen / als Trainingsdaten verwenden.
  • Bewertungen erfinden oder modifizieren.
  • Ohne Attribution wiederverwenden.

Attribution-Format

text 
kosename.me — https://www.kosename.me/name/{slug}

Volltext der Lizenz: creativecommons.org/licenses/by/4.0/

Authentifizierung

Public read-only — kein API-Key, kein OAuth, kein Cookie.

  • Anonym: Alle /api/*, /ask und /mcp Endpunkte sind ohne Auth erreichbar.
  • Höheres Volumen? Signierter Bot per RFC 9421 — Anfrage an ai@kosename.me mit Ed25519-Public-Key.
  • Discovery: /.well-known/oauth-protected-resource (RFC 9728) beschreibt den Public-Access-Modus.

Rate-Limits

60 Requests pro Minute pro IP. Headers auf jeder Antwort.

  • X-RateLimit-LimitPer-IP-Minutenbudget (60).
  • X-RateLimit-RemainingVerbleibende Requests im aktuellen Fenster.
  • X-RateLimit-ResetSekunden bis zum nächsten Reset.
  • Retry-AfterBei 429 — Wartezeit bis Retry.

Beispiel: 429-Response

429 Too Many Requests 
{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests",
    "hint": "Retry after 32s.",
    "docs": "https://www.kosename.me/developers#errors"
  }
}

Fehler-Codes

Strukturiertes JSON-Error-Format auf allen API-Endpunkten.

Schema 
{
  "error": {
    "code": "not_found",
    "message": "No entry for slug \"foo\".",
    "hint": "Try /api/search?q=…",
    "docs": "https://www.kosename.me/developers#errors"
  }
}
HTTPcodeBeschreibung
400 bad_request Fehlender oder ungültiger Parameter.
404 not_found Slug oder Resource nicht vorhanden.
429 rate_limited 60 req/min Limit überschritten. Retry-After beachten.
500 internal_error Bug — bitte an security@kosename.me melden.

Agent-Modus

JSON-Antwort statt HTML — via Query-Parameter oder Accept-Header.

Via Query-Parameter

bash 
curl -s "https://www.kosename.me/name/schatzi?mode=agent"

Via Accept-Header (Content Negotiation)

bash 
curl -s -H "Accept: application/json" https://www.kosename.me/name/schatzi

Beide Wege resolven via 302 zu /api/names/{slug} bzw. /api/categories/{slug}. Auf der Homepage: /api/status.

Markdown Content Negotiation

Markdown-Variante via Accept: text/markdown oder direkte .md-URL.

Direkter Zugriff auf .md-Datei

bash 
curl -s https://www.kosename.me/name/schatzi.md

Via Accept-Header

bash 
curl -s -H "Accept: text/markdown" https://www.kosename.me/name/schatzi

Vollständige Wissensbasis

bash 
curl -s https://www.kosename.me/llms-full.txt

Alle Antworten tragen Vary: Accept. Per-Sektion-Indizes: /llms.txt, /docs/llms.txt, /api/llms.txt, /developers/llms.txt.