shelfatlas-catalog

ShelfAtlas MCP サーバー

デンマークの食料品カタログと売り場データを、MCP ツールとして提供します。「今、Pepsi Max が一番安いのはどこですか？」と尋ねると、デンマークの主要チェーンすべての最新セール、最寄り店舗の地理検索、商品名と EAN による検索、専用の find_cheapest_offers ツールから、最新の構造化された回答が得られます。承認された場合は、コミュニティによる売り場在庫情報も確認件数とともに含まれます。

• エンドポイント： https://api.shelfatlas.com/api/v1/mcp（Streamable HTTP）
• 認証： Authorization: Bearer sa_live_<your-key> — 無料キーは https://app.shelfatlas.com で作成できます
• ドキュメント： https://shelfatlas.com/docs（ツール、利用枠、エラーコード）

ツール

ツール	回答する内容
search_products	他のツールを呼び出す前に、商品名から ID と EAN を特定します
get_product_by_ean	EAN-13 バーコードで商品を検索します
find_cheapest_offers	「この商品が今一番安いのはどこですか？」— 最新のセールを安い順に表示し、チェーンを特定します
search_catalog_offers	価格と有効期間を含むカタログのセール（デフォルトは最新情報のみ。チェーン／EAN／商品で絞り込み可能）
get_stores	ページ分割された店舗一覧、または距離の近い順の地理検索
list_chains	小売チェーン一覧（ID、スラッグ、名前）

Claude Desktop

Claude Desktop は mcp-remote を通じてリモートサーバーに接続します。

{
  "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>"
      }
    }
  }
}

Streamable HTTP にネイティブ対応しているクライアントは、Authorization ヘッダーを使ってエンドポイントに直接接続します。

ローカルで実行（stdio）

stdio のみを使用するクライアント向けに、このリポジトリにはホストされたツールを stdio 経由で提供する小規模なローカルサーバーも含まれています（Node.js 20 以降）。

git clone https://github.com/SlambertDK/shelfatlas-mcp && cd shelfatlas-mcp
npm ci
SHELFATLAS_API_KEY=sa_live_<your-key> node index.js

または Docker を使用します：docker build -t shelfatlas-mcp . と docker run -i --rm -e SHELFATLAS_API_KEY=sa_live_<your-key> shelfatlas-mcp。

ツール一覧の取得にはキーは不要ですが、ツールの呼び出しには SHELFATLAS_API_KEY が必要です。 server.json は公式 MCP レジストリ用のマニフェストです。