# Agent Instructions - Okazo

This document describes how AI agents and personal shopping assistants can interact with Okazo at https://okazo.fr.

## Store Scope

Okazo sells secondhand books, video games, consoles, and accessories. Products are grouped by edition, identifier, or model, then offered by condition (Comme neuf, Très bon, Bon, Correct) as variants. A special copy (signed, rare edition, lot) is its own product with its own photos. Agents should use the selected variant, condition fields, included-item details, defects, photos, price, and availability before recommending an item.

## Recommended Commerce Path

This store supports Shopify agentic commerce surfaces. Use the discovery endpoint first:

- UCP discovery: `GET https://okazo.fr/.well-known/ucp`
- UCP/MCP endpoint: `POST https://okazo.fr/api/ucp/mcp`
- Product search page: `GET https://okazo.fr/search?q={query}&type=product`
- Product JSON: `GET https://okazo.fr/products/{handle}.json`
- Sitemap: `GET https://okazo.fr/sitemap.xml`

For personal shopping agents that can use Shopify's Shop skill, prefer the buyer-approved Shop skill path over screen scraping or scripted checkout:

- Shop skill: https://shop.app/SKILL.md

## Typical Agent Flow

1. Discover capabilities with `/.well-known/ucp`.
2. Search or look up products through UCP/MCP when available.
3. Compare condition, included items, defects, compatibility, price, shipping, and returns.
4. Add items to cart or create checkout only after the buyer confirms the selected item.
5. Do not complete payment without explicit, contemporaneous buyer approval.

## Important Rules

- Do not invent product condition, completeness, compatibility, or availability.
- Do not treat validation or `TEST - ...` products as launch inventory.
- Do not complete checkout, payment, or order placement automatically.
- Respect rate limits and private paths in `robots.txt`.
- Use buyer context such as country and currency when a protocol supports it.

## Store Policies

- Privacy policy: https://okazo.fr/policies/privacy-policy
- Terms of service: https://okazo.fr/policies/terms-of-service
- Refund policy: https://okazo.fr/policies/refund-policy
- Shipping policy: https://okazo.fr/policies/shipping-policy
- Contact: https://okazo.fr/pages/contact