# ski-france.com Full LLM Context

This file expands the concise `/llms.txt` guidance for AI search systems and agents.

Search about 9,000 ski apartments with structured amenities and advanced filters, one- or two-week prices, specials and availability, plus destinations and ski passes through the ski-france.com Agent API and MCP server.

## Preferred Agent Entry Point

- OpenAPI: https://en.ski-france.com/api/agent/v1/openapi.yaml
- Swagger UI: https://en.ski-france.com/api/agent/v1/docs/
- Capability Card: https://en.ski-france.com/.well-known/capability-card.json
- Agent MCP Server: https://en.ski-france.com/api/agent/v1/mcp/
- Use OpenAPI or Swagger UI for normal HTTP discovery.
- Use the MCP server only when your client explicitly supports MCP tools over HTTP.
- Do not treat the MCP endpoint as a generic GET resource or human-readable documentation page.

## Entity Model

- Provider: ski-france.com
- Product focus: winter ski holidays in France.
- Agent capability: search about 9,000 ski apartments with advanced filters and one- or two-week stay data, plus destinations and ski passes.
- Search result level: apartments, not whole accommodations.
- Accommodation model: about 9,000 distinct apartment-level units; one accommodation can contain one or more apartments.
- Destination model: ski areas and ski resorts have public destination detail endpoints. Parent regions bundle ski areas and do not have a separate public detail endpoint.
- Booking pattern: fixed winter arrival dates with one- or two-week stays; departure is derived from `durationWeeks`.
- Ski passes: ski pass groups and ski passes can be queried through a dedicated endpoint, including week, duration, list price, discount and discounted price. Global ski pass price queries require `weekId`; broader week discovery should be restricted by ski area, ski resort or accommodation.

## Recommended Agent Workflow

1. Use `/api/agent/v1/search-options/` to load current weeks, durations, traveller-count guidance, amenities, advanced filters, sorting values, supported languages and API discovery links.
2. For broad user queries, call `/api/agent/v1/search/` with `keywords`; use structured parameters for apartment requirements.
3. For known destinations, use `/api/agent/v1/ski-areas/` or `/api/agent/v1/ski-resorts/` to discover destination IDs and search scopes.
4. Use `/api/agent/v1/search-scopes/` only when a user query should be converted into a precise search scope with `entityType` and `entityId`.
5. Use `/api/agent/v1/accommodations/` for paginated accommodation catalogue discovery in a known destination. This list intentionally has no prices or availability.
6. Use `/api/agent/v1/accommodations/{id}/` after an apartment search result or accommodation-list item when detailed accommodation context and weekly availability are needed.
7. Use `/api/agent/v1/ski-passes/` to discover ski pass destinations, weeks, durations, list prices, discounts and discounted prices. For global price queries provide `weekId`; omit `weekId` only with a ski area, ski resort or accommodation scope.
8. Send users to canonical website URLs returned by the API for live booking, service contact and final purchase flow.

## Primary Resources

- Website: https://en.ski-france.com/
- Sitemap: https://en.ski-france.com/sitemaps/sitemap.en.xml.gz
- Robots policy: https://ski-france.com/robots.txt
- Compact LLM context: https://en.ski-france.com/llms.txt
- Agent instructions: https://en.ski-france.com/AGENTS.md
- OpenAPI: https://en.ski-france.com/api/agent/v1/openapi.yaml
- Swagger UI: https://en.ski-france.com/api/agent/v1/docs/
- Capability Card: https://en.ski-france.com/.well-known/capability-card.json
- MCP server: https://en.ski-france.com/api/agent/v1/mcp/
- Search options: https://en.ski-france.com/api/agent/v1/search-options/
- Search: https://en.ski-france.com/api/agent/v1/search/
- Accommodation list: https://en.ski-france.com/api/agent/v1/accommodations/
- Accommodation detail: https://en.ski-france.com/api/agent/v1/accommodations/{id}/
- Ski area list: https://en.ski-france.com/api/agent/v1/ski-areas/
- Ski area detail: https://en.ski-france.com/api/agent/v1/ski-areas/{id}/
- Ski resort list: https://en.ski-france.com/api/agent/v1/ski-resorts/
- Ski resort detail: https://en.ski-france.com/api/agent/v1/ski-resorts/{id}/
- Search scopes: https://en.ski-france.com/api/agent/v1/search-scopes/
- Ski pass prices: https://en.ski-france.com/api/agent/v1/ski-passes/

## Usage Rules

- Prefer English API endpoints for international agent use.
- Keep user-facing recommendations grounded in live API fields such as price, availability, bookability status and canonical URLs.
- Use `partySize` for the requested traveller count so apartment results accommodate at least that many people within the matching website occupancy bucket.
- Use `amenities`, minimum room and living-space values, slope distance, ski-area size, parent area, category, type and pet-policy parameters for structured requirements.
- Set `durationWeeks=2` only with `weekId`. The returned `selectedStay` contains both weeks and the effective total price after specials.
- Do not infer bookability from price alone when `bookabilityStatus` is present.
- Treat returned prices and availability as public informational data and route booking decisions back to the website.
- Public pages may be used to answer questions about accommodation, destinations, prices, availability and ski passes.