Before — no catalog endpoint
# GET /.well-known/acp/query?q=trail+running+shoes — stock Next.js
HTTP/2 404 Not Found
# There is no machine catalog to query. A shopping agent
# falls back to scraping rendered HTML, one product page
# at a time — no structured comparisons, no trade-offs,
# no fit signals. Nothing to recommend from.
After — your normalized catalog
# GET /.well-known/acp/query?q=trail+running+shoes
{
"query": "trail running shoes",
"mode": "search",
"products": [
{
"id": "trail-runner-gtx",
"title": "Trail Running Shoes",
"brand": "Acme Outdoor",
"url": "https://acme-outdoor.com/products/trail-runner-gtx",
"variants": [
{
"id": "trail-runner-gtx-9",
"title": "US 9 / Slate",
"price": { "amount": 12900, "currency": "USD" },
"availability": { "available": true, "status": "in_stock" },
"barcodes": [ { "type": "gtin", "value": "0123456789012" } ]
}
],
"reviews": { "average_rating": 4.7, "review_count": 482 },
"intelligence": {
"best_for": ["technical descents", "wet-rock grip"],
"key_tradeoffs": ["heavier than road runners", "runs half a size small"],
"why_choose_over": { "altra-lone-peak": "Stickier on wet rock; firmer midfoot hold." },
"ideal_buyer": "Trail runner who prizes grip and stability over plush cushioning.",
"decision_narrative": "Pick these for technical, wet terrain — and size up half a size."
}
}
],
"storeInsights": { "totalProducts": 1240, "bestOverallValue": "trail-runner-gtx" },
"curatedQueries": [
{ "pattern": "waterproof trail shoes", "topPickSlug": "trail-runner-gtx" }
]
}