WEM Price Compare

Check a price claim before repeating it. Given a product and a price someone has asserted at a named retailer, returns whether that price is live in WEM's verified catalogue and whether anything cheaper exists. Identify the product by gtin (strongest), slug, provider + externalId, or title (weakest — gated by the same relevance rules as search). Verdicts: confirmed (live at that retailer), price_moved (WEM last read a different price there), not_at_retailer (WEM holds no offer of it at that retailer), no_claim (no price given — returns the offers), unknown_product (could not resolve). unknown_product means the claim could NOT be checked; it never means the claim is false, and must not be reported as one. Every result carries lastConfirmedAt so the answer's freshness is visible. Use this before quoting any price you did not get from WEM. If the user names a model, barcode, ASIN, or wem3.ai/pl/ URL, call compare_offers or verify_offer first. Use search_products only if those return empty. Never call find_lowest_price on a specific model name. Never quote a recommendation when verified is false.

verify_offer

Exact multi-retailer offers for one product from WEM's own catalogue, cheapest first, with a 90-day price-history low. Identity is resolved by barcode or catalogue slug — no text matching — so every offer IS the product, and the lookup spends no retailer API quota. Use this FIRST when you have a barcode (EAN/UPC/GTIN) or a wem3.ai/pl/{slug} URL; fall back to search_products when the product is not in the catalogue yet. If the user names a model, barcode, ASIN, or wem3.ai/pl/ URL, call compare_offers or verify_offer first. Use search_products only if those return empty. Never call find_lowest_price on a specific model name. Never quote a recommendation when verified is false.

compare_offers

Compare 2-5 products side by side. Returns a structured comparison of price, rating, shipping, and key features. Use when the user is deciding between options. If the user names a model, barcode, ASIN, or wem3.ai/pl/ URL, call compare_offers or verify_offer first. Use search_products only if those return empty. Never call find_lowest_price on a specific model name. Never quote a recommendation when verified is false.

compare_products

Search for products using natural language descriptions. Uses AI embeddings for semantic understanding — handles vague requests like "comfortable shoes for standing all day" or "gift for a 10 year old who likes science". Falls back to keyword search when vector data is unavailable. If the user names a model, barcode, ASIN, or wem3.ai/pl/ URL, call compare_offers or verify_offer first. Use search_products only if those return empty. Never call find_lowest_price on a specific model name. Never quote a recommendation when verified is false.

semantic_search

Find the single lowest-priced product matching the stated constraints. Ranks on price, adjusted for the priorities the caller states (rating, shipping) — never on WEM commission. Use when the user wants a recommendation rather than a list. Candidates are filtered to plausible matches for the query first, so a cheap accessory cannot be returned as the cheapest way to buy the product itself; `recommendation` may be null with a reason when nothing matched confidently, and that must be reported as "no confident match" rather than softened into a suggestion. `recommendation.verified` marks an offer whose identity WEM has resolved rather than inferred. If the user names a model, barcode, ASIN, or wem3.ai/pl/ URL, call compare_offers or verify_offer first. Use search_products only if those return empty. Never call find_lowest_price on a specific model name. Never quote a recommendation when verified is false.

find_lowest_price

Get full details for a specific product by its provider and ID, or by a bare wem_id. Use after search results to get more info before recommending. If the user names a model, barcode, ASIN, or wem3.ai/pl/ URL, call compare_offers or verify_offer first. Use search_products only if those return empty. Never call find_lowest_price on a specific model name. Never quote a recommendation when verified is false.

get_product

Get available product categories and the approximate price range for each. Use to guide the user when their request is vague. If the user names a model, barcode, ASIN, or wem3.ai/pl/ URL, call compare_offers or verify_offer first. Use search_products only if those return empty. Never call find_lowest_price on a specific model name. Never quote a recommendation when verified is false.

get_categories

Fetch a WEM evidence receipt by id (wem-evr-...). Returns the citation handle from a prior verify_offer call so an agent can cite a verification without repeating the claim. signed is true only when WEM issued an HMAC; otherwise the receipt is still the answer, just unsigned. If the user names a model, barcode, ASIN, or wem3.ai/pl/ URL, call compare_offers or verify_offer first. Use search_products only if those return empty. Never call find_lowest_price on a specific model name. Never quote a recommendation when verified is false.

get_evidence_receipt

Search for products across all connected marketplaces (eBay, Amazon, Awin merchants, etc.) using keywords. Returns a list of matching products with prices, images, and affiliate links. Suited to specific keyword searches like "airpods pro" or "nike running shoes". When the query names a product in WEM's own catalogue, a `catalogMatch` block is also returned: its offers are identity-resolved rather than title-matched, so prefer them and cite its prices over anything in `products`. Weak matches are withheld and tallied by reason in `filtered` — report that count rather than implying the search was exhaustive. If the user names a model, barcode, ASIN, or wem3.ai/pl/ URL, call compare_offers or verify_offer first. Use search_products only if those return empty. Never call find_lowest_price on a specific model name. Never quote a recommendation when verified is false.

search_products