claudeers.
// MCP Servers

digikala-mcp

Unofficial read-only MCP server for Digikala (دیجی‌کالا), Iran: search products, compare every seller and price, price history, reviews and deals. For Claude…

// MCP Servers[ cli ][ api ][ desktop ][ web ][ mobile ][ claude ]#claude#ai-agents#claude-code#cursor#digikala#e-commerce#iran#mcp#mcp-servers◷ MIT$open-sourceupdated about 1 month ago
Actively maintained
100/100
last commit 7 days ago
last release 7 days ago
releases 12
open issues 0
// star history

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up digikala-mcp (pip project) into my current project.
Found on https://claudeers.com/digikala-mcp
Repo: https://github.com/sepehr071/digikala-mcp
Homepage/docs: https://pypi.org/project/digikala-mcp/
Detected install method: pip → pip install digikala-mcp
Category: mcp-servers. Platforms: cli, api, desktop, web, mobile.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or install directly (pip)
pip install digikala-mcp
// or clone
git clone https://github.com/sepehr071/digikala-mcp

// compatibility

Platformscli, api, desktop, web, mobile
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguagePython

Get your FREE $2.50 API credits to access TickAtlas financial data ↗
digikala-mcp: unofficial Digikala MCP server for Claude, Cursor and Copilot

digikala-mcp: Digikala MCP server for AI agents

Let your AI agent shop around on Digikala (دیجی‌کالا).
An unofficial, read-only MCP server for Iran's largest online store: search products, compare every seller's offer,
check a product's price history, read reviews and Q&A, and catch today's Incredible Offers, all from Claude, Cursor or Copilot.

For AI agents · Quick start · What it can do · Tools · FAQ · فارسی


For AI agents

  • What: unofficial MCP server for Digikala (digikala.com, Iran). Queries in Persian or English, prices in Toman.
  • Install: uvx digikala-mcp or claude mcp add digikala -- uvx digikala-mcp. Transport: stdio. Needs uv (Python 3.10+).
  • Auth: none, no API key or account. Optional DIGIKALA_MCP_PROXY (HTTP proxy, e.g. with an Iranian exit if Digikala blocks yours).
  • Access: read-only. No login, cart, checkout or payment, so no confirmation is needed before calling any tool.
  • Tools: 23, all prefixed dk_. Start with dk_find_cheapest, dk_search, dk_best_for_budget, dk_deals. Typical sequence: dk_find_cheapest -> dk_product -> dk_price_history.
  • Use when: finding, comparing or judging prices of products and sellers on Digikala, including the Fresh supermarket.
  • Do not use when: the user wants to buy, or needs shipping cost (only calculated at checkout) or anything behind a login.
  • Output: compact JSON. Prices in Toman, ratings 0-5 (null = not rated). Numeric product ids (the <id> of dkp-<id>) pass between tools.
  • Machine-readable: server.json and the awesome-iran-mcp catalog (TOOLS.md, servers.json, llms.txt).

Why

Digikala lists the same phone many times: different colors, memory sizes, bundles and a dozen sellers per listing, with prices that move every day. Sorting by "cheapest" puts phone cases first. Finding the real cheapest offer, and whether today's price is a good one means a lot of clicking. An agent with digikala-mcp does it in three calls:

You: Cheapest Samsung Galaxy A07 on Digikala, and is now a good time to buy?

Agent: calls dk_find_cheapest(query="samsung a07") → dk_product(product_id=20109389) → dk_price_history(product_id=20109389)

PriceModelSeller
42,503,600Galaxy A07 64 GB / 4 GBDigikala (same-day delivery in Tehran)
44,518,000Galaxy A07 64 GB / 4 GB + 25 W chargerSepahan Hamrah Yaghout
46,811,800Galaxy A07 128 GB / 4 GBDigikala

The 64 GB model is cheapest at 42,503,600, sold by Digikala itself; the next seller asks 42,918,000. But it's not a great moment: the black one sold for 34,499,000 yesterday and 33,200,000 at its lowest this month. Today's best offer is about 23% above yesterday's, so waiting may pay off.

Real tool output from 2026-10-03; prices change all the time. Prices are in Toman.

