Für integrierende Agenten
Wie unsere Begriffe auf das Universal Commerce Protocol abbilden
OpenShopGraph beschreibt eine Discovery-/Trust-Schicht, nicht die Shopping-Catalog-Schicht von UCP — diese Seite benennt die Entsprechung ausdrücklich, statt sie zu erraten zu überlassen.
Ein-Satz-Antwort: die Namen sind kohärent, weil sie eine andere Schicht beschreiben als UCP und das ehrlich tun; wir übernehmen kein einziges UCP-Wort, wir dokumentieren nur die Zuordnung.
Keine Namensänderungen. Kein Tool- oder Feldname ist eine nachgewiesene Stolperstelle für einen Agenten — find_shop, get_shop, list_coupons,
get_trust, report_* sind selbsterklärend und tragen ausführliche Beschreibungen. Ein Umbenennen auf UCP-Namen wäre ein Breaking Change für jeden Konsumenten der live laufenden MCP-Schnittstelle, mit Alias-Pflege auf unbestimmte Zeit, für keinen Nutzen. Die zwei echten Stolperstellen waren keine Namen, sondern Fakten: eine veraltete Versionszeichenkette im Agent-Profil und eine falsch gezählte Tool-Bilanz in llms.txt (beide separat behoben, in derselben Änderung).
| UCP-Begriff | OSG-Begriff | Deckungsgrad | Anmerkung |
|---|---|---|---|
| Agent profile (ucp-agent.profile, HTTPS, JSON) | /ucp/agent-profile.json | deckungsgleich | Derselbe Discovery-Handschlag. (Die Version war veraltet — 2026-04-08 gegen den damals aktuellen Stand 2026-08-25 — behoben am 2026-09-04, E1.) |
| Capability dev.ucp.shopping.catalog.search | find_shop | teilweise | UCP sucht Produkte (Item); OSG sucht Shops. |
| Capability dev.ucp.shopping.catalog.lookup | get_shop | teilweise | Gleiche Richtung, andere Granularität (Shop statt Item). |
| Item (id, title, price) | get_shop.offers | teilweise | Nur ein Schema-Platzhalter — die Offer-Tabelle war laut Messung vom 2026-07-30 leer; das Feld existiert, liefert aber noch keine Daten. |
| Discount.codes | list_coupons → code | teilweise | UCP kennt nur die Code-Zeichenkette. OSG trägt zusätzlich verificationStatus/lastVerifiedAt/validUntil (siehe nächste Zeile) — in Discount.codes gepresst würde aus "per echtem Checkout bewiesen" nur "eine Zeichenkette". |
| no counterpart | verificationStatus, lastVerifiedAt, validUntil | OSG-eigen | Das Proof-Konzept (ein echter Checkout-Versuch gegen einen Code) hat in UCP kein Gegenstück. |
| dev.ucp.shopping.fulfillment (named as an example only, not verified against a schema) | get_shipping_policy | nicht bewertbar — OFFEN | Das Feldschema stand im Quell-Dossier nicht zur Verfügung — als offen markiert statt geraten. |
| no counterpart | get_trust (source, checked_at, signal_coverage) | OSG-eigen | Selbst gemessene Vertrauenssignale (TLS, Hosting, Registrierung) ohne Gesamtwertung — kein UCP-Gegenstück. |
| Message (type, code, content, path) | report_code, report_issue | kein Gegenstück | Andere Richtung: UCPs Message läuft vom Händler zum Agenten; OSGs Reports laufen vom Agenten zu OSG. Keine gleiche Beziehung — nicht verwechseln. |
| Merchant/Customer schema | shop_domain / shop_id_or_domain | nicht bewertbar — OFFEN | UCPs händlerseitige Felder standen im Quell-Dossier nicht zur Verfügung — als offen markiert statt geraten. |
| Checkout, Cart, LineItem, Totals, QuantityUnit, Action, payment instruments, payment_handlers | none | bewusst leer | Bewusst leer — Checkout/Payment ist eine andere Schicht (ACP-/AP2-Territorium), keine versehentliche Lücke. Kein ACP-Checkout, keine AP2-Mandate, keine payment_handlers. |
Namensraum-Regel für künftige OSG-eigene UCP-Erweiterungen
OSG-eigene Begriffe (verificationStatus, signal_coverage , und weitere) werden, falls sie je über UCP exponiert werden, ausschließlich unter einem Reverse-Domain-Namensraum von openshopgraph geführt — zum Beispiel com.openshopgraph.trust — niemals unter
dev.ucp.* , das der Governance von UCP selbst vorbehalten bleibt.
Das ist kein Gedankenspiel: UCPs eigene Spec sieht genau dieses Erweiterungsmuster vor (siehe Shopifys eigenes dev.shopify.catalog / dev.shopify.catalog.global als Präzedenzfall) — ein OSG-Konzept stattdessen in ein bestehendes UCP-Feld zu pressen, würde dessen Bedeutung verengen. Genau dieses Risiko benennt und vermeidet dieses Dokument.