MCP Tool

Booster: Produktkennzahlen mit Filtern und Seiten oder ein Produkt abrufen SELECT

Vorgenerierte Kennzahlen je Produkt (Verkaeufe 10/30/90/180/365 Tage und gesamt, Verkaufsveraenderung in Prozent, Marge, Abverkauf, Einbuchungen, Reklamationen, Anmerkung, Flag-IDs) mit Suche, Filtern, Sortierung und Seiten (_meta). Mit produktid genau ein Produkt mit Monats- und Jahresverkaeufen, Verkaufsvergleich, Flags und Werten je Verkaufsplattform. Ohne Lagerwerte. Daten aus dem Cron, Stand im Feld stand.

Tool-Name

tool

select_booster_produkte

Parameter

Parameter	Typ	Pflicht	Beschreibung
`abverkauf_bis`	`number`	Nein	Abverkaufszeitraum in Tagen bis (Zahl, Dezimalpunkt).
`abverkauf_von`	`number`	Nein	Abverkaufszeitraum in Tagen ab (Zahl, Dezimalpunkt).
`detailgrad`	`string`	Nein	Nur uebersicht.
`flag_ID`	`array`	Nein	IDs aus select_booster_flags; das Produkt muss alle haben.
`grundpreisartikel`	`integer`	Nein	1 = nur Artikel mit Grundpreisangabe.
`help`	`integer`	Nein	Filterhilfe.
`kategorie_ID`	`integer`	Nein	Produktkategorie mit Unterkategorien.
`limit`	`integer`	Nein	Eintraege je Seite, 1 bis 200, Standard 50.
`marge_bis`	`number`	Nein	Marge bis (Zahl, Dezimalpunkt).
`marge_von`	`number`	Nein	Marge ab (Zahl, Dezimalpunkt).
`monitor`	`string`	Nein	vorhanden oder warnung (Monitor ausgeloest).
`offset`	`integer`	Nein	Startposition ab 0, Standard 0. Naechste Seite: offset + limit, solange _meta.has_more true ist.
`produktid`	`integer`	Nein	Ein Produkt vollstaendig abrufen; andere Filter werden dann ignoriert.
`produkttyp`	`string`	Nein	einzelartikel, sammelartikel oder einzelartikel_ohne (nicht in Sammelartikeln verwendet).
`reklamation_bis`	`number`	Nein	Reklamationen im Zeitraum bis (Zahl, Dezimalpunkt).
`reklamation_von`	`number`	Nein	Reklamationen im Zeitraum ab (Zahl, Dezimalpunkt).
`reklamation_zeitraum`	`string`	Nein	Zeitraum fuer reklamation_von/reklamation_bis, Standard 90.
`sortierung`	`string`	Nein	Ein Wert, Minus = absteigend. Standard: titel.
`suche`	`string`	Nein	Artikelnummer, Titel, ASIN, EAN oder Produkt-ID.
`suchtyp`	`string`	Nein	– Standard: `booster_produkte`
`verkauf_bis`	`number`	Nein	Verkaeufe im Zeitraum bis (Zahl, Dezimalpunkt).
`verkauf_von`	`number`	Nein	Verkaeufe im Zeitraum ab (Zahl, Dezimalpunkt).
`verkauf_zeitraum`	`string`	Nein	Zeitraum fuer verkauf_von/verkauf_bis, Standard 30.

Input Schema

json

