TuEspacioPR

Get full details for a single vehicle listing: full description, all photos, year, brand, model, mileage, transmission, fuel type, body type, color, condition, location and contact info. Pass `id` ONLY when you have a UUID from a previous search result. If the user just describes the vehicle in words (brand+model, color, year, distinctive feature) pass that text in `query` — NOT in `id`. When the user references a vehicle by PRICE, BRAND, MODEL or YEAR shown in a previous gallery (e.g. 'the $18,500 2020 Toyota Corolla'), ALSO pass `price`, `brand`, `model`, `year` and/or `municipality` to disambiguate — these are STRONG hints used to pick the right listing. Provide at least one of `id` or `query`. IMPORTANT: When summarising the result for the user, use ONLY the fields returned in the structured payload (`description`, `price`, `brand`, `model`, `year`, `mileage`, `transmission`, `fuelType`, `bodyType`, `color`, `condition`, `location`, `municipality`, `contactPhone`, `contactEmail`, `imageUrls`). Do NOT invent service history, warranty, accident history, ownership count, or any other field not present in the response. `mileage` is in miles. Quote the `description` verbatim when the user asks for the full description. Do NOT use for browse/list intents (use `search_vehicle_listings`); call this only after a search has surfaced a specific vehicle the user is asking about.

Search and BROWSE active 'Explora' places curated by TuEspacio influencers across Puerto Rico (playas, ríos & cascadas, coffee spots, lugares escondidos, escapadas de fin de semana, y dónde quedarse). Returns an interactive HTML gallery with photos, category, municipality, price range, tips and a 'Ver lugar' button that opens the place on tuespaciopr.com. USE THIS TOOL whenever the user asks to see, list, browse, recommend or explore places in Puerto Rico — INCLUDING broad open-ended requests like 'muéstrame todos los ríos', 'qué playas hay', 'recomiéndame cafeterías', 'lugares para ir este fin de semana', 'dónde quedarme en Rincón'. ALL parameters are optional — you can call it with NO filters at all to return the most recent places. Do NOT refuse or ask clarifying questions before calling it; just call it with whatever filters the user gave (or none) and let the gallery answer. Only ask clarifying questions AFTER you've shown an initial result set. MAPPING USER INTENT TO `category` (set this whenever the user clearly named a category): • 'ríos' / 'rios' / 'cascadas' / 'chorros' / 'waterfalls' → category = 'rios_cascadas' • 'playas' / 'beach' / 'snorkel' / 'surf' → category = 'playas' • 'café' / 'cafetería' / 'coffee' → category = 'coffee_spots' • 'escondido' / 'secreto' / 'hidden' → category = 'lugares_escondidos' • 'escapada' / 'fin de semana' / 'paseo' → category = 'escapadas' • 'hospedaje' / 'hotel' / 'airbnb' / 'cabaña' / 'dónde quedarme' → category = 'quedate' INFLUENCER FILTER — IMPORTANT: • When the user mentions an influencer's name in their query (currently only 'Zerep' is supported), pass the FULL user phrase in `searchText`. The repository auto-detects the influencer name and scopes results to ONLY that influencer's posts. Do NOT pass the user_id yourself. • When the user does NOT mention an influencer, results come from all curators. • When summarising influencer-scoped results, phrase the reply as 'La playa que Zerep recomienda es: <title> — https://tuespaciopr.com/explore/<id>' (or '<N> lugares que Zerep recomienda…' for multiple). CANONICAL CATEGORIES (use one of these in `category` when possible — stored as lowercase enum): • 'playas' — playas, beach, snorkel, surf, arena, mar, costa • 'rios_cascadas' — ríos, cascadas, chorros, pozos, waterfalls • 'coffee_spots' — cafés, cafeterías, baristas, espresso • 'lugares_escondidos' — lugares escondidos / secretos / hidden gems • 'escapadas' — escapadas de fin de semana, paseos, aventuras • 'quedate' — hospedaje, hoteles, airbnb, cabañas, villas (Loose colloquial terms like 'playa', 'cascada', 'café', 'airbnb', 'hidden gem' are auto-expanded.) PRICE RANGE: one of 'free', 'budget', 'moderate', 'expensive'. Returns at most 12 listings (default 8). If a search returns 0 results, retry once with fewer filters (drop `category` first) before telling the user nothing was found. Do NOT use for transactional intents — buying property (`search_real_estate_listings`), vehicles (`search_vehicle_listings`), marketplace items (`search_marketplace_listings`), hiring a service (`search_service_listings`) or finding work (`search_job_listings`).

