Shelfatlas Catalog

io.github.SlambertDK由 GitHub 帳號 SlambertDK 發布v1.0.0更新於 Oct 24, 2026

Danish grocery catalog as MCP tools: live offers across all major chains, stores, EAN lookup, stock.

已驗證Streamable HTTP可網頁執行位置與生活商業與電商

概覽

AI 產生的概覽

面向丹麥雜貨目錄的遠端 MCP 伺服器：各大連鎖的現行優惠、門市查詢、商品名稱與 EAN 檢索，以及最低價回答。

可以做什麼
  • 列出零售連鎖及其 slug
  • 列出門市，可分頁或依經緯度由近到遠排序並限制半徑
  • 依連鎖、商品 id 或 EAN 搜尋目錄優惠，預設只回傳目前有效的優惠
  • 查詢某商品目前最便宜的優惠，依價格由低到高並解析連鎖名稱
  • 把商品名稱解析為 id 與 EAN，或依 EAN 條碼查詢商品
適用情境
適合讓助理回答丹麥雜貨價格、促銷與門市位置相關問題，例如某商品現在哪裡最便宜，或附近哪家門市有該優惠。
執行需求
遠端 Streamable HTTP 端點；原生支援的用戶端不需本機執行環境，Claude Desktop 需透過 mcp-remote，僅支援 stdio 的用戶端可執行 Node.js 20+ 或 Docker 版本。API 金鑰透過 Authorization 標頭以 Bearer 方式傳送；列出工具不需金鑰，呼叫工具則需要。
安裝前請注意
需要 API 金鑰並透過 Authorization 標頭傳送，避免寫入共用設定或日誌。資料僅涵蓋丹麥零售連鎖，自助金鑰可能只看得到已發布的促銷優惠，結果可能不完整。操作以唯讀查詢為主，但查詢內容（商品與位置）會傳送給該服務。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Shelfatlas Catalog，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

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

交給代理程式安裝

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

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

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

其他 MCP 客戶端

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

{
  "mcpServers": {
    "shelfatlas-catalog": {
      "type": "http",
      "url": "https://api.shelfatlas.com/api/v1/mcp"
    }
  }
}

README

ShelfAtlas MCP server

[shelfatlas-mcp MCP server – quality and maintenance score on Glama]

Danish grocery catalog and shelf data as MCP tools. Ask "where is Pepsi Max cheapest right now?" and get live, structured answers: current offers across every major Danish chain, nearest-store geo search, product name and EAN lookup, and a purpose-built find_cheapest_offers tool. Community shelf-stock signals are included where approved, with confirmation counts.

Tools

ToolWhat it answers
search_productsResolve a product name to id + EAN before calling other tools
get_product_by_eanLook up a product by EAN-13 barcode
find_cheapest_offers"Where is this product cheapest right now?" — live offers, cheapest first, chain resolved
search_catalog_offersCatalog offers with price and validity window (live-only by default; chain/EAN/product filters)
get_storesPaginated store list, or nearest-first geo search
list_chainsAll retail chains (id, slug, name)

Claude Desktop

Claude Desktop reaches remote servers through mcp-remote:

json
{  "mcpServers": {    "shelfatlas": {      "command": "npx",      "args": ["-y", "mcp-remote", "https://api.shelfatlas.com/api/v1/mcp"],      "env": {        "MCP_REMOTE_HEADER_AUTHORIZATION": "Bearer sa_live_<your-key>"      }    }  }}

Clients with native Streamable HTTP support connect directly to the endpoint with the Authorization header.

Run locally (stdio)

For clients that only speak stdio, this repository is also a small local server that serves the hosted tools over stdio (Node.js 20+):

bash
git clone https://github.com/SlambertDK/shelfatlas-mcp && cd shelfatlas-mcpnpm ciSHELFATLAS_API_KEY=sa_live_<your-key> node index.js

Or with Docker: docker build -t shelfatlas-mcp . and docker run -i --rm -e SHELFATLAS_API_KEY=sa_live_<your-key> shelfatlas-mcp.

Listing the tools works without a key; calling them needs SHELFATLAS_API_KEY. server.json is the manifest for the official MCP registry.

來源：README.md，提交 842fa12

工具

6

list_chains

List all retail chains available in the ShelfAtlas catalog.

無需輸入參數。

get_stores

List stores in the ShelfAtlas catalog. Filter by chain slug, or pass lat/lng for a nearest-first geo search (optionally capped by radius_km; geo results are not paginated).

輸入參數latlnglimitcursorradius_kmchain_slug

search_catalog_offers

Search catalog offers (promotions and listed products) from Danish retail chains. Returns ONLY currently-valid offers unless include_expired is set. Filter by chain slug, product id, or EAN. Offers carry chainId — resolve names via list_chains. Self-serve keys see published campaign offers (tilbudsaviser, month-campaigns) only — not everyday shelf prices, which are Salling-only and restricted to partner keys.

輸入參數eanlimitcursorchain_slugproduct_idinclude_expired

find_cheapest_offers

Answer 'where is this product cheapest right now?' in one call: the currently-valid offers for one product (by EAN or product id), cheapest first, with chain slug and name resolved. Combine with get_stores(lat/lng, chain_slug) to find the nearest store carrying the winning chain's offer. Self-serve keys see published campaign offers only — not everyday shelf prices, which are Salling-only and restricted to partner keys.

輸入參數eanlimitproduct_id

get_product_by_ean

Look up a product in the ShelfAtlas catalog by its EAN barcode.

輸入參數ean必填

search_products

Resolve a product NAME to its ShelfAtlas id and EAN — use this BEFORE calling find_cheapest_offers or search_catalog_offers when you only have a product name (e.g. from a user question) and not an id or barcode. Matches on the canonical product name, case-insensitive, substring match. Returns id, name, ean (null for self-serve keys — every EAN is Salling-sourced and restricted to partner keys), and size (volumeMl/unitCount/quantityUnit) where known.

輸入參數q必填limit

版本歷史

1
  1. v1.0.0最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

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

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