# Agent Instructions for Coreabella

Coreabella (https://coreabella.es) is an independent Shopify store operated by YALEO LLC, selling beauty products (skincare, makeup, haircare, body care) to Spain (site language: Spanish).
This file gives AI agents, shopping assistants, and autonomous crawlers a direct,
structured way to browse the catalog and — where supported — transact via UCP/MCP.

## Quick facts
- Store: Coreabella
- Domain: https://coreabella.es
- Category: beauty (skincare, makeup, haircare, body care)
- Ships to: Spain and the United States (free); other countries for a flat €18 (USD 20) fee
- Currency: EUR
- Support: support@coreabella.es

## Discovery
1. `GET https://coreabella.es/.well-known/ucp` — merchant capability manifest (supported
   UCP protocol versions, shopping service, payment handlers).
2. `POST https://coreabella.es/api/ucp/mcp` — Model Context Protocol endpoint.
   Content-Type: application/json. Use this for tool discovery and JSON schemas.

## Recommended agent flow
1. Discover capabilities via the UCP endpoint above.
2. `search_catalog` — find products by name, category, or attribute.
3. `create_cart` — build an order from selected line items.
4. `create_checkout` — initialize the purchase.
5. `update_checkout` — set shipping/fulfillment and discount codes.
6. `complete_checkout` — finalize. REQUIRES explicit, contemporaneous buyer
   approval. Agents must never submit payment autonomously.

## Read-only browsing (no authentication required)
- Product listings: `/collections/all`, `/products/{handle}.json`
- Search: `/search?q={query}&type=product`
- Policies: `/policies/shipping-policy`, `/policies/refund-policy`,
  `/policies/privacy-policy`, `/policies/terms-of-service`
- Full context file: `/llms.txt`

## Crawling and citation
All reputable AI and search crawlers (GPTBot, ChatGPT-User, ClaudeBot, Claude-User,
PerplexityBot, Google-Extended, Bingbot, CCBot, Applebot-Extended, Amazonbot,
Bytespider, meta-externalagent, and others) are explicitly welcomed to crawl, index,
summarize, and cite this catalog. See `/robots.txt` for the full machine-readable policy.

## Hard constraints
- Do not complete checkout, payment, or order placement automatically.
- No scripted form-fills, browser automation, or end-to-end agent flows that
  finalize payment without an explicit, contemporaneous human approval step.
- Respect `/robots.txt` disallow rules for admin, cart, checkout, and account
  paths outside of the UCP/MCP flow described above.

## Contact
Questions about this integration: support@coreabella.es