What it can do

  • 🔎 Search the whole catalogue in Persian or English, with price, brand, feature (OS, storage, ...), color, seller and fast-delivery filters; every result says whether its title really matches
  • 💸 Find the real cheapest match, with accessories filtered out, and every seller's offer for a product
  • 🏆 Best picks for a budget, ranked by a rating weighted by how many buyers rated it, with the reasoning shown
  • 📋 Re-check a shortlist of up to 10 products in one call: price, cheapest offer, stock, distance from the 30-day low
  • 📈 Judge a price with about 30 days of daily price history and the 30-day low
  • 🗂️ Browse categories, brands, sellers and best sellers, sorted by price, sales, views, newest or buyers' pick
  • ⭐ Check quality with reviews, pros/cons, buyer Q&A and seller reputation
  • ⚡ Catch deals: Incredible Offers and supermarket (Digikala Fresh) discounts
  • 🧾 Extras: spec comparison, installment plans, Digikala Plus shipping plans, live gold and coin prices
  • 🔒 Read-only by design: no login, no cart, no orders, no payment

Quick start

You need uv. No API key or account.

Claude Code
claude mcp add digikala -- uvx digikala-mcp
Claude Desktop

Settings → Developer → Edit Config, then add:

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

Click Install in Cursor above, or add the Claude Desktop block to ~/.cursor/mcp.json.

VS Code (Copilot agent mode)

Click Install in VS Code above, or add to .vscode/mcp.json:

{
  "servers": {
    "digikala": { "type": "stdio", "command": "uvx", "args": ["digikala-mcp"] }
  }
}
Anything else

It's a standard stdio MCP server: run uvx digikala-mcp, or pip install digikala-mcp and run digikala-mcp.

Then just ask:

  • "Cheapest AirPods-style earbuds under 3 million Toman with at least 4 stars?"
  • "Compare the Galaxy A07 64 GB and 128 GB. Is the bigger one worth the difference?"
  • "Is this seller reliable? CGDG9"
  • ارزان‌ترین شیر کم‌چرب در سوپرمارکت دیجی‌کالا چند است؟

How it works

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  digikala-mcp  (runs on your machine)
      │
      │  HTTPS
      └──────▶  api.digikala.com   products, sellers, deals, Fresh supermarket

digikala-mcp runs locally and calls the same public endpoints the digikala.com web app uses. There's no hosted server in between, no API key, and nothing about you is sent anywhere else.

Tools

Product ids are the number in a digikala.com/product/dkp-<id>/ link. Every list returns compact product cards: id, title, brand, price, discount, stock, seller, rating, a photo URL (image) and the product link.

🔎 Find products (12)
ToolWhat it does
dk_searchSearch by words with sort, price, brand, feature, color and seller filters; flags loose title matches
dk_find_cheapestCheapest in-stock real matches for a query, accessories dropped, one list
dk_best_for_budgetBest-rated real matches under a budget, rating weighted by number of ratings
dk_suggestAutocomplete: better keywords, category codes and brand ids
dk_filtersFilter options of a category or search: features (OS, storage, ...), colors, brands, sellers, price range
dk_categoriesFind category codes and main-category ids
dk_category_productsBrowse a category with sort and the same filters, optionally one brand
dk_brand_productsBrowse a brand's products
dk_sellerA seller's rating, on-time shipping, cancellations, returns and products
dk_dealsIncredible Offers or supermarket deals, biggest discount first
dk_best_sellersCurrent best sellers, overall or per main category
dk_fresh_searchSearch or browse Digikala Fresh, the supermarket
📦 Products (8)
ToolWhat it does
dk_productPrice, stock, specs and every seller's offer (color, warranty, shipping), cheapest first
dk_shortlistRe-price up to 10 products at once: price, cheapest offer, stock, rating, distance from the 30-day low
dk_price_historyAbout 30 days of daily prices per color, with low and high
dk_reviewsCustomer reviews with stars, pros/cons and verified-buyer flag
dk_questionsCustomer questions with their top answers
dk_similarSimilar products, e.g. cheaper alternatives
dk_compare2-4 products side by side: the specs that differ, plus the shared ones
dk_installmentsDigipay credit-line offers for a product (credit amount, monthly repayment, months)
🧾 Other (3)
ToolWhat it does
dk_plus_plansDigikala Plus membership plans (free shipments) and benefits
dk_gold_pricesLive 18k gold price per gram (daily and ~3-month change) and gold coin prices
dk_locationAddress → coordinates, or coordinates → address with Digikala city/province ids

All 23 tools are annotated readOnlyHint: true and return compact structured JSON, so they don't flood the agent's context.

