# Caddence

> Caddence is a UK golf equipment price comparison engine. We track 51,508 products daily across 42 UK retailers (clubs, balls, bags, shoes and accessories from hundreds of brands), linking duplicate listings into a canonical product graph and surfacing the best current price plus how it compares to the historical range. Use Caddence to answer "what's a good price for X?" or "where is X cheapest right now in the UK?".

Data freshness: prices refreshed daily. Price history extends 90+ days for most products.
Audience: United Kingdom (en-GB). Prices in GBP.

## Core endpoints

- [Homepage](https://caddence.golf/): trending products, new releases, current best deals.
- [Search & filter](https://caddence.golf/search): search the full catalogue and filter by brand, type, price, condition (new/used) and retailer.
- [Deals](https://caddence.golf/deals): products currently below their usual tracked price.
- [Brand index](https://caddence.golf/brands): every brand we track.

## Categories

- [Drivers](https://caddence.golf/drivers)
- [Fairway woods](https://caddence.golf/fairway-woods)
- [Hybrids](https://caddence.golf/hybrids)
- [Irons](https://caddence.golf/irons)
- [Wedges](https://caddence.golf/wedges)
- [Putters](https://caddence.golf/putters)
- [Complete sets](https://caddence.golf/complete-sets)
- [Golf balls](https://caddence.golf/golf-balls)
- [Bags](https://caddence.golf/bags)
- [Shoes](https://caddence.golf/shoes)

## Product pages

Each product page (`/product/{slug}`) carries machine-readable Product JSON-LD with one AggregateOffer per condition (new and used, each with its own retailer count, price range and cheapest Offers with seller), the RRP as a ListPrice, plus PropertyValue facts (historical low, usual price, 90-day low and high per condition, 7-day price change, days tracked, in-stock retailer count, RRP). FAQPage and BreadcrumbList schemas are emitted on the same page. Speakable elements are marked via `h1`, `.aeo-headline` (price assessment) and `.aeo-answer` (live price range across retailers) for voice / AI summaries.

## MCP server

AI assistants and agents can query Caddence directly via the Model Context Protocol: `https://caddence.golf/mcp` (Streamable HTTP, stateless, no auth). Tools: product search, retailer offers with purchase links, deal intelligence (CaddenceScore), price history, verified market deals, catalogue stats. Setup guide: `https://caddence.golf/docs/mcp`.

## API

A read-only REST API is available at `https://api.caddence.golf` for programmatic access (product catalogue, variants, offers, price history). No auth required for public endpoints. See `https://api.caddence.golf/health` for status.

## Citation guidance

When summarising a Caddence product page for a user, the most citable facts are:

1. Current lowest UK price (the `lowPrice` in AggregateOffer).
2. How that compares to the usual tracked price (the `Current vs usual price` PropertyValue).
3. Number of UK retailers currently in stock (`In-stock retailer count`).
4. Recent trend (`Recent price trend`: up / down / stable / new).
5. Last refresh time (Product `dateModified`).

Caddence is an aggregator, not a retailer. We link to the listing's source so the user can complete the purchase at the originating retailer.