Digikala MCP - shop intelligence for AI agents

A public MCP server that gives AI agents - Iran's largest online marketplace: search, , discounts, ratings, sellers, reviews, deals and bestsellers.
接入你的智能体
从发布者处安装。不是 PlugMCP 端点。
远程 URL 还是本机命令? 两种安装方式的区别
来自发布者

A public MCP server that gives AI agents - Iran's largest online marketplace: search, , discounts, ratings, sellers, reviews, deals and bestsellers.
MCP server for Digikala: search, compare and price-check products on Iran's largest marketplace. Read-only, no API key. 19 tools, hosted on Cloudflare Workers.
Live endpoint: https://digikala-mcp.mmdju.workers.dev/mcp (Streamable HTTP)
Any Streamable HTTP MCP client, one URL. Cline / Cursor / Claude Desktop (mcp.json style):
{
"mcpServers": {
"digikala": { "url": "https://digikala-mcp.mmdju.workers.dev/mcp" }
}
}
Then just talk: "best Samsung phone under 100 million Toman", "is this laptop any good?", "what is on deal today?", "what is popular in Iran right now?".
No client at hand? The whole protocol is one POST - a real call:
curl -sS https://digikala-mcp.mmdju.workers.dev/mcp \
-H 'content-type: application/json' \
-H 'accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_digikala","arguments":{"query":"هدفون بی سیم","limit":2}}}'
And a real answer, trimmed to its bones (Toman, as JSON numbers):
{
"query": "هدفون بی سیم",
"returned": 2,
"items": [
{ "id": 5112620, "title": "هدفون بی سیم مدل P47 5.0+EDR", "price_toman": 800000, "rating_stars": 3.7, "url": "https://www.digikala.com/product/dkp-5112620/" },
{ "id": 19019009, "title": "هدفون بلوتوثی مدل P9 V5.3 ...", "price_toman": 900000, "rating_stars": 3, "url": "https://www.digikala.com/product/dkp-19019009/" }
]
}
Find it
Know one product
Decide
What is hot
digikala_suggest to get real search terms and a category_id; get brand_ids from search_filters or brand_lookup.find_best_value - plain search only sees one page. A brand word in query is not a filter - picks come from a price-sorted page - so pin the brand with brand_ids from brand_lookup.low_confidence with the exact unmatched_terms, and clamped pages report page_clamped instead of silently correcting.retry-after; the counter is Cloudflare's, per data centre). A full agent session - handshake, a search, a few detail reads, one comparison - measures at roughly 15-20 POSTs, so ordinary use never comes close.browse_tag falls back to a plain search for the shelf's name and labels the answer items_from_search: true - never a silent substitute.flowchart LR
subgraph you [Your machine]
agent[AI agent<br/>Cline / Cursor / Claude]
end
subgraph cf [Cloudflare Workers]
worker[digikala-mcp<br/>read-only, no accounts]
end
dk[(Digikala public web API<br/>api.digikala.com)]
agent -->|POST /mcp<br/>Streamable HTTP, no key| worker
worker -->|HTTPS + polite pacing<br/>reads only| dk
dk -->|compact JSON| worker
worker -->|small cards<br/>toman, rating, URL| agent
One request in, one answer out - and nothing in that path stores who you are. The full picture is in docs/architecture.md.
Don't take my word for it - check the live server yourself:
node scripts/verify-live.mjs # needs Node.js 18+, nothing to install
It checks the handshake, the live release against this repo's CHANGELOG, the tool list, a real search with a details read, and the two error paths. The same script runs hourly in CI () - if the endpoint or Digikala's API drifts, the badge goes red. examples/python.py is a copy-paste client (standard library only).
Digikala's public web API (undocumented, may change without notice). This project is not affiliated with or endorsed by Digikala.
Showcase repository - docs, examples and the standalone live-verify script, no server source - see LICENSE. Security notes in SECURITY.md. Persian version in README_FA.md.
If this is useful, a star helps other builders find it.
MCP server for Digikala: search, compare and price-check products on Iran's largest marketplace. Read-only, no API key. 19 tools, hosted on Cloudflare Workers.
工具
暂无工具列表。远程服务器在首次健康检查后会获得工具列表。
常见问题
在本页复制适用于 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 配置。它使用发布者的安装方式,而不是 PlugMCP 代理。
此记录未列出必需的环境变量。
Digikala 通过 stdio 在本地运行。
上次检查时间:2026-10-28。 MCP server for Digikala: search, compare and price-check products on Iran's largest marketplace. Read-only, no API key. 19 tools, hosted on Cloudflare Workers.