Yappman Data Supermarket Price Snapshots
Read-only supermarket price snapshots (UK basket, AU index). Compilation CC BY 4.0. Not live.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`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"
}커뮤니티
증거