Metadata Standard

Schema.org Product JSON-LD — machine-readable product data for autonomous agents.

Why Schema.org?

Every AI model is trained on web data saturated with Schema.org markup. By using Schema.org Product as the metadata format, any AI agent can parse Katanga listings without the Katanga SDK — it's standard JSON-LD.

Compatible with OpenAI/Stripe's Agentic Commerce Protocol (ACP), Google/Shopify's Universal Commerce Protocol (UCP), and Google's Agent-to-Agent Protocol (A2A).

Standards Used

Standard	Purpose
Schema.org Product	Core product schema (name, price, offers, shipping)
GTIN (GS1)	Global product identification (UPC/EAN barcode)
UNSPSC	UN product classification (8-digit category code)
ISO 4217	Currency codes (USD, NZD, etc.)
ISO 3166-1	Country codes for shipping regions
ISO 8601	Timestamps
ISO 80000	Units of measurement (weight, dimensions)

Example

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Wireless Earbuds Pro",
  "description": "Premium wireless earbuds with ANC",
  "sku": "WEB-001",
  "gtin": "0012345678905",
  "brand": {
    "@type": "Brand",
    "name": "SoundTech"
  },
  "category": "Electronics > Audio > Headphones",
  "unspsc": "43191501",
  "offers": {
    "@type": "Offer",
    "price": 29.99,
    "priceCurrency": "USD",
    "availability": "InStock",
    "itemCondition": "NewCondition"
  },
  "weight": {
    "@type": "QuantitativeValue",
    "value": 0.05,
    "unitCode": "KGM"
  },
  "countryOfOrigin": "CN",
  "shippingDetails": {
    "@type": "OfferShippingDetails",
    "shippingDestination": [
      {
        "@type": "DefinedRegion",
        "addressCountry": "US"
      },
      {
        "@type": "DefinedRegion",
        "addressCountry": "GB"
      }
    ],
    "deliveryTime": {
      "@type": "ShippingDeliveryTime",
      "transitTime": {
        "@type": "QuantitativeValue",
        "minValue": 4,
        "maxValue": 7,
        "unitCode": "DAY"
      }
    }
  },
  "katanga:supplierAddress": "0xeF31369D...",
  "katanga:listingId": 1,
  "katanga:chainId": 114
}

Key Fields for Agent Evaluation

These are the fields a buyer agent uses to evaluate and rank listings:

Field	Weight	Source
offers.price	40%	IPFS metadata
reputation score	35%	On-chain (KatangaReputation)
deliveryTime.transitTime	25%	IPFS metadata
offers.availability	filter	IPFS metadata
shippingDestination	filter	IPFS metadata + on-chain