find_best_merchant

io.github.primoliquors/beacon · Verify this server

Rank merchants that can actually fulfill a purchase need, by honest signals only. Args: category: product category, e.g. "vodka". ship_to: ISO region the order must ship to, e.g. "US-FL". require_age_gate: only return merchants that enforce 21+. limit: max results. optimize_for: what matters to the BUYER -- "trust" (default), "price" (lowest matched price), or "speed" (same-day, then next-day fulfillment). Ties always break by earned trust. product_type/dest_state/channel: pass all three (e.g. "spirits", "FL", "ship"|"local_delivery") for STRICT COMPLIANCE mode -- only merchants with attested age-gate + attested license + a legal jurisdiction path are returned, each with its compliance verdict. Every result carries ships_to states (match them against where the buyer lives), best_price, and the evidence behind the record. Paid placement never affects any ranking (ranking_basis states the basis actually used).