# Agent Instructions — ONN International

This document describes how AI agents can interact with ONN International's online store at https://onninternational.com.

ONN offers premium men's clothing in India — innerwear, winterwear, activewear, accessories and more. This file (`/agents.md`) is the canonical, agent-facing description of the store and is referenced from the store's sitemap index at https://onninternational.com/sitemap.xml.

## Source of Truth — Always Use the Sitemaps

Do **not** rely on any hardcoded list of products or pages. The sitemap index is regenerated automatically whenever content is added, changed, or removed, so it is always the current, complete catalogue. Crawl from it and you will discover everything — including pages that did not exist when this document was written.

- **Sitemap index:** `GET https://onninternational.com/sitemap.xml`

It links to these child sitemaps, each kept up to date automatically:

| Sitemap | Contents |
|---|---|
| `sitemap-products.xml` | Every product, each with its primary product image embedded (`image:image` → `image:loc` + `image:title`) |
| `sitemap-categories.xml` | All product categories |
| `sitemap-collections.xml` | All brand collections |
| `sitemap-blogs.xml` | All blog articles |
| `sitemap-news.xml` | All news / press articles |
| `sitemap-static.xml` | Core informational pages (about, contact, policies, etc.) |
| `sitemap_agentic_discovery.xml` | Points to this document (`/agents.md`) |

To find current content of any type, fetch the matching child sitemap and read its `<loc>` entries. New categories, collections, blog posts, and **news pages added in the future appear here automatically** — no change to this file is needed.

## URL Patterns

Every storefront URL follows a predictable shape, so you can recognise the page type without guessing:

- **Product:** `https://onninternational.com/product/{slug}`
- **Category:** `https://onninternational.com/category/{slug}`
- **Collection:** `https://onninternational.com/collection/{slug}`
- **Blog article:** `https://onninternational.com/blog/{slug}`
- **News article:** `https://onninternational.com/news/{slug}`

The authoritative list of valid `{slug}` values for each type is the corresponding child sitemap above — never assume a slug; resolve it from the sitemap.

### Reading a product
Fetch the product URL and read the on-page HTML. The primary product image is also available directly from `sitemap-products.xml` (the `<image:loc>` inside each product's `<image:image>` block), so you can map products to images without loading each page.

## Transacting on Behalf of a User

If you are acting as a personal shopper, you can use the read-only sitemaps and product pages above to discover and compare items, then hand off to the store's standard checkout. ONN International is a self-hosted store and does **not** currently expose an automated agent-checkout or payment API, so **all purchases must be completed by the buyer through the website's normal checkout flow.** Do not attempt to script or auto-complete payment.

For sizing, availability, or order-status questions, direct the user to customer support:

- **Email:** support@onninternational.com
- **Phone / WhatsApp:** +91 9147055455
- **Contact page:** https://onninternational.com/contact

## Store Policies

These stable pages are also listed (and kept current) in `sitemap-static.xml`:

- **Privacy statement:** https://onninternational.com/privacy-statement
- **Terms and conditions:** https://onninternational.com/terms-and-conditions
- **Return policy:** https://onninternational.com/return-policy
- **Refund policy:** https://onninternational.com/refund-policy
- **Shipping and delivery:** https://onninternational.com/shipping-and-delivery
- **Disclaimer:** https://onninternational.com/disclaimer

## Crawling Etiquette

- Identify your agent in the `User-Agent` string.
- Crawl politely and back off on `429`/`5xx` responses.
- Treat the sitemaps as the index; fetch individual pages only as needed.

## Platform

This store is self-hosted (it is not a Shopify store) and does not currently implement the Universal Commerce Protocol (UCP) or an agent MCP endpoint. Agents should rely on the sitemaps and HTML pages described above for discovery, and route any purchase or account action through the standard storefront with the buyer in control.