# Digikala

Searches Digikala products, tracks 30-day price trends, compares seller offers, and pulls customer reviews directly into agent chats.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 37
- Author: sepehr071
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/sepehr071/digikala-mcp
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/digikala

## What it does

This read-only server equips assistants with 23 tools prefixed by `dk_` to query the Digikala marketplace and its Fresh supermarket. It processes queries in English or Persian, filters out accessories when hunting for the lowest price, and spots Incredible Offers deals. Prices are reported in Toman.

Requests require no user credentials or API tokens. The server cannot place orders or manage shopping carts. It also skips delivery calculations because the platform determines shipping fees only at checkout. Execution relies on `uv` alongside Python 3.10+.

Direct network calls target `api.digikala.com`. Whenever environments outside Iran encounter HTTP 403 errors, assigning an Iranian proxy to the `DIGIKALA_MCP_PROXY` variable resolves the issue.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `DIGIKALA_MCP_PROXY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env DIGIKALA_MCP_PROXY=<DIGIKALA_MCP_PROXY> --transport stdio digikala -- uvx digikala-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from digikala-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add digikala --env DIGIKALA_MCP_PROXY=<DIGIKALA_MCP_PROXY> -- uvx digikala-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from digikala-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "digikala": {
            "command": "uvx",
            "args": [
                "digikala-mcp"
            ],
            "env": {
                "DIGIKALA_MCP_PROXY": "<DIGIKALA_MCP_PROXY>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from digikala-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "digikala": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "digikala-mcp"
            ],
            "env": {
                "DIGIKALA_MCP_PROXY": "<DIGIKALA_MCP_PROXY>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from digikala-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e DIGIKALA_MCP_PROXY=<DIGIKALA_MCP_PROXY> digikala uvx digikala-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from digikala-mcp <command>

## When to use it
- filter out phone cases and locate the cheapest merchant for an exact product
- inspect 30-day pricing history to verify whether a discount is genuine
- evaluate merchant ratings and customer reviews before buying
- track active discounts across Incredible Offers and Digikala Fresh

## Example prompts
- Find the cheapest offer for Samsung Galaxy A07 on Digikala and show its price history.
- Check seller ratings, pros, and cons for Digikala product ID 20109389.
- List today's top deals in the Digikala Fresh supermarket under 5000000 Toman.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md