{
    "type": "object",
    "properties": {
        "produktid": {
            "type": "integer",
            "description": "Ein Produkt vollstaendig abrufen; andere Filter werden dann ignoriert.",
            "minimum": 1
        },
        "suche": {
            "type": "string",
            "description": "Artikelnummer, Titel, ASIN, EAN oder Produkt-ID.",
            "maxLength": 100
        },
        "kategorie_ID": {
            "type": "integer",
            "description": "Produktkategorie mit Unterkategorien.",
            "minimum": 1
        },
        "flag_ID": {
            "type": "array",
            "items": {
                "type": "integer"
            },
            "description": "IDs aus select_booster_flags; das Produkt muss alle haben.",
            "minItems": 1,
            "maxItems": 500
        },
        "produkttyp": {
            "type": "string",
            "description": "einzelartikel, sammelartikel oder einzelartikel_ohne (nicht in Sammelartikeln verwendet).",
            "enum": [
                "einzelartikel",
                "sammelartikel",
                "einzelartikel_ohne"
            ],
            "werte": {
                "einzelartikel": "Einzelartikel",
                "sammelartikel": "Sammelartikel",
                "einzelartikel_ohne": "Einzelartikel ohne Sammelartikel"
            }
        },
        "grundpreisartikel": {
            "type": "integer",
            "description": "1 = nur Artikel mit Grundpreisangabe.",
            "minimum": 0,
            "maximum": 1
        },
        "marge_von": {
            "type": "number",
            "description": "Marge ab (Zahl, Dezimalpunkt)."
        },
        "marge_bis": {
            "type": "number",
            "description": "Marge bis (Zahl, Dezimalpunkt)."
        },
        "abverkauf_von": {
            "type": "number",
            "description": "Abverkaufszeitraum in Tagen ab (Zahl, Dezimalpunkt)."
        },
        "abverkauf_bis": {
            "type": "number",
            "description": "Abverkaufszeitraum in Tagen bis (Zahl, Dezimalpunkt)."
        },
        "verkauf_zeitraum": {
            "type": "string",
            "description": "Zeitraum fuer verkauf_von/verkauf_bis, Standard 30.",
            "enum": [
                10,
                30,
                90,
                180,
                365,
                "gesamt"
            ],
            "werte": {
                "10": "10 Tage",
                "30": "30 Tage",
                "90": "90 Tage",
                "180": "180 Tage",
                "365": "365 Tage",
                "gesamt": "Gesamt"
            }
        },
        "verkauf_von": {
            "type": "number",
            "description": "Verkaeufe im Zeitraum ab (Zahl, Dezimalpunkt)."
        },
        "verkauf_bis": {
            "type": "number",
            "description": "Verkaeufe im Zeitraum bis (Zahl, Dezimalpunkt)."
        },
        "reklamation_zeitraum": {
            "type": "string",
            "description": "Zeitraum fuer reklamation_von/reklamation_bis, Standard 90.",
            "enum": [
                30,
                90,
                180,
                365,
                "gesamt"
            ],
            "werte": {
                "30": "30 Tage",
                "90": "90 Tage",
                "180": "180 Tage",
                "365": "365 Tage",
                "gesamt": "Gesamt"
            }
        },
        "reklamation_von": {
            "type": "number",
            "description": "Reklamationen im Zeitraum ab (Zahl, Dezimalpunkt)."
        },
        "reklamation_bis": {
            "type": "number",
            "description": "Reklamationen im Zeitraum bis (Zahl, Dezimalpunkt)."
        },
        "monitor": {
            "type": "string",
            "description": "vorhanden oder warnung (Monitor ausgeloest).",
            "enum": [
                "vorhanden",
                "warnung"
            ],
            "werte": {
                "vorhanden": "Monitor vorhanden",
                "warnung": "Monitor ausgeloest"
            }
        },
        "sortierung": {
            "type": "string",
            "description": "Ein Wert, Minus = absteigend. Standard: titel.",
            "enum": [
                "titel",
                "-titel",
                "produktid",
                "-produktid",
                "artikelnummer",
                "-artikelnummer",
                "verkauf_30",
                "-verkauf_30",
                "verkauf_365",
                "-verkauf_365",
                "verkauf_gesamt",
                "-verkauf_gesamt",
                "marge",
                "-marge",
                "abverkauf",
                "-abverkauf"
            ],
            "werte": {
                "titel": "titel aufsteigend",
                "-titel": "titel absteigend",
                "produktid": "produktid aufsteigend",
                "-produktid": "produktid absteigend",
                "artikelnummer": "artikelnummer aufsteigend",
                "-artikelnummer": "artikelnummer absteigend",
                "verkauf_30": "verkauf_30 aufsteigend",
                "-verkauf_30": "verkauf_30 absteigend",
                "verkauf_365": "verkauf_365 aufsteigend",
                "-verkauf_365": "verkauf_365 absteigend",
                "verkauf_gesamt": "verkauf_gesamt aufsteigend",
                "-verkauf_gesamt": "verkauf_gesamt absteigend",
                "marge": "marge aufsteigend",
                "-marge": "marge absteigend",
                "abverkauf": "abverkauf aufsteigend",
                "-abverkauf": "abverkauf absteigend"
            }
        },
        "limit": {
            "type": "integer",
            "description": "Eintraege je Seite, 1 bis 200, Standard 50.",
            "minimum": 1,
            "maximum": 200
        },
        "offset": {
            "type": "integer",
            "description": "Startposition ab 0, Standard 0. Naechste Seite: offset + limit, solange _meta.has_more true ist.",
            "minimum": 0
        },
        "detailgrad": {
            "type": "string",
            "description": "Nur uebersicht.",
            "enum": [
                "uebersicht"
            ]
        },
        "help": {
            "type": "integer",
            "enum": [
                1
            ],
            "description": "Filterhilfe."
        },
        "suchtyp": {
            "type": "string",
            "enum": [
                "booster_produkte"
            ],
            "default": "booster_produkte"
        }
    },
    "additionalProperties": false
}

Beispiel-Aufruf

json

{
    "tool": "select_booster_produkte",
    "arguments": {
        "abverkauf_bis": 1,
        "abverkauf_von": 1,
        "detailgrad": "...",
        "flag_ID": [],
        "grundpreisartikel": 1,
        "help": 1,
        "kategorie_ID": 1,
        "limit": 1,
        "marge_bis": 1,
        "marge_von": 1,
        "monitor": "...",
        "offset": 1,
        "produktid": 1,
        "produkttyp": "...",
        "reklamation_bis": 1,
        "reklamation_von": 1,
        "reklamation_zeitraum": "...",
        "sortierung": "...",
        "suche": "...",
        "suchtyp": "booster_produkte",
        "verkauf_bis": 1,
        "verkauf_von": 1,
        "verkauf_zeitraum": "..."
    }
}