<!-- https://pricto.dev/docs · versión en inglés: https://pricto.dev/docs/index.en.md -->

# Inicio rápido

Pricto entrega el precio, la oferta, el stock y el historial de productos en tiendas de Chile, con el mismo producto identificado entre cadenas y la fuente de cada precio. Se usa por API REST o desde un agente con MCP. Esta guía te lleva a tu primera respuesta en un minuto, sin registrarte: todos los ejemplos ya traen la key pública de la sandbox.

> **Sandbox.** `sk_test_sandbox` es una key pública y gratis. Responde con datos de ejemplo: los nombres de tiendas y marcas son reales, los precios no. La forma de cada respuesta y su costo en créditos son los mismos que en producción, así que cuando tengas tu key solo cambias la key. Límites: 5 consultas por segundo, 60 por minuto y 5.000 al día.

## 1. Busca un producto

Por nombre, marca o código de barras. Cuesta 1 crédito por página de resultados, y 0 si no encuentra nada.

```bash
curl "https://pricto.dev/v1/products/search?q=leche+entera&limit=2" \
  -H "Authorization: Bearer sk_test_sandbox"
```
```python
import requests

API_KEY = "sk_test_sandbox"

r = requests.get(
    "https://pricto.dev/v1/products/search",
    params={"q": "leche entera", "limit": 2},
    headers={"Authorization": f"Bearer {API_KEY}"},
)
print(r.status_code, r.json())
```
```js
const API_KEY = "sk_test_sandbox";

const res = await fetch(`https://pricto.dev/v1/products/search?${new URLSearchParams({"q":"leche entera","limit":"2"})}`, {
  headers: { Authorization: `Bearer ${API_KEY}` },
});
console.log(res.status, await res.json());
```

Respuesta (recortada):

```json
{
  "data": [
    {
      "id": "prd_01colu",
      "name": "Leche entera Colun 1 L",
      "brand": {
        "id": "colun",
        "name": "Colun"
      },
      "category": {
        "id": "food.dairy.milk",
        "label": "Leche",
        "path": [
          "Alimentos y bebidas",
          "… 2 más / more"
        ]
      },
      "size": {
        "value": 1,
        "unit": "l",
        "pack_count": 1,
        "text": "1 L"
      },
      "gtin": [
        "2000070000007"
      ],
      "image_url": null,
      "price_summary": {
        "currency": "CLP",
        "min": 1090,
        "max": 1290,
        "median": 1190,
        "offers_count": 3,
        "retailers_count": 3,
        "best": {
          "retailer": {
            "id": "cl-unimarc",
            "name": "Unimarc"
          },
          "offer_id": "ofr_01nuni",
          "price": 1090
        },
        "observed_at": "2026-10-23T11:00:00Z"
      },
      "score": 1
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "eyJvIjoyfQ"
  },
  "meta": {
    "credits_charged": 1,
    "attribution": {
      "text": "Fuente: Pricto · 23-10-2026 08:00 CLST"
    }
  }
}
```

## 2. Pide su precio en cada tienda

Con el `id` del paso anterior o con el código de barras. Cuesta 1 crédito por tienda.

```bash
curl "https://pricto.dev/v1/products/2000070000007/prices" \
  -H "Authorization: Bearer sk_test_sandbox"
```
```python
import requests

API_KEY = "sk_test_sandbox"

r = requests.get(
    "https://pricto.dev/v1/products/2000070000007/prices",
    headers={"Authorization": f"Bearer {API_KEY}"},
)
print(r.status_code, r.json())
```
```js
const API_KEY = "sk_test_sandbox";

const res = await fetch("https://pricto.dev/v1/products/2000070000007/prices", {
  headers: { Authorization: `Bearer ${API_KEY}` },
});
console.log(res.status, await res.json());
```

Respuesta (recortada):

```json
{
  "data": {
    "product": {
      "id": "prd_01colu",
      "name": "Leche entera Colun 1 L"
    },
    "prices": [
      {
        "retailer": {
          "id": "cl-unimarc",
          "name": "Unimarc"
        },
        "price": 1090,
        "list_price": 1090,
        "card_price": null,
        "unit_price": {
          "amount": 1090,
          "per": "l"
        },
        "availability": "in_stock",
        "url": "https://example.com/cl-unimarc/leche-entera-colun-1-l",
        "observed_at": "2026-10-23T11:00:00Z",
        "capture_method": "public_page"
      }
    ],
    "summary": {
      "currency": "CLP",
      "min": 1090,
      "max": 1290,
      "median": 1190,
      "offers_count": 3,
      "retailers_count": 3,
      "best": {
        "retailer": {
          "id": "cl-unimarc",
          "name": "Unimarc"
        },
        "offer_id": "ofr_01nuni",
        "price": 1090
      },
      "observed_at": "2026-10-23T11:00:00Z"
    }
  },
  "meta": {
    "credits_charged": 3,
    "credits_remaining": 14994
  }
}
```

`price` es lo que paga cualquiera, sin condiciones; el precio con tarjeta y las promociones vienen aparte. `url`, `observed_at` y `capture_method` dicen de dónde salió cada precio.

## 3. Conecta tu agente

El servidor MCP de la sandbox no pide login. Tu agente ve siete herramientas (buscar, precios, comparar, historial, ofertas, cobertura y pedir datos) y decide cuál usar.

```bash
claude mcp add --transport http pricto https://pricto.dev/mcp/sandbox
```
```json
{
  "mcpServers": {
    "pricto": { "url": "https://pricto.dev/mcp/sandbox" }
  }
}
```
```bash
code --add-mcp '{"name":"pricto","type":"http","url":"https://pricto.dev/mcp/sandbox"}'
```
```text
Personalizar → Conectores → Agregar → Conector personalizado
Nombre: Pricto
URL: https://pricto.dev/mcp/sandbox
Autenticación: sin inicio de sesión
```
```text
Configuración → Conectores → Avanzado → Modo desarrollador → Crear
Nombre: Pricto
URL: https://pricto.dev/mcp/sandbox
Autenticación: ninguna
```

Después pregúntale: "¿dónde está más barato el paracetamol?". Con tu key de producción, la URL es `https://pricto.dev/mcp` con el header `Authorization: Bearer <key>`: Claude Code, Cursor, VS Code y los conectores de Claude aceptan headers. ChatGPT solo acepta servidores sin autenticación o con OAuth, así que con key de producción hay que esperar el OAuth (ver [Autenticación](/docs/autenticacion#oauth)).

## Qué sigue

- [Probar sin registro](/docs/probar): cada endpoint con un formulario que llama a la sandbox.
- [Autenticación](/docs/autenticacion): tipos de key, cabeceras y rotación.
- [Límites y costos](/docs/limites): créditos por operación, límites por plan y qué pasa al agotarse.
- [Referencia de la API](/docs/api): cada endpoint, parámetro y campo.
- [MCP](/docs/mcp) y [Para agentes](/docs/agentes): herramientas, prompts, Markdown, OpenAPI y Postman.