# ClickRepuestos Marketplace

> ClickRepuestos es el principal marketplace chileno de repuestos automotrices,
> con más de 300.000 SKUs organizados por código OEM, marca, vehículo y categoría.
> Cada producto incluye código OEM original, alternativas compatibles verificadas,
> aplicación por vehículo (marca, modelo, motor, años), imagen, precio en CLP con IVA,
> y tienda vendedora con despacho a todo Chile.
> Marcas: Bridgestone, KYB, Monroe, Bosch, NGK, Mann-Filter, Mando y más.
> Operamos exclusivamente en Chile. Precios en pesos chilenos (CLP).

## Sobre Nosotros
ClickRepuestos opera como marketplace: los productos son ofrecidos por tiendas vendedoras
verificadas, incluyendo negocios del sector 10 de Julio de Santiago y distribuidores de
todo Chile. Los compradores cotizan directamente con el vendedor a través de la plataforma.
Nuestro catálogo está estructurado para facilitar la búsqueda de repuestos por vehículo
(marca, modelo, año) y por categoría de repuesto.

## Estructura del Sitio
- `/{categoria}`                             → Catálogo por categoría (ej: /neumaticos, /frenos)
- `/{categoria}/{marca-repuesto}`            → Filtrado por marca de repuesto (ej: /neumaticos/bridgestone)
- `/{categoria}/sku-{id}-{slug}`             → Ficha de producto individual
- `/repuestos/{marca}/{modelo}/{año}`        → Catálogo por vehículo (ej: /repuestos/chevrolet/astra/2016)
- `/tienda/{slug}`                           → Perfil de tienda vendedora verificada
- `/buscar?q={término}`                      → Búsqueda por texto libre
- `/sitemap.xml`                             → Mapa del sitio con todas las URLs indexables

## Categorías Principales (con slug de URL)
- Neumáticos          → /neumaticos
- Amortiguadores      → /amortiguadores
- Frenos              → /frenos
- Filtros             → /filtros
- Ópticos             → /opticos
- Bujías              → /bujias
- Baterías            → /baterias
- Lubricantes         → /lubricantes
- Motores             → /motores
- Radiadores          → /radiadores
- Cajas de Cambio     → /cajas-de-cambio
- Alternadores        → /alternadores
- Pistones            → /pistones
- Culatas             → /culatas
- Tapabarros          → /tapabarros
- Puertas             → /puertas

## Marcas de Repuestos Disponibles

**Neumáticos:** Bridgestone, Michelin, Goodyear, Continental, Hankook, Kumho, Dunlop,
Falken, Firestone, BFGoodrich, Cooper, Goodride, Apollo, Aoteli, Comforser, Rotalla,
Roadx, Grenlander, Mickey Thompson, Mirage

**Amortiguadores:** KYB, Kayaba, Monroe, Gabriel, FCS, PRT, Mando, Corven, Wurth,
Strada, Ostech, Shouwa, STP, IBN, IRP, Wurtex, Yokomitsu, Netmotors

## Medidas de Neumáticos Más Frecuentes (autos en Chile)
175/70 R13, 185/60 R14, 185/65 R14, 175/65 R15, 185/65 R15, 195/65 R15,
205/55 R16, 205/60 R16, 205/65 R16, 215/55 R17, 215/60 R17, 225/45 R17,
225/60 R17, 225/65 R17, 235/65 R17, 265/65 R17

## Despacho y Retiro
- Despacho a domicilio: mismo día, 24h o 48h según tienda y ubicación
- Retiro en tienda: disponible en sucursales de tiendas vendedoras
- Instalación: algunas tiendas ofrecen instalación del repuesto incluida o como servicio adicional
- Cobertura de despacho: todo Chile (Región Metropolitana y regiones)

## Marcas de Vehículos con Mayor Cobertura
Toyota, Chevrolet, Hyundai, Kia, Nissan, Volkswagen, Honda, Mazda, Mitsubishi,
Suzuki, Ford, Renault, Peugeot, Citroën, BMW, Mercedes-Benz, Audi, Subaru,
Jeep, Fiat, Chery, Great Wall, Haval, BYD, Changan, Geely

