# KAIBEAUTY - AI Agentic Commerce Interface

> KAIBEAUTY (kaibeauty.me) is a curated, medical-grade Korean Beauty (K-Beauty) global commerce platform.
> This document specifies structured interfaces and endpoints for AI agents (OpenAI Operator, Claude, Perplexity, AutoGPT) to search verified cosmetic products, inspect INCI ingredients, compute transparent landed costs (product + international express shipping), and generate delegated one-click checkout sessions.

## Core Capabilities for AI Agents

- **Product Discovery & Ingredients**: Over 6,000 verified Korean skincare products with full INCI ingredients in English, dermatological goal matching (Hydration, Soothing, Barrier, Tone, Texture, Elasticity), and caution screening.
- **Transparent Landed Cost Quoting**: Breakdown of product pricing, weight-based international express shipping (EMS directly from Seoul, South Korea), and final USD checkout amounts without hidden fees.
- **Delegated Checkout Sessions**: Instant creation of pre-filled Shopify checkout URLs for users to approve and complete payments via Apple Pay, Google Pay, or Credit Cards with one click.

## Agent API Endpoints

- `GET /api/agent/products`: Search and filter products by skin concerns, ingredient safety, and category.
- `POST /api/agent/quote`: Calculate exact itemized cost breakdown (subtotal, shipping, total landed cost in USD).
- `POST /api/agent/checkout`: Generate an instant, verified Shopify checkout URL with cart lines pre-filled.
- `GET /api/agent/tools.json`: Machine-readable tool schemas compatible with OpenAI Function Calling and Claude Tool Use.

## Verification & Trust

All products are authenticated directly from authorized Korean manufacturers. Ingredient safety and claims are verified against MFDS (Ministry of Food and Drug Safety) standards.
For detailed documentation and tool definitions, see `/llms-full.txt` or `/api/agent/tools.json`.