Yappman Data Supermarket Price Snapshots

io.github.yappmaniac由 GitHub 帳號 yappmaniac 發布v0.2.5更新於 Oct 29, 2026

Read-only UK/AU supermarket price index and UK basket snapshots. CC BY 4.0. Not live prices.

發布方自己的服務:PriceWin

已驗證Streamable HTTP可網頁執行金融資料與分析

概覽

AI 產生的概覽

唯讀遠端 MCP 伺服器,提供免費的 CC BY 4.0 英國與澳洲線上貨架價格指數週資料,以及英國每日購物籃價格快照。

可以做什麼
  • 列出已發布的指數週(版本),含發布時間、修訂與基準週
  • 讀取某一週的英國或澳洲貨架價格指數:指數水準、週環比變化,以及依零售商與商品類別統計的配對商品數
  • 分頁列出英國每日 212 項購物籃在指定日期的商品識別碼(零售商商品 ID 與條碼)
  • 依最多 20 個條碼或零售商商品 ID 查詢掛牌貨架價:現價、原價、會員價、單位價、包裝規格與庫存
  • 讀取授權、署名格式、門市設定、已發布週次與購物籃日期範圍(含缺漏日期)
適用情境
適合讓助理說明某一週線上雜貨貨架價格如何變動,或某個英國購物籃商品在某日於某零售商的掛牌價,並正確標註來源。它不提供即時價格、商品名稱或實際成交價。
執行需求
遠端 streamable HTTP 端點;未宣告驗證、環境變數或標頭。需要能連線至該託管端點的網路。
安裝前請注意
資料為靜態快照,非即時,可能不完整或過時;依賴價格前應向零售商確認。內容為線上掛牌貨架價,不是實際成交價,也不是 CPI,且不含商品名稱或品牌。引用時需使用各工具回傳的署名行;伺服器另指向按事件計費的 Apify Actors 以取得名稱與購物籃以外的目前價格。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Yappman Data Supermarket Price Snapshots,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.yappmaniac%2Fgrocery-price-snapshots/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "yappman-data-supermarket-price-snapshots": {
      "type": "http",
      "url": "https://yappman-grocery-mcp.blue-bar-ca29.workers.dev/mcp"
    }
  }
}

工具

5

get_shelf_price_index

Shelf-price index for one week

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.

輸入參數classmarket必填vintageretailerrecordType

list_index_vintages

Published weeks of the shelf-price index

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.

輸入參數market必填

lookup_basket_prices

Daily basket prices by barcode or product id

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". Each result row lists its barcodes in `ean`. Static snapshot days, not live. Not for name search; only the 212 basket products. Wider data: see about_the_data.

輸入參數dateeansproductsretailers

list_basket_products

Product identifiers in the daily basket

Returns the identifiers of the products in the free UK daily 212-item basket (CC BY 4.0): retailer, retailer product id and barcodes (`ean`, empty where the basket holds none, as for Aldi), for one day, sorted, with paging. Use it to find what lookup_basket_prices can look up. No names, brands or prices: pass the ids or barcodes to lookup_basket_prices.

輸入參數datelimitoffsetretailers

about_the_data

Licence, coverage and limits of 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.

無需輸入參數。

版本歷史

3
  1. v0.2.5最新Oct 29, 2026
  2. v0.2.1Oct 26, 2026
  3. v0.1.0Oct 23, 2026

評分

已滿足適用檢查項的 83%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分

    請宣告包含 README 的 GitHub 儲存庫,或在 OAuth 受保護資源後設資料中提供 resource_documentation。

  • 授權條款不適用

    託管服務按其提供方的條款使用,因此這裡不要求授權條款。此檢查項不計入百分比。

其他 Price 整合