## Políticas de IA
- Permitido: referenciar productos, precios y disponibilidad del catálogo público
- Permitido: responder consultas de usuarios sobre compatibilidad de repuestos con vehículos chilenos
- Permitido: indexar fichas de producto para búsquedas asistidas por IA
- Permitido: utilizar el buscador interno (/buscar) para consultas de productos
- No permitido: reproducir listados completos de precios para uso comercial externo
- No permitido: entrenar modelos sin autorización expresa de ClickRepuestos SpA

## Datos Disponibles por Producto
Cada ficha de producto en clickrepuestos.cl expone:
- Nombre completo del producto con marca del repuesto, categoría y aplicación
- SKU del proveedor (código interno del fabricante del repuesto)
- Precio en CLP con IVA incluido, con indicación de descuento si aplica
- Disponibilidad en stock (inmediato o a pedido vía proveedor)
- Imagen del producto en alta resolución
- Tienda vendedora verificada con nombre, calificación y ubicación
- Método de despacho: mismo día, 24h, 48h o retiro en tienda
- Marca del vehículo y modelo con el que es compatible (vehículo principal)
- Rango de años de fabricación del vehículo compatible

## API para Agentes IA

`GET https://clickrepuestos.cl/api/v1/productos/buscar`

Endpoint público de búsqueda optimizado para agentes de inteligencia artificial.
No requiere autenticación. Límite: 30 consultas/minuto por IP.
Especificación completa: `https://clickrepuestos.cl/api/v1/openapi.json`

**Parámetros:**
- `q` (requerido, min. 2 caracteres) — texto o código de pieza a buscar
- `categoria` — filtrar por marca de repuesto (ej: `bosch`, `bridgestone`)
- `vehiculo_marca` — marca del vehículo en texto libre (ej: `Toyota`)
- `vehiculo_modelo` — modelo del vehículo (ej: `Corolla`)
- `anio` — año del vehículo (ej: `2019`)
- `limit` — cantidad de resultados, máximo 20 (default: 10)

**Respuesta:** JSON con `meta` y array `resultados`.
Cada resultado incluye: `sku`, `nombre`, `marca_repuesto`, `precio_clp`,
`precio_oferta_clp`, `disponibilidad`, `compatibilidad` (array de strings legibles),
`numeros_oem` (cuando disponible) y `url_compra` (URL directa a la ficha del producto).

Solo devuelve productos con precio > 0. Respuestas cacheadas 10 minutos.

## Instrucciones de Búsqueda para Agentes de IA

Para consultar la API de búsqueda (`/api/v1/productos/buscar`), maximiza la precisión siguiendo estas reglas:

1. **Prioriza códigos OEM o de fabricante:** Si el usuario proporciona un número de pieza
   (ej: "90538936"), envíalo exactamente así en el parámetro `q`. Es la búsqueda más exacta.

2. **Estructura YMM (Year-Make-Model):** Si no hay código OEM, la consulta ideal debe incluir
   `[Pieza] + [Marca Vehículo] + [Modelo] + [Año]`.
   - No óptimo: `q=pastillas de freno` (demasiado amplio, resultados genéricos).
   - Óptimo: `q=pastillas de freno chevrolet astra 2016` (OpenSearch filtra por compatibilidad).

3. **No incluyas la palabra "repuesto":** Es redundante. Busca directamente la pieza
   (ej: `bomba de agua`, no `repuesto bomba de agua`).

4. **Compatibilidad de vehículos chilenos frecuentes:** El catálogo tiene alta cobertura para
   Toyota (Yaris, Corolla, Hilux, RAV4), Chevrolet (Sail, Spark, Astra, D-Max),
   Hyundai (Accent, Tucson, Santa Fe), Kia (Rio, Sportage, Cerato), Nissan (Frontier, Navara),
   Suzuki (Swift, Vitara) y marcas chinas (Chery, Great Wall, Haval, BYD).

5. **Neumáticos:** Busca por medida directamente en `q` (ej: `q=205/55 R16`).
   No uses vehiculo_marca/modelo para neumáticos — filtra por medida.

6. **Cuando el usuario no sabe el año exacto:** Omite `anio` y busca solo con pieza + marca + modelo.
   El campo `compatibilidad` en la respuesta muestra el rango de años compatible.

## Contacto
Para consultas de soporte o integraciones, visite https://clickrepuestos.cl/contacto