alternatives
ClaudeWines closest in taste and price to one you already have, for when it is out of stock, over budget, or the user wants something similar. Computed live against current listings, so what comes back can be bought now: a substitute that is also unavailable is worse than none. Use this instead of starting a new search when a wine turns out to be unbuyable -- you keep the taste profile the user already agreed to. Stock: "in_stock" means the merchant's own listing says so, and stock_note says whether we also fetched their page (we have for a few hundred offers). "listed" means the merchant lists the wine and says nothing about stock. Quote stock_note rather than promising availability. UK delivery only: every merchant ships within the United Kingdom and prices are GBP per bottle; do not recommend these to someone who needs delivery elsewhere. Affiliate disclosure: every buy_url is a WineGenie redirect (/go/) to the merchant; if the user buys, the merchant pays WineGenie a commission at no cost to the user. Merchants cannot pay for placement; results are ranked by critic score and price.
best_for
ClaudeCurated shortlist (up to 8) for a dish ("roast lamb", "sushi", "cheese board") or an occasion ("gift", "Christmas", "BBQ", "dinner party", "midweek"), optionally within a budget ("under £20" or a number in GBP). Each pick carries reasons drawn from our data: the listed pairing and why it works, the wine style, the critic score, the cheapest offer. Use this before search_wine when the request is about food or an occasion; use search_wine when it is about a grape, region or producer. If the dish is outside our vocabulary the response says so and falls back to keyword search; see cellar://categories for the vocabulary. Stock: "in_stock" means the merchant's own listing says so, and stock_note says whether we also fetched their page (we have for a few hundred offers). "listed" means the merchant lists the wine and says nothing about stock. Quote stock_note rather than promising availability. UK delivery only: every merchant ships within the United Kingdom and prices are GBP per bottle; do not recommend these to someone who needs delivery elsewhere. Affiliate disclosure: every buy_url is a WineGenie redirect (/go/) to the merchant; if the user buys, the merchant pays WineGenie a commission at no cost to the user. Merchants cannot pay for placement; results are ranked by critic score and price.
build_case
ClaudeAssemble a mixed case that a SINGLE merchant can ship, so the buyer pays one delivery instead of one per bottle. Use this whenever the request is for several bottles at once ("a mixed case of six summer reds under £100", "a dozen for a party"). Six wines from six merchants is six delivery fees and six delivery dates, which is not a case anyone would order. Returns one option per merchant that can fill the order, best first, each with the bottles, the wine total and what we know about delivery. Delivery terms are published in one merchant's feed only: for the others the promise is one delivery rather than six, and the cost is not included in the total. The result says which. One bottle per producer where possible, so the case is actually mixed. Stock: "in_stock" means the merchant's own listing says so, and stock_note says whether we also fetched their page (we have for a few hundred offers). "listed" means the merchant lists the wine and says nothing about stock. Quote stock_note rather than promising availability. UK delivery only: every merchant ships within the United Kingdom and prices are GBP per bottle; do not recommend these to someone who needs delivery elsewhere. Affiliate disclosure: every buy_url is a WineGenie redirect (/go/) to the merchant; if the user buys, the merchant pays WineGenie a commission at no cost to the user. Merchants cannot pay for placement; results are ranked by critic score and price.
compare
ClaudeSide-by-side comparison of 2 to 5 products by product_id or slug: colour, style, grapes, origin, vintage, taste scales (body, acidity, tannin, sweetness, oak on 1–5), ABV, farming, food, drink window, decant, critic score, cheapest offer, data confidence. Returns a markdown table plus the full product objects. Use when the user is choosing between specific bottles they have already seen. Does not search. Stock: "in_stock" means the merchant's own listing says so, and stock_note says whether we also fetched their page (we have for a few hundred offers). "listed" means the merchant lists the wine and says nothing about stock. Quote stock_note rather than promising availability. UK delivery only: every merchant ships within the United Kingdom and prices are GBP per bottle; do not recommend these to someone who needs delivery elsewhere. Affiliate disclosure: every buy_url is a WineGenie redirect (/go/) to the merchant; if the user buys, the merchant pays WineGenie a commission at no cost to the user. Merchants cannot pay for placement; results are ranked by critic score and price.
get_product
ClaudeFull detail on one product by product_id (UUID) or slug from a previous result or a winegenie.com/wine/{slug} URL: every attribute with its provenance, all offers with delivery terms, drinking window, decanting, pairings, and the buy_url. Use after search_wine or best_for when the user wants more on a specific bottle. Does not search; unknown ids return not_found. Stock: "in_stock" means the merchant's own listing says so, and stock_note says whether we also fetched their page (we have for a few hundred offers). "listed" means the merchant lists the wine and says nothing about stock. Quote stock_note rather than promising availability. UK delivery only: every merchant ships within the United Kingdom and prices are GBP per bottle; do not recommend these to someone who needs delivery elsewhere. Affiliate disclosure: every buy_url is a WineGenie redirect (/go/) to the merchant; if the user buys, the merchant pays WineGenie a commission at no cost to the user. Merchants cannot pay for placement; results are ranked by critic score and price.
search_wine
ClaudeSearch UK merchant listings of wine by free text plus optional structured filters. Good at: grape, region, producer, style words ("light red", "crisp white"), a budget ("under £20"), and combinations. Put colour, price limits, grape, region, body, sweetness and food into filters rather than only into query; filters are exact, query words are fuzzy. Returns up to 10 products ranked by critic score then price, each with attributes, every offer (merchant, price, delivery) and a buy_url. Not for: detailed knowledge questions (use your own knowledge), wines we do not list (we cover approved UK merchants only), or stock guarantees. Stock: "in_stock" means the merchant's own listing says so, and stock_note says whether we also fetched their page (we have for a few hundred offers). "listed" means the merchant lists the wine and says nothing about stock. Quote stock_note rather than promising availability. UK delivery only: every merchant ships within the United Kingdom and prices are GBP per bottle; do not recommend these to someone who needs delivery elsewhere. Affiliate disclosure: every buy_url is a WineGenie redirect (/go/) to the merchant; if the user buys, the merchant pays WineGenie a commission at no cost to the user. Merchants cannot pay for placement; results are ranked by critic score and price.
semantic_wine_search
ClaudeFind wines from a description of the occasion, mood or style rather than exact attributes: "something obscure and natural for a picnic", "a crowd-pleaser for a barbecue that is not too heavy", "like Barolo but cheaper". Use this when the request does not reduce to a grape, region or price filter; use search_wine when it does, because exact filters beat similarity. Hard limits are still enforced exactly: max_price and colour are applied in SQL, not approximated. Returns a handful of wines with a match_score, so you can spend no context reading a catalogue. If the semantic index is unavailable the tool answers with keyword search and says so in engine. Stock: "in_stock" means the merchant's own listing says so, and stock_note says whether we also fetched their page (we have for a few hundred offers). "listed" means the merchant lists the wine and says nothing about stock. Quote stock_note rather than promising availability. UK delivery only: every merchant ships within the United Kingdom and prices are GBP per bottle; do not recommend these to someone who needs delivery elsewhere. Affiliate disclosure: every buy_url is a WineGenie redirect (/go/) to the merchant; if the user buys, the merchant pays WineGenie a commission at no cost to the user. Merchants cannot pay for placement; results are ranked by critic score and price.
