# Agent instructions — ShoppersLane

This document describes how AI agents, shopping assistants, and LLM crawlers can discover and interact with **ShoppersLane**.

> Store URL: https://www.shopperslane.com.au  
> Currency: AUD  
> Sitemap: https://www.shopperslane.com.au/sitemap.xml

## Store overview

ShoppersLane is a Shopify storefront. Use the read-only URLs below for catalog discovery. For checkout and cart actions, use the Universal Commerce Protocol (UCP) endpoints.

## Commerce protocol (UCP)

This store supports agent-driven commerce via the Universal Commerce Protocol:

- **Discovery:** `GET https://www.shopperslane.com.au/.well-known/ucp`
- **MCP endpoint:** `POST https://www.shopperslane.com.au/api/ucp/mcp`

### Supported UCP versions


- 2026-08-25 (latest)

- 2026-04-08

- 2026-01-23


## Read-only catalog browsing

Use these patterns to fetch structured product data (JSON) without rendering HTML:

| Resource | URL pattern |
| -------- | ----------- |
| All products | `GET /collections/all` |
| Collection | `GET /collections/{handle}` |
| Product JSON | `GET /products/{handle}.json` |
| Search | `GET /search?q={query}&type=product` |
| Sitemap | https://www.shopperslane.com.au/sitemap.xml |

Product JSON includes title, description, variants, pricing (AUD), availability, and media URLs.

## Content and policies

- **Policies:** `/policies` (shipping, returns, privacy, terms)
- **Pages:** `/pages/{handle}`
- **Blog:** `/blogs/{handle}`

## Guidance for AI systems

1. **Pricing and availability** — Always read live product JSON or UCP responses; do not cache prices as authoritative.
2. **Images** — Product and collection images include descriptive alt text derived from product names, collection names, or merchant-provided labels.
3. **Structured data** — Product, collection, article, FAQ, and breadcrumb JSON-LD is embedded in HTML pages when enabled by the merchant.
4. **Indexing** — Cart, customer account, search results, and gift-card pages may be marked `noindex`.
5. **Alternate discovery files** — `/llms.txt` and `/llms-full.txt` mirror this document unless a dedicated template overrides them.

## Contact

Do not scrape private merchant contact details from this file. Refer shoppers to the store contact page at `/pages/contact` when available.