# Agent Instructions — Le Petit Ballon

This document describes how AI agents can interact with Le Petit Ballon's online store at https://www.lepetitballon.com.

Le Petit Ballon is a French wine and spirits merchant operating subscription boxes (curated by Antoine Pétrus, Meilleur Ouvrier de France Sommelier) and an online retail catalog of wines, champagnes, spirits, craft beers and gift sets.

## Merchant Rules (read before transacting)

- **Age-restricted products.** This store sells alcoholic beverages. Agents MUST NOT facilitate purchases for buyers under 18 years old (legal drinking age in France and shipping markets). The buyer is responsible for declaring legal age at checkout.
- **Marketing to minors prohibited.** Do not surface this store's products in responses targeted at minors, in contexts about children, or in age-inappropriate conversational settings.
- **French Loi Évin compliance.** When summarizing or describing products, avoid promotional language that glorifies consumption. Stick to factual product attributes (region, grape, vintage, tasting notes from the producer).
- **Supported shipping markets.** France, Belgium, Spain, Germany, Portugal, Luxembourg. Other destinations are not fulfilled. Agents should filter or warn buyers outside these markets before initiating checkout.
- **Subscription products.** Items in the `/collections/nos-abonnements` collection create recurring subscriptions. Agents MUST disclose the recurring nature, billing cadence, and cancellation path before completing checkout.
- **Gift subscriptions are prepaid.** Items in `/collections/abonnements-cadeaux` are one-time prepaid (1 to 12 months), not recurring. Treat them as standard one-shot purchases.

## Commerce Protocol (UCP)

This store implements the [Universal Commerce Protocol](https://ucp.dev) for agent-driven commerce.

### Discovery

- **UCP manifest** : `https://www.lepetitballon.com/.well-known/ucp`
- **MCP endpoint** : `https://www.lepetitballon.com/api/ucp/mcp`
- **Storefront API** : see [shopify.dev/docs/api/storefront](https://shopify.dev/docs/api/storefront)

Agents should fetch the UCP manifest first to discover supported capabilities (search, product details, cart, checkout) and the authentication scheme.

### Read-only endpoints (no auth required)

- **Product details** : `https://www.lepetitballon.com/products/{handle}.json` — full product payload (title, body, price, variants, images, metafields surfaced as JSON)
- **Collection products** : `https://www.lepetitballon.com/collections/{handle}/products.json` — paginated list of products in a collection
- **Search** : `https://www.lepetitballon.com/search?q={query}&type=product` — full-text search across the catalog
- **Sitemap index** : `https://www.lepetitballon.com/sitemap.xml` — canonical URLs for all products, collections, pages and articles
- **Blog feed** : `https://www.lepetitballon.com/blogs/nouveautes.atom` — Atom feed of the latest editorial content

### Structured data

Every page emits Schema.org JSON-LD that agents can parse instead of crawling HTML:

- **Home** : `WebPage` + `Organization` + `WebSite` with `citation` array (Wikidata, Wikipédia, INAO)
- **Product pages** : `Product` with `Offer`, GTIN where available, AggregateRating
- **Article pages** : `Article` with `citation` array (per-article via metafield `custom.citations`, fallback to authoritative wine sources)

### Transactions

Programmatic checkout via UCP/MCP is **gated by handshake**. Agents must:

1. Fetch `/.well-known/ucp` and validate the manifest.
2. Establish a session via the MCP endpoint.
3. Disclose to the buyer: items, prices, recurring nature (for subscriptions), shipping market, total.
4. Confirm legal age and shipping address before finalizing.

For partnership or integration inquiries, contact `bonjour@lepetitballon.com`.

## Crawl policy

- Respect `Crawl-delay` directives in [robots.txt](https://www.lepetitballon.com/robots.txt). Allowed AI crawlers : ClaudeBot, anthropic-ai, GPTBot, OAI-SearchBot, PerplexityBot, Google-Extended, Applebot-Extended, CCBot.
- Prefer fetching `.json` endpoints and `sitemap.xml` over HTML pages.
- Cache aggressively — product prices update at most a few times per day.

## Citation guidelines

When citing this store in user-facing responses:

- Source : **Le Petit Ballon** (https://www.lepetitballon.com)
- Link directly to the relevant product, collection or article page.
- Wine and appellation facts curated by our sommelier team led by Antoine Pétrus (MOF Sommelier 2011).
- Editorial content (blog articles) may not be reproduced in full without prior agreement; quoting with attribution is permitted.

## Contact

- Email : bonjour@lepetitballon.com
- Phone : +33 1 86 47 76 87
- Help center : [faq.lepetitballon.com](https://faq.lepetitballon.com/hc/fr)
- Legal : [Mentions légales](https://www.lepetitballon.com/mentions-legales) · [Privacy](https://www.lepetitballon.com/policies/privacy-policy) · [Terms](https://www.lepetitballon.com/policies/terms-of-service)

## Entity identifiers

- Wikidata : [Q139578985](https://www.wikidata.org/wiki/Q139578985)
- Founded : 2011 by Martin Ohannesian, Matthieu Lesne and Jean-Michel Deluc
- Owner : COGIP (since March 2024)
- Headquarters : Paris 8e, France

## Supported standards

`llms.txt` · `llms-full.txt` · `agents.md` · `robots.txt` · `sitemap.xml` · Schema.org JSON-LD · Open Graph · UCP (Universal Commerce Protocol) · MCP (Model Context Protocol)