search_used_goods
Search MaggyFinds for used and pre-owned goods. Uses hybrid vector + BM25 keyword search with AI reranking. Understands natural language, SKUs, reference numbers, grade codes (PSA 10, MS70, BGS 9.5), and condition slang (DS, VNDS, GUC, EUC). Returns ranked products with ai_description and condition_grade for easy parsing.
lookup_product
Retrieve structured product data from MaggyFinds. Three modes: "identifier" resolves a canonical_id to full data; "variants" finds all colorways/sizes/years for a brand+model; "market_signal" returns aggregated stats (year range, MSRP distribution, condition breakdown) for a product family.
get_listings
Get active marketplace listings for a specific product canonical_id. Returns vendor URLs, prices, conditions, and listing freshness. Phase 4.5 freshness policy: listings older than 7 days are excluded entirely (hard filter); listings older than 24h carry stale:true and a [stale] warning — treat these as lower-confidence. last_verified echoes the retrieval timestamp so callers can surface data age to users. Use after search_used_goods to get purchasable offers for a specific product.