# دیجی‌کالا (Digikala MCP)

نسخهٔ کامل دیجی‌کالا با ۲۳ قابلیت بدون حساب: جستجو و مقایسهٔ کالا با فیلتر، بهترین کالا در حد بودجه، مقایسهٔ فروشنده‌ها، تاریخچهٔ قیمت و نظر خریداران

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

## هشدارها

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

## نصب

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

## API دیجی‌کالا

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

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

## حالت حساب

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

## ابزارها

- `dk_search`: جستجوی کالا، با قیمت، تخفیف، فروشنده و امتیاز
- `dk_find_cheapest`: ارزان‌ترین کالای موجودی که واقعاً با جستجوی شما جور است
- `dk_best_for_budget`: بهترین کالاهای پرامتیاز در حد بودجه شما
- `dk_suggest`: تبدیل جستجوی مبهم به کلمه و دسته دقیق‌تر
- `dk_filters`: فیلترهای یک دسته یا جستجو: ویژگی، رنگ، فروشنده و بازه قیمت
- `dk_categories`: پیدا کردن کد دسته‌های کالا
- `dk_category_products`: کالاهای یک دسته، با مرتب‌سازی و فیلتر
- `dk_brand_products`: کالاهای یک برند، با مرتب‌سازی و فیلتر قیمت
- `dk_seller`: کارنامه یک فروشنده و کالاهایش
- `dk_deals`: شگفت‌انگیزهای امروز، از بیشترین تخفیف
- `dk_best_sellers`: پرفروش‌ترین کالاها، در کل سایت یا در یک دسته
- `dk_fresh_search`: جستجو در سوپرمارکت دیجی‌کالا فرش
- `dk_product`: قیمت، موجودی، مشخصات و پیشنهاد همه فروشنده‌های یک کالا
- `dk_price_history`: تاریخچه قیمت در حدود ۳۰ روز گذشته
- `dk_reviews`: نظر خریداران، با نقاط قوت و ضعف
- `dk_questions`: پرسش‌وپاسخ‌های یک کالا
- `dk_similar`: کالاهای مشابه از مدل‌ها و برندهای دیگر
- `dk_compare`: مقایسه ۲ تا ۴ کالا کنار هم
- `dk_shortlist`: بررسی دوباره قیمت و موجودی حداکثر ۱۰ کالا با یک درخواست
- `dk_installments`: طرح‌های اعتباری دیجی‌پی برای خرید یک کالا
- `dk_plus_plans`: طرح‌های اشتراک دیجی‌کالا پلاس
- `dk_gold_prices`: قیمت لحظه‌ای طلای ۱۸ عیار و سکه
- `dk_location`: تبدیل نشانی به مختصات و برعکس
- `dk_account` (با حساب): وضعیت ورود به حساب و شمارهٔ موبایل (نیمه‌پنهان)
- `dk_orders` (با حساب): سفارش‌های شما در هر تب (جاری، تحویل‌شده، لغو یا مرجوعی)، تازه‌ترین اول
- `dk_order` (با حساب): یک سفارش شما: اقلام، مرسوله‌ها و پیگیری ارسال
- `dk_cancel_shipment` (با حساب، تغییر حساب): لغو یک مرسولهٔ سفارش جاری با ذکر دلیل (با تأیید شما)
- `dk_cart` (با حساب): سبد خرید شما: اقلام، تعداد و قیمت به تومان
- `dk_cart_edit` (با حساب، تغییر حساب): افزودن کالا به سبد خرید، تغییر تعداد یا حذف آن
- `dk_favorites` (با حساب): فهرست علاقه‌مندی‌های شما با قیمت و موجودی
- `dk_favorite` (با حساب، تغییر حساب): افزودن کالا به علاقه‌مندی‌ها یا برداشتن آن
- `dk_alerts` (با حساب): کالاهایی که برای «موجود شد» یا شگفت‌انگیز شدن زیر نظر دارید
- `dk_alert` (با حساب، تغییر حساب): خبر دادن هنگام موجود شدن کالا یا شگفت‌انگیز شدنش، یا برداشتن این هشدار
- `dk_notifications` (با حساب): پیام‌های صندوق دیجی‌کالا، تازه‌ترین اول، با تعداد خوانده‌نشده‌ها
- `dk_addresses` (با حساب): نشانی‌های ذخیره‌شدهٔ شما (آدرس کامل و گیرنده نیمه‌پنهان)
- `dk_wallet` (با حساب): موجودی کیف پول دیجی‌پی، اعتبار، امتیاز دیجی‌کلاب و دیجی‌کوین

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

- ارزان‌ترین لپ‌تاپ با رم ۱۶ گیگ در دیجی‌کالا کدام است؟
- بهترین هدفون بی‌سیم تا ۳ میلیون تومان چیست؟
- ارزان‌ترین گوشی سامسونگ A07 کدام است و الان قیمتش خوب است؟
- سفارش‌های جاری من در دیجی‌کالا کجا هستند؟

## توضیحات

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

این سرور غیررسمی است و ۲۳ قابلیت دارد. بدون اتصال حساب فقط اطلاعات را می‌خواند: وارد حساب شما نمی‌شود، سبد خرید نمی‌سازد و سفارش ثبت نمی‌کند. اگر در روتر MCP حساب دیجی‌کالای خود را وصل کنید، دستیار به سفارش‌ها، سبد خرید، علاقه‌مندی‌ها و کیف پول شما هم دسترسی پیدا می‌کند.

معمولاً به IP ایران (اتصال از داخل ایران) نیاز ندارد. اگر همه قابلیت‌ها خطای 403 دادند، `DIGIKALA_MCP_PROXY` را روی یک پراکسی HTTP با خروجی ایران بگذارید.

#### نکته‌ها

- همه قیمت‌ها به تومان است و امتیازها مثل خود سایت از ۵.
- جواب‌ها تا ۲ دقیقه نگه داشته می‌شوند؛ پس قیمت ممکن است تا همین حد از سایت عقب باشد.
- این سرور در روتر هم هست: کافی است در داشبورد اضافه‌اش کنید.
