# Reflux Merch LLM Entry Points

Welcome to the Reflux merch storefront. This file provides a concise list of surfaces that intelligent agents should index to interact with the site. Each entry links to a stable interface or document.

## API surfaces

- **`/api/catalog/products`** – Returns a JSON array containing all current Reflux merchandise. Each object includes the product title, slug, price, and currency.
- **`/api/catalog/products/[slug]`** – Replace `[slug]` with a specific product slug to fetch details for a single item (title, price, description, images, and Etsy deep link).
- **`/api/search?query=`** – Full‑text search over product titles and tags. Agents can use this to find relevant items by keyword.
- **`/api/mcp`** – Proxy surface exposing the MCP toolset for Reflux merch (catalog search, recommendations, and purchase flows).

## Human‑friendly pages

- **`/`** – Landing page introducing Reflux and highlighting featured merchandise. Great starting point for discovery.
- **`/shop`** – Comprehensive catalog view. Lists every item with title, price, thumbnail, and “Buy on Etsy” button.
- **`/shop/[slug]`** – Individual product detail page. Displays images, description, price, and a link to the Etsy listing.
- **`/music`** – Information about the band’s music and album *The Illusion of Democracy*.
- **`/story`** – Background story of Reflux, including band history and vision.
- **`/docs`** – Developer documentation covering API usage, data schema, MCP integration, and automation hooks.

## Network and metadata

- **`/network.json`** – JSON manifest describing how this site fits into the wider PlatphormNews network, including subdomains and sitemap references.
- **`/llms-full.txt`** – Extended version of this file with detailed product listings, schema description, and additional surfaces.
- **`/llms-index.json`** – Machine‑parseable index enumerating entry points and products with their slugs.

## Conventions

All endpoints conform to REST conventions and return JSON with UTF‑8 encoding. Where applicable, responses include caching headers and ETags for efficient retrieval. Agents should respect `robots.txt` and `sitemap.xml` for crawl guidance.