Snapp! Shop

snappshop-mcp：面向 AI Agent 的 Snapp! Shop MCP 服务

让你的 AI Agent 在 Snapp! Shop（اسنپ‌شاپ）上购物。
一个面向伊朗 Snapp 集市 Snapp! Shop 的非官方只读 MCP 服务：
搜索商品、比较每位卖家的托曼价格、按规格筛选、查看买家评价并掌握今日限时抢购，全部通过 Claude、Cursor 或 Copilot 完成。

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

面向 AI Agent

• **功能：**适用于 Snapp! Shop（snappshop.ir）的非官方 MCP 服务（Model Context Protocol，模型上下文协议）。Snapp! Shop 是伊朗的多商店和药店市场，涵盖电子产品、手机、健康与美容、家居和时尚商品。用波斯语查询效果最佳；价格以托曼计。
• 安装：uvx snappshop-mcp 或 claude mcp add snappshop -- uvx snappshop-mcp。传输方式：stdio。需要 uv（Python 3.10+）。
• **身份验证：**无需身份验证、API 密钥或账户（它使用网站为每位访客提供的访客会话）。Snapp! Shop 仅接受伊朗 IP：请在伊朗境内运行且不要使用 VPN，或将 SNAPPSHOP_MCP_PROXY 设置为出口 IP 位于伊朗的 HTTP 代理。系统代理设置会被忽略。
• **访问权限：**只读。无需登录，不支持购物篮、订单或付款，因此调用任何工具前都无需确认。全部 13 个工具均带有 readOnlyHint: true。
• **工具：**13 个：ss_search、ss_suggest、ss_filters、ss_categories、ss_category、ss_brand、ss_product、ss_compare、ss_reviews、ss_similar、ss_seller、ss_promotions、ss_collection。 典型流程：ss_search -> ss_product（所有卖家，按价格从低到高排列）-> ss_reviews。浏览流程：ss_categories -> ss_filters -> ss_category。
• ID：product_id（数字）用于 ss_product 和 ss_compare；id（6 个字符）用于 ss_reviews 和 ss_similar；seller_id 用于 ss_seller；collection_id 用于 ss_collection。
• 单位：价格以托曼计，配送至德黑兰，价格以网站显示为准。
• **适用场景：**比较伊朗在售商品的价格、卖家、规格和评价，或关注限时抢购。
• **不适用场景：**用户希望下单或付款，或身处伊朗境外且没有伊朗 IP 或代理（网站会返回 HTTP 403）。
• **输出：**精简的 JSON。省略空值和空字段（缺少 rating 表示尚未评分）。每页列表包含 12 个项目；网站将列表上限设为 10,000 个项目。省略评价者姓名。
• 机器可读信息：server.json，以及服务器列入其中后的 iran-mcp catalog。

原因

Snapp! Shop 上同一商品由多个卖家销售，价格、保修和配送条款各不相同。要找到最划算的报价，就得逐个打开商品页面。使用 snappshop-mcp 的 Agent 可以在几秒内读取所有页面：

你： Snapp! Shop 上谁以最低价出售 Samsung Galaxy A07（64 GB）？提供什么保修？

Agent： 调用 ss_search(query="Galaxy A07 64") → ss_product(product="25751584")

价格（托曼）	卖家	颜色	保修
44,600,000	دیجی لند سانا	سبز	گارانتی ۱۸ ماهه شرکتی
44,770,000	سام پلاس	بنفش	گارانتی ۱۸ ماهه هماهنگ (داریا همراه)
45,500,000	ویراوین	سبز	گارانتی ۱۸ ماهه شرکتی

总共有 12 个卖家，370 条评分，平均评分为 4.3。要用 ss_reviews 查看评价吗？

_{真实工具输出，日期为 2026-11-04；价格和库存随时可能变化。价格以托曼计。}

功能介绍

• 按名称搜索商品，并可筛选价格区间、品牌、规格、颜色、库存、折扣和快速配送
• 比较卖家：查看某件商品的所有报价，包括价格、折扣、库存、保修、配送方式和卖家评分
• 并排比较商品：查看价格、评分，以及不同的规格
• 浏览分类树、品牌页面和卖家页面；ss_filters 可显示列表的实际筛选条件
• 查看评价，包括评分、优缺点，并查找相似商品
• 发现优惠：限时抢购及其结束时间、活动页面，以及促销中的所有商品
• 仅提供只读功能：无需登录，不提供购物车、订单或支付功能

示例提示词：

