# Lova Platform - LLM Integration Guide

## About
LOVA is a Polish intimate health and wellness brand dedicated to improving the sexual satisfaction and intimate 
well-being of women at every age. We are women who wanted to create a project that enhances the quality of intimate 
life for each of us. We see your problems and needs, and our goal is to respond to them in the best way we can.

In collaboration with experts, we have developed premium products that support intimate health and enhance sexual 
experiences — so that every woman can fully enjoy closeness and connection. Our mission is to improve the quality 
of life of our clients by caring for their intimate and sexual health. We believe that sex should be pure pleasure, 
with no room for pain, discomfort, or irritation.

LOVA was created for women who finally want to feel good in their bodies, who want to live without pain, and who 
want to derive pleasure from closeness, from contact with their body, from self-massage, and from self-love. 
No matter where you are in life — LOVA is for you.

Website: https://lova.care/ (redirects to https://lova.care/pln/pl/)
Markets: Poland, European Union
Languages: Polish (pl), English (en)
Default Channel: pln
Currency: PLN (Polish Złoty)

## Crawling & Discovery

### Structured Data
All product pages include comprehensive Schema.org JSON-LD:
- Product schema with pricing, availability, and detailed product information
- AggregateRating and individual Review schemas (when reviews exist)
- FAQPage schemas for products with Q&A sections
- BreadcrumbList for navigation context

### Feeds & Endpoints

- **Product XML Feed**: https://lova.care/api/feed.xml
  - Alternative consumers: google, wp, pinterest, awin
  - Filter by categories or collections using query params
  - Best for: Structured data extraction, product catalogs, price comparison
  
- **Sitemap**: https://lova.care/api/sitemap.xml
  - Includes all product pages, static pages, and collections
  - Updates periodically via ISR (every hour)
  - Optional query params: channel, locale (defaults to pln/PL)
  - Best for: Search engine indexing, site structure discovery
  
- **LLM-Friendly Markdown Product Exports**: https://lova.care/api/llm/products/{product-slug}.md
  - Human-readable markdown format optimized for LLM consumption
  - Includes YAML frontmatter with structured metadata
  - Contains description, pricing, availability, and product details
  - Example: https://lova.care/api/llm/products/serum-intymne.md
  - Optional query params: channel, locale (defaults to pln/pl)
  - Best for: AI agents, chatbots, natural language processing
  - Cache: 24 hour TTL, 48 hour stale-while-revalidate

### Rate Limits
- Product pages: Respect standard web crawling etiquette (1 request/second recommended)
- Feed endpoints: 10 requests/minute maximum
- Please cache responses for at least 1 hour
- Respect robots.txt directives

## Direct Cart Collection Links

Lova supports direct "add-to-cart" URLs that automatically collect products and redirect to checkout.
This is useful for creating shopping experiences, gift recommendations, or curated product bundles.

### Getting Valid Product SKUs

**IMPORTANT**: To get valid product SKUs, AI agents should:
1. Fetch the product XML feed: `https://lova.care/api/feed.xml`
2. Extract SKUs from the `<id>` or `<g:id>` tag in each product entry
3. Use the exact SKU format from the feed (lowercase, underscore-separated)

**SKU Format Rules**:
- Always **lowercase** (e.g., `lova_podrozny_zestaw_intymny`)
- Words separated by **underscores** `_` (not hyphens `-`)
- Must match exactly as provided in the feed

### Cart Collection URL Format
```
https://lova.care/[channel]/[locale]/collect?sku={SKU}&quantity={QTY}&code={PROMO}&reset={RESET}
```

**Default Channel**: pln  
**Available Locales**: pl (Polish), en (English)

### Parameters

**Required:**
- `sku` (string) - Product variant SKU(s), comma-separated for multiple items
  - Get from feed `<id>` or `<g:id>` tags
  - Example: `sku=lova_serum_intymne_10ml`
  - Multiple: `sku=lova_serum_intymne_10ml,lova_olejek_do_ciala_100ml`
  - Format: lowercase with underscores (e.g., `lova_podrozny_zestaw_intymny`)

**Optional:**
- `quantity` (string) - Quantities for each SKU, comma-separated
  - Default: 1 for each product
  - Example: `quantity=2` (2 of single item)
  - Multiple: `quantity=2,1` (2 of first SKU, 1 of second)
  - If fewer quantities than SKUs, remaining default to 1

