Yappman Data Supermarket Price Snapshots
Read-only supermarket price snapshots (UK basket, AU index). Compilation CC BY 4.0. Not live.
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"grocery-price-snapshots": {
"url": "https://yappman-grocery-mcp.blue-bar-ca29.workers.dev/mcp"
}
}
}Puntos de conexión remotos
https://yappman-grocery-mcp.blue-bar-ca29.workers.dev/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (4)
🟢get_shelf_price_index(market, vintage, recordType, retailer, class)
Returns one published week of the free UK or Australian online shelf-price index (CC BY 4.0): index levels, week-on-week change and matched-product counts by retailer and product class. Use it for "how did posted grocery shelf prices move this week". Not a CPI, not prices paid, no product names. Omit vintage for the latest week; call list_index_vintages for the others.
Esquema de entrada
{
"type": "object",
"properties": {
"market": {
"type": "string",
"enum": [
"uk",
"au"
],
"description": "uk or au. Example: \"uk\"."
},
"vintage": {
"type": "string",
"pattern": "^[0-9]{4}-W[0-9]{2}$",
"description": "ISO week, e.g. \"2026-W42\". Omit for the latest published week."
},
"recordType": {
"type": "string",
"enum": [
"headline",
"retailer",
"class",
"retailer_class",
"retailer_like_for_like",
"subtotal",
"retailer_subtotal"
],
"description": "Only rows of this kind, e.g. \"headline\". Omit for all rows."
},
"retailer": {
"type": "string",
"enum": [
"tesco",
"sainsburys",
"asda",
"aldi",
"coles",
"woolworths",
"aldi_au"
],
"description": "Only rows for this retailer id, e.g. \"tesco\" (UK) or \"aldi_au\" (AU)."
},
"class": {
"type": "string",
"pattern": "^[a-z-]{2,40}$",
"description": "Only rows for this product class id, e.g. \"dairy-eggs\"."
}
},
"required": [
"market"
],
"additionalProperties": false
}Esquema de salida
{
"type": "object",
"properties": {
"market": {
"type": "string"
},
"title": {
"type": "string"
},
"vintage": {
"type": "string"
},
"publishedAt": {
"type": "string"
},
"revision": {
"type": "integer"
},
"base": {
"type": "string"
},
"notCpi": {
"type": "boolean"
},
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"vintage": {
"type": "string"
},
"publishedAt": {
"type": "string"
},
"revision": {
"type": "integer"
},
"recordType": {
"type": "string"
},
"retailer": {
"type": [
"string",
"null"
]
},
"class": {
"type": [
"string",
"null"
]
},
"level": {
"type": [
"number",
"null"
]
},
"weekOnWeekPct": {
"type": [
"number",
"null"
]
},
"fourWeekPct": {
"type": [
"number",
"null"
]
},
"matched": {
"type": [
"integer",
"null"
]
},
"matchedShare": {
"type": [
"number",
"null"
]
},
"status": {
"type": [
"string",
"null"
]
}
}
}
},
"credit": {
"type": "string"
}
},
"required": [
"market",
"vintage",
"rows",
"credit"
]
}🟢list_index_vintages(market)
Returns the published weeks (vintages) of the free UK or Australian online shelf-price index, newest first, with publication time, revision and base week. Use it before get_shelf_price_index to pick a week. Not for prices.
Esquema de entrada
{
"type": "object",
"properties": {
"market": {
"type": "string",
"enum": [
"uk",
"au"
],
"description": "uk or au. Example: \"au\"."
}
},
"required": [
"market"
],
"additionalProperties": false
}Esquema de salida
{
"type": "object",
"properties": {
"market": {
"type": "string"
},
"vintages": {
"type": "array",
"items": {
"type": "object"
}
}
},
"required": [
"market",
"vintages"
]
}🟢lookup_basket_prices(eans, products, date, retailers)
Returns posted shelf prices from the free UK daily 212-item basket (CC BY 4.0) for up to 20 barcodes (EAN) or retailer product ids, up to one row per retailer for one day: price, was-price, loyalty price, unit price, pack size and stock. Use it for "what did this barcode cost at Tesco, Sainsbury's, Asda or Aldi on a day". Static snapshot days, not live. Not for searching by product name, and only the 212 basket products are covered.
Esquema de entrada
{
"type": "object",
"properties": {
"eans": {
"type": "array",
"minItems": 1,
"maxItems": 20,
"items": {
"type": "string",
"pattern": "^[0-9]{8}$|^[0-9]{12,14}$"
},
"description": "Barcodes, 8, 12, 13 or 14 digits, e.g. [\"5000157024671\"]. Give eans, products or both."
},
"products": {
"type": "array",
"minItems": 1,
"maxItems": 20,
"items": {
"type": "object",
"properties": {
"retailer": {
"type": "string",
"enum": [
"tesco",
"sainsburys",
"asda",
"aldi"
]
},
"retailerProductId": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]{1,128}$"
}
},
"required": [
"retailer",
"retailerProductId"
],
"additionalProperties": false
},
"description": "Retailer product ids, e.g. [{\"retailer\": \"tesco\", \"retailerProductId\": \"254656543\"}]."
},
"date": {
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
"description": "Day, e.g. \"2026-10-08\". Omit for the latest day loaded."
},
"retailers": {
"type": "array",
"minItems": 1,
"items": {
"type": "string",
"enum": [
"tesco",
"sainsburys",
"asda",
"aldi"
]
},
"uniqueItems": true,
"description": "Only these retailers, e.g. [\"tesco\", \"asda\"]. Omit for all four. The basket holds no barcodes for Aldi: use products for Aldi."
}
},
"additionalProperties": false
}Esquema de salida
{
"type": "object",
"properties": {
"date": {
"type": "string"
},
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"scrapedAt": {
"type": "string"
},
"retailer": {
"type": "string"
},
"retailerProductId": {
"type": "string"
},
"ean": {
"type": "array",
"items": {
"type": "string"
}
},
"price": {
"type": [
"number",
"null"
]
},
"wasPrice": {
"type": [
"number",
"null"
]
},
"loyaltyPrice": {
"type": [
"number",
"null"
]
},
"unitPrice": {
"type": [
"object",
"null"
],
"properties": {
"value": {
"type": "number"
},
"measure": {
"type": "string"
}
}
},
"packSize": {
"type": [
"string",
"null"
]
},
"inStock": {
"type": [
"boolean",
"null"
]
}
}
}
},
"notFound": {
"type": "object",
"properties": {
"eans": {
"type": "array",
"items": {
"type": "integer"
}
},
"products": {
"type": "array",
"items": {
"type": "integer"
}
}
}
},
"credit": {
"type": "string"
}
},
"required": [
"date",
"rows",
"notFound",
"credit"
]
}🟢about_the_data
Returns the licence (CC BY 4.0) and credit form, what is not served, the store setting, the published index weeks and the basket date range with its short and missing days. Use it before citing or relying on the other tools.
Esquema de entrada
{
"type": "object",
"properties": {},
"additionalProperties": false
}Esquema de salida
{
"type": "object"
}Comunidad
Evidencia