Find shops
market_searchFind shops in the Lucerna market by what they do, what they say about themselves, AND WHAT THEY ACTUALLY STOCK. Use this when you know what you are shopping for but not which shop — 'a barber in Denver', 'heavyweight black tee'. Words are matched against each shop's own prose and against its live shelf — titles, descriptions, categories, tags and variant labels — so you can search for the PRODUCT and not only for a shop that happens to describe itself using your word. Each row says which it was (matched_on: words, shelf, or both). unreachable names any shop whose shelf refused, so a shop that stocks the thing and would not answer is never silently missing from your count. Filter with can to require a capability. Results are alphabetical: there is no paid placement and no ranking to game. Then call shop_lookup or concierge_ask on one. THIS SEARCHES SHOPS AND THEIR SHELVES, NOT THIS PLATFORM'S OWN PRODUCTS. A shop sells tees, food and files; the platform's own subscription lines (agent memory, video generation, mailboxes, plans) are never on a shelf, so a search here for 'saas', 'subscription' or 'pricing' will correctly find nothing — call platform_catalog for those, and never report an empty market as proof that none exist.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | words to match against a shop's name, tagline, description, mission and location AND the words on its live shelf (titles, descriptions, categories, tags, variant labels) — every word must appear somewhere, so more words narrow the result. 'san diego tee' can match a town from the shop's prose and a product from its shelf. | |
| can | No | require ALL of these capabilities: bookings (takes appointments), shop (sells goods), quote (quotes custom work by walking a concierge), tips | |
| limit | No | how many shops to return (default 24, max 100) | |
| offset | No | skip this many — page with `total` from the answer |