Search active job listings (ofertas de empleo) in Puerto Rico from the TuEspacio database. Returns an interactive HTML gallery with company name & logo, salary range, location, job type, experience level and a 'Ver oferta' button that opens the listing on tuespaciopr.com. Use this when the user asks about jobs, work, employment, vacancies, careers, trabajos, empleos, vacantes, ofertas de trabajo. CANONICAL CATEGORIES (use one of these in `category` when possible — stored values are Spanish, capitalized): • 'Legal' — abogados, paralegal, notarios, attorneys • 'Salud' — médicos, enfermeras, farmacia, terapistas, dentistas • 'Tecnología' — programadores, developers, software, IT, soporte, analistas de datos • 'Educación' — maestros, profesores, tutores, instructores • 'Ventas' — vendedores, sales, cajeros, representantes • 'Marketing' — marketing digital, redes sociales, publicidad • 'Administración' — secretarias, asistentes administrativos, recepcionistas, oficina • 'Contabilidad' / 'Finanzas' — contadores, contables, accounting • 'Construcción' — obreros, plomeros, electricistas, albañiles, mantenimiento • 'Hostelería' — meseros, cocineros, bartenders, hotel • 'Transporte' — choferes, conductores, delivery, camioneros, logística, almacén • 'Seguridad' — guardias, security • 'Limpieza' — conserjes, cleaning • 'Servicio al Cliente' — call center, atención al cliente • 'Ingeniería' — ingenieros (todas las ramas) (Pass the canonical category when known; loose / colloquial inputs are auto-expanded — 'programador', 'maestra', 'enfermera', 'mesero', 'chofer', 'cajero', 'abogado' all still match.) JOB TYPE (`jobType`): one of 'tiempo_completo' (full-time), 'medio_tiempo' (part-time), 'contrato', 'freelance', 'pasantia' / 'internship', 'temporal'. EXPERIENCE LEVEL (`experienceLevel`): one of 'junior' / 'entry', 'medio', 'senior', 'experto'. REMOTE: pass `remoteOnly=true` to return only remote / work-from-home positions. Returns at most 12 listings (default 8). Paid/featured listings (`isPromoted=true`, with active `enhancements` like `bump_to_top`, `urgent_tag`, `highlight`, `auto_bump`) are surfaced first; acknowledge them as featured/destacados when summarising results. If a search returns 0 results, retry once with fewer filters (drop `category` first, then `experienceLevel`/`jobType`) before telling the user nothing was found. Do NOT use for real estate (`search_real_estate_listings`), vehicles (`search_vehicle_listings`), marketplace (`search_marketplace_listings`), one-off service gigs (`search_service_listings` — services are paid provider contracts, jobs are W-2/1099 employment), or tourism (`search_explore_places`).

Search active marketplace listings in Puerto Rico from the TuEspacio database. Returns an interactive HTML gallery with photos, price, category, brand/model, condition, location and a 'Ver Anuncio' button that opens the listing on tuespaciopr.com. Use this when the user asks for general items for sale (electrónica, comida casera, ropa, muebles, electrodomésticos, herramientas, juguetes, libros, deportes, etc.) — anything that is NOT a vehicle and NOT real estate (those have their own tools). CANONICAL CATEGORIES (use one of these in `category` when possible — stored values are lowercase Spanish): • 'electronica' — celulares, móviles, iPhone, Android, tabletas, iPad, laptops, computadoras, TV, consolas (PS5/Xbox/Nintendo), audífonos, bocinas, cámaras, GPS, accesorios • 'comidas' — comida casera, bizcochos, repostería, panadería, catering, postres, dulces • 'ropa' — camisas, pantalones, jeans, vestidos, zapatos, tenis, carteras, accesorios (mujer/hombre/niños) • 'muebles' — sofás, sillas, mesas, camas, colchones • 'hogar' — electrodomésticos (nevera, estufa, microondas, lavadora, secadora), decoración • 'herramientas' — herramientas eléctricas y de mano • 'deportes' — bicicletas, equipo deportivo • 'juguetes' — juguetes y artículos para niños / bebés • 'libros' — libros y revistas (Pass the exact lowercase category from the list above; loose / colloquial inputs are auto-expanded — 'celular', 'bizcocho', 'sofá', 'tablet samsung', 'comida casera' all still match.) Returns at most 12 listings (default 8). Paid/featured listings (`isPromoted=true`, with active `enhancements` like `bump_to_top`, `urgent_tag`, `highlight`, `auto_bump`) are surfaced first; acknowledge them as featured/destacados when summarising results. If a search returns 0 results, retry once with fewer filters (drop `category` first, then `brand`/`model`) before telling the user nothing was found. Do NOT use for vehicles (`search_vehicle_listings`), real estate (`search_real_estate_listings`), services / providers (`search_service_listings`), jobs (`search_job_listings`), or tourism (`search_explore_places`).

