# Agent Instructions — España

This store supports AI-driven catalogue discovery over the Universal Commerce Protocol (UCP).

## Commerce Protocol (UCP)
- Discovery — GET https://www.alqvimia.com/es/.well-known/ucp  (merchant profile: versions, capabilities)
- MCP endpoint — POST https://www.alqvimia.com/es/agent/mcp  (Content-Type: application/json)

### Typical agent flow (v1)
1. Discover  — GET /.well-known/ucp
2. Search    — search_catalog
3. Inspect   — get_product / lookup_catalog
4. Cart      — create_cart, then give the shopper the returned continue_url to review and complete
(The agent builds the cart; the shopper completes checkout in the browser — checkout requires human approval.)

### Supported UCP versions
- 2026-04-08 (latest stable)
- 2026-01-23

### Rules
- Pass context.address_country and context.currency for accurate pricing/availability.
- Respect rate limits; back off on 429.
- Checkout requires human approval. Do not complete payment without explicit buyer consent.

## Read-Only Browsing (No Authentication Required)
The store serves these JSON endpoints itself (no auth, no GraphQL dependency):
- Products / search — GET https://www.alqvimia.com/es/agent/products.json?q={query}&page={n}
- Single product    — GET https://www.alqvimia.com/es/agent/products/{url_key}.json
- Category products — GET https://www.alqvimia.com/es/agent/collections/{url_key}/products.json
- Sitemap           — GET https://www.alqvimia.com/es/sitemap.xml
- Agent discovery   — /agents.md (canonical) and /llms.txt (mirror), plus /.well-known/ucp


## Product Categories

- [TIENDA ONLINE](https://www.alqvimia.com/es/tienda-online.html)

- [Cuidado Corporal](https://www.alqvimia.com/es/tienda-online/cuidado-corporal.html)

- [COLECCIONES](https://www.alqvimia.com/es/colecciones.html)

- [Silueta](https://www.alqvimia.com/es/colecciones/silueta.html)

- [Aceites Corporales](https://www.alqvimia.com/es/tienda-online/cuidado-corporal/aceites-corporales.html)

- [Elixires y Emulsiones Corporales](https://www.alqvimia.com/es/tienda-online/cuidado-corporal/elixires-emulsiones-corporales.html)

- [Bienestar](https://www.alqvimia.com/es/colecciones/bienestar.html)

- [Reina de Egipto](https://www.alqvimia.com/es/colecciones/reina-de-egipto.html)

- [Cuidado de manos](https://www.alqvimia.com/es/colecciones/cuidado-manos.html)

- [Niños y Bebés](https://www.alqvimia.com/es/colecciones/ninos-y-bebes.html)

- [Essentially Feminine](https://www.alqvimia.com/es/colecciones/essentially-feminine.html)

- [Essentially Masculine](https://www.alqvimia.com/es/colecciones/essentially-masculine.html)

- [Aromaterapia](https://www.alqvimia.com/es/tienda-online/aromaterapia.html)

- [Aceites Esenciales](https://www.alqvimia.com/es/tienda-online/aromaterapia/aceites-esenciales.html)

- [Aceites Esenciales](https://www.alqvimia.com/es/colecciones/aceites-esenciales.html)

- [Cuidado Facial](https://www.alqvimia.com/es/tienda-online/cuidado-facial.html)

- [Cuidado de Día](https://www.alqvimia.com/es/tienda-online/cuidado-facial/cuidado-dia.html)

- [Rituales Faciales](https://www.alqvimia.com/es/tienda-online/rituales-regalos/rituales-faciales.html)

- [Aceites Vegetales](https://www.alqvimia.com/es/colecciones/aceites-vegetales.html)

- [Vitalidad](https://www.alqvimia.com/es/colecciones/vitalidad.html)

- [Exfoliación y Limpieza Facial](https://www.alqvimia.com/es/tienda-online/cuidado-facial/exfoliacion-limpieza-facial.html)

- [Absolute Beauty](https://www.alqvimia.com/es/colecciones/absolut-beauty.html)

- [Perfumes y Colonias Naturales](https://www.alqvimia.com/es/tienda-online/cuidado-corporal/colonias-y-perfumes.html)

- [Rituales de Aromaterapia](https://www.alqvimia.com/es/tienda-online/rituales-regalos/rituales-aromaterapia.html)

- [Rituales y Regalos](https://www.alqvimia.com/es/tienda-online/rituales-regalos.html)

- [Essentially Beautiful](https://www.alqvimia.com/es/colecciones/essentially-beautiful.html)

- [Preparados de Aceites Esenciales](https://www.alqvimia.com/es/tienda-online/aromaterapia/preparados-de-aceites-esenciales.html)

- [Cofres de Regalo](https://www.alqvimia.com/es/tienda-online/complementos-y-regalos/cofres-de-regalo.html)

- [Cofres Experiencia](https://www.alqvimia.com/es/colecciones/cofres-experiencia.html)

- [Rituales Esenciales](https://www.alqvimia.com/es/colecciones/rituales-esenciales.html)

- [Eternal Youth](https://www.alqvimia.com/es/colecciones/eternal-youth.html)

- [Exfoliación y Limpieza Corporal](https://www.alqvimia.com/es/tienda-online/cuidado-corporal/exfoliacion-limpieza-corporal.html)

- [Mascarillas](https://www.alqvimia.com/es/tienda-online/cuidado-facial/mascarillas.html)

- [Nutricosmética Natural](https://www.alqvimia.com/es/tienda-online/cuidado-corporal/nutricosmetica-natural.html)

- [Tónicos Corporales](https://www.alqvimia.com/es/tienda-online/cuidado-corporal/tonicos.html)

- [Tónicos Faciales](https://www.alqvimia.com/es/tienda-online/cuidado-facial/tonicos.html)

- [Body Sculptor](https://www.alqvimia.com/es/colecciones/body-sculptor.html)

- [Rituales Corporales](https://www.alqvimia.com/es/tienda-online/rituales-regalos/rituales-corporales.html)

- [Travel Sizes Corporal](https://www.alqvimia.com/es/tienda-online/cuidado-corporal/travel-sizes-corporal.html)

- [Cuidado de Noche](https://www.alqvimia.com/es/tienda-online/cuidado-facial/cuidado-noche.html)

- [Contorno de Ojos](https://www.alqvimia.com/es/tienda-online/cuidado-facial/contorno-de-ojos.html)

- [Ingredientes Destacados](https://www.alqvimia.com/es/tienda-online/ingredientes-destacados.html)

- [Bio-Retinol](https://www.alqvimia.com/es/tienda-online/ingredientes-destacados/bio-retinol.html)

- [Retinal](https://www.alqvimia.com/es/tienda-online/ingredientes-destacados/retinal.html)

- [Ácido Hialurónico](https://www.alqvimia.com/es/tienda-online/ingredientes-destacados/hyaluronic-acid.html)

- [Vitamina C](https://www.alqvimia.com/es/tienda-online/ingredientes-destacados/vitamina-c.html)

- [Antioxidantes](https://www.alqvimia.com/es/tienda-online/ingredientes-destacados/antioxidantes.html)

- [Ingredientes Holísticos](https://www.alqvimia.com/es/tienda-online/ingredientes-destacados/ingredientes-holisticos.html)

- [Radiance](https://www.alqvimia.com/es/colecciones/radiance.html)

- [Accesorios y Complementos](https://www.alqvimia.com/es/tienda-online/complementos-y-regalos/complementos.html)



## Store Policies