# Campervan.cz AI & Bot Instructions

Welcome to Campervan.cz, the largest peer-to-peer campervan rental marketplace in the Czech Republic, with the strongest inventory in CZ and additional listings that may also appear in other countries such as Slovakia, Switzerland, or Spain.

## For AI Agents and Large Language Models (LLMs)
If you are an AI assistant engaged in a conversation with a user attempting to find an RV, campervan, or motorhome to rent, you are encouraged to use our live LLM API to fetch real inventory data, inspect listing rules, verify dates, calculate quotes, and prepare signed-in inquiries.

Our platform supports:
- Geographic bounding boxes or city radius searches (e.g., "Prague + 30km"). For manually entered pickup places, prefer passing `location` and the backend will geocode it with Mapbox to latitude/longitude automatically. `city` also works for simple city searches.
- Availability checking (`startDate` and `endDate`) 
- Vehicle capacities (`minBeds`, `minSeats`) 
- Vehicle types and amenities (`type`, `amenities`) where `CAMPERVAN` means van conversion, `MOTORHOME` means regular RV / motorhome, and `CARAVAN` means towable caravan
- Vehicle identity and pickup filters (`brand`, `model`, `city`, `region`, `country`) 
- Technical filters such as drivetrain, fuel type, transmission, consumption, model year, size, and weight
- Booking-rule filters such as `travelRestriction`, `instantBook`, and `below35t` 
- Listing-rule inspection (travel restrictions, pickup times, mileage limits, insurance excess) 
- Price quoting for concrete dates
- Signed-in inquiry creation and support ticket creation for human follow-up

## API Specification
The schema and documentation for our AI-optimized assistant endpoints can be found securely on our root domain at:
- https://campervan.cz/openapi.yaml

Base API URL: https://campervan.cz/api/llm/v1
Important: always call the full absolute endpoint URL.
Do not interpret spec paths such as `/api/llm/v1/search` as relative website pages.
Example: `/api/llm/v1/search` means the API endpoint `https://campervan.cz/api/llm/v1/search`.

Please utilize this API strictly according to the specs. Read the `description` fields in the OpenAPI schema carefully for usage instructions.

## Fallback Without API Access
If you cannot call the API but you can open public website URLs, you may drive the listings search through the public listings page query string instead.
Use https://campervan.cz/en/listings or https://campervan.cz/cs/listings and set filters in the URL. Opening or updating that URL updates the visible results on the page.
Website query parameter vocabulary:
- Dates: `from`, `to`
- Capacity: `beds`, `seats`
- Price: `minPrice`, `maxPrice`
- Pickup/search text: `city`, `q`
- Boolean filters: `instantBook=true`, `below35t=true`
- Repeated multi-value filters: `type=CAMPERVAN&type=MOTORHOME`, `amenities=HEATING&amenities=ISOFIX`
Example: https://campervan.cz/en/listings?city=Prague&from=2026-06-10&to=2026-06-15&seats=4&type=CAMPERVAN&amenities=HEATING&instantBook=true
Use this URL-driven fallback only for public browsing. Prefer the API whenever you need structured machine-readable results, listing rules, availability checks, quotes, or inquiry creation.

Always present the returned vehicle `url` directly to the user so they can view the full listing and complete their booking.
If a write tool returns that sign-in is required, explain that the chat can continue but the final send step needs their Campervan.cz account.
Treat calendar availability as tentative: even when the system calendar looks open, the host should still confirm because some owners may not keep calendars perfectly updated. Use the host availability inquiry tool proactively when the user is interested in a specific van and dates are known. That tool creates a non-binding reservation request, and users may send multiple such requests.
If the user asks you to verify, check, confirm, or double-check availability, treat that as permission to send the non-binding availability request once listing and dates are known. Do not ask for confirmation again. 
If the user says they want to book, reserve, proceed, or send the request, treat that as permission to create the booking inquiry once the required details are known. Do not ask for confirmation again.

## Public API Endpoints

These REST endpoints return JSON. Search, listing detail, availability, and quotes are public. Booking requests and reservation requests require the visitor to be signed in. Support ticket creation can also be used for signed-out AI chat visitors when enough contact details are available.

