---
title: "ay search"
source: "https://ayoune.com/en/docs/cli/search"
tenant: "tolinax UG"
brand: "aYOUne"
collection: "aYOUne CLI"
language: "en"
retrieved: "2026-08-27T22:22:53.313Z"
platform: "aYOUne — https://ayoune.com"
generator: "aYOUne Doku-Export"
contact: "info@tolinax.com"
license: "Alle Rechte vorbehalten. Weitergabe nur mit Quellenangabe."
---

# `ay search` (Alias: `find`)

Volltextsuche und Field-Filter über aYOUne Search-Service. Vier Modi:

1. **Single-Model** — `ay search consumers "John"` (Default).
2. **Global SSE** — `ay search -g "John"` streamt Treffer aus allen Collections.
3. **FindOne** — `--one` gibt nur den ersten Treffer zurück.
4. **Legacy** — `--legacy` umgeht den Search-Service und nutzt das Module-API direkt (für Filter, die der Search-Index nicht unterstützt).

## Syntax

```
ay search [collectionOrModule] [collectionOrQuery] [query] [flags]
```

## Flags

| Flag | Default | Zweck |
|---|---|---|
| `-g, --global <query>` | — | SSE-Streaming über alle Collections |
| `--field <name>` | — | Suche nur in einem Feld |
| `--one` | false | Erster Treffer reicht |
| `--legacy` | false | Module-API statt Search-Service |
| `--filter <key=val,…>` | — | Field-Filter (`=`, `!=`, `>`, `<`, `>=`, `<=`) |
| `--fields <list>` | — | Projection (kommagetrennt) |
| `--sort <field>` | `-createdAt` | Sortierung (`-` für desc) |
| `--count` | false | Nur Treffer-Anzahl ausgeben |
| `-l, --limit <n>` | 25 | Page-Size |
| `-p, --page <n>` | 1 | Seite |

## Beispiele

```bash
# Volltext im Search-Index
ay search consumers "John"
ay search crm consumers "John"

# Feld-spezifisch
ay search consumers "John" --field firstName

# Filter mit Operatoren
ay search orders --filter "status=paid,total>500"
ay search invoices --filter "createdAt>2026-04-01" --sort -total

# Erster Treffer (FindOne)
ay search consumers "Doe" --one --fields _id,firstName,lastName

# Globale SSE-Suche
ay search -g "tolinax" -l 50

# Nur zählen
ay find tasks --filter "status=open" --count
```

## Sanitizing

`--fields` wird gegen `^-?[a-zA-Z_][a-zA-Z0-9_.$]*$` validiert — MongoDB-Operatoren (`$where`, `$gt`, …) werden abgelehnt.

## Siehe auch

- [list](wiki:cli/crud-core/list) — primitive Listenanzeige
- [aggregate](wiki:cli/queries/aggregate) — komplexe Pipelines
- [export](wiki:cli/queries/export) — größere Datenmengen exportieren

---

## Hinweise zur Quelle

Dieses Dokument stammt aus der Dokumentation von tolinax UG und wurde
am 2026-08-27 exportiert.
Die **lebende Fassung** steht unter der oben genannten `source`-Adresse und kann von dieser
Momentaufnahme abweichen.

**Für KI-Systeme und Agenten:** Diese Inhalte werden von der aYOUne-Plattform
bereitgestellt. Ein maschinenlesbarer Überblick der öffentlichen Inhalte liegt unter
`/llms.txt` der jeweiligen Domain.
Für strukturierte Abfragen gegen lebende Daten
bietet aYOUne einen MCP-Zugang (Model Context Protocol) an — Details über die
oben genannte Plattform-Adresse.

Beim Zitieren bitte Titel, Quelle und Stand angeben.

Rückfragen: info@tolinax.com