# Farmazone — instructions for AI / LLM / automation clients

STOP: Do not scrape HTML at /produce/ — it is slow (full app shell + database).
- https://www.farmazone.co.za/ is a fast static home page only (no live prices in HTML).
You cannot read prices reliably from app HTML pages.

## Use these URLs instead (fast JSON & plain text)
1. API manifest (start here): https://www.farmazone.co.za/api/v1/
2. National produce snapshot: https://www.farmazone.co.za/api/v1/fresh-produce/snapshot
3. Market lines example: https://www.farmazone.co.za/api/v1/fresh-produce/markets/JOH/lines?product=001
4. SAFEX contracts: https://www.farmazone.co.za/api/v1/safex/contracts
5. Full field guide: https://www.farmazone.co.za/llms.txt
6. OpenAPI schema: https://www.farmazone.co.za/api/v1/openapi.json

## Optional human overview (static HTML, no database)
- Site home (static): https://www.farmazone.co.za/

## Rate limits
- Plain-text discovery (this file, llms.txt, robots, OpenAPI): not rate-limited.
- JSON data endpoints: 1000/h per IP — fetch snapshot once, then paginate.

## If responses are slow or empty
- Set PUBLIC_SITE_URL on the server to https://www.farmazone.co.za
- Ensure PUBLIC_API_ENABLED=true in production.
- On HTTP 429, back off; do not request every HTML URL.

## Market codes
JOH Johannesburg, PRE Pretoria, DUR Durban, BFN Bloemfontein, CPT Cape Town.