• “找一款有库存、黑色、存储空间为 256 GB 的最便宜的 Samsung 手机。”
• “比较 Xiaomi Poco X7 Pro 和 Galaxy A56：规格有哪些不同？”
• “这款镁补充剂哪位卖家的价格最低？买家怎么评价？”
• “Snapp! Shop 上有哪些限时抢购会在今晚结束？”
• ارزان‌ترین گوشی سامسونگ موجود با حافظه ۲۵۶ گیگابایت را پیدا کن.
• فروشنده‌های این محصول را با قیمت و گارانتی مقایسه کن.
• امروز چه فروش ویژه‌هایی در اسنپ‌شاپ هست؟

快速开始

你需要安装 uv，并使用伊朗 IP 地址 （Snapp! Shop 会屏蔽外国 IP；请参阅 FAQ）。无需 API 密钥或账户。

claude mcp add snappshop -- uvx snappshop-mcp

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

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

codex mcp add snappshop -- uvx snappshop-mcp

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

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

工具

所有工具均为只读。列表每页返回 12 个项目（page 从 1 开始）。

筛选条件使用名称，而非 ID：specs=["حافظه داخلی=256 گیگابایت"]、colors=["مشکی"]。请先调用 ss_filters，查看某个分类提供的筛选条件。

工作原理

该服务使用访客令牌调用 Snapp! Shop Web 应用所使用的同一个 JSON API（apix.snappshop.ir），该令牌由网站发给每位访客。请求会使用 Chrome TLS 指纹以及网站前端自身发送的标头，因此看起来就像正常浏览。一个共享的 HTTP 客户端会将读取结果缓存 60 秒、限制并发数、在超时和服务器错误时重试，并拒绝访问 apix.snappshop.ir 以外的任何主机。

不会存储任何内容，也不会向其他任何地方发送数据。无需登录：该服务无法查看或更改任何账户。

注意事项

• 仅限伊朗 IP。 从国外访问时，网站会返回 HTTP 403（“请关闭 VPN”）。请使用伊朗网络连接，或设置 SNAPPSHOP_MCP_PROXY。
• 价格单位为 Toman，与网站显示的相同，适用于配送到德黑兰。库存和价格会在一天内变动。
• 总数受网站限制，最多为 10,000，而且不同次调用的结果可能相差一两个。
• 无法匹配短语时，会回退到无关商品，因此请核对标题。
• 顶级类别（例如 mobile）没有商品列表：请从 ss_categories 中选择一个子类别。
• 不会返回评价者姓名。

常见问题

需要 API 密钥或账户吗？ 不需要。它使用每位访客都会获得的访客会话。

可以购买商品或将商品加入购物篮吗？ 不可以。该服务从设计上就是只读的。

为什么会收到 HTTP 403？ 网站只响应来自伊朗 IP 的请求。请在伊朗境内且不使用 VPN 运行服务，或者将 SNAPPSHOP_MCP_PROXY 设置为出口位于伊朗的 HTTP 代理。

这和 snapp-mcp 是同一个项目吗？ 不是。snapp-mcp 涵盖 Snappfood（餐厅）和 SnappMarket（杂货）；本服务涵盖 Snapp! Shop 电商平台。

应该用哪种语言提问？ 波斯语的匹配效果最好，因为商品标题和规格都是波斯语；英文品牌名和型号名也可以使用。

如何按存储容量筛选手机？ 调用 ss_filters(path="mobile/samsung")，然后调用 ss_category(path="mobile/samsung", specs=["حافظه داخلی=256 گیگابایت"])。

配置

波斯语：Snapp‌Shop MCP 服务

claude mcp add snappshop -- uvx snappshop-mcp

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

工具位于 src/snappshop_mcp/shop.py；每个工具都是带类型标注的异步函数，并附有说明 Agent 何时应使用该工具的文档字符串。欢迎提交问题和 PR，尤其是新工具和 API 变更修复。

发布：更新 pyproject.toml 和 server.json 中的版本，然后推送一个 v* 标签。GitHub Actions 会运行测试、发布到 PyPI 和 MCP Registry，并创建 GitHub Release。

相关服务

• iran-mcp：所有伊朗服务 MCP 服务的目录
• snapp-mcp：Snappfood 和 SnappMarket（餐厅和杂货）
• digikala-mcp：Digikala 商品搜索和价格
• torob-mcp：对比伊朗各商店的价格
• basalam-mcp：Basalam 上的手工制品和本地商品

免责声明

这是非官方项目，与 Snapp 无关，也未获其认可。它是只读的：仅读取 snappshop.ir 网页应用的公开接口，这些接口可能随时变更。请合理控制请求频率。

作者

由 Sepehr Radmard（سپهر رادمرد）构建并维护。欢迎在 LinkedIn 上联系，或在 GitHub 上关注 @sepehr071，获取更多面向伊朗网站的 MCP 服务，全部列于 iran-mcp。如果这为你节省了时间，给仓库点个星能帮助其他人发现它。

许可证

MIT

如果这为你省去了几次点击，点个星能帮助其他人发现它。