# chercher_clients

> Für KI-Agenten: Das vollständige Verzeichnis der Dokumentation steht unter [llms.txt](https://stampywallet.com/de/docs/llms.txt), die gesamte Dokumentation passt in eine Datei: [llms-full.txt](https://stampywallet.com/de/docs/llms-full.txt). Seite online: https://stampywallet.com/de/docs/mcp/werkzeuge/chercher_clients/

Mit Konto · Nur Lesen.

Listet die Kunden des Ladens nach einem Segment (Stammkunden, Weggebliebene, ein Stempel vor der Prämie, Prämie einzulösen, Neue, Inaktive, nie wiedergekommen), kombiniert mit Filtern: Vorname, Stempel auf der Karte, Anzahl Besuche, Anmeldedatum, Datum des letzten Besuchs, Art des Wallets; sortiert und seitenweise. Liefert für jeden eine Kennung, den Vornamen und den Anfangsbuchstaben des Nachnamens, die Besuche, den letzten Besuch und den Stand der Karte, nie E-Mail oder Telefon. Verwenden für „Wer sind meine besten Kunden?“, „Wer ist nicht wiedergekommen?“, „Wer ist kurz vor seiner Prämie?“ oder um die Kennung eines Kunden vor fiche_client zu finden.

## Parameter

- `segment` (enum, optional) : Ausgangsgruppe, so definiert wie in der App. tous (Standard); habitues = mindestens 4 Besuche in den letzten 60 Tagen; perdus = mindestens 4 Mal gekommen und länger weg als das Anderthalbfache ihres üblichen Rhythmus (Median der Abstände zwischen ihren Besuchen) oder, ohne genug Verlauf, länger als die Frist des Ladens; Urlaub und Ruhetage zählen nicht; presque = ihnen fehlt nur ein Stempel bis zur Prämie; recompense_prete = eine verdiente Prämie, noch nicht eingelöst, nicht abgelaufen; nouveaux = in den letzten 30 Tagen angemeldet; inactifs = kein Besuch seit mehr als der Frist des Ladens, in Kalendertagen, egal wie oft sie da waren; un_seul_passage = höchstens ein Besuch: angemeldet, aber nie wiedergekommen. Werte : tous, habitues, perdus, presque, recompense_prete, nouveaux, inactifs, un_seul_passage. Standard : "tous".
- `recherche` (string, ≤ 60 Zeichen, optional) : Teil des Vor- oder Nachnamens (Akzente und Groß-/Kleinschreibung werden ignoriert).
- `tampons_min` (integer, ≥ 0, optional) : Mindestens so viele Stempel auf der aktuellen Karte.
- `tampons_max` (integer, ≥ 0, optional) : Höchstens so viele Stempel auf der aktuellen Karte.
- `visites_min` (integer, ≥ 0, optional) : Mindestens so viele Besuche seit der Anmeldung (Willkommensstempel nicht mitgezählt).
- `visites_max` (integer, ≥ 0, optional) : Höchstens so viele Besuche seit der Anmeldung.
- `inactif_depuis_jours` (integer, 1…3650, optional) : Kein Besuch seit mindestens N Kalendertagen (ein Kunde, der nie da war, zählt ab seiner Anmeldung).
- `actif_depuis_jours` (integer, 1…3650, optional) : Mindestens ein Besuch in den letzten N Tagen.
- `inscrit_depuis` (string (date), optional) : An diesem Tag oder danach angemeldet (JJJJ-MM-TT).
- `inscrit_avant` (string (date), optional) : An diesem Tag oder davor angemeldet (JJJJ-MM-TT).
- `derniere_visite_depuis` (string (date), optional) : Letzter Besuch an diesem Tag oder danach (JJJJ-MM-TT).
- `derniere_visite_avant` (string (date), optional) : Letzter Besuch an diesem Tag oder davor (JJJJ-MM-TT). Schließt Kunden aus, die nie da waren.
- `wallet` (enum, optional) : Wo der Kunde seine Karte aufbewahrt. aucun = Webseite, ohne Wallet. Werte : tous, apple, google, aucun. Standard : "tous".
- `tri` (enum, optional) : Reihenfolge der Ergebnisse. Standard derniere_visite (die jüngsten zuerst). Werte : derniere_visite, visites, visites_90j, tampons, recompenses, inscription, prenom. Standard : "derniere_visite".
- `ordre` (enum, optional) : auto (Standard): absteigend, außer prenom (A→Z). Werte : auto, asc, desc. Standard : "auto".
- `limite` (integer, 1…100, optional) : Maximale Anzahl an Ergebnissen. Standard : 25.
- `decalage` (integer, ≥ 0, optional) : Anzahl der zu überspringenden Ergebnisse (Paginierung). Standard : 0.

## Antwort

Ein Text, den der Assistent liest (`content`), und dieselben Informationen als strukturierte Daten (`structuredContent`). Bei einer Ablehnung (Parameter falsch, Tarif, Rolle) trägt die Antwort `isError: true` und einen Satz, den der Assistent umformulieren kann.

## Beispiel

Prompt : « Welche meiner Stammkunden kommen nicht mehr? »

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "chercher_clients",
    "arguments": {
      "segment": "perdus",
      "tri": "visites",
      "limite": 20
    }
  }
}
```

```bash
curl https://app.stampywallet.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer $STAMPY_JETON" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"chercher_clients","arguments":{"segment":"perdus","tri":"visites","limite":20}}}'
```

`$STAMPY_JETON` ist das OAuth-Token, das der Assistent erhält, wenn Sie Ihr Konto verbinden ([siehe Verbinden](https://stampywallet.com/de/docs/mcp/verbinden/#connexion)). Sie müssen damit selbst nichts tun.