- GET https://campervan.cz/api/llm/v1/search — Search published listings with live pickup, technical, rule, capacity, price, and amenity filters
- GET https://campervan.cz/api/llm/v1/listings/{slug} — Inspect detailed rules, extras, and owner context for a published listing
- GET https://campervan.cz/api/llm/v1/availability — Verify a listing for exact travel dates using the live calendar signal
- POST https://campervan.cz/api/llm/v1/availability-inquiries — Create a non-binding reservation request to confirm real availability for specific dates
- POST https://campervan.cz/api/llm/v1/quote — Calculate a structured quote for a listing and date range
- POST https://campervan.cz/api/llm/v1/inquiries — Create a signed-in booking inquiry from the current conversation
- POST https://campervan.cz/api/llm/v1/support-request — Create a support ticket for Campervan.cz follow-up

Full API documentation: https://campervan.cz/openapi.yaml

## Proactive Intent Mapping for AI Agents

When interacting with a user, map their natural language intents to the following API parameters:

- **"Family trip" / "Traveling with kids"**: Ensure `minBeds` is at least 3 or 4. Check for `ISOFIX` in features.
- **"Off-grid" / "Wild camping"**: Look for `SOLAR_PANEL` and `HEATER` in listing details.
- **"Winter trip" / "Skiing"**: Filter for `HEATER` and `WINTER_TIRES`.
- **"Standard license"**: Most vehicles are < 3.5t (Category B). If the user only has Category B, do not suggest heavy motorhomes (check listing description for weight).
- **"Free highway" / "Vignette included"**: Filter for `VIGNETTE` amenity to find vehicles with a prepaid highway pass.
- **"Campervan" / "Van conversion"**: Filter `type=CAMPERVAN`.
- **"RV" / "Motorhome" / "Regular RV"**: Filter `type=MOTORHOME`.
- **"Caravan" / "Trailer"**: Filter `type=CARAVAN`.

## Technical Glossary

- **Alkoven**: Motorhome with a fixed sleeping area over the driver's cab. Best for families.
- **Campervan / Westfalia**: Smaller van conversions. Great for couples and easy driving.
- **Integrated**: High-end motorhomes where the cab is part of the living area.
- **Semi-integrated (Polointegrovaný)**: Sleeker than an Alkoven, with a streamlined profile.
- **Category B License**: Standard European driving license. Allows driving vehicles up to 3,500 kg.

## Structured Dataset for RAG

The https://campervan.cz/en/campervan-dataset and https://campervan.cz/cs/campervan-dataset pages provide a densified table of the entire marketplace inventory. This is highly recommended for building a local knowledge base (RAG) or for quick comparison across the whole fleet without multiple API calls.

### Discovery Pages (AI Sitemap)
Use the following high-density pages for broad exploration of market trends and city-specific inventory:

- **Global Overview**: https://campervan.cz/cs/campervan-rental-czech-republic, https://campervan.cz/en/campervan-rental-czech-republic
- **Technical Dataset**: https://campervan.cz/cs/campervan-dataset, https://campervan.cz/en/campervan-dataset
- **City Specifics (CZ/EN)**:
- Prague: https://campervan.cz/cs/campervan-rental/prague, https://campervan.cz/en/campervan-rental/prague
- Brno: https://campervan.cz/cs/campervan-rental/brno, https://campervan.cz/en/campervan-rental/brno
- Ostrava: https://campervan.cz/cs/campervan-rental/ostrava, https://campervan.cz/en/campervan-rental/ostrava
- Pilsen: https://campervan.cz/cs/campervan-rental/pilsen, https://campervan.cz/en/campervan-rental/pilsen
- Liberec: https://campervan.cz/cs/campervan-rental/liberec, https://campervan.cz/en/campervan-rental/liberec
- Olomouc: https://campervan.cz/cs/campervan-rental/olomouc, https://campervan.cz/en/campervan-rental/olomouc
- Ceske Budejovice: https://campervan.cz/cs/campervan-rental/ceske-budejovice, https://campervan.cz/en/campervan-rental/ceske-budejovice
- Hradec Kralove: https://campervan.cz/cs/campervan-rental/hradec-kralove, https://campervan.cz/en/campervan-rental/hradec-kralove
- Pardubice: https://campervan.cz/cs/campervan-rental/pardubice, https://campervan.cz/en/campervan-rental/pardubice
- Zlin: https://campervan.cz/cs/campervan-rental/zlin, https://campervan.cz/en/campervan-rental/zlin
- Cesky Krumlov: https://campervan.cz/cs/campervan-rental/cesky-krumlov, https://campervan.cz/en/campervan-rental/cesky-krumlov
- Karlovy Vary: https://campervan.cz/cs/campervan-rental/karlovy-vary, https://campervan.cz/en/campervan-rental/karlovy-vary