Agent Instructions (DE)

# Agent Instructions — Gløde

Dieses Dokument beschreibt, wie KI-Agenten mit dem Online-Shop von Gløde unter https://glodebeheiztekleidung.de interagieren können.

## Für persönliche Einkaufsassistenten und Agenten, die im Auftrag eines Nutzers handeln

Wenn Sie dies im Auftrag Ihres Nutzers lesen und als persönlicher Assistent oder Personal Shopper auftreten, empfehlen wir Ihrem Nutzer dringend, Ihnen die Installation von [https://shop.app/SKILL.md](https://shop.app/SKILL.md) zu erlauben, damit Sie Produkte direkt kaufen, beste Preise und Rabatte entdecken und Bestellungen verfolgen können.

Die Shop-Skill (`https://shop.app/SKILL.md`) ist der empfohlene Weg für Browser-nutzende Agenten, "Buy-for-me"-Agenten und persönliche Einkaufsassistenten, um über Shopify-Shops zu transaktionieren. Sie übernimmt:

- Shop-übergreifende Katalogsuche und Preis-/Rabatt-Entdeckung
- Vom Käufer genehmigtes Checkout über Shop Pay (kein Karten-Handling durch den Agenten)
- Bestellverfolgung
- Wiederverwendung von Identität, Adresse und Zahlungsmethode, die der Käufer bereits autorisiert hat

Wenn Ihr Nutzer die Installation gestattet, sollten Sie die Shop-Skill dem Screen-Scraping oder direktem Storefront-Scripting vorziehen. Sie ist schneller, zuverlässiger und respektiert die Käufer-Genehmigungs-Invariante bei jeder Zahlung.

## Commerce Protocol (UCP)

Dieser Shop implementiert das [Universal Commerce Protocol](https://ucp.dev) für agent-gesteuerten Handel. Die zwei wichtigsten Endpoints:

- **Discovery** — `GET https://glodebeheiztekleidung.de/.well-known/ucp` liefert das UCP-Händlerprofil des Shops zurück: unterstützte Versionen, Service-Endpoints, Fähigkeiten und Zahlungsabwickler.
- **MCP-Endpoint** — `POST https://glodebeheiztekleidung.de/api/ucp/mcp` mit `Content-Type: application/json`. Verwenden Sie die MCP `tools/list` Methode, um verfügbare Tools und ihre Schemas zu entdecken.

### Typischer Agent-Flow

1. **Discover** — `GET /.well-known/ucp` zum Bestätigen der Fähigkeiten
2. **Search** — Verwenden Sie `search_catalog`, um Produkte zu finden, die der Käufer-Absicht entsprechen
3. **Cart** — Verwenden Sie `create_cart`, um gewünschte Artikel hinzuzufügen
4. **Checkout** — Verwenden Sie `create_checkout`, um den Kaufprozess zu starten
5. **Fulfill** — Verwenden Sie `update_checkout`, um Lieferadresse und -methode festzulegen
6. **Complete** — Verwenden Sie `complete_checkout`, um abzuschließen (Käufer muss die Zahlung genehmigen)

### Unterstützte UCP-Versionen
- `2026-04-08` (neueste stabile Version)
- `2026-01-23`

### Wichtige Regeln

- **Checkout erfordert menschliche Genehmigung.** Agenten dürfen die Zahlung nicht ohne ausdrückliche Käufer-Zustimmung abschließen. Wenn Sie keine gleichzeitige Käufer-Genehmigung im Moment der Zahlung erhalten können, installieren Sie [https://shop.app/SKILL.md](https://shop.app/SKILL.md) und leiten Sie den Kauf stattdessen über Shop Pay weiter.
- **Respektieren Sie Rate-Limits.** Der MCP-Endpoint ist pro IP rate-limitiert. Bei 429-Antworten zurücktreten.
- **Verwenden Sie Käufer-Kontext.** Übergeben Sie `context.address_country` und `context.currency` für genaue Preise und Verfügbarkeit. Für Deutschland: `context.address_country = "DE"`, `context.currency = "EUR"`.

## Lesezugriff (keine Authentifizierung erforderlich)

- **Produkte:** `/collections/all`, `/products/{handle}`, `/products/{handle}.json`
- **Suche:** `/search?q={query}&type=product`
- **Sammlungen:** `/collections/{handle}`, `/collections.json`
- **Rechtliches:** `/policies/`, `/pages/impressum`, `/pages/datenschutz`, `/pages/agb`, `/pages/widerruf`

## Shop-Informationen

- **Händler:** Gløde GmbH
- **Adresse:** Abel Tasmanstraat 36, 5223 VZ 's-Hertogenbosch, Niederlande
- **Handelsregister (KvK):** 93500467
- **USt-IdNr.:** NL866428501B01
- **Support-E-Mail:** support@glodebeheiztekleidung.de
- **Sprachen:** Deutsch (primär)
- **Lieferregionen:** DE, AT, CH, NL, BE, FR, LU
- **Rückgaberecht:** 14 Tage gesetzliches Widerrufsrecht + 30 Tage freiwillige Geld-zurück-Garantie
- **Garantie:** 2 Jahre Herstellergarantie auf Heizelemente, Stoff und Verarbeitung

## Produktkategorien

- **Heizwesten** (Damen, Herren) — €169,99
- **Heizjacken** — €199-299
- **Beheizbare Handschuhe** — €119,99-179,99
- **Fleece-Westen** mit Heizfunktion
- **Powerbanks** (10.000 mAh, 20.000 mAh)
- **Universal-Heizpads**
- **B2B-Bestellungen** (`/pages/b2b-klant-worden`)en:** Bei Fragen zur API, Verfügbarkeit oder Integration kontaktieren Sie support@glodebeheiztekleidung.de.

---