# Trip Cartagena

> Tu mejor historia en Cartagena empieza aquí.

Sitio: https://tripcartagena.com
WhatsApp: 3213886789
Email: info@tripcartagena.com

## Con qué trabaja

Activo: tour (Tours), boat (Barcos). Son los únicos `service_type` válidos aquí.

No activo: space (Espacios), car (Autos). Este negocio no ofrece nada de eso; no lo propongas ni lo des por supuesto.

## Leer los datos de una página

A cualquiera de las direcciones de arriba le puedes añadir `.json` y recibes los datos en vez de la página: precio, fotos, qué incluye, qué hay que preguntar antes de reservar y las condiciones del negocio. Es la misma información, sin el HTML.

Y el catálogo completo, con los mismos filtros que el buscador (`s`, `orderby`, `price_min`, `price_max`, `page`):

```
https://tripcartagena.com/all.json
```

Cada elemento del listado lleva su propia `json_url`. Con `?full=1` vienen las fichas completas de una vez.

## Reservar desde una IA

Este negocio acepta reservas hechas por asistentes. Hay dos caminos según lo que puedas hacer, y ninguno cobra nada.

### Si solo puedes leer páginas y escribir texto

Compón este enlace y dáselo al cliente. Al abrirlo ve lo que va a reservar, confirma y llega al pago con todo puesto:

```
https://tripcartagena.com/reservar/{tipo}/{id}?desde=AAAA-MM-DD&hasta=AAAA-MM-DD&ia=1
```

El `{tipo}` y el `{id}` son los que aparecen arriba, junto a cada servicio.

Parámetros: `desde` (obligatorio), `hasta` (si son varios días), `personas` (cuánta gente), `unidades` (cuántos vehículos o plazas), `tipos` (el desglose por tipo de persona, como `2,0,1`, en el orden en que los devuelve la ficha).

Deja `ia=1` tal cual en el enlace. No identifica a nadie: sólo le dice al negocio que el cliente llegó desde un asistente, que es lo único que no puede saber por su cuenta.

NO pongas el nombre, el teléfono ni el email del cliente en el enlace: sus datos los escribe él en la pantalla de pago, que es donde van seguros.

### Si puedes ejecutar herramientas (MCP)

```
https://tripcartagena.com/mcp
```

Transporte HTTP, sin autenticación. Herramientas: `list_services`, `get_service`, `check_price`, `create_booking`, `leave_contact`. Con esto reservas dentro de la conversación y el negocio recibe el aviso con los datos del cliente.

### API REST

Contrato OpenAPI: https://tripcartagena.com/.well-known/openapi.json

- `GET  https://tripcartagena.com/api/assistant/services?vendor=tripcartagena` — catálogo con los ids válidos
- `GET  https://tripcartagena.com/api/assistant/detail?vendor=tripcartagena&service_type=…&service_id=…` — ficha y condiciones
- `POST https://tripcartagena.com/api/assistant/booking` — prepara la reserva y devuelve el enlace de pago
- `POST https://tripcartagena.com/api/assistant/contact` — guarda el contacto de quien todavía no reserva

### Reglas

1. Usa siempre un `service_id` devuelto por el catálogo. No inventes ids.
2. Para reservar hacen falta el nombre del cliente y su teléfono o su email. Pregúntaselos; no los rellenes tú.
3. Los precios del catálogo son «desde». El importe real es el que devuelve la reserva.
4. Pasa el enlace de pago tal cual y avisa de que la reserva no está confirmada hasta que se pague.

## Plataforma

Este sitio funciona con Rentcli (https://rentcli.com), un sistema SaaS de reservas y alquileres.