{
  "version": "1.0",
  "schema": "ikeytz-answer-engine-catalog",
  "generated_at": "2026-11-03T06:04:47+02:00",
  "timezone": "Europe/Berlin",
  "content_policy": {
    "ai_train": "no",
    "attribution": "Quelle: Schlüsseldienst Ludwigsburg ikeytz (ikeytz.com)",
    "policy_url": "https://tueroeffnung.ikeytz.com/.well-known/ai.txt"
  },
  "description": "Bedienungs-Katalog der ikeytz Answer Engine: wie man sucht und liest (ähnlich MCP tools/list — aber HTTP GET, kein tools/call). Antworttexte stehen in answer-engine-{locale}.json; dieser Katalog erklärt nur die API.",
  "index": "https://tueroeffnung.ikeytz.com/.well-known/answer-engine.json",
  "not_mcp": "Dies ist kein MCP-Server. Für Tool-Aufrufe: https://tueroeffnung.ikeytz.com/mcp (www) und https://maps.ikeytz.com/mcp (maps).",
  "operations": [
    {
      "name": "get_index",
      "method": "GET",
      "url": "https://tueroeffnung.ikeytz.com/answer",
      "aliases": [
        "https://tueroeffnung.ikeytz.com/.well-known/answer-engine.json",
        "https://tueroeffnung.ikeytz.com/answer-engine.json",
        "https://tueroeffnung.ikeytz.com/ai-answer",
        "https://tueroeffnung.ikeytz.com/api/answer"
      ],
      "description": "Ohne Query-Parameter q: liefert den schlanken Index (<30 KB) — Business, Typ-Counts, Locale-Datei-URLs, API-Beispiele, catalog-Pointer. Keine Antworttexte.",
      "parameters": [],
      "response": {
        "content_type": "application/json",
        "shape": "ikeytz-answer-engine-index"
      }
    },
    {
      "name": "search",
      "method": "GET",
      "url": "https://tueroeffnung.ikeytz.com/answer",
      "description": "Kundenfrage suchen. Liefert Treffer mit short-Antwort, URL und actions (Anrufen, WhatsApp, ggf. contact_prefab mit WA/mailto/SMS).",
      "parameters": [
        {
          "name": "q",
          "in": "query",
          "required": true,
          "type": "string",
          "description": "Suchfrage in Kundensprache. Leerer String → HTTP 400. Ohne Parameter q → Index (get_index), nicht Suche."
        },
        {
          "name": "lang",
          "in": "query",
          "required": false,
          "type": "string",
          "enum": [
            "de",
            "en",
            "fr",
            "fa",
            "ru",
            "tr",
            "ar"
          ],
          "default": "de (oder Accept-Language)",
          "description": "Antwort-Locale (de|en|fr|fa|ru|tr|ar). Ohne lang: Accept-Language, sonst de. Unbekanntes lang (z. B. lang=xx) → HTTP 400 invalid_lang (kein stilles Deutsch)."
        },
        {
          "name": "limit",
          "in": "query",
          "required": false,
          "type": "integer",
          "default": 3,
          "minimum": 1,
          "maximum": 10,
          "description": "Max. Treffer."
        },
        {
          "name": "type",
          "in": "query",
          "required": false,
          "type": "string",
          "description": "Optionaler Typ-Filter (Werte aus list_types, z. B. preis, ort, kontakt, notfall) plus Aliase seite|basis. Unbekannter type → HTTP 400 invalid_type (kein Zufallstreffer)."
        }
      ],
      "response": {
        "content_type": "application/json",
        "fields": [
          "ok",
          "q",
          "lang",
          "results[]",
          "attribution",
          "policy"
        ],
        "result_item_fields": [
          "id",
          "score",
          "type",
          "question",
          "short",
          "url",
          "actions",
          "map",
          "in_service_area",
          "fallback"
        ],
        "errors": [
          "empty_q → 400",
          "invalid_lang → 400 + allowed[]",
          "invalid_type → 400 + allowed[] + types_url"
        ]
      },
      "examples": [
        "https://tueroeffnung.ikeytz.com/answer?q=kommt+ihr+nach+tamm&lang=de",
        "https://tueroeffnung.ikeytz.com/answer?q=how+much+at+night&lang=en",
        "https://tueroeffnung.ikeytz.com/answer?q=WhatsApp%3F&lang=de&limit=3",
        "https://tueroeffnung.ikeytz.com/answer?q=gece+kapı+açma+fiyatı&lang=tr"
      ],
      "notes": [
        "POST → 405.",
        "Rate-Limit nur bei gesetztem q.",
        "X-Robots-Tag: noindex auf Suchantworten.",
        "Ort+Leistung/Zeit kann seite.* vor ort.* ranken (AE-30).",
        "AE-33: invalid lang/type → 400, kein stilles DE / kein Zufalls-Kontakt."
      ]
    },
    {
      "name": "get_by_id",
      "method": "GET",
      "url": "https://tueroeffnung.ikeytz.com/answer/{id}",
      "description": "Einen Eintrag inkl. answer/actions per ID laden (Stufe 1 oder Treffer-Metadaten).",
      "parameters": [
        {
          "name": "id",
          "in": "path",
          "required": true,
          "type": "string",
          "description": "z. B. kontakt.whatsapp, preis.opening_slam.day, ort.tamm"
        },
        {
          "name": "lang",
          "in": "query",
          "required": false,
          "type": "string",
          "enum": [
            "de",
            "en",
            "fr",
            "fa",
            "ru",
            "tr",
            "ar"
          ],
          "default": "de",
          "description": "Locale. Unbekanntes lang → HTTP 400 invalid_lang."
        }
      ],
      "examples": [
        "https://tueroeffnung.ikeytz.com/answer/kontakt.whatsapp?lang=de",
        "https://tueroeffnung.ikeytz.com/answer/preis.opening_slam.day?lang=de"
      ]
    },
    {
      "name": "list_types",
      "method": "GET",
      "url": "https://tueroeffnung.ikeytz.com/answer/types",
      "description": "Typen → Anzahl + ID-Liste (ohne Antworttexte). Zusätzlich filter_aliases: seite|basis für search type=.",
      "parameters": [
        {
          "name": "lang",
          "in": "query",
          "required": false,
          "type": "string",
          "enum": [
            "de",
            "en",
            "fr",
            "fa",
            "ru",
            "tr",
            "ar"
          ],
          "description": "Locale. Unbekanntes lang → HTTP 400 invalid_lang."
        }
      ],
      "examples": [
        "https://tueroeffnung.ikeytz.com/answer/types"
      ]
    }
  ],
  "files": {
    "index": "https://tueroeffnung.ikeytz.com/.well-known/answer-engine.json",
    "catalog": "https://tueroeffnung.ikeytz.com/.well-known/answer-engine-catalog.json",
    "catalog_alias": "https://tueroeffnung.ikeytz.com/answer-engine-catalog.json",
    "locale_answers": "https://tueroeffnung.ikeytz.com/answer-engine-{locale}.json",
    "locale_answers_txt": "https://tueroeffnung.ikeytz.com/answer-engine-{locale}.txt",
    "seiten": "https://tueroeffnung.ikeytz.com/answer-engine-seiten-{locale}.json",
    "build_report": "https://tueroeffnung.ikeytz.com/answer-engine-build.txt",
    "roles": {
      "index": "Navigation + Counts + API-Pointer (<30 KB), keine Antworttexte",
      "catalog": "Diese Bedienungsanleitung (Parameter/Felder)",
      "locale_answers": "Stufe-1 Antworten × Locale (~222 Einträge) + contact_templates ×12",
      "seiten": "Stufe-2 Seiten-Einträge aus ai-pages"
    }
  },
  "actions": [
    {
      "type": "call",
      "description": "tel:-Link Handy (Kontakt-SSOT der Website)."
    },
    {
      "type": "whatsapp",
      "description": "Bare wa.me ohne Prefill-Text."
    },
    {
      "type": "email",
      "description": "mailto: ohne Prefill."
    },
    {
      "type": "contact_prefab",
      "description": "Fertigtext wie MCP list_whatsapp_options / compose_whatsapp / compose_mailto: Festpreis, Zeitfenster, leere Felder Adresse/Angefragt. Felder: contactOption, label, whatsappUrl, mailtoUrl, smsUrl. 12 Locale-Fertigtexte (Website WhatsApp-Optionen). An preis.*, kontakt.whatsapp/email, bestellung.wie und Datei-Root contact_templates.",
      "fields": [
        "contactOption",
        "label",
        "whatsappUrl",
        "mailtoUrl",
        "smsUrl"
      ]
    }
  ],
  "contact_templates": {
    "count": 12,
    "source": "messages.*.whatsapp.options (12 Fertigtexte Tag/Nacht)",
    "parity": "MCP list_whatsapp_options + compose_whatsapp + compose_mailto",
    "note": "12 vorgefertigte Kontakttexte (WhatsApp/Mailto/SMS) mit Festpreis, Zeitfenster und leeren Feldern Adresse/Angefragt — gleiche SSOT wie die Website. In jeder Locale-Antwort-Datei unter contact_templates; passende Prefabs auch in entry.actions bei Preis/Kontakt."
  },
  "mcp_bridge": {
    "www": "https://tueroeffnung.ikeytz.com/mcp",
    "maps": "https://maps.ikeytz.com/mcp",
    "tool_catalogs_in_de_file": "https://tueroeffnung.ikeytz.com/answer-engine-de.json",
    "hint": "Preise/whenKey weiter über MCP get_prices → get_ort_datetime → get_invoice_line_items."
  }
}
