# اسنپ‌شاپ (Snapp! Shop MCP)

کالاهای اسنپ‌شاپ را با قیمت همهٔ فروشنده‌ها، مشخصات و نظر خریداران بگردید، کالاها را مقایسه کنید و حراج‌های لحظه‌ای را ببینید

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

## هشدارها

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

## نصب

- اجرا (stdio): `uvx snappshop-mcp`
- متغیر محیطی `SNAPPSHOP_MCP_PROXY` (اختیاری): اگر بیرون از ایران هستید یا VPN دارید: نشانی یک پراکسی HTTP با خروجی ایران (چند نشانی را با ویرگول جدا کنید)

## API اسنپ‌شاپ

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

```sh
curl "https://mcpfarsi.ir/api/v1/tools?q=snappshop&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": "snappshop", "tool": "ss_search", "arguments": {}}'
```

## حالت حساب

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

## ابزارها

- `ss_search`: جستجوی کالا با نام، با فیلتر قیمت، برند، مشخصات، رنگ و نحوهٔ ارسال
- `ss_suggest`: کامل کردن عبارت جستجو مثل جعبهٔ جستجوی سایت، پرجستجوترین اول
- `ss_categories`: دسته‌های اسنپ‌شاپ، با مسیری که برای دیدن کالاهای هر دسته لازم است
- `ss_category`: کالاهای یک دسته یا یک برند در یک دسته، با مرتب‌سازی و فیلتر قیمت، مشخصات و رنگ
- `ss_product`: یک کالا: مشخصات، امتیاز و قیمت، موجودی و ارسال همهٔ فروشنده‌ها
- `ss_reviews`: نظر خریداران یک کالا: امتیاز، عنوان، متن، نقاط قوت و ضعف، رأی مفید بودن و تاریخ
- `ss_similar`: کالاهای جایگزینی که اسنپ‌شاپ زیر «کالاهای مشابه» نشان می‌دهد
- `ss_seller`: کالاهایی که یک فروشنده در اسنپ‌شاپ عرضه می‌کند
- `ss_filters`: فیلترهای یک دسته یا جستجو: بازهٔ قیمت، رنگ، برند و مشخصات
- `ss_brand`: کالاهای صفحهٔ یک برند
- `ss_collection`: همهٔ کالاهای یک مجموعهٔ تبلیغاتی، مثل حراج لحظه‌ای یا فهرست‌های صفحهٔ اول
- `ss_promotions`: تبلیغ‌های امروز اسنپ‌شاپ: حراج‌های لحظه‌ای با زمان پایان، فهرست‌ها، کمپین‌ها و کالاهای برتر
- `ss_compare`: مقایسهٔ ۲ تا ۴ کالا کنار هم: قیمت، امتیاز، تعداد فروشنده و مشخصاتی که فرق دارند
- `ss_account` (با حساب): وضعیت ورود به حساب اسنپ‌شاپ و شمارهٔ موبایل (نیمه‌پنهان)
- `ss_orders` (با حساب): تعداد سفارش‌های شما (جاری، تحویل‌شده، مرجوعی، لغوشده) و سفارش‌های جاری
- `ss_cart` (با حساب): سبد خرید شما، با قیمت برای یک نشانی ارسال
- `ss_cart_edit` (با حساب، تغییر حساب): افزودن یک عدد از پیشنهاد یک فروشنده به سبد خرید شما، کم کردن یک عدد یا حذف آن
- `ss_wishlist` (با حساب): فهرست علاقه‌مندی‌های شما: قیمت و قیمت اصلی به تومان، تخفیف و موجودی
- `ss_wishlist_edit` (با حساب، تغییر حساب): افزودن کالا به علاقه‌مندی‌های شما یا برداشتن آن
- `ss_vouchers` (با حساب): کدهای تخفیف شما در اسنپ‌شاپ
- `ss_addresses` (با حساب): نشانی‌های ذخیره‌شدهٔ شما در اسنپ‌شاپ

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

- ارزان‌ترین فروشندهٔ گوشی گلکسی A55 در اسنپ‌شاپ کیست و کی ارسال می‌کند؟
- حراج‌های لحظه‌ای امروز اسنپ‌شاپ را بیاور.
- این دو هدفون را از نظر قیمت، امتیاز و مشخصات مقایسه کن.
- کدهای تخفیف من در اسنپ‌شاپ را نشان بده.

## توضیحات

با این سرور، دستیار هوش مصنوعی شما در اسنپ‌شاپ، بازار اینترنتی اسنپ با فروشگاه‌ها و داروخانه‌های مختلف، کالا پیدا می‌کند: قیمت، موجودی و ارسال همهٔ فروشنده‌های یک کالا را کنار هم می‌گذارد، مشخصات و نظر خریداران را می‌خواند، ۲ تا ۴ کالا را مقایسه می‌کند و حراج‌های لحظه‌ای و کمپین‌های امروز را نشان می‌دهد.

#### نکته‌ها

- غیررسمی است (سازنده‌اش خود اسنپ‌شاپ نیست) و ۱۳ قابلیت عمومی دارد که فقط اطلاعات را می‌خوانند. سفارش نمی‌دهد و پولی پرداخت نمی‌کند.
- با روتر MCP می‌توانید حساب اسنپ‌شاپ خود را در mcpfarsi.ir وصل کنید تا دستیار سفارش‌ها، سبد خرید، علاقه‌مندی‌ها، کدهای تخفیف و نشانی‌های شما را هم بخواند و کالا را به سبد خرید یا علاقه‌مندی‌ها اضافه یا از آن‌ها حذف کند. این تغییرها فقط با اشتراک «حرفه‌ای» یا «کسب‌وکار» ممکن است. نصب روی کامپیوتر خودتان ورود به حساب ندارد.
- اسنپ‌شاپ فقط به IP ایران جواب می‌دهد. سرور را از داخل ایران و بدون VPN اجرا کنید، یا `SNAPPSHOP_MCP_PROXY` را روی یک پراکسی HTTP با خروجی ایران بگذارید.
- قیمت‌ها به تومان است.