Good to know

  • Prices are in Toman. The Digikala API answers in Rial; every tool divides by 10 so numbers match the website. Gold and coin prices are already Toman.
  • Ratings are 0–5, like the site (the API's 0–100 divided by 20); null means not rated yet. Review stars are 1–5.
  • Persian and English queries both work (گوشی سامسونگ, airpods pro). Category and brand codes are English slugs (mobile-phone, samsung).
  • sort=cheapest on a text search shows accessories first; that's how Digikala ranks it. Use dk_find_cheapest for "cheapest X".
  • Search always returns something, even for nonsense words (Digikala's search is semantic). dk_search marks each result match: all / some / none (with the missing words), and dk_find_cheapest and dk_best_for_budget keep only titles that contain every query word.
  • Filters by feature: dk_filters(category_code="mobile-phone") lists ids like operating system → Android, then dk_category_products(attributes={2226: [19239]}) filters on them.
  • The 30-day low ignores one-day dips. dk_shortlist compares today's price with the lowest price that held on two days in a row (low_30d), because Digikala's own 30-day low (lowest_one_day_30d, dk_product's lowest_price_30d) can be a single day of one color. dk_price_history gives both per color.
  • Photos: cards carry image, dk_product an images list (max 4), both absolute https URLs taken from the API as-is. They end in ?x-oss-process=image/resize,m_lfit,h_300,w_300/quality,q_80, so they are 300 px JPEGs; drop that suffix for the original size.
  • Prices move several times an hour on popular listings with many sellers; re-check right before buying.
  • Answers are cached for 2 minutes, so an agent repeating a call doesn't hit Digikala again; prices can lag the site by that much.
  • Groceries come from the supermarket store: dk_product shows its price, which can differ from the main-store price in search results.
  • Shipping cost is only calculated at checkout (login). dk_product shows how each offer ships, and dk_plus_plans the free-shipping plans.

FAQ

Is there a Digikala API or MCP server for AI agents?

Yes: digikala-mcp is an unofficial MCP server with 23 read-only tools for search, seller offers, price history, reviews and deals. It calls the same public endpoints the digikala.com web app uses; no API key is needed.

How do I use Digikala with Claude, Cursor or Copilot?

Add the server with claude mcp add digikala -- uvx digikala-mcp (or the matching config in Quick start for Claude Desktop, Cursor and VS Code), then ask in plain language, in Persian or English.

Is it official, safe and free?

It is unofficial and not affiliated with Digikala. It is read-only (no login, cart or payment), runs on your machine, and is free under the MIT license.

Do I need an Iranian IP?

Usually not: in testing the API answered from a foreign (Turkish) exit. If every tool fails with "refused the request (HTTP 403)", set DIGIKALA_MCP_PROXY to an HTTP proxy with an Iranian exit. (A 403 from just one call usually means an unknown category or brand code.) Normal system proxy variables are ignored on purpose.

Can it buy something for me?

No, and that's deliberate. It has no login and never calls the cart, checkout, payment, or review/question posting endpoints; it only reads public data. The agent finds the best option; you tap buy on the site.

A product shows in_stock: false and no price

Digikala lists products that are out of stock, coming soon or discontinued. They have no current offer, so there's no price. Searches use in_stock_only: true by default.

Claude Desktop says uvx is not found

Use the full path to uvx (where uvx on Windows, which uvx on macOS/Linux) as command.

How do I debug what the agent sees?
npx @modelcontextprotocol/inspector uvx digikala-mcp

Configuration

VariableDefaultMeaning
DIGIKALA_MCP_PROXYunsetHTTP proxy for every request, e.g. http://user:pass@host:port

فارسی: سرور MCP دیجی‌کالا

digikala-mcp یک سرور MCP غیررسمی و فقط‌خواندنی برای دیجی‌کالا، بزرگ‌ترین فروشگاه اینترنتی ایران، است. این سرور به دستیار هوش مصنوعی شما (Claude، Cursor، Copilot و ...) اجازه می‌دهد در دیجی‌کالا جستجو کند، قیمت همه فروشندگان یک کالا را مقایسه کند، تاریخچه قیمت، نظرات و پرسش‌وپاسخ‌ها را بخواند و پیشنهادهای شگفت‌انگیز را پیدا کند.

چه کارهایی می‌کند

  • جستجو به فارسی یا انگلیسی، با فیلتر قیمت، برند، ویژگی (سیستم عامل، حافظه و ...)، رنگ، نوع فروشنده و ارسال سریع؛ کنار هر نتیجه می‌گوید عنوانش واقعاً با جستجو جور است یا نه.
  • ارزان‌ترین کالای واقعی را پیدا می‌کند (لوازم جانبی مثل قاب و کابل را کنار می‌گذارد) و پیشنهاد همه فروشندگان یک کالا را از ارزان به گران نشان می‌دهد.
  • بهترین انتخاب با بودجه شما: کالاها را بر اساس امتیازی رتبه‌بندی می‌کند که تعداد امتیازدهنده‌ها را هم در نظر می‌گیرد، تا یک کالای ۵ ستاره با ۳ رأی از کالای ۴٫۶ ستاره با ۹۰۰ رأی جلو نزند.
  • تاریخچه قیمت حدود ۳۰ روز گذشته و کمترین قیمت ماه، برای اینکه بدانید الان وقت خرید است یا نه.
  • بررسی دوباره فهرست منتخب: قیمت، موجودی و فاصله تا کمترین قیمت ماه تا ۱۰ کالا با یک درخواست.
  • کیفیت: نظرات خریداران با نقاط قوت و ضعف، پرسش‌وپاسخ‌ها، و کارنامه فروشنده (ارسال به‌موقع، لغو، مرجوعی).
  • تخفیف‌ها: شگفت‌انگیزها، پرفروش‌ها و تخفیف‌های سوپرمارکت (دیجی‌کالا فرش).
  • بیشتر: مقایسه مشخصات فنی، طرح‌های دیجی‌کالا پلاس، قیمت لحظه‌ای طلا و سکه.

نکته‌ها

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

نصب (اول uv را نصب کنید). در Claude Code:

claude mcp add digikala -- uvx digikala-mcp

در Claude Desktop، Cursor و بقیه برنامه‌ها همان تنظیم بخش Quick start را بگذارید.

نمونه پرسش‌ها

  • «ارزان‌ترین گوشی سامسونگ A07 کدام است و الان قیمتش خوب است؟»
  • «بهترین هدفون بی‌سیم تا ۳ میلیون تومان چیست؟»
  • «گوشی اندرویدی با ۲۵۶ گیگ حافظه که خود دیجی‌کالا می‌فروشد، از ارزان به گران.»
  • «این سه لپ‌تاپ را مقایسه کن و بگو کدام ارزش خرید دارد.»
  • «امروز چه شگفت‌انگیزی برای هدفون هست؟»

Development

git clone https://github.com/sepehr071/digikala-mcp && cd digikala-mcp
uv sync
uv run pytest            # offline, against recorded responses
uv run pytest -m live    # real API
uv run ruff check .

The live tests can also run on GitHub (Actions → Live → Run workflow). They are not scheduled: from GitHub's US runners Digikala times out on a few calls each run, while the same tests pass from an Iranian connection.

Tools live in src/digikala_mcp/catalog.py, product.py and services.py; each is a typed async function with a docstring that tells the agent when to use it. Issues and PRs are welcome, especially new tools and fixes for API changes.

Releases: bump the version in pyproject.toml and server.json, then push a v* tag. GitHub Actions tests, publishes to PyPI and the MCP Registry, and creates the GitHub Release.

Disclaimer

Unofficial and not affiliated with or endorsed by Digikala. It uses the public endpoints of the digikala.com web app, which can change without notice. Please keep request rates reasonable.

License

MIT

If this saves you clicks, a star helps others find it.

// faq

What is digikala-mcp?

Unofficial read-only MCP server for Digikala (دیجی‌کالا), Iran: search products, compare every seller and price, price history, reviews and deals. For Claude, Cursor and Copilot via uvx.. It is open-source on GitHub.

Is digikala-mcp free to use?

digikala-mcp is open-source under the MIT license, so it is free to use.

What category does digikala-mcp belong to?

digikala-mcp is listed under mcp-servers in the Claudeers registry of Claude-compatible tools.

15 views
★ 43 stars
unclaimed
updated about 1 month ago

// embed badge

digikala-mcp on Claudeers
[![Claudeers](https://claudeers.com/api/badge/digikala-mcp.svg)](https://claudeers.com/digikala-mcp)

// retro hit counter

digikala-mcp hit counter
[![Hits](https://claudeers.com/api/counter/digikala-mcp.svg)](https://claudeers.com/digikala-mcp)

// reviews

// guestbook

0/500

// related in MCP Servers

🔓

f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete…

// mcp-serversf/⟨HTML⟩★ 175,627◷ NOASSERTION[ claude ]
🔓

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io

// mcp-serversfarion1231/⟨Rust⟩★ 151,540◷ MIT[ claude ]
🔓

🪨 why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman

// mcp-serversJuliusBrussee/⟨JavaScript⟩★ 117,780◷ MIT[ claude ]
🔓

An open-source AI agent that brings the power of Gemini directly into your terminal.

// mcp-serversgoogle-gemini/⟨TypeScript⟩★ 108,744◷ Apache-2.0[ claude ]
→ see how digikala-mcp connects across the ecosystem