Outmore Living Product Search

Purpose

Search the Outmore Living catalog (outmoreliving.com) and return matching products filtered by type (chaise, sofa, lounge chair, ottoman, side table, accent pillow), collection (Solerno), and price range. For each product return: name, SKU, price, materials (teak, Sunbrella, HeatTech, ComfortCore), availability, and product page URL. Read-only — never add to cart, never check out.

When to Use

• Daily / weekly catalog monitoring (price drops, restocks of Solerno Heated * SKUs).
• Cross-shopping outdoor furniture by type or material — e.g. "all teak + Sunbrella chaises under $4000."
• Any flow that would otherwise scrape outmoreliving.com/collections/... HTML — the Shopify JSON endpoints are unauthenticated, uncached at the IP level, and return everything you'd otherwise parse out of rendered HTML.

Workflow

Outmore Living runs on stock Shopify. Do not browse the site to enumerate products — three public JSON endpoints expose the entire catalog with no auth, no cookies, no anti-bot stealth, no rate limiting that we hit, and no residential-proxy requirement (we ran browse cloud fetch --proxies only out of caution; bare HTTP works equally well). The browser fallback exists for the rare case where Shopify's JSON endpoints are temporarily 5xx-ing.

1. Pull the catalog

Three endpoints, pick the one matching your scope:

All return HTTP 200 with application/json. The catalog is small (37 published products, ~580 KB at limit=250), so paginate only if a future expansion overflows 250 items: append &page=2, &page=3, … until you get {"products":[]}.

To enumerate collections (handle + display title + product count):

GET https://outmoreliving.com/collections.json?limit=250

Current handle list (verified 2026-05-19): accessories, all, apparel (empty), chairs-ottomans, coffee-side-tables, customer-favorites, dining, heated-seating-1, heated-seating, heated-seating-copy, heated-seating-website-1-copy, loveseats-sofas, new-arrivals, power-bars-chargers, protective-covers, sets, heated-seating-dec-2025-copy, social-lander-individual-products-copy, the-solerno-collection (17 products).

2. Filter client-side

Map the user's requested filters onto the response shape:

Type → product.product_type (canonical enum observed in catalog):

Full observed enum: Cover, Chair, Chaise Lounge, Table, Set, "" (empty), Ottoman, Protective Cover, Side Table, Coffee Table, Sofa, Loveseat.

Collection (Solerno) → two equivalent options:

• Hit /collections/the-solerno-collection/products.json directly (17 products), or
• Filter the full catalog where product.title.toLowerCase().includes("solerno") (covers the same 17 + sometimes 1–2 stragglers like Heated Ottoman whose title omits the word).

The collection endpoint is canonical — prefer it.

Price → client-side numeric compare on variant.price (string, parse as Float). Each product has multiple variants (color / fabric / configuration); a product's representative price is Math.min(...variants.map(v => +v.price)). For "products under $X," include the product if any variant's price ≤ X.

Materials → derived from three signals (in order of reliability):

