# مسترکالا (MasterKala MCP)

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

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

## هشدارها

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

## نصب

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

## API مسترکالا

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

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

## حالت حساب

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

## ابزارها

- `mk_search`: جستجوی کالا با قیمت، تخفیف و موجودی
- `mk_find_cheapest`: ارزان‌ترین کالاهای موجود برای یک جستجو
- `mk_browse`: کالاهای یک دسته، برند یا برچسب، با مرتب‌سازی و فیلتر
- `mk_filters`: فیلترهای یک دسته یا برند و بازه قیمت آن
- `mk_categories`: فهرست دسته‌های کالا
- `mk_brands`: فهرست برندهای مسترکالا
- `mk_deals`: کالاهای تخفیف‌دار امروز؛ اول آن‌هایی که بیشترین تخفیف را دارند
- `mk_product`: جزئیات کامل یک کالا: قیمت، موجودی، رنگ‌ها و امتیاز
- `mk_specs`: جدول مشخصات ۱ تا ۴ کالا کنار هم
- `mk_reviews`: نظرات خریداران و پاسخ فروشگاه
- `mk_shipping`: زودترین زمان ارسال یک کالا و هزینه آن
- `mk_branches`: شعبه‌های حضوری مسترکالا در تهران
- `mk_blog_posts`: مطالب وبلاگ و راهنماهای خرید
- `mk_blog_comments`: دیدگاه‌های یک مطلب وبلاگ
- `mk_account` (با حساب): وضعیت ورود به حساب و شمارهٔ موبایل (نیمه‌پنهان)
- `mk_cart` (با حساب): سبد خرید شما در مسترکالا: کالا، تعداد، گزینه‌ها و قیمت به تومان
- `mk_cart_edit` (با حساب، تغییر حساب): افزودن کالا به سبد خرید، تغییر تعداد یا حذف یک ردیف
- `mk_wishlist` (با حساب، تغییر حساب): افزودن کالا به علاقه‌مندی‌ها یا برداشتن آن
- `mk_notify_me` (با حساب، تغییر حساب): خبر دادن (با پیامک یا ایمیل) وقتی کالای ناموجود دوباره موجود شد
- `mk_invoice` (با حساب): لینک دریافت فاکتور یک سفارش شما
- `mk_pay` (با حساب، تغییر حساب): شروع پرداخت یک سفارش پرداخت‌نشده: مبلغ و لینک درگاه بانک را می‌دهد تا خودتان پرداخت کنید (با تأیید شما)
- `mk_orders` (با حساب): سفارش‌های شما در مسترکالا: وضعیت، مبلغ به تومان، تاریخ و اقلام
- `mk_addresses` (با حساب): نشانی‌های ذخیره‌شدهٔ شما و نشانی پیش‌فرض
- `mk_tickets` (با حساب): درخواست‌های مرجوعی و پشتیبانی شما با وضعیت هر کدام
- `mk_wallet` (با حساب): موجودی کیف پول و اعتبار باشگاه (بازگشت نقدی) به تومان، با تراکنش‌ها
- `mk_club` (با حساب): مسترکلاب شما: سکه‌ها، روزهای پیاپی، مأموریت‌ها و جایزه‌هایی که با سکه می‌شود گرفت
- `mk_cancel_order` (با حساب، تغییر حساب): لغو یک سفارش شما با ذکر دلیل و مقصد بازگشت مبلغ پرداخت‌شده (با تأیید شما)
- `mk_club_reward` (با حساب، تغییر حساب): گرفتن سکهٔ روزانهٔ مسترکلاب یا خرج کردن سکه برای یک جایزه، مثل کد تخفیف یا کالای رایگان (با تأیید شما)

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

- ارزان‌ترین هندزفری بلوتوث بین ۳ تا ۵ میلیون تومان کدام است و کی به تهران می‌رسد؟
- بهترین تخفیف‌های امروز مسترکالا روی پاوربانک کدام‌اند؟
- مشخصات این دو پاوربانک را کنار هم بگذار و بگو کدام بهتر است.
- سفارش‌های من در مسترکالا در چه وضعیتی هستند؟

## توضیحات

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

#### نکته‌ها

- بدون اتصال حساب فقط اطلاعات را می‌خواند: وارد حساب شما نمی‌شود، سبد خرید نمی‌سازد، سفارش ثبت نمی‌کند و نظر نمی‌فرستد. اگر در روتر MCP حساب مسترکالا خود را وصل کنید، دستیار به سفارش‌ها، سبد خرید، کیف پول و مسترکلاب شما هم دسترسی پیدا می‌کند.
- غیررسمی است (سازنده‌اش خود مسترکالا نیست) و ۱۴ قابلیت دارد.
- قیمت‌ها به تومان است. کاور و قاب از نتیجه‌های «ارزان‌ترین» جدا می‌شوند.
- این سرور در روتر MCP هم هست: کافی است در داشبورد اضافه‌اش کنید.
