Snappfood & SnappMarket

snapp-mcp：AI エージェント向け Snappfood・SnappMarket MCP サーバー

AI エージェントに、Snappfood と SnappMarket（اسنپ‌فود و اسنپ‌مارکت）で買い物をさせましょう。
イランの Snappfood（レストランのデリバリー）と SnappMarket（食料品）向けの、非公式の読み取り専用 MCP サーバーです。
料理や食料品を検索し、数百のレストランや店舗の実際の価格を比較し、メニューやレビューを確認し、今日のフラッシュセールをチェックできます。すべて Claude、Cursor、Copilot から利用できます。

AI エージェント向け · 理由 · できること · クイックスタート · ツール · 仕組み · 知っておくとよいこと · FAQ · 設定 · فارسی · 開発

AI エージェント向け

• 概要： イランの Snappfood（snappfood.ir、レストランの配達）と SnappMarket（snapp.market、食料品）に対応した非公式の MCP サーバー（モデルコンテキストプロトコル）です。ペルシャ語での検索が最も適しており、価格の単位はトマンです。
• インストール： uvx snapp-mcp または claude mcp add snapp -- uvx snapp-mcp を実行します。トランスポートは stdio です。uv（Python 3.10+）が必要です。
• 認証： 不要です。API キーやアカウントは必要ありません。Snappfood はイランの IP アドレスからのみアクセスできます。VPN を使わずにイランから実行するか、SNAPP_MCP_PROXY にイランを出口とする HTTP プロキシを設定してください。システムのプロキシ設定は無視されます。
• アクセス： 読み取り専用です。ログイン、カート、注文、支払いには対応していないため、ツールを呼び出す前に確認を取る必要はありません。21 個すべてのツールに readOnlyHint: true が設定されています。
• ツール： 21 個あります。find_location、reverse_geocode、list_cities、続いて food_*（9 個）と market_*（9 個）です。ほとんどのフードおよびマーケット関連ツールには lat と long が必要です（food_reviews、market_reviews、market_product、list_cities を除く）。 一般的な手順：find_location -> food_find_cheapest -> food_order_costs（食料品の場合：market_find_cheapest -> market_store_info）。
• 単位： 価格はトマン（1 トマン = 10 リアル）、評価は 0～5 です。
• 使用する場合： イラン国内の住所付近で、料理や食料品の実際の合計金額（食品代 + 包装代 + 配送料）を比較するときに使用します。
• 使用しない場合： ユーザーが注文または支払いを希望している場合や、イランの IP アドレスまたはプロキシを利用できない国外にいる場合は使用しないでください（Snappfood は HTTP 403 を返します）。
• 出力： 簡潔な JSON です。null と空のフィールドは省略されます（rating がない場合は未評価です）。レビューと説明文は 400 文字で切り詰められます。全文を取得するには、food_reviews、market_reviews、または market_product に full_text: true を渡してください。レストランと店舗の vendor_code の値は、ツール間で引き渡して使用します。FoodParty と Gem のお得情報は、特定の時間帯にのみ利用できます。
• 機械可読データ： server.json と iran-mcp カタログ（TOOLS.md、servers.json、llms.txt）。

このツールを使う理由

Snappfood では、一度に 1 軒のレストランしか表示されません。実際に自宅まで届く一番安いピザを見つけるには、何十ものメニューを開き、包装代と配送料を頭の中で足し、各レストランの最低注文金額を確認する必要があります。snapp-mcp を使うエージェントなら、これを数秒で行えます。

あなた： 今すぐヴァナク広場に配達できる、配送料込みで一番安いピザは？

エージェント： 呼び出し find_location(query="میدان ونک") → food_find_cheapest(query="پیتزا", lat=35.7577, long=51.4095)

合計	料理	レストラン	内訳
296,400	پیتزا سوسیس مینی + نوشابه	پیتزاتو (گاندی)	食品代 296,400 · 配送料無料
410,000	پیتزا اسمارت وجی لاور	پیتزا دومینوز (جردن)	食品代 360,000 + 配送料 50,000
464,000	پیتزا پپرونی اسلایسی	تله پیتزا (سعادت آباد)	食品代 315,000 + 配送料 149,000