1. product.tags — most reliable but sparse. Observed tag vocab: Heated, Sunbrella Fabrics, Teak, best seller. Many product types lack tags entirely (covers, throws, accessories).
2. variant.option1 / variant.option2 — frame material (Teak) appears as option1 on Solerno furniture; Sunbrella fabric colors (Dove, Aloe, Indigo, Carbon, Seaglass, Java, Bisque, Cast Sand) appear as option2.
3. product.body_html substring match — required for HeatTech and ComfortCore (no tag exists for either; they're proprietary marketing names that appear only in product copy).

function deriveMaterials(p) {
  const tags = new Set(p.tags || []);
  const body = (p.body_html || "").toLowerCase();
  return {
    teak: tags.has("Teak") || (p.variants || []).some(v => v.option1 === "Teak") || body.includes("teak"),
    sunbrella: tags.has("Sunbrella Fabrics") || body.includes("sunbrella"),
    heattech: tags.has("Heated") || body.includes("heattech"),  // proxy: Heated tag ≈ HeatTech presence
    comfortcore: body.includes("comfortcore")
  };
}

Availability → product-level rollup of variant.available:

const available = (p.variants || []).some(v => v.available === true);

A product is "available" if any variant is in stock. Per-variant availability is also exposed in the response if you need color-level granularity.

3. Construct the product URL

https://outmoreliving.com/products/{product.handle} — no query string needed. Optionally append ?variant={variant.id} to deep-link to a specific color / configuration.

4. Emit the result

See Expected Output below.

Browser fallback (only if products.json returns 5xx)

Use a stealth + proxy session and parse the rendered collection page:

sid=$(browse cloud sessions create --keep-alive --proxies | node -e "let s='';process.stdin.on('data',c=>s+=c).on('end',()=>process.stdout.write(JSON.parse(s).id))")
export BROWSE_SESSION="$sid"
browse open "https://outmoreliving.com/collections/the-solerno-collection?sort_by=price-ascending" --remote
browse get markdown body --remote > /tmp/collection.md
# Markdown body contains: product title, price, "From $X" range, image alt-text.
# SKU + per-variant availability require visiting each product page individually,
# OR — better — just retry the JSON endpoint after a backoff.
browse cloud sessions update "$sid" --status REQUEST_RELEASE

The browser path costs ~50× more tokens than the JSON path and still cannot return per-variant SKU/availability without a click-through per product. Use only when the JSON endpoint is genuinely down.

Site-Specific Gotchas

• /products.json returns 37 products; the all collection lists 41. Difference = unpublished / draft products that the storefront hides but /collections/all/products.json exposes through whatever publishing rule Shopify is currently applying. For agent-facing answers, prefer the customer-visible count from /products.json. If you need the truly canonical inventory, hit /collections/all/products.json.
• The single-product endpoint /products/{handle}.json does NOT include available on variants. Field available is present on the list endpoint (/products.json and /collections/.../products.json) and the search endpoint (/search/suggest.json), but absent from the single-product detail JSON. For availability, never rely on the single-product endpoint alone — fetch the list endpoint or call /products/{handle}/variants.json separately.
• Accent pillows do not exist in the catalog. A search query for pillow or accent via /search/suggest.json?q=... returns 0 products. The closest match is the Signature Outdoor Throw. When asked for accent pillows, return an empty array plus a notes field explaining the absence — do not silently return the throw as a pseudo-match.
• Material tags are sparse and inconsistent. Teak tag is only set on the two Solerno dining tables, even though every Solerno chair / chaise / sofa is also teak-framed. You must combine tags, variant.option1/option2, and body_html substring matching to identify materials reliably. HeatTech and ComfortCore have no dedicated tags at all — they appear only in body_html. The Heated tag is a reasonable proxy for HeatTech presence (every Heated product uses HeatTech).
• SKU format varies by product family. Solerno furniture SKUs follow FU-SO-{ITEM-CODE}-{COLOR} (e.g. FU-SO-HCL-DOV = Furniture, Solerno, Heated Chaise Lounge, Dove). Protective covers use B{nnnnn}.{COLOR} (e.g. B00500.STN). Don't assume one regex — the SKU field is opaque; treat it as a passthrough string.
• product_type is inconsistent vs. title. Solerno Heated Lounge Chair has product_type: "Chair" (not "Lounge Chair"). To disambiguate "lounge chair" vs. "dining chair" vs. "swivel chair" vs. "bistro chair", match on title + product_type, not product_type alone.
• Multiple near-duplicate collections exist — heated-seating, heated-seating-1, heated-seating-copy, heated-seating-website-1-copy, heated-seating-dec-2025-copy, etc. These look like staging / A-B / lander variants the merchant hasn't cleaned up. For canonical Solerno listing, always use the-solerno-collection (17 products) — the others overlap or duplicate it.
• Compare-at-price is mostly empty ("" or "0.00") on Solerno products. One outlier observed: Dining Set Protective Cover - Rectangle has price: "700.00", compare_at_price: "280.00" — a likely data-entry error where the fields are reversed. Treat compare_at_price as best-effort and never assume it's > price.
• variants can contain hidden / draft variants. Always filter to available === true (or fall back to inventory_management === "shopify") before counting "in stock."
• No residential-proxy or stealth required. browse cloud fetch without --proxies works for all JSON endpoints in repeated testing. The site is Cloudflare-fronted but its bot rules don't block the standard Shopify storefront API. Don't waste budget on --verified sessions.
• Pagination yields empty {"products":[]} past the last page — not 404. Use that as the terminator.
• Search via /search/suggest.json?q={term}&resources[type]=product&resources[limit]=10 returns the same shape as the list endpoint plus a flattened available, price, price_min, price_max per product, and a relative url. Useful for fuzzy text search across body_html (e.g. q=ComfortCore returns every product mentioning the term).

Expected Output

{
  "query": {
    "types": ["chaise", "sofa"],
    "collection": "Solerno",
    "price_min": 0,
    "price_max": 5000
  },
  "total_matches": 2,
  "notes": [],
  "products": [
    {
      "name": "Solerno Heated Chaise Lounge",
      "product_type": "Chaise Lounge",
      "collection": "the-solerno-collection",
      "url": "https://outmoreliving.com/products/solerno-heated-chaise-lounge",
      "price_min": 3300.00,
      "price_max": 3300.00,
      "currency": "USD",
      "available": true,
      "materials": {
        "teak": true,
        "sunbrella": true,
        "heattech": true,
        "comfortcore": true
      },
      "tags": ["Heated", "Sunbrella Fabrics"],
      "variants": [
        { "sku": "FU-SO-HCL-DOV", "title": "Teak / Dove",     "price": "3300.00", "available": true },
        { "sku": "FU-SO-HCL-ALO", "title": "Teak / Aloe",     "price": "3300.00", "available": true },
        { "sku": "FU-SO-HCL-IND", "title": "Teak / Indigo",   "price": "3300.00", "available": true },
        { "sku": "FU-SO-HCL-CBN", "title": "Teak / Carbon",   "price": "3300.00", "available": true },
        { "sku": "FU-SO-HCL-SGS", "title": "Teak / Seaglass", "price": "3300.00", "available": true },
        { "sku": "FU-SO-HCL-JVA", "title": "Teak / Java",     "price": "3300.00", "available": true },
        { "sku": "FU-SO-HCL-BQE", "title": "Teak / Bisque",   "price": "3300.00", "available": true },
        { "sku": "FU-SO-HCL-CSD", "title": "Teak / Cast Sand","price": "3300.00", "available": true }
      ]
    },
    {
      "name": "Solerno Heated Sofa",
      "product_type": "Sofa",
      "collection": "the-solerno-collection",
      "url": "https://outmoreliving.com/products/solerno-heated-sofa",
      "price_min": 4800.00,
      "price_max": 4800.00,
      "currency": "USD",
      "available": true,
      "materials": { "teak": true, "sunbrella": true, "heattech": true, "comfortcore": true },
      "tags": ["Sunbrella Fabrics"],
      "variants": [ /* … */ ]
    }
  ]
}

Empty-result shape (e.g. accent pillow request):

{
  "query": { "types": ["accent pillow"], "collection": null, "price_min": null, "price_max": null },
  "total_matches": 0,
  "notes": [
    "Outmore Living's catalog contains no accent pillows. The closest item is 'Signature Outdoor Throw' (handle: signature-outdoor-throw). Returning empty result set."
  ],
  "products": []
}

Sort options (Shopify-supported, pass through as ?sort_by= on collection URLs or sort client-side after JSON fetch): manual, best-selling, title-ascending, title-descending, price-ascending, price-descending, created-ascending, created-descending.