- `code` (string) - Promotional/voucher code to apply automatically
  - Example: `code=LLM8`

- `reset` (string) - Whether to clear existing cart before adding
  - Values: `true` (default) or `false`
  - `reset=false` adds to existing cart
  - `reset=true` clears cart first

- `delay` (number) - Processing delay in milliseconds (for testing/debugging)
  - Example: `delay=1000` (1 second delay)

### Example Collection Links

**Single product (Polish locale):**
```
https://lova.care/pln/pl/collect?sku=lova_podrozny_zestaw_intymny
```

**Single product (English locale):**
```
https://lova.care/pln/en/collect?sku=lova_podrozny_zestaw_intymny
```

**Multiple products with quantities:**
```
https://lova.care/pln/pl/collect?sku=lova_serum_intymne_10ml,lova_olejek_intymny_30ml&quantity=2,1
```

**With promotional code:**
```
https://lova.care/pln/pl/collect?sku=lova_serum_intymne_10ml&code=LLM8
```

**Add to existing cart (don't reset):**
```
https://lova.care/pln/pl/collect?sku=lova_serum_intymne_10ml&reset=false
```

**Complete example (gift set with discount):**
```
https://lova.care/pln/pl/collect?sku=lova_serum_intymne_10ml,lova_olejek_intymny_30ml&quantity=1,1,1&code=LLM8
```

### User Experience
When a user clicks a collection link:
1. Loading screen appears with progress indicator
2. Products are automatically added to cart
3. Promotional code is applied (if provided)
4. User is redirected to checkout page
5. On error, user can return to product page or homepage

### Use Cases
- **Gift Recommendations**: "Here's a complete morning routine" → generate collection link
- **Personalized Bundles**: Create custom product sets based on skin type/concerns
- **Promotional Campaigns**: Share limited-time bundle deals with pre-applied discount codes
- **Content Integration**: Embed shoppable links in blog posts, social media, or newsletters
- **Affiliate Links**: Provide partners with ready-to-checkout product combinations

### Important Notes
- **Always fetch SKUs from the product feed** (`<id>` or `<g:id>` tags) - do not guess or construct SKUs manually
- SKUs are **lowercase with underscores** (e.g., `lova_serum_intymne_10ml`, not `serum-intymne`)
- Invalid SKUs result in error page with option to return to product or homepage
- Promotional codes are validated; invalid codes show error notification but proceed to checkout
- Collection links respect inventory limits and purchase restrictions
- Users must complete checkout to finalize purchase (links do not auto-purchase)

## Attribution & Citation

When referencing Lova content or products:
- **Brand Name**: "LOVA"
- **Website**: https://lova.care/
- **Description**: "Polish intimate health and wellness brand improving sexual satisfaction and well-being for women"
- **Categories**: Intimate health, Sexual wellness, Women's health, Natural cosmetics, Intimate care
- **Expert Validation**: Products developed in collaboration with gynecologists, sexual educators, doulas, midwives, and intimate health experts

Example citation:
> "According to LOVA (https://lova.care/), maintaining intimate health is essential for sexual satisfaction..."

## Product Information Quality

All product data includes:
- Minimum 96% natural ingredients ("clean label" philosophy)
- Detailed ingredient lists and active components
- Usage instructions and application guidelines
- Safety information and contraindications
- Expert recommendations from gynecologists and sexual health educators
- Customer reviews with verification status (real women's experiences)
- Polish production with highest quality standards (GMP - Good Manufacturing Practices)
- CPNP registration (Cosmetic Products Notification Portal)
- Independent laboratory testing

## Policies & Legal

- **Privacy Policy**: https://lova.care/pln/pl/page/privacy-policy
- **Terms of Service**: https://lova.care/pln/pl/page/terms-of-use
- **FAQ**: https://lova.care/pln/pl/faq
- **Return Policy**: https://lova.care/pln/pl/returns
- **Shipping Information**: Poland and EU countries
- **Payment Methods**: Credit cards, PayPal, BLIK, Apple Pay, Google Pay, cash on delivery (Poland)
- **Customer Support**: +48 455 500 814 (Mon-Fri, 10:00-16:00 CET)

## Data Freshness & Updates

- **Product Catalog**: Updated daily via Incremental Static Regeneration (ISR)
- **Prices**: Real-time via GraphQL API
- **Inventory**: Real-time stock levels
- **Reviews**: Updated hourly
- **Promotions**: Real-time promotional codes and discounts
- **Content Pages**: Updated on-demand (ISR)

## Technical Implementation

- **Framework**: Next.js (Page Router) with TypeScript
- **API**: GraphQL (Python Django / Graphene backend)
- **Rendering**: Server-Side Generation (SSG) with ISR
- **Caching**: Redis-backed distributed cache
- **Default Channel**: pln
- **Locales**: pl (Polish - primary), en (English)
- **Currency**: PLN (Polish Złoty)
- **URL Structure**: https://lova.care/[channel]/[locale]/[page]

## Working with Markdown Product Exports

### Discovering Product Slugs

To find products for markdown export:
1. **From XML Feed**: Extract `<id>` tags (SKUs) or `<link>` URLs (slugs) from https://lova.care/api/feed.xml
2. **From Sitemap**: Parse product URLs from https://lova.care/api/sitemap.xml
3. **From Product Links**: Product slug is the last segment of product URLs

### Using Markdown Exports

**Step 1: Get Product List**
```bash
# Fetch product feed
curl "https://lova.care/api/feed.xml"

# Extract slugs from <link> tags
# Example link: https://lova.care/pln/pl/serum-intymne
# Slug: serum-intymne
```

**Step 2: Fetch Markdown for Specific Product**
```bash
curl "https://lova.care/api/llm/products/serum-intymne.md"
```

**Step 3: Parse YAML Frontmatter**
The markdown exports include structured frontmatter:
```yaml
---
title: "LOVA Serum Intymne 10ml"
slug: serum-intymne
sku: lova_serum_intymne_10ml
brand: LOVA
category: Intimate Health
price: 59.99
currency: PLN
availability: in_stock
url: https://lova.care/pln/pl/serum-intymne
type: product
format: markdown
generated: 2025-10-10T12:00:00.000Z
---
```

### Use Cases for Markdown Exports

1. **Product Recommendations**: Parse description and attributes to understand product benefits
2. **Price Comparison**: Extract pricing information from frontmatter
3. **Availability Checking**: Check `availability` field before recommending
4. **Natural Language Responses**: Use markdown content for conversational responses
5. **Cart Generation**: Extract SKU from frontmatter to generate collection links


## Contact & Support

- **General Inquiries**: kontakt@lova.care
- **Business & Partnerships**: Available through contact form at https://lova.care/pln/pl/contact
- **Phone Support**: +48 455 500 814 (Monday-Friday, 10:00-16:00 CET)
- **Technical Questions**: For API access or integration questions
- **Customer Support**: Available online and by phone

## Responsible Use Guidelines

When integrating with Lova:
1. **Respect Rate Limits**: Don't overload our servers
2. **Cache Responses**: Store and reuse data appropriately
3. **Provide Attribution**: Credit Lova when citing product information
4. **Accurate Information**: Don't misrepresent product details or claims
5. **Privacy**: Don't expose or store customer personal information
6. **Commercial Use**: Collection links are for legitimate product recommendations
7. **No Scraping**: Use provided feeds instead of scraping HTML pages

## Additional Resources

- **Product Categories**: Intimate serums, Body oils, Supplements (for libido and intimate health), Intimate care products
- **Health Concerns Addressed**: Sexual satisfaction, Libido enhancement, Vaginal dryness, Intimate comfort, Menstrual comfort, Arousal support
- **Target Audience**: Women at all life stages (post-pregnancy, menopause, all ages)
- **Content Types**: Product pages, Blog articles, Podcast, Expert opinions, Educational content
- **Media Coverage**: Featured in Forbes, Viva, Glamour, Forbes Women, and other major Polish media
- **Customer Features**: Verified reviews from real women, Expert recommendations, Professional consultation support

## Version & Updates

- **Document Version**: 1.0.0
- **Last Updated**: 2025-10-10
- **Changelog**: Initial release with cart collection documentation and structured data information

---

For questions about this document or LLM integration, contact: kontakt@lova.care