# اسنپ‌فود و اسنپ‌مارکت (Snapp MCP)

رستوران، منو و هزینه سفارش را در اسنپ‌فود پیدا کنید و ارزان‌ترین کالای سوپرمارکتی را در اسنپ‌مارکت ببینید

- نوع: سرور MCP
- دسته: فروشگاه اینترنتی
- منبع: ساختهٔ بازارچه
- سازنده: sepehr071 (https://github.com/sepehr071)
- مجوز: MIT
- زبان: Python
- آخرین بررسی: 2026-11-14
- صفحه: https://mcpfarsi.ir/servers/snapp/
- مخزن: https://github.com/sepehr071/snapp-mcp
- وب‌سایت سرویس: https://snappfood.ir

## هشدارها

- فقط از IP ایران: فقط از داخل ایران (با IP ایران) کار می‌کند.
- اتصال با API غیررسمی: از راه رسمی وصل نمی‌شود و ممکن است ناگهان از کار بیفتد.

## نصب

- اجرا (stdio): `uvx snapp-mcp`
- بدون نصب: از راه روتر MCP (https://mcp.mcpfarsi.ir/mcp، ورود با OAuth)؛ راهنما: https://mcpfarsi.ir/start/
- متغیر محیطی `SNAPP_MCP_PROXY` (اختیاری): اگر VPN روشن است: نشانی یک پراکسی HTTP (سرور واسط) که اینترنتش از ایران وصل است

## API اسنپ‌فود و اسنپ‌مارکت

- REST API روتر MCP همین ابزار را برای اسکریپت و برنامه هم اجرا می‌کند: `GET https://mcpfarsi.ir/api/v1/tools?q=` قابلیت‌ها و آرگومان‌هایشان را برمی‌گرداند و `POST https://mcpfarsi.ir/api/v1/call` یکی را اجرا می‌کند. شناسهٔ سرور: `snapp`.
- اول ابزار را در داشبورد به ابزارهای خودتان اضافه کنید، بعد کلید API را در https://mcpfarsi.ir/dashboard/?tab=access بسازید و با `Authorization: Bearer <کلید>` بفرستید. هر اجرای موفق از سقف طرح کم می‌شود (https://mcpfarsi.ir/pricing/).

```sh
curl "https://mcpfarsi.ir/api/v1/tools?q=snapp&limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X POST "https://mcpfarsi.ir/api/v1/call" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"server": "snapp", "tool": "food_search", "arguments": {}}'
```

## حالت حساب

- روتر MCP (https://mcp.mcpfarsi.ir/mcp) این ابزار را با حساب خود کاربر هم اجرا می‌کند: ابزار را در داشبورد https://mcpfarsi.ir/dashboard/ اضافه کنید و یک بار در همان سایت وارد حساب سرویس شوید (اتصال حساب).
- پلن «رایگان» و «پایه»: فقط قابلیت‌های خواندنی. پلن «حرفه‌ای» و «کسب‌وکار»: قابلیت‌هایی هم که حساب را تغییر می‌دهند؛ کارهای برگشت‌ناپذیر فقط بعد از تأیید کاربر در سایت. تعرفه‌ها: https://mcpfarsi.ir/pricing/

## ابزارها

- `food_search`: جستجوی غذا در نزدیکی محل ارسال، با قیمت، تخفیف و رستوران
- `food_find_cheapest`: ارزان‌ترین راه سفارش یک غذا، از منوی رستوران‌های باز و فودپارتی
- `food_restaurants`: رستوران‌هایی که به یک نقطه غذا می‌فرستند، با امتیاز، هزینه و زمان ارسال
- `food_menu`: منوی کامل یک رستوران با قیمت، تخفیف و هزینه بسته‌بندی
- `food_order_costs`: هزینه‌های اضافه و شرایط سفارش از یک رستوران
- `food_reviews`: نظرات اخیر مشتریان یک رستوران
- `food_party_deals`: تخفیف‌های فودپارتی امروز که هنوز تمام نشده‌اند
- `food_meal_for_one`: غذاهای یک‌نفره با ارسال رایگان، ارزان‌ترین اول
- `food_discounted_vendors`: رستوران‌های تخفیف‌دار، و تخفیف «جم» اگر فعال باشد
- `find_location`: تبدیل نام مکان یا نشانی به مختصات
- `reverse_geocode`: تبدیل مختصات به نام خیابان و محله
- `list_cities`: شهرهایی که اسنپ‌فود در آن‌ها فعال است
- `market_search`: جستجوی کالا در همه فروشگاه‌های اسنپ‌مارکت نزدیک
- `market_find_cheapest`: ارزان‌ترین پیشنهاد موجود برای یک کالای سوپرمارکتی
- `market_stores`: فروشگاه‌هایی که به شما ارسال دارند، با هزینه ارسال، حداقل سفارش و امتیاز
- `market_store_info`: هزینه ارسال، ساعت کاری و کدهای تخفیف یک فروشگاه
- `market_store_products`: مرور یا جستجوی کالاهای یک فروشگاه
- `market_categories`: دسته‌ها و زیردسته‌های کالا در اسنپ‌مارکت
- `market_product`: جزئیات و قیمت یک کالا در یک فروشگاه
- `market_party_deals`: تخفیف‌های مارکت‌پارتی نزدیک، بیشترین تخفیف اول
- `market_reviews`: نظرات مشتریان یک فروشگاه
- `snapp_account` (با حساب): وضعیت ورود به حساب و شمارهٔ موبایل (نیمه‌پنهان)
- `snapp_orders` (با حساب): سفارش‌های شما در اسنپ‌فود: اول سفارش‌های در جریان، بعد سفارش‌های قبلی با اقلام و مبلغ
- `snapp_addresses` (با حساب): نشانی‌های ذخیره‌شدهٔ شما با برچسب، شهر و موقعیت تقریبی (حدود ۱۰۰ متر)
- `snapp_wallet` (با حساب): موجودی کیف پول اسنپ‌فود و اعتبار اسنپ‌پی، امتیاز باشگاه، اشتراک پرو و پرداخت‌های اخیر
- `snapp_vouchers` (با حساب): کدهای تخفیف فعال شما: مبلغ یا درصد، حداقل سفارش، تاریخ انقضا و سرویس مربوط
- `snapp_favorites` (با حساب): رستوران‌ها و فروشگاه‌های مورد علاقهٔ شما، با باز بودن و ارسال به نشانی شما
- `snapp_favorite` (با حساب، تغییر حساب): افزودن رستوران یا فروشگاه به علاقه‌مندی‌ها یا برداشتن آن
- `snapp_basket` (با حساب، تغییر حساب): افزودن غذا به سبد خرید (یا تغییر تعداد)، برداشتن یا خالی کردن سبد؛ سفارش و پرداخت را خودتان در اسنپ‌فود انجام می‌دهید

## نمونه سؤال‌ها

- پیتزافروشی‌های نزدیک ونک با امتیاز بالای ۴٫۵ را پیدا کن.
- ارزان‌ترین شیر کم‌چرب یک‌لیتری در اسنپ‌مارکت کدام است؟
- ارزان‌ترین کباب نزدیک میدان آزادی شیراز با هزینه ارسال چند درمی‌آید؟
- کدهای تخفیف فعال من در اسنپ‌فود کدام‌اند و حداقل سفارششان چقدر است؟

## توضیحات

با این سرور، دستیار هوش مصنوعی شما در اسنپ‌فود رستوران‌های نزدیک را پیدا می‌کند، منوها را می‌خواند و هزینه نهایی سفارش را حساب می‌کند. در اسنپ‌مارکت هم ارزان‌ترین کالای سوپرمارکتی را پیدا می‌کند.

#### نکته‌ها

- سفارشی ثبت نمی‌کند. بدون اتصال حساب فقط اطلاعات را می‌خواند؛ اگر در روتر MCP حساب اسنپ‌فود خود را وصل کنید، دستیار به سفارش‌ها، سبد خرید، کیف پول و کدهای تخفیف شما هم دسترسی پیدا می‌کند.
- غیررسمی است (سازنده‌اش خود اسنپ نیست) و ۲۱ قابلیت دارد.
- اسنپ فقط به IP ایران پاسخ می‌دهد؛ یعنی اینترنت شما باید از داخل ایران وصل باشد. اگر ناچارید VPN روشن بماند، `SNAPP_MCP_PROXY` را روی یک پراکسی HTTP (سرور واسط) با خروجی ایران بگذارید.
- این سرور در روتر MCP هم هست و آنجا هم با IP ایران کار می‌کند: کافی است در داشبورد اضافه‌اش کنید.