Search active real estate listings in Puerto Rico from the TuEspacio database. Returns an interactive HTML gallery with photos, price, beds/baths, location and a 'Ver Anuncio' button that opens the listing on tuespaciopr.com. Use this when the user asks for houses, apartments, condos, land, commercial space or any property for sale or rent. Returns at most 12 listings (default 8). Paid/featured listings (`isPromoted=true`, with active `enhancements` like `bump_to_top`, `urgent_tag`, `highlight`, `auto_bump`) are surfaced first; acknowledge them as featured/destacados when summarising results. Do NOT use for vehicles (use `search_vehicle_listings`), marketplace items (`search_marketplace_listings`), services (`search_service_listings`), jobs (`search_job_listings`), or tourism / places (`search_explore_places`).

Search active service listings in Puerto Rico from the TuEspacio database. Returns an interactive HTML gallery with photos, price, category, provider info, served municipalities and a 'Ver Anuncio' button that opens the listing on tuespaciopr.com. Use this when the user asks for service providers (barberos, peluquerías, salones de belleza, uñas, plomeros, electricistas, limpieza, tutorías, fotografía, mecánicos, mudanzas, catering, eventos, soporte técnico, servicios para mascotas, etc.). CANONICAL CATEGORIES (use one of these in `category` when possible): • 'Belleza y cuidado personal' — barbero, peluquería, salón de belleza, corte de cabello, uñas, manicura, maquillaje, masajes • 'Servicios para Mascotas' — peluquería canina, paseo, adiestramiento, veterinaria • 'Eventos y Entretenimiento' — catering, repostería, bizcochos, fiestas, bodas, DJ, fotografía de eventos • 'Tecnología y Soporte' — soporte técnico, reparación de computadoras, instalación de internet/wifi, redes • 'Hogar y Construcción' — plomería, electricidad, pintura, mantenimiento, mudanzas, jardinería, limpieza • 'Salud y Bienestar' — terapia, masajes, nutrición, entrenamiento personal • 'Educación y Tutorías' — tutorías escolares, idiomas, música, clases particulares • 'Profesionales' — legal, contabilidad, consultoría, traducción, bienes raíces • 'Automotriz' — mecánica, hojalatería, detallado, grúas (Pass the exact category string from the list above; partial / loose / colloquial inputs are auto-expanded — 'pelu', 'salón', 'recortarme' will still match 'Belleza y cuidado personal'.) Returns at most 12 listings (default 8). Paid/featured listings (`isPromoted=true`, with active `enhancements` like `bump_to_top`, `urgent_tag`, `highlight`, `auto_bump`) are surfaced first; acknowledge them as featured/destacados when summarising results. NOTE: services often have NO fixed price — when `price` is null, use `priceType` (e.g. 'hourly', 'negotiable', 'quote', 'project', 'fixed') to describe how the provider charges. If a search returns 0 results, retry once with fewer filters (drop `category` first, then `municipality`) before telling the user nothing was found. Do NOT use for real estate (`search_real_estate_listings`), vehicles (`search_vehicle_listings`), marketplace products (`search_marketplace_listings`), jobs / employment (`search_job_listings`), or tourism (`search_explore_places`). Services are for hiring a provider (one-off or recurring), not for buying products or applying to W-2/1099 employment.

Search active vehicle listings in Puerto Rico from the TuEspacio database. Returns an interactive HTML gallery with photos, price, year, brand/model, mileage, transmission, fuel type, location and a 'Ver Anuncio' button that opens the listing on tuespaciopr.com. Use this when the user asks for cars, trucks, SUVs, pickups, vans, minivans, motorcycles or any vehicle for sale. IMPORTANT — how to call this tool: • When the user types a single model or colloquial term ('transit', 'sienna', 'civic', 'tacoma', 'troca', 'guagua'), pass the WHOLE phrase in `searchText` and DO NOT also set `brand` or `model` — the synonym map will expand it ('transit' → Ford + Transit + van; 'sienna' → Toyota + Sienna + minivan; 'tacoma' → Toyota + Tacoma + pickup; 'troca' → pickup + truck; 'guagua' → SUV + van). • Only set `brand` and `model` as strict filters when the user explicitly named BOTH (e.g. 'Toyota Corolla'). • `bodyType` is a strict equals filter — only use canonical values: 'sedan', 'suv', 'pickup', 'coupe', 'hatchback', 'convertible', 'minivan', 'wagon', 'van', 'truck'. If unsure, leave it null and let `searchText` do the work. • If a search returns 0 results, retry once with fewer filters (drop `brand` and `model` first, keep only `searchText`) before telling the user nothing was found. Returns at most 12 listings (default 8). Paid/featured listings (`isPromoted=true`, with active `enhancements` like `bump_to_top`, `urgent_tag`, `highlight`, `auto_bump`) are surfaced first; acknowledge them as featured/destacados when summarising results. Do NOT use for real estate (`search_real_estate_listings`), marketplace items (`search_marketplace_listings`), services (`search_service_listings`), jobs (`search_job_listings`), or tourism (`search_explore_places`).