Adventskalender-Kompass

Findet passende Adventskalender in der Datenbank des Adventskalender-Kompass (nur aktuell sichtbare Kalender). Alle Filter sind optional und werden kombiniert (UND); mehrere Interessen gelten als ODER, Kalender mit mehr Treffern stehen oben. Liefert höchstens 10 Kalender mit Name, Marke, Kurztext, Preisklasse, Zielgruppen und Link. Gültige Werte für zielgruppe, kategorie, marke, preisklasse und interessen liefert list_options. Preise nur als Preisklasse (bis-20, 20-50, 50-100, ueber-100).

{
  "type": "object",
  "properties": {
    "zielgruppe": {
      "type": "string",
      "description": "Für wen? Slug oder Name, z. B. \"papa\", \"kinder\", \"frauen\", \"oma\". Untergruppen zählen mit (Kinder schließt Mädchen und Jungs ein)."
    },
    "kategorie": {
      "type": "string",
      "description": "Inhalt, z. B. \"beauty\", \"schokolade\", \"tee\", \"spielzeug\", \"lego\" (Slug oder Name, siehe list_options)."
    },
    "interessen": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Interessen/Stichworte, z. B. [\"Star Wars\", \"Backen\"]. Mindestens eines muss passen."
    },
    "marke": {
      "type": "string",
      "description": "Marke oder Hersteller, z. B. \"Lindt\", \"LEGO\", \"Playmobil\"."
    },
    "alter": {
      "type": "integer",
      "minimum": 0,
      "maximum": 120,
      "description": "Alter der beschenkten Person in Jahren (berücksichtigt die Altersangabe der Kalender)."
    },
    "preisklasse": {
      "type": "string",
      "enum": [
        "bis-20",
        "20-50",
        "50-100",
        "ueber-100"
      ],
      "description": "Preisklasse: bis 20 €, 20–50 €, 50–100 €, über 100 €."
    },
    "alkoholfrei": {
      "type": "boolean",
      "description": "true = nur Kalender ohne Alkohol."
    },
    "vegan": {
      "type": "boolean",
      "description": "true = nur vegane Kalender."
    },
    "nachhaltig": {
      "type": "boolean",
      "description": "true = nur nachhaltige Kalender."
    },
    "tuerchen_min": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Mindestanzahl Türchen (meist 24)."
    },
    "tuerchen_max": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Höchstanzahl Türchen."
    },
    "suchbegriff": {
      "type": "string",
      "description": "Optionaler Freitext, alle Wörter müssen vorkommen, z. B. \"Gin\" oder \"Harry Potter\"."
    },
    "sortierung": {
      "type": "string",
      "enum": [
        "relevanz",
        "preis_aufsteigend",
        "preis_absteigend",
        "bewertung",
        "neu"
      ],
      "default": "relevanz",
      "description": "relevanz (Standard: Empfehlungen zuerst), preis_aufsteigend, preis_absteigend, bewertung, neu (Ausgabe des laufenden Jahres zuerst)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "default": 10,
      "description": "Anzahl Ergebnisse, höchstens 10."
    }
  }
}

Liefert alle Details zu einem Adventskalender: Beschreibung, Inhalt, Türchen, Alter, Zielgruppen, Merkmale, für wen er sich eignet und für wen nicht, Preisklasse sowie Link zur Kalenderseite und Amazon-Weiterleitung (Partnerlink, wird von uns erfasst). Ein Preis erscheint nur, wenn er frisch aus der Amazon-API stammt (mit Stand), sonst nur die Preisklasse.

{
  "type": "object",
  "properties": {
    "kalender": {
      "type": "string",
      "description": "Slug (aus find_calendars) oder Name des Kalenders, z. B. \"lego-star-wars-adventskalender-2026\"."
    }
  },
  "required": [
    "kalender"
  ]
}

Volltextsuche über Name, Marke, Kurztext, Merkmale und Interessen aller sichtbaren Adventskalender (alle Wörter müssen vorkommen). Liefert id (= Slug), Titel und Link; Details dazu mit get_calendar oder fetch.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Suchbegriff(e), z. B. \"Gin\", \"Playmobil Weihnachten\", \"Katzen\"."
    }
  },
  "required": [
    "query"
  ]
}

Lädt einen Adventskalender anhand der id aus search (= Slug) als Text mit Link – für ChatGPT-Konnektoren.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "id aus search (Slug)"
    }
  },
  "required": [
    "id"
  ]
}

Listet die gültigen Werte für die Filter von find_calendars: Zielgruppen (mit Obergruppe), Kategorien, Marken (mit Anzahl), Preisklassen, häufige Interessen und Anlässe. Optional nur einen Teil abrufen.

{
  "type": "object",
  "properties": {
    "teil": {
      "type": "string",
      "enum": [
        "alle",
        "zielgruppen",
        "kategorien",
        "marken",
        "preisklassen",
        "interessen"
      ],
      "default": "alle",
      "description": "Welche Liste? Standard: alle (Marken auf die 60 größten gekürzt)."
    }
  }
}

Findet Adventskalender, die einem gegebenen ähneln (gleiche Kategorie, Zielgruppen, Interessen und Preisklasse) – etwa als Alternative, wenn einer nicht passt oder zu teuer ist.

{
  "type": "object",
  "properties": {
    "kalender": {
      "type": "string",
      "description": "Slug oder Name des Ausgangskalenders."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "default": 6
    }
  },
  "required": [
    "kalender"
  ]
}