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.

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

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())

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.

curl "https://pricto.dev/v1/products/2000070000007/prices" \
  -H "Authorization: Bearer sk_test_sandbox"

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())

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.

claude mcp add --transport http pricto https://pricto.dev/mcp/sandbox

{
  "mcpServers": {
    "pricto": { "url": "https://pricto.dev/mcp/sandbox" }
  }
}

code --add-mcp '{"name":"pricto","type":"http","url":"https://pricto.dev/mcp/sandbox"}'

Personalizar → Conectores → Agregar → Conector personalizado
Nombre: Pricto
URL: https://pricto.dev/mcp/sandbox
Autenticación: sin inicio de sesión

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).

Qué sigue#

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

Quickstart

Pricto delivers price, sale, stock and history for products at Chilean stores, with the same product identified across chains and the source of every price. Use it over a REST API or from an agent with MCP. This guide gets you to your first response in a minute, without signing up: every example already carries the public sandbox key.

Sandbox. sk_test_sandbox is a public, free key. It answers with sample data: store and brand names are real, prices are not. Every response has the same shape and credit cost as production, so when you get your key you only swap the key. Limits: 5 requests per second, 60 per minute and 5,000 per day.

1. Search a product#

By name, brand or barcode. Costs 1 credit per page of results, and 0 if nothing is found.

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

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())

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());

Response (trimmed):

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. Get its price at every store#

With the id from the previous step or with the barcode. Costs 1 credit per store.

curl "https://pricto.dev/v1/products/2000070000007/prices" \
  -H "Authorization: Bearer sk_test_sandbox"

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())

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());

Response (trimmed):

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 is what anyone pays, with no conditions; card prices and promotions come separately. url, observed_at and capture_method say where each price came from.

3. Connect your agent#

The sandbox MCP server needs no login. Your agent sees seven tools (search, prices, compare, history, offers, coverage and data requests) and picks which to use.

claude mcp add --transport http pricto https://pricto.dev/mcp/sandbox

{
  "mcpServers": {
    "pricto": { "url": "https://pricto.dev/mcp/sandbox" }
  }
}

code --add-mcp '{"name":"pricto","type":"http","url":"https://pricto.dev/mcp/sandbox"}'

Customize → Connectors → Add → Custom connector
Name: Pricto
URL: https://pricto.dev/mcp/sandbox
Authentication: no sign-in

Settings → Connectors → Advanced → Developer mode → Create
Name: Pricto
URL: https://pricto.dev/mcp/sandbox
Authentication: none

Then ask it: "where is paracetamol cheapest?". With your production key, the URL is https://pricto.dev/mcp with the header Authorization: Bearer <key>: Claude Code, Cursor, VS Code and Claude connectors accept headers. ChatGPT only accepts servers with no authentication or with OAuth, so with a production key you need to wait for OAuth (see Authentication).

Next#

Try without signing up: every endpoint with a form that calls the sandbox.
Authentication: key types, headers and rotation.
Limits and costs: credits per operation, limits per plan and what happens when you run out.
API reference: every endpoint, parameter and field.
MCP and For agents: tools, prompts, Markdown, OpenAPI and Postman.