# Introducción

> Productos, precios, disponibilidad y sucursales de tiendas online de Venezuela, por REST y MCP.

URL: https://boelabs.com/docs/bazar
Language: Español

Bazar reúne los productos, precios, disponibilidad y sucursales de tiendas online de Venezuela,
y los sirve de dos formas: una API REST (`/v1`) y un servidor MCP (`/mcp`) para modelos de
lenguaje. Esta guía es para quien la integra: qué ofrece, cómo acceder y cómo resolver cada caso
de uso. La referencia completa de cada campo está en la
[referencia OpenAPI](https://bazar.boelabs.com/docs).

- **Base:** `https://bazar.boelabs.com`
- **Solo lectura.** Bazar no compra ni reserva; para comprar, se manda a la persona a la `url`
  del producto en la tienda.
- **No consulta en vivo.** Cada tienda se sincroniza cada pocas horas. Cada oferta dice cuándo la
  reportó la tienda (`observedAt`) y si ya es vieja (`stale`).

## Qué ofrece

| Necesidad                                                            | REST                            | MCP                  |
| -------------------------------------------------------------------- | ------------------------------- | -------------------- |
| Buscar productos por palabras o por significado, con filtros         | `GET /v1/search`                | `search_products`    |
| Todo sobre un producto: descripción, atributos, ofertas por sucursal | `GET /v1/listings/{id}`         | `get_listing`        |
| El mismo producto en todas las tiendas, del más barato al más caro   | `GET /v1/compare`               | `compare_prices`     |
| Cómo cambió su precio, también en la otra moneda                     | `GET /v1/listings/{id}/history` | `get_price_history`  |
| Sucursales con dirección y horario, la más cercana primero           | `GET /v1/branches`              | `find_branches`      |
| Tasas del bolívar (oficial BCV y paralela)                           | `GET /v1/rates`                 | `get_exchange_rates` |
| Qué tiendas hay, con cuántos productos y su última sincronización    | `GET /v1/stores`                | `list_stores`        |

## Primera consulta

No hace falta registrarse: sin API key cada dirección IP tiene una cuota diaria pequeña.

```bash
curl "https://bazar.boelabs.com/v1/search?q=licuadora%20oster&limit=2"
```

## Por dónde seguir

<Cards>
  <Card title="Acceso y cuotas" href="https://boelabs.com/docs/bazar/acceso">
    Sin key, con API key, cabeceras de cuota y límites.
  </Card>
  <Card title="Cómo leer una respuesta" href="https://boelabs.com/docs/bazar/respuestas">
    Precios, monedas, disponibilidad y por qué apareció cada resultado.
  </Card>
  <Card title="Buscar productos" href="https://boelabs.com/docs/bazar/casos/buscar">
    Palabras, significado, filtros y filtros escritos en la consulta.
  </Card>
  <Card title="MCP" href="https://boelabs.com/docs/bazar/mcp">
    Conectar Bazar a Claude, ChatGPT u otro cliente MCP.
  </Card>
</Cards>