Entwickler

Der Katalog von Dinilu, aktuelle Preise und Frachtangebote stehen auch Software zur Verfügung, nicht nur Menschen. Zwei Schnittstellen liefern dieselben Daten: ein Model-Context-Protocol-Server für KI-Assistenten und eine einfache JSON-REST-API für alles andere. Beide sind öffentlich, nur lesend und benötigen weder Schlüssel noch Registrierung.

Model Context Protocol

Wenn Ihr Client MCP spricht, nutzen Sie ihn bevorzugt. Tool-Argumente sind JSON, es muss also nichts in einen Query-String gepresst werden.

Der Endpunkt ist /mcp auf dieser Domain, JSON-RPC 2.0 über POST. Er ist zustandslos und öffnet keinen SSE-Stream.

Drei Tools stehen bereit:

  • search_products — Produkte über Freitext, über Kategorie oder beides finden.
  • get_product — die konfigurierbaren Attribute eines Produkts und ihre Optionen, die Mindestbestellmenge und die Schrittweite.
  • get_quote — eine konkrete Konfiguration und Menge kalkulieren, mit Produktionszeit und Versandoptionen.

Jede Domain und jede Sprache ist ein eigener Endpunkt, mit eigenem Sortiment, eigenen Preisen und eigener Währung. Verbinden Sie sich mit dem Endpunkt des gewünschten Marktes, statt die Ergebnisse selbst zu übersetzen.

Einen Assistenten verbinden

Der Endpunkt ist eine öffentliche HTTPS-URL und benötigt keinen Schlüssel — die meisten Clients brauchen nichts weiter als die Adresse:

https://dinilu.de/mcp

  • Claude — Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen, dann die URL einfügen. In Team- und Enterprise-Tarifen kann eine Administratorin oder ein Administrator den Connector unter den Organisationseinstellungen einmalig für alle hinterlegen.
  • ChatGPT — den Entwicklermodus unter Settings → Apps aktivieren und anschließend eine App anlegen, die auf die URL zeigt.
  • Cursor, VS Code und andere Editoren — {"url": "https://dinilu.de/mcp"} in die MCP-Konfiguration eintragen.

Jede Dinilu-Domain ist ein eigener Endpunkt, mit eigenem Sortiment, eigenen Preisen, eigener Währung und eigenen Versandarten. Nutzen Sie die Domain des Marktes, für den Sie kalkulieren.

JSON-REST-API

  • GET /api/products — alle Produkte, die auf dieser Domain in dieser Sprache verfügbar sind.
  • GET /api/product/{mpn} — Attribute, Optionen, Bestellmengen und Bilder eines Produkts.
  • GET /api/quote?mpn={mpn}&qty={qty}&attributes={config} — aktueller Preis, Produktionszeit und Versandoptionen.

Eine Produktnummer finden

Jede Produktseite enthält ihre MPN in den JSON-LD-Daten und verweist über ein <link rel="alternate" type="application/json">-Tag im Seitenkopf auf ihr eigenes JSON. Sie können den Katalog auch auflisten und durchsuchen.

Ein Angebot konfigurieren

Optionen werden über ihre id gewählt: attributes={Attribut-id}:{Options-id}, Paare getrennt durch |. Beide ids liefert get_product. Optionsnamen werden ebenfalls akzeptiert, sind aber je Domain übersetzt und müssen exakt übereinstimmen — ids sind daher die verlässliche Form. Jede Produktantwort enthält ein lauffähiges Beispiel.

Was die Zahlen bedeuten

  • Angebote sind unverbindlich. Sie werden live aus aktuellen Kosten, Wechselkursen und Frachttarifen berechnet, und die Antwort weist darauf hin.
  • Preise verstehen sich pro Stück und zzgl. MwSt., in der Währung der aufgerufenen Domain.
  • Versandoptionen werden einzeln kalkuliert. Die verkaufende juristische Person richtet sich nach der Versandart und nicht nach der Domain — jede Option nennt daher ihren eigenen Lieferanten.
  • Mindestbestellmengen gelten tatsächlich. Eine zu geringe Menge wird nach oben angepasst, und die Antwort gibt dazu eine Warnung aus.

Jede Antwort enthält ein warnings-Array. Es lohnt sich zu lesen: dort meldet die API, dass eine Menge angepasst, eine Option mit einem Standardwert belegt oder ein Land nicht aufgelöst werden konnte.

Faire Nutzung

Es gibt keinen API-Schlüssel und kein hartes Limit. Bitte gehen Sie vernünftig damit um — cachen Sie, was sich nicht ändert, und lesen Sie den Katalog nicht häufiger aus, als er sich ändert. Wenn Sie Volumenzugriff, eine garantierte Rate oder eine kommerzielle Integration benötigen, nutzen Sie das Kontaktformular und beschreiben Sie Ihr Vorhaben.

Maschinenlesbarer Index

/llms.txt ist eine kurze Zusammenfassung für KI-Assistenten, /llms-full.txt dokumentiert den vollständigen Ablauf mit ausgearbeiteten Beispielen. Beide werden pro Domain und Sprache erzeugt.

Fragen

Fragen zur Integration, Fehlermeldungen und Wünsche sind über das Kontaktformular willkommen.