digikala-mcp
Advanced tools
Unofficial read-only MCP server for Digikala: search with feature filters, best picks for a budget, compare sellers and prices, price history, reviews, deals.
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 · Why · What it can do · Quick start · Tools · How it works · Good to know · FAQ · Configuration · فارسی · Development · Related
uvx digikala-mcp or claude mcp add digikala -- uvx digikala-mcp. Transport: stdio. Needs uv (Python 3.10+).DIGIKALA_MCP_PROXY (HTTP proxy, or a comma-separated list, e.g. with an Iranian exit if Digikala blocks yours).dk_. Start with dk_find_cheapest, dk_search, dk_best_for_budget, dk_deals.
Typical sequence: dk_find_cheapest -> dk_product -> dk_price_history.null = not rated). Numeric product ids (the <id> of dkp-<id>) pass between tools.api.digikala.com directly from your machine. On "refused the request (HTTP 403)" for every call, set DIGIKALA_MCP_PROXY.server.json and the
iran-mcp catalog (TOOLS.md, servers.json, llms.txt).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)
Price Model Seller 42,503,600 Galaxy A07 64 GB / 4 GB Digikala (same-day delivery in Tehran) 44,518,000 Galaxy A07 64 GB / 4 GB + 25 W charger Sepahan Hamrah Yaghout 46,811,800 Galaxy A07 128 GB / 4 GB Digikala 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.
You need uv. No API key or account.
claude mcp add digikala -- uvx digikala-mcp
Settings → Developer → Edit Config, then add:
{
"mcpServers": {
"digikala": { "command": "uvx", "args": ["digikala-mcp"] }
}
}
Click Install in Cursor above, or add the Claude Desktop block to ~/.cursor/mcp.json.
Click Install in VS Code above, or add to .vscode/mcp.json:
{
"servers": {
"digikala": { "type": "stdio", "command": "uvx", "args": ["digikala-mcp"] }
}
}
codex mcp add digikala -- uvx digikala-mcp
Or in ~/.codex/config.toml:
[mcp_servers.digikala]
command = "uvx"
args = ["digikala-mcp"]
Add to ~/.gemini/settings.json:
{
"mcpServers": {
"digikala": { "command": "uvx", "args": ["digikala-mcp"] }
}
}
Add the Claude Desktop block to ~/.codeium/windsurf/mcp_config.json.
It's a standard stdio MCP server: run uvx digikala-mcp, or pip install digikala-mcp and run digikala-mcp.
Then just ask:
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.
| Tool | What it does |
|---|---|
dk_search | Search by words with sort, price, brand, feature, color and seller filters; flags loose title matches |
dk_find_cheapest | Cheapest in-stock real matches for a query, accessories dropped, one list |
dk_best_for_budget | Best-rated real matches under a budget, rating weighted by number of ratings |
dk_suggest | Autocomplete: better keywords, category codes and brand ids |
dk_filters | Filter options of a category or search: features (OS, storage, ...), colors, brands, sellers, price range |
dk_categories | Find category codes and main-category ids |
dk_category_products | Browse a category with sort and the same filters, optionally one brand |
dk_brand_products | Browse a brand's products |
dk_seller | A seller's rating, on-time shipping, cancellations, returns and products |
dk_deals | Incredible Offers or supermarket deals, biggest discount first |
dk_best_sellers | Current best sellers, overall or per main category |
dk_fresh_search | Search or browse Digikala Fresh, the supermarket |
| Tool | What it does |
|---|---|
dk_product | Price, stock, specs and every seller's offer (color, warranty, shipping), cheapest first |
dk_shortlist | Re-price up to 10 products at once: price, cheapest offer, stock, rating, distance from the 30-day low |
dk_price_history | About 30 days of daily prices per color, with low and high |
dk_reviews | Customer reviews with stars, pros/cons and verified-buyer flag |
dk_questions | Customer questions with their top answers |
dk_similar | Similar products, e.g. cheaper alternatives |
dk_compare | 2-4 products side by side: the specs that differ, plus the shared ones |
dk_installments | Digipay credit-line offers for a product (credit amount, monthly repayment, months) |
| Tool | What it does |
|---|---|
dk_plus_plans | Digikala Plus membership plans (free shipments) and benefits |
dk_gold_prices | Live 18k gold price per gram (daily and ~3-month change) and gold coin prices |
dk_location | Address → 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.
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.
null means not rated yet. Review stars are 1–5.گوشی سامسونگ, 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".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.dk_filters(category_code="mobile-phone") lists ids like operating system → Android, then dk_category_products(attributes={2226: [19239]}) filters on them.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.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.dk_product shows its price, which can differ from the main-store price in search results.dk_product shows how each offer ships, and dk_plus_plans the free-shipping plans.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.
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.
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.
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. If Digikala serves a bot-check page, install the optional browser
fallback (uvx --with patchright==1.63.0 digikala-mcp or pip install digikala-mcp[browser]), then run
patchright install chromium.
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.
in_stock: false and no priceDigikala 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.
Yes. dk_fresh_search searches and browses Digikala Fresh, dk_deals takes store='supermarket', and dk_product
falls back to the Fresh product API for supermarket ids.
Toman, like the website. The API answers in Rial and every tool divides by 10; gold and coin prices are already Toman.
dk_installments return a note instead of offers?Since 2026-10-05 Digikala's Digipay credit endpoint answers an empty list for every product (the product page shows no credit box either), so the tool returns a note instead of offers.
uvx is not foundUse the full path to uvx (where uvx on Windows, which uvx on macOS/Linux) as command.
npx @modelcontextprotocol/inspector uvx digikala-mcp
| Variable | Default | Meaning |
|---|---|---|
DIGIKALA_MCP_PROXY | unset | HTTP proxy for every request, e.g. http://user:pass@host:port. A comma-separated list is used one at a time: the next proxy takes over when one is blocked (403/429) or cannot connect |
digikala-mcp یک سرور MCP غیررسمی و فقطخواندنی برای دیجیکالا، بزرگترین فروشگاه اینترنتی ایران، است. این سرور به دستیار هوش مصنوعی شما (Claude، Cursor، Copilot و ...) اجازه میدهد در دیجیکالا جستجو کند، قیمت همه فروشندگان یک کالا را مقایسه کند، تاریخچه قیمت، نظرات و پرسشوپاسخها را بخواند و پیشنهادهای شگفتانگیز را پیدا کند.
چه کارهایی میکند
نکتهها
کلیدواژهها: دیجیکالا، digikala، سرور MCP دیجیکالا، مقایسه قیمت، ارزانترین قیمت، تاریخچه قیمت، شگفتانگیز دیجیکالا، دیجیکالا فرش، فروشگاه اینترنتی، خرید آنلاین.
نصب (اول uv را نصب کنید). در Claude Code:
claude mcp add digikala -- uvx digikala-mcp
در Claude Desktop، Cursor و بقیه برنامهها همان تنظیم بخش Quick start را بگذارید.
نمونه پرسشها
git clone https://github.com/sepehr071/digikala-mcp && cd digikala-mcp
uv sync
uv run python -m pytest # offline, against recorded responses
uv run python -m 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.
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.
Built and maintained by Sepehr Radmard (سپهر رادمرد). Connect on LinkedIn or follow @sepehr071 on GitHub for more MCP servers for Iranian websites, all listed in iran-mcp. If this saves you time, a star on the repo helps other people find it.
If this saves you clicks, a star helps others find it.
FAQs
Unofficial read-only MCP server for Digikala: search with feature filters, best picks for a budget, compare sellers and prices, price history, reviews, deals.
We found that digikala-mcp demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Threat Research
/Security News
Socket uncovered secret-stealing workflows that ran in LiteLLM’s GitHub repository 11 days before the supply chain attack on PyPI and Docker.
Security News
Cloudflare introduces tsrs, a Rust port of TypeScript’s compiler promising faster checks and lower memory use, with the TypeScript team’s help.
Security News
The PHP Foundation says Chainguard broke a security embargo ahead of critical RCE patches, as leaks disrupted the coordinated release.