# Para desarrolladores y agentes

Las salidas libres de 45 campos, los campos, las zonas y los torneos también están disponibles para programas y asistentes de IA. Sin clave ni registro, solo lectura.

## Salidas libres: GET /api/tee-times

Lee en directo las hojas de salidas de los clubes y devuelve las horas libres con su precio por jugador (cuando el club lo publica) y el enlace para reservar en la web del club.

### Parámetros

- `date`: Día, AAAA-MM-DD (en hora de Madrid).
- `area`: Zona: madrid, toledo, guadalajara, segovia, avila, burgos, costa-del-sol o valencia.
- `courses`: Campos concretos, por id o por slug, separados por comas.
- `players`: Jugadores, de 1 a 4.
- `holes`: 9 o 18 hoyos.
- `from`: Primera hora de salida, HH:MM.
- `to`: Última hora de salida, HH:MM.
- `band`: Franja del día: morning, midday o afternoon.
- `maxPrice`: Precio máximo por jugador, en euros.
- `order`: Orden: time (por hora) o price (más barato primero).
- `lang`: Idioma de los textos: es o en.

### Ejemplo

```sh
curl "https://teesdesalida.es/api/tee-times?date=2026-10-17&area=madrid&players=2&from=08:00&to=11:00&order=price&lang=es"
```

## Datos estáticos

- [/data/courses.json](https://teesdesalida.es/data/courses.json): Los campos: ubicación, zona, recorrido, instalaciones, tarifas publicadas y antelación de reserva.
- [/data/areas.json](https://teesdesalida.es/data/areas.json): Las zonas y sus campos.
- [/data/tournaments.json](https://teesdesalida.es/data/tournaments.json): Los torneos próximos; se regenera cada día.
- [/openapi.json](https://teesdesalida.es/openapi.json): La descripción OpenAPI de la API.

## Servidor MCP

Un servidor MCP remoto (Streamable HTTP, sin estado y sin autenticación) con estas herramientas:

    https://teesdesalida.es/mcp

- `search_tee_times`: busca salidas libres por día, zona, campos, hora, jugadores y precio.
- `list_areas`: las zonas y cuántos campos tiene cada una.
- `list_courses`: los campos de una zona o de todas.
- `get_course`: la ficha de un campo: tarifas, instalaciones, antelación y enlaces.
- `list_tournaments`: los torneos próximos, por zona o por campo.

### En Claude

Ajustes → Conectores → Añadir conector personalizado, y pega la URL del servidor.

### En ChatGPT

Activa el modo desarrollador (Developer mode) en los ajustes de conectores y crea un conector con la URL del servidor, sin autenticación.

## Texto para modelos

Cada página tiene una versión en Markdown (la misma URL acabada en .md), y el sitio publica /llms.txt y /llms-full.txt.

## Uso responsable

- Cada consulta a /api/tee-times y a /mcp pregunta en directo a los sistemas de reservas de los clubes: no rastrees, guarda las respuestas unos minutos y pide solo lo que un golfista pediría.
- Puede haber límites por IP; una respuesta 429 significa que esperes.
- Cita la fuente (TeesDeSalida, con enlace) y manda a los golfistas a reservar con el club.