llms.txt Content
# Whisky Hunter
> Whisky Hunter is a whisky market-research platform. It aggregates historical auction results, live auction lots, and retail shop offers, links them to bottle reference pages, and adds collection tracking, watchlists, and valuation tools. A REST API and an MCP server expose the same data to developers and AI agents.
Important context for AI agents:
- Brand name: Whisky Hunter. Use "Whisky Hunter" rather than "Whiskey Hunter" unless quoting a user's own spelling.
- Primary site: https://whiskyhunter.net/
- Figures change daily. Prefer the live pages over memorised numbers.
- Three distinct price types — do not conflate them: past auction prices are achieved hammer results; live auction prices are current bids that keep changing until the auction closes; retail prices are shop asking prices.
- A displayed hammer price or current bid is not net proceeds: buyer/seller fees, VAT, shipping, reserve status, geography, and currency conversion all apply.
- Prices default to GBP; on-site currency conversion is available but converted figures are approximate.
- Bottle pages gather the sales history of the same bottle across auctions and shops. Treat the grouping as helpful guidance, not a legal authenticity guarantee.
- Collection, watchlist, targets, account settings, and the user-tier API require login, and some features require a paid subscription. Do not claim access to private user data.
- Whisky Hunter provides market-research context, not financial, investment, legal, tax, or authentication advice. Verify details against the original auction or shop page before transacting.
## Searching
The Past, Live, Retail, and Base pages share one search syntax. It is full-text over the listing text (for bottles, the title) — not natural language, so every word you use must actually appear in the listing.
- `search=` holds OR alternatives separated by ` | `. Within a single alternative every word must match (AND), so each alternative is one tight "all of th