全体では Pizzato のセットが最安です。food_order_costs で最低注文金額とクーポンを確認しましょうか？

_{2026-10-02 時点の実際のツール出力です。価格は常に変動します。価格の単位はトマンです。}

できること

• 検索 イラン国内の任意の住所付近で、名前から料理や食料品を検索します
• 本当の最安値を探す：割引後の料理価格に包装費と配送料を加えた金額を、最新のメニューと照合します
• 閲覧：送料無料、割引、クーポン、評価、距離で絞り込んで、レストランや店舗を探します
• 確認：メニュー全体、店舗の商品一覧、最低注文金額、配送料、到着予定時間、クーポンを確認します
• お得な情報を見つける：FoodParty のフラッシュセール、一人分の食事、Gem ハント、Market Party
• 品質を確認：おすすめを紹介する前に、顧客レビューを確認します
• 読み取り専用の設計：ログイン、カート、注文、決済はありません

プロンプトの例：

• 「タジュリシュ付近で送料無料、評価が4.5以上のレストランはどこですか？」
• 「近くで40％を超える割引の FoodParty セールを見せてください。」
• 「テヘランのジョルダン付近で低脂肪乳が最も安いのはどこですか？配送料も含めてください。」
• 「エンゲラーブ広場付近で、送料無料の20万トマン以下の一人分の食事を探してください。」
• ارزان‌ترین کباب نزدیک میدان آزادی شیراز با هزینه ارسال؟
• امروز در فودپارتی نزدیک ونک چه تخفیف‌هایی هست؟
• ارزان‌ترین شیر کم‌چرب نزدیک میدان ونک را از اسنپ‌مارکت پیدا کن.

クイックスタート

uv とイランの IP アドレスが必要です （Snappfood は海外の IP アドレスの大半をブロックします。FAQ を参照してください）。API キーやアカウントは不要です。

claude mcp add snapp -- uvx snapp-mcp

{
  "mcpServers": {
    "snapp": { "command": "uvx", "args": ["snapp-mcp"] }
  }
}

{
  "servers": {
    "snapp": { "type": "stdio", "command": "uvx", "args": ["snapp-mcp"] }
  }
}

codex mcp add snapp -- uvx snapp-mcp

[mcp_servers.snapp]
command = "uvx"
args = ["snapp-mcp"]

{
  "mcpServers": {
    "snapp": { "command": "uvx", "args": ["snapp-mcp"] }
  }
}

すべてのフード・食料品ツールでは lat / long を指定します。メニュー、価格、配送料は配送先によって異なるためです。エージェントはまず find_location または list_cities から取得します。

全 21 個のツールには readOnlyHint: true が注釈として付与され、コンパクトな構造化 JSON を返すため、エージェントのコンテキストを圧迫しません。

仕組み

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  snapp-mcp  (runs on your machine, uses your IP)
      │
      │  HTTPS
      ├──────▶  snappfood.ir    restaurants
      └──────▶  snapp.market    groceries

snapp-mcp はローカルで動作し、Snappfood および SnappMarket のウェブアプリと同じ公開エンドポイントを、Chrome に似た TLS・ヘッダープロファイルを使用して呼び出します。同時リクエストは最大 2 件で、短いランダムな遅延（150-600 ms）を挟みます。 同一の GET リクエストは 60 秒間キャッシュされ、失敗した GET（タイムアウト、ネットワークエラー、5xx、429）はバックオフを挟んで最大 2 回再試行されます。 通信先は Snapp の固定許可リストに含まれるホストのみで、レスポンス本文のサイズは 5 MB に制限されています。 唯一実行する POST は、SnappMarket の匿名トークン（公開ウェブアプリのクライアント認証情報）を取得するもので、店舗および商品のエンドポイントで必要になります。 間にホスト型サーバーはなく、API キーも不要です。また、あなたに関する情報がほかの場所に送信されることもありません。

知っておくと便利なこと

