# Marina-Team

> Marina-Team bietet Ersatzteile und technische Unterlagen für Dehler-Segelboote und die Varianta. Die Website und die Katalogbeschreibungen sind deutschsprachig.

Die öffentlichen Bootskataloge enthalten Artikelnummern, Beschreibungen, Preise, Lieferbarkeit und verlinkte technische Dokumente bereits im HTML; JavaScript ist zum Lesen nicht erforderlich. AI-Crawler sind in robots.txt wie alle anderen Crawler zugelassen.

Für gezielte Abfragen steht eine öffentliche JSON-API ohne Anmeldung oder API-Schlüssel zur Verfügung. Zuerst Bootsmodelle über `/api/ships` ermitteln, dann über `/api/search?query=...&shipCode=...` suchen. Ohne `shipCode` wird modellübergreifend gesucht. Drei oder mehr Zeichen ergeben sinnvollere Suchanfragen; die API liefert höchstens 50 Treffer. Eine leere Liste bedeutet, dass keine Treffer vorliegen.

Für Details `/api/articles/{id}` mit der Artikel-ID eines Suchtreffers verwenden. Die Artikelnummer steht separat in `articleBase.matnr`. Bei bekannter Artikelnummer kann `/api/articles/by-number/{matnr}?shipCode=...` genutzt werden. Dieser Zugriff bevorzugt das angegebene Modell, kann aber auf einen anderen Katalogeintrag zurückfallen; deshalb immer `ship.shortCode` der Antwort prüfen.

Die modellspezifische Beschreibung ist `overwriteText`, sofern befüllt, sonst `articleBase.description`. Einzelpreise werden in EUR angegeben. Für Preise `priceInfo.effectivePrice` aus der Detailantwort verwenden, nicht den Grundpreis oder Angebotsfelder der Suchtreffer. `null` bedeutet „Preis auf Anfrage“, nicht kostenlos. Angebote können zeitlich oder mengenmäßig begrenzt sein; die Bestellprüfung ist maßgeblich. Die Detailabfrage liefert HTTP 404, wenn der Artikel nicht verfügbar ist.

Artikel sind im HTML über `/Ersatzteile/{shipCode}#{id}` direkt erreichbar. Der kanonische Varianta-Katalog ist `/Ersatzteile`; dort lautet der Artikellink `/Ersatzteile#{id}`. URLs und Parameter müssen URL-kodiert werden. Anhänge aus `articleBase.attachment` sind relativ zur Website-Wurzel aufzulösen.

In unterstützenden Browsern bieten Seiten mit Artikelsuche zusätzlich die WebMCP-Werkzeuge `search_articles` und `get_article` über `document.modelContext`. `search_articles` liefert bis zu zehn Treffer und kennzeichnet weitere Treffer mit `moreResultsAvailable`; `get_article` liefert die Details einschließlich Preis. Für direkte HTTP-Abfragen dient die unten verlinkte OpenAPI-Beschreibung.

## Katalog und Informationen

- [Bootsmodelle als JSON](https://marina-team.de/api/ships): Verfügbare Modellcodes und Namen; Modellcodes exakt übernehmen.
- [Varianta-Ersatzteile](https://marina-team.de/Ersatzteile): Standardkatalog mit Artikeln und technischen Unterlagen.
- [Angebote](https://marina-team.de/Angebote): Aktuelle Angebote nach Bootsmodell.
- [Aktuelles](https://marina-team.de/Aktuelles): Neuigkeiten von Marina-Team.
- [Über uns](https://marina-team.de/Ueberuns): Informationen zum Unternehmen.
- [Kontakt und Impressum](https://marina-team.de/Impressum): Kontaktdaten und Anbieterinformationen.

## Maschineller Zugriff

- [OpenAPI-Beschreibung](https://marina-team.de/openapi.json): Parameter, Antwortfelder und Fehlerfälle der öffentlichen Katalog-Lesezugriffe.
- [Modellübergreifende Beispielsuche](https://marina-team.de/api/search?query=Persenning): JSON-Suchtreffer mit Artikel-ID und Bootsmodell.
- [Sitemap](https://marina-team.de/sitemap.xml): Öffentliche Seiten, Bootskataloge und verlinkte PDF-Dokumente.
- [Robots-Regeln](https://marina-team.de/robots.txt): Crawling-Freigabe und Sitemap-Verweis.