StartseiteProdukt-API

Produkt-API

Für Einkaufssysteme, Skripte und KI-Agenten: Das Sortiment, das der Shop zeigt, ist auch per HTTP lesbar. Die Schnittstelle ist öffentlich, braucht keine Authentifizierung und liefert JSON. Preise sind Listenpreise netto in EUR; bestellt wird weiter über den Shop oder per Anfrage.

Maschinenlesbare Beschreibung

OpenAPI 3.1: https://www.whichsensor.com/openapi.json
API-Katalog nach RFC 9727: https://www.whichsensor.com/.well-known/api-catalog
Betriebsstatus: https://www.whichsensor.com/api/health
MCP-Server für KI-Agenten: https://www.whichsensor.com/api/public-mcp

Produkte suchen

GET https://www.whichsensor.com/api/products

`query`	Suchbegriff: Typbezeichnung, Artikelnummer oder freier Text.
`filters`	JSON-Array von Filtern, URL-kodiert (siehe unten).
`sort`	Sortierschlüssel aus sorting_options[].key einer vorherigen Antwort.
`sort-order`	asc oder desc.
`limit`	Treffer pro Seite, Standard 48, höchstens 50.
`offset`	Startposition für die nächste Seite, Standard 0.
`lang`	de (Standard) oder en: Sprache von Bezeichnungen und Facetten.

curl "https://www.whichsensor.com/api/products?query=induktiver%20Sensor%20M12&limit=10"

Die Antwort enthält die Treffer (results), ihre Gesamtzahl (total_results) und die Facetten der Treffermenge (filter_options). Der key einer Facette ist der Filterschlüssel für filters: Werte einer Auswahl als {"value": "…"}, Zahlenbereiche als {"min": …, "max": …}.

[{"key":"category","values":[{"value":"pressure_sensor"}]},
 {"key":"EF004103","values":[{"min":50,"max":500}]}]

Produktdetails

GET https://www.whichsensor.com/api/products/{id}

Liefert ein Produkt mit allen technischen Merkmalen (facts), Bildern, Listenpreis (pricing, null bei Preis auf Anfrage) und der Mengenrabattstaffel des Herstellers (tiers). Die id kommt aus einem Suchtreffer.

curl "https://www.whichsensor.com/api/products/123456"

MCP-Server für KI-Agenten

Dasselbe Sortiment als MCP-Server (Streamable HTTP) für Kunden mit Which-Sensor-Konto. Er durchsucht den Katalog, nennt bei jedem Produkt neben dem Listenpreis Ihren Preis (Listenpreis abzüglich des Rabatts, den Ihre Firma bei Which Sensor hat) und kann mit request_quote eine Angebotsanfrage stellen: https://www.whichsensor.com/api/public-mcp. In Claude, ChatGPT und anderen Clients als Remote-MCP-Server bzw. Connector mit dieser URL hinzufügen; der Client meldet sich per OAuth an und Sie bestätigen den Zugriff in Ihrem Kundenkonto. Noch kein Konto? Kostenlos registrieren. Höchstens 15 Tool-Aufrufe pro Minute und 250 pro Tag und Kunde.

`search_products`	Produkte suchen
`get_product`	Produktdetails
`get_alternatives`	Alternativen finden
`get_filter_reference`	Filterschlüssel
`get_shop_info`	Shop-Informationen
`request_quote`	Angebot anfragen

Claude Code

claude mcp add --transport http whichsensor-produkte https://www.whichsensor.com/api/public-mcp

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "whichsensor-produkte": {
      "url": "https://www.whichsensor.com/api/public-mcp"
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "whichsensor-produkte": {
      "type": "http",
      "url": "https://www.whichsensor.com/api/public-mcp"
    }
  }
}

Beschreibung für die automatische Einrichtung:Server Card,AI Catalog,Agent Skill.

Fehler

Fehler kommen als JSON mit einem Feld error: 400 bei einer ungültigen ID, 404 für ein Produkt, das nicht im Sortiment ist, 503, wenn die Suche vorübergehend nicht erreichbar ist.

429 mit Retry-After, wenn ein Limit erreicht ist: höchstens 30 Anfragen pro Minute und 1.500 Produkte pro Tag je Absender. Eine Suche zählt mit ihremlimit, ein Produktdetail mit 1.