# Digikala [Health: Active]

**Category:** 🛒 E-Commerce  
**Repository:** https://github.com/sepehr071/digikala-mcp  
**GitHub Stars:** 30  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/digikala

## Description
Unofficial read-only Digikala: search products, compare sellers, price history, reviews, deals.

## Tools
Capabilities this server exposes over MCP:

- **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
- **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)
- **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

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

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

## Documentation

## What Digikala MCP server does

The Digikala MCP server gives an AI agent read-only access to product and marketplace information from Digikala, Iran’s online store. It supports Persian and English queries and returns prices in Toman. The server does not log in, add items to a cart, place orders, or make payments, so it is intended for research and comparison rather than transaction workflows.

The available data covers the main Digikala catalogue, individual seller offers, Digikala Fresh supermarket listings, Incredible Offers, customer feedback, and selected related services. A typical research flow can identify the cheapest matching item, inspect its seller offers, and then check roughly 30 days of price history.

## How it works

The Digikala MCP server runs on the local machine and communicates with an AI client through MCP over stdio. It then makes HTTPS requests to Digikala’s public API endpoints, which provide products, sellers, deals, and Fresh data. There is no hosted intermediary described in the project, and authentication is not required.

Product identifiers are numeric values taken from Digikala product links, such as the number after `dkp-`. These identifiers can be passed between tools for follow-up operations. Responses are compact JSON containing fields such as product title, brand, price, discount, stock, seller, rating, image URL, and product link where applicable. Ratings use a 0–5 scale, and unavailable ratings may be returned as `null`.

The server is suitable for agents that need to narrow a catalogue search, compare two to four products, re-check up to ten products, or assess whether a current price is near its recent low. Shipping cost is not available because Digikala calculates it at checkout.

## Setup and configuration

Install `uv`, with Python 3.10 or newer available for the package, then run the Digikala MCP server with:

```bash
uvx digikala-mcp
```

It can also be installed with `pip install digikala-mcp` and started with `digikala-mcp`. Claude Code can register it with `claude mcp add digikala -- uvx digikala-mcp`. Claude Desktop, Cursor, and VS Code can use a stdio configuration whose command is `uvx` and whose argument is `digikala-mcp`.

No API key or account is needed. If Digikala blocks the local network connection, the optional `DIGIKALA_MCP_PROXY` setting can specify an HTTP proxy, including one with an Iranian exit. The server uses no login credentials.

## Tools and capabilities

The Digikala MCP server exposes tools in five broad groups:

- **Discovery:** search, autocomplete suggestions, category and brand browsing, seller browsing, best sellers, filters, and Fresh supermarket search.
- **Selection:** find the cheapest in-stock matching products, rank products within a budget, and remove accessory results from cheapest-match results.
- **Product analysis:** inspect price, stock, specifications, seller offers, colors, warranties, shipping details, similar products, and side-by-side differences.
- **Market signals:** view daily prices for about 30 days, identify recent lows and highs, re-price a shortlist of up to ten products, inspect reviews and questions, and find current deals.
- **Additional data:** query Digipay installment offers, Digikala Plus plans, live 18k gold and coin prices, and address or coordinate conversion with Digikala location identifiers.

The confirmed category for this listing is 🛒 E-Commerce. Use the Digikala MCP server when the agent must gather current marketplace information; use another system when the task requires buying, account access, checkout, or shipping-cost computation.

_Full upstream README: https://allmcps.com/mcp/digikala/readme_