• 価格はトマン表記です（1 トマン＝10 リアル）。評価は 0～5 に正規化されています（API では 0～10）。rating がない場合は未評価です（null／空のフィールドは省略されます）。
• フード注文の実質費用 ＝価格 − 割引 ＋ 梱包料 ＋ 配送料 − クーポンで、注文金額がレストランの最低注文金額に達している必要があります。food_find_cheapest と food_order_costs を使うと、エージェントはこれらすべての情報を取得できます。
• 価格はリアルタイムで確認されます。 検索インデックスの価格は古くなるため、food_search の価格順検索と food_find_cheapest は最新のメニューを再取得し、販売終了、注文不可、またはサイドメニュー（ソース、ドリンクなど）の料理を除外します。
• ペルシャ語のクエリが最もよく一致します（پیتزا、کباب、شیر）。名前のフィルターでは、アラビア語の ي／ك と、半角スペースとスペースを同じものとして扱います。
• セールには開催時間があります。 FoodParty と Gem は特定の時間帯のみ開催されます。時間外には、ツールは active: false または gem: null を返します。
• テキストは省略されます。 full_text を指定しない限り、レビューと説明のテキストは 400 文字までです。
• 位置情報が必要です。 メニュー、価格、料金は配達先によって異なるため、ほとんどのツールで lat と long が必要です。
• イランの IP アドレスが必要です。 Snappfood のファイアウォールはイランの IP アドレスのみを受け付けます（それ以外では HTTP 403 となり、一部の接続元では TLS 接続がリセットされます）。SnappMarket の制限はそれほど厳しくありません。海外から実行する必要がある場合は、SNAPP_MCP_PROXY を設定してください。
• 対象外： ログイン、OTP、カート、注文、決済、ウォレット、レビューの投稿、住所の保存。サーバーがこれらのエンドポイントを呼び出すことはありません。

よくある質問

npx @modelcontextprotocol/inspector uvx snapp-mcp

設定

Snapp がボット確認ページを返した場合、サーバーはヘッドレスブラウザーで対処できます。snapp-mcp[browser] をインストールし（例：uvx --from 'snapp-mcp[browser]' snapp-mcp）、その後 patchright install chromium を実行してください。デフォルトでは無効です。

ペルシャ語：Snappfood と Snappmarket の MCP サーバー

claude mcp add snapp -- uvx snapp-mcp

開発

git clone https://github.com/sepehr071/snapp-mcp && cd snapp-mcp
uv sync
uv run python -m pytest            # offline, against recorded responses
uv run python -m pytest -m live    # real APIs (needs an Iranian IP)
uv run ruff check .

ツールは src/snapp_mcp/food.py、market.py、location.py にあります。それぞれ型付きの非同期関数で、エージェントがいつ使うべきかを説明する docstring が付いています。問題の報告や PR を歓迎します。特に、新しいツールや API の変更に対する修正をお待ちしています。

リリースするには、pyproject.toml と server.json のバージョンを更新し、v* タグをプッシュしてください。GitHub Actions がテストを実行し、PyPI と MCP Registry に公開して、GitHub Release を作成します。

関連サーバー

• iran-mcp：イランの各種サービス向け MCP サーバーのカタログ
• okala-mcp：各店舗の食料品価格とセール情報
• tapsifood-mcp：イランの別のプラットフォームにおける料理のデリバリー検索とメニュー
• digikala-mcp：Digikala の商品検索と価格
• torob-mcp：イランのショップ間での価格比較

免責事項

非公式のプロジェクトであり、Snapp との提携や同社による推奨を受けていません。読み取り専用で、snappfood.ir と snapp.market のウェブアプリが公開しているエンドポイントのみを読み取ります。これらは予告なく変更されることがあります。リクエスト頻度は適切に保ってください。

作者

Sepehr Radmard（سپهر رادمرد）が開発・メンテナンスしています。LinkedIn でつながるか、GitHub の @sepehr071 をフォローして、イランのウェブサイト向け MCP サーバーをご覧ください。すべて iran-mcp に掲載されています。時間の節約に役立ったら、リポジトリにスターを付けていただくと、ほかの人にも見つけてもらいやすくなります。

ライセンス

MIT

クリックの手間が省けたら、スターを付けていただくと、ほかの人にも見つけてもらいやすくなります。