# Kommandozeile

```bash
export TRACKDOLPHIN_TOKEN=td_live_…
npx @trackdolphin/cli shops
```

Wie der [MCP-Server](/docs/mcp.md) leitet die Kommandozeile ihre Befehle aus
der [OpenAPI-Beschreibung](/docs/api.md) ab. Ein neuer Endpunkt ist sofort ein
neuer Befehl.

## Beispiele

```bash
trackdolphin shops
trackdolphin tracking-health shop_meinshop_de_ab12cd
trackdolphin kpis shop_meinshop_de_ab12cd
trackdolphin channels shop_meinshop_de_ab12cd --days 30
trackdolphin start-import shop_meinshop_de_ab12cd --since 2026-01-01
```

Die Shop-Kennung steht direkt hinter dem Befehl — man tippt sie ohnehin zuerst.

Lesebefehle verlieren das Verb (`getShopKpis` → `kpis`), Schreibbefehle
behalten es (`startShopImport` → `start-import`): Bei einem Schreibvorgang ist
das Verb die Warnung.

## Alles anzeigen

```bash
trackdolphin help
```

Bei einem Tippfehler schlägt sie das Naheliegende vor:

```
$ trackdolphin kpi shop_x
Unbekannter Befehl: kpi
Meintest du: kpis?
```

## In Skripten

Die Ausgabe ist JSON — mit `jq` weiterverarbeitbar:

```bash
trackdolphin shops | jq -r '.shops[].id' | while read shop; do
  trackdolphin tracking-health "$shop" | jq -r '"\(.shop.name): \(.status)"'
done
```