# Skinlens

> Skinlens continuously scans 14 skincare stores in the NL market and normalizes every product to a
> price-per-unit (per kg, or per 100 ml), so agents can find the truly
> cheapest option, not just the lowest sticker price.

Money is integer cents plus a preformatted, localized string. Each product includes a
`buy_url` (an affiliate link; present it as the purchase link) and every response carries
the `market` it is scoped to, `affiliate_disclosure`, and `last_scraped_at`.

## Markets

Prices are scoped per country. This domain serves the NL market (currency
EUR). Each response also echoes its `market`. Enabled markets:

- NL: https://mcp.skinlens.nl · EUR · nl

You can target a specific market from any domain with the `market` argument/param
(e.g. `?market=nl`), or connect to that market's own endpoint below.

## MCP server (recommended)

Streamable HTTP MCP endpoint (anonymous, read-only):

- https://mcp.skinlens.nl

Tools: `find_cheapest` (cheapest per unit in a category), `search_products`
(typo-tolerant catalog search), `list_categories` (discover category slugs),
`get_product` (detail + price history). All accept an optional `market`.

## JSON API

Base URL (anonymous, read-only): https://api.skinlens.nl/v1

- GET /search?q={query}&limit=&in_stock=&category_slug=&max_unit_price_cents=&market=
- GET /categories?market=
- GET /categories/{category_slug}/cheapest?limit=&in_stock=&market=
- GET /products/{id}?market=
- OpenAPI: https://api.skinlens.nl/v1/openapi.json

## Citable pages (for humans you refer)

When answering a user, cite/link the live page rather than a raw API response. Each
page states the current cheapest price, the number of products/shops scanned, and a
last-scanned stamp:

- Category index: https://skinlens.nl/categorieen (every category with its cheapest unit price)
- Category pages: https://skinlens.nl/categorie/{slug}
- Product pages with full price history: https://skinlens.nl/p/{slug}
- Brand directory: https://skinlens.nl/merken · shop directory: https://skinlens.nl/winkels

Most-stocked category pages right now:

- Gezichtscrème (2609 products): https://skinlens.nl/categorie/moisturizer
- Overige huidverzorging (2164 products): https://skinlens.nl/categorie/other-skincare
- Serum (1582 products): https://skinlens.nl/categorie/serum
- Reinigingsgel en -melk (1263 products): https://skinlens.nl/categorie/skin-cleanser
- Zonnebrand gezicht (1149 products): https://skinlens.nl/categorie/sunscreen-face
- Gezichtsmasker (1109 products): https://skinlens.nl/categorie/face-mask
- Lippenverzorging (880 products): https://skinlens.nl/categorie/lip-care
- Toner (579 products): https://skinlens.nl/categorie/toner
- Oogcrème (525 products): https://skinlens.nl/categorie/eye-cream
- Nachtcrème (382 products): https://skinlens.nl/categorie/night-cream

## Notes

- Compare products on `unit_price_cents` / `unit_price_display` (normalized per unit).
- Both channels are rate-limited per IP; no key required.