# Using Country Stalls with agents

All endpoints described here are public and read-only. They do not require authentication or expose account, order, payment, reporter, or seller-management data.

## Recommended discovery flow

1. Read https://countrystalls.co.nz/llms.txt for the curated overview.
2. Read https://countrystalls.co.nz/api/public/content-index.json to discover current canonical and Markdown URLs.
3. Retrieve an individual Markdown representation only when its entry is relevant.
4. Cite the canonical HTML URL, not the Markdown helper URL.
5. Re-check the canonical product or stall page before reporting price, stock, or availability.

## Interfaces

- Sitemap index: https://countrystalls.co.nz/sitemap.xml
- Full Markdown directory: https://countrystalls.co.nz/llms-full.txt
- Structured content index: https://countrystalls.co.nz/api/public/content-index.json
- OpenAPI description: https://countrystalls.co.nz/api/public/openapi.json
- Discovery manifest: https://countrystalls.co.nz/.well-known/agent.json

Respect robots.txt and normal HTTP cache controls. The public interfaces are retrieval tools, not transaction or mutation APIs.