Snappfood & SnappMarket

snapp-mcp：面向 AI Agent 的 Snappfood 和 SnappMarket MCP 服务

让你的 AI Agent 在 Snappfood 和 SnappMarket（اسنپ‌فود و اسنپ‌مارکت）上逛逛。
一款面向伊朗 Snappfood（餐厅外送）和 SnappMarket（杂货）的非官方只读 MCP 服务：
可从 Claude、Cursor 或 Copilot 搜索菜品和杂货、比较数百家餐厅和商店的实时价格、查看菜单和评价，并发现今日限时优惠。

面向 AI Agent · 原因 · 功能 · 快速开始 · 工具 · 工作原理 · 须知 · 常见问题 · 配置 · فارسی · 开发

面向 AI Agent

• **内容：**适用于伊朗 Snappfood（snappfood.ir，餐厅配送）和 SnappMarket（snapp.market，杂货）的非官方 MCP 服务（模型上下文协议）。使用波斯语查询效果最佳；价格以 Toman 计。
• 安装：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 个）。大多数 food 和 market 工具需要 lat 和 long（food_reviews、market_reviews、market_product、list_cities 除外）。 典型流程：find_location -> food_find_cheapest -> food_order_costs（杂货：market_find_cheapest -> market_store_info）。
• **单位：**价格以 Toman 计（1 Toman = 10 Rial），评分范围为 0-5。
• **适用场景：**比较伊朗某个地址附近的菜品或杂货的实际总价（食物 + 包装 + 配送）。
• **不适用场景：**用户想要下单或付款，或用户位于伊朗境外且没有伊朗 IP 或代理（Snappfood 会返回 HTTP 403）。
• **输出：**精简的 JSON。省略 Null 和空字段（缺少 rating 表示尚未评分）；评论和描述文本截断至 400 个字符（将 full_text: true 传给 food_reviews、market_reviews 或 market_product 可获取完整文本）。餐厅和门店的 vendor_code 值可在工具间传递。FoodParty 和 Gem 优惠仅在特定时段有效。
• 机器可读：server.json 和 iran-mcp 目录（TOOLS.md、servers.json、llms.txt）。

原因

Snappfood 一次只向你展示一家餐厅。要找到真正能送到你家门口的最便宜披萨，意味着要打开几十份菜单，在脑中加上包装费和配送费，并逐一查看每家餐厅的最低订单金额。使用 snapp-mcp 的 Agent 几秒钟就能完成：

**你：**现在送到 Vanak Square 的最便宜披萨是什么？包括配送费？

**Agent：**调用 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 的真实工具输出；价格随时可能变动。价格以 Toman 计。}

功能

• 搜索 伊朗任意地址附近的菜品和杂货商品
• 找出真正最便宜的选项：根据实时菜单，计算折扣后的商品价格、包装费和配送费
• 浏览 餐厅和商店，并按免费配送、折扣、优惠券、评分和距离筛选
• 查看完整菜单、商店目录、最低订单金额、配送费、预计送达时间和优惠券
• 发现优惠：FoodParty 限时特惠、单人餐、Gem 寻宝、Market Party
• 查看品质：推荐前先阅读顾客评价
• 设计为只读：无需登录，不加入购物车，不下单，不付款

示例提示词：

• “塔杰里什附近有哪些餐厅提供免费配送且评分至少为 4.5 星？”
• “显示我附近折扣超过 40% 的 FoodParty 优惠。”
• “约旦街、德黑兰附近哪里可以买到最便宜的低脂牛奶？请包含配送费。”
• “在革命广场附近找一份低于 200k 托曼且免费配送的单人餐。”
• ارزان‌ترین کباب نزدیک میدان آزادی شیراز با هزینه ارسال؟
• امروز در فودپارتی نزدیک ونک چه تخفیف‌هایی هست؟
• ارزان‌ترین شیر کم‌چرب نزدیک میدان ونک را از اسنپ‌مارکت پیدا کن.

快速开始

你需要 uv 和伊朗 IP 地址 （Snappfood 会屏蔽大多数海外 IP；请参阅 常见问题）。无需 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，因为菜单、价格和配送费取决于配送地点。Agent 会先通过 find_location 或 list_cities 获取这些信息。

所有 21 个工具都标注了 readOnlyHint: true，并返回精简的结构化 JSON，因此不会让 Agent 的上下文过载。

工作原理

  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 密钥，也不会将任何与你有关的信息发送到其他地方。

需要了解的信息

• 价格单位为 Toman（1 Toman = 10 Rial）。评分已统一换算为 0–5（API 使用 0-10）；缺少 rating 表示尚未评分（空值字段会被省略）。
• 食品订单的实际费用 = 价格 − 折扣 + 包装费 + 配送费 − 优惠券，且购物篮金额必须达到餐厅的最低订单金额。food_find_cheapest 和 food_order_costs 会向 Agent 提供所有相关信息。
• 价格会实时核验。 搜索索引中的价格会过时，因此 food_search 的价格排序和 food_find_cheapest 会重新读取实时菜单，并剔除已下架、不可用或属于配菜的菜品（酱料、饮料等）。
• 波斯语查询效果最佳（پیتزا、کباب、شیر）。名称筛选会将阿拉伯语的 ي/ك 和半空格与空格视为相同。
• 优惠活动有时间窗口。 FoodParty 和 Gem 只在特定时段开放；其他时间，工具会返回 active: false 或 gem: null。
• 文本会被截断。 评论和描述文本限制为 400 个字符，除非你请求 full_text。
• 需要位置信息。 菜单、价格和费用取决于配送地点，因此几乎所有工具都需要 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。此功能默认关闭。

波斯语：Snapp‌Food 和 Snapp‌Market 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 中；每个工具都是带有文档字符串的类型化异步函数，文档字符串会说明何时使用该工具。欢迎提交问题和 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 Web 应用的公开接口，这些接口可能会在未通知的情况下发生变化。请保持合理的请求频率。

作者

由 Sepehr Radmard（سپهر رادمرد）开发并维护。通过 LinkedIn 联系，或在 GitHub 上关注 @sepehr071，获取更多面向伊朗网站的 MCP 服务；所有服务均列在 iran-mcp 中。如果本项目为您节省了时间，请为仓库点亮星标，帮助其他人发现它。

许可证

MIT

如果本项目为您省去了点击操作，请点亮星标，帮助其他人发现它。