Yappman Data Supermarket Price Snapshots
Read-only supermarket price snapshots (UK basket, AU index). Compilation CC BY 4.0. Not live.
我该使用它吗
质量与安全性
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"grocery-price-snapshots": {
"url": "https://yappman-grocery-mcp.blue-bar-ca29.workers.dev/mcp"
}
}
}远程端点
https://yappman-grocery-mcp.blue-bar-ca29.workers.dev/mcpstreamable-http它能做什么
工具清单
工具（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.
输入模式
{
"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
}输出模式
{
"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.
输入模式
{
"type": "object",
"properties": {
"market": {
"type": "string",
"enum": [
"uk",
"au"
],
"description": "uk or au. Example: \"au\"."
}
},
"required": [
"market"
],
"additionalProperties": false
}输出模式
{
"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.
输入模式
{
"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
}输出模式
{
"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.
输入模式
{
"type": "object",
"properties": {},
"additionalProperties": false
}输出模式
{
"type": "object"
}社区
证据