UCP-Checker
Gib die Adresse eines Shops ein und sieh nach, ob seine UCP-Discovery-Datei wirklich existiert — und wirklich gültig ist.
UCP (Universal Commerce Protocol) ist der offene Standard, mit dem ein KI-Assistent im Auftrag eines Shops einkaufen kann. Ein Shop, der UCP spricht, veröffentlicht ein maschinenlesbares JSON-Profil unter /.well-known/ucp — seine Protokollversion, die Dienste, die er anbietet, die Zahlungsabwickler, die er akzeptiert, und die öffentlichen Schlüssel, mit denen er signiert. Dieser Checker ruft diese Datei von unserem Server ab, prüft sie gegen die Hosting- und Profilregeln der offiziellen Spezifikation und testet die Endpunkte, die sie deklariert. Der Agent-Readiness-Checker sucht die Discovery-Datei als ein Signal unter vielen; dieses Tool ist die Tiefenprüfung für die UCP-Datei. Der Begleitartikel Was UCP ist und wie man es prüft geht ein echtes Dokument von Hand durch.
Zuletzt aktualisiert:
Einen Shop prüfen
Ergebnisse
Befunde
Geparstes Dokument
Rohdokument (JSON)
Kopiert.
Kein Dokument anzuzeigen — der Abruf hat kein verwendbares Profil geliefert.
🔒 Das Ziel wird von unserem Prüfserver abgerufen, nie von deinem Browser — also keine CORS-Blockade, und der Shop sieht die Anfrage des Prüfers, nicht deine. Nichts über dich wird an den Shop gesendet.
Was unter /.well-known/ucp liegt
Ein UCP-Profil ist ein JSON-Objekt mit einem erforderlichen ucp-Mitglied. Darin sind ucp.version, ucp.services und ucp.payment_handlers Pflicht — die letzten beiden müssen auch dann vorhanden sein, wenn sie leer sind. ucp.capabilities ist optional, obwohl ein nützliches Commerce-Profil normalerweise mindestens eine Fähigkeit angibt. Ein Array keys[] auf oberster Ebene kann die öffentlichen Signaturschlüssel des Shops als JWK-Set nach RFC 7517 veröffentlichen.
Versionen sind Daten, niemals Wörter wie „draft“: Die erste Version war 2026-01-11, die neueste stabile Version ist 2026-08-25. Ein Profil, das eine ältere Version deklariert, bleibt gültig, aber dieser Checker warnt — und listet unten die Breaking Changes — weil Gegenstellen Einträge ablehnen können, deren Version nicht mit der des Profils übereinstimmt. Ein Shop, der weiterhin ältere Versionen anbietet, listet sie in supported_versions, jede mit Verweis auf ihr eigenes Versionsprofil.
Von den Breaking Changes in 2026-08-25 betreffen diese ein veröffentlichtes Profil: Das alte Feld signing_keys[] wurde entfernt und durch das Array keys[] auf oberster Ebene ersetzt; die Fulfillment-Konfiguration wurde umstrukturiert (Optionen verloren das Präfix allows_, multi_destination wurde von einer Map zu einem Array); die Käufer-Einwilligung wechselte von festen booleschen Optionen zu einer dynamischen Map mit Schlüsseln aus umgekehrten Domain-Bezeichnern; und Zahlungserweiterungen wechselten von dev.ucp.shopping.* zu dev.ucp.common.payment.*.
Die Hosting-Regeln sind streng, weil Profile Vertrauensmaterial sind: Ein Profil muss über HTTPS ausgeliefert werden, darf nicht weiterleiten (jedes 3xx ist ein Fehler) und muss Cache-Control: public mit max-age von mindestens 60 Sekunden tragen — niemals private, no-store oder no-cache. Shopify-Shops liefern standardmäßig ein 2026-08-25-Profil unter /.well-known/ucp — probiere den Demo-Button.
Was dieser Checker tut — und was nicht
Er ruft ab, validiert und testet — vom Server aus. Der Checker fragt https://<domain>/.well-known/ucp direkt ab (eine Anfrage, ohne Weiterleitungen zu folgen), validiert das Dokument gegen die Regeln dieser Seite und testet jeden deklarierten Endpunkt mit einer HEAD-Anfrage (GET, wo HEAD abgelehnt wird). Dein Browser kontaktiert das Ziel nie, also wird die Prüfung nicht von CORS blockiert.
Er gibt keine Bestellungen auf, authentifiziert sich nicht als Käufer und validiert nicht die Kryptografie von Zahlungsabwicklern. Ein Profil, das hier besteht, beweist, dass der Shop auffindbar ist und seine Endpunkte erreichbar sind — nicht, dass ein Checkout gelingt, ein Preis stimmt oder ein Zahlungsabwickler vertrauenswürdig ist.
Er prüft keine ACP-, AP2- oder x402-Dokumente — nur UCP. Ein deklarierter, aber unerreichbarer Endpunkt ist eine Warnung, kein Fehler: Der Endpunkt kann eine Authentifizierung verlangen, und eine 401- oder 404-Antwort zählt trotzdem als erreichbar, weil der Server geantwortet hat. Nur eine Verbindung, die vollständig fehlschlägt, zählt als unerreichbar.
Sei ehrlich zu dir selbst, bevor du einem Profil vertraust
Ein gültiges Profil ist kein funktionierender Checkout. Discovery ist der erste Schritt: Das Profil sagt, was der Shop anbietet und wo seine Endpunkte liegen. Ob diese Endpunkte echte Anfragen annehmen, echte Preise zurückgeben und eine echte Bestellung abschließen, ist eine andere Frage, und dieser Checker beantwortet sie nicht.
Eine alte Version ist aus gutem Grund eine Warnung, kein Fehler. Ein Shop auf 2026-04-08 kann weiterhin mit einer Plattform handeln, die 2026-04-08 spricht — aber eine Plattform, die nur 2026-08-25 spricht, muss Einträge ablehnen, deren Version nicht übereinstimmt; ein altes Profil schränkt also ein, wer dort einkaufen kann.
Ein 404 bedeutet meist „hier kein UCP“, nicht „Shop kaputt“. Die meisten Seiten im Internet veröffentlichen überhaupt kein UCP-Profil — die Negativ-Demo zeigt genau das. Betrachte ein fehlendes Profil als Tatsache über die Agent-Bereitschaft des Shops, nicht als Fehler des Shops selbst.
Wichtige Fakten
| Universal Commerce Protocol | Der offene Standard, mit dem ein KI-Assistent Katalog, Checkout und After-Sales eines Shops entdecken und im Auftrag eines Käufers einkaufen kann. |
| Discovery-Datei | Das JSON-Profil, das unter /.well-known/ucp auf der eigenen Domain des Shops veröffentlicht wird. |
| Neueste Version | 2026-08-25. Versionen sind Daten; die erste Version war 2026-01-11. |
| Pflichtfelder | ucp.version, ucp.services, ucp.payment_handlers — die letzten beiden müssen auch leer vorhanden sein. ucp.capabilities ist optional. |
| Cache-Regel | Cache-Control: public mit max-age von mindestens 60 Sekunden; niemals private, no-store oder no-cache. |
| Weiterleitungsregel | Profile müssen über HTTPS ohne Weiterleitungen ausgeliefert werden — jede 3xx-Antwort ist ein Fehler. |
| Offizielle Spezifikation | Universal Commerce Protocol (UCP) Official Specification |
Häufige Fragen
Warum läuft die Prüfung auf einem Server und nicht in meinem Browser?
Weil Browser ursprungsübergreifende Lesezugriffe blockieren. Eine Seite auf sysosx.com kann die Datei /.well-known/ucp eines anderen Shops nicht direkt abrufen — der Server des Shops müsste das mit CORS-Headern erlauben, und die meisten tun das nicht. Der Checker ruft die Datei von seinem eigenen Server ab, wo diese Einschränkung nicht gilt, und liefert das Ergebnis an deinen Browser.
Mein Shop läuft auf Shopify — muss ich etwas veröffentlichen?
Nein. Shopify liefert standardmäßig auf jedem Shop ein 2026-08-25-Profil unter /.well-known/ucp — probiere den Demo-Button, der allbirds.com prüft. Wenn dein Shop auf Shopify läuft und die Prüfung fehlschlägt, liegt das Problem woanders (eine Weiterleitung vor dem Shop oder eine eigene Domain, die nicht den Shop ausliefert).
Das Dokument existiert, aber das Urteil lautet „teilweise“ — was behebe ich zuerst?
Behebe zuerst die als Fehler markierten Befunde: ein fehlendes Pflichtfeld (Version, Dienste oder Zahlungsabwickler), ein Dokument, das kein gültiges JSON ist, oder eine Weiterleitung. Warnungen — ein Cache-Header unter 60 Sekunden, eine alte Version, ein unerreichbarer Endpunkt — sind Hinweise und verhindern allein kein UCP-bereit-Urteil.