Digikala

digikala-mcp：面向 AI Agent 的 Digikala MCP 服务

让你的 AI Agent 在 Digikala（دیجی‌کالا）上逛逛。
这是面向伊朗最大网店的非官方只读 MCP 服务：搜索商品、比较每位卖家的报价、
查看商品价格历史、阅读评价和问答，还能查看今日的 Incredible Offers；以上操作均可通过 Claude、Cursor 或 Copilot 完成。

面向 AI Agent · 原因 · 功能 · 快速开始 · 工具 · 工作原理 · 须知 · 常见问题 · 配置 · فارسی · 开发 · 相关服务

面向 AI Agent

• 简介： 面向 Digikala（digikala.com，伊朗）及其 Fresh 超市的非官方 MCP 服务（模型上下文协议）。支持波斯语或英语查询，价格以 Toman 计。
• 安装： uvx digikala-mcp 或 claude mcp add digikala -- uvx digikala-mcp。传输方式：stdio。需要安装 uv（Python 3.10+）。
• 身份验证： 无需身份验证、API 密钥或账户。可选配置 DIGIKALA_MCP_PROXY（HTTP 代理，也可以是以逗号分隔的代理列表；例如使用伊朗出口节点，以防 Digikala 屏蔽你的连接）。
• 访问权限： 只读。无需登录，无法使用购物车、结账或付款，因此调用任何工具前均无需确认。
• 工具： 共 23 个，名称均以 dk_ 开头。可从 dk_find_cheapest、dk_search、dk_best_for_budget、dk_deals 开始。 典型调用顺序：dk_find_cheapest -> dk_product -> dk_price_history。
• 适用场景： 在 Digikala（包括 Fresh 超市）上查找、比较或评估商品及卖家的价格。
• 不适用场景： 用户想要购买商品，或需要了解运费（仅在结账时计算），或需要访问任何登录后才能查看的内容。
• 输出： 精简的 JSON。价格以 Toman 计，评分范围为 0-5（null = 暂无评分）。工具之间传递数字商品 ID（dkp-<id> 中的 <id>）。
• 网络： 从你的设备直接连接 api.digikala.com。如果每次调用都出现“拒绝请求（HTTP 403）”，请设置 DIGIKALA_MCP_PROXY。
• 机器可读信息： server.json 和 iran-mcp 目录（TOOLS.md、servers.json、llms.txt）。

为什么

Digikala 上同一款手机会重复出现很多次：不同颜色、内存容量、套装，以及每个商品列表下的一大堆卖家，价格还每天都在变。按“最便宜”排序时，手机壳会排在最前面。想找到真正最便宜的商品，以及今天的价格是否值得入手，需要点很多次。使用 digikala-mcp 的 Agent 只需调用三次：

你： Digikala 上最便宜的 Samsung Galaxy A07 是哪款，现在适合买入吗？

Agent： 调用 dk_find_cheapest(query="samsung a07") → dk_product(product_id=20109389) → dk_price_history(product_id=20109389)

价格	型号	卖家
42,503,600	Galaxy A07 64 GB / 4 GB	Digikala（德黑兰当天送达）
44,518,000	Galaxy A07 64 GB / 4 GB + 25 W 充电器	Sepahan Hamrah Yaghout
46,811,800	Galaxy A07 128 GB / 4 GB	Digikala

64 GB 型号最便宜，售价 42,503,600，由 Digikala 自营；下一位卖家的报价为 42,918,000。 但现在并不是入手的好时机：黑色款昨天的售价是 34,499,000，本月最低价则是 33,200,000。今天的最佳报价比昨天高出约 23%，因此等一等可能更划算。

_{来自 2026-10-03 的真实工具输出；价格随时可能变化。价格单位为 Toman。}

能做什么

• 搜索整个商品目录，支持波斯语或英语，并可按价格、品牌、功能（操作系统、存储空间等）、颜色、卖家和快速配送筛选；每条结果都会说明标题是否确实匹配
• 找到真正最便宜的匹配商品，过滤掉配件，并列出该商品各卖家的报价
• 按预算挑选最佳商品，根据结合评分人数加权的评分排序，并展示判断依据
• 一次调用重新检查最多 10 件候选商品：价格、最低报价、库存，以及与 30 天最低价的差距
• 判断价格，参考约 30 天的每日价格历史和 30 天最低价
• 浏览类别、品牌、卖家和畅销商品，并按价格、销量、浏览量、上新时间或买家推荐排序
• 检查质量，查看评价、优缺点、买家问答和卖家信誉
• 发现优惠：惊喜优惠和超市（Digikala Fresh）折扣
• 其他功能：规格对比、分期付款方案、Digikala Plus 配送方案、实时黄金和金币价格
• 设计上仅支持只读操作：无需登录，不使用购物车、不下单、不付款

快速开始

你需要 uv。无需 API 密钥或账户。

claude mcp add digikala -- uvx digikala-mcp

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

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

codex mcp add digikala -- uvx digikala-mcp

[mcp_servers.digikala]
command = "uvx"
args = ["digikala-mcp"]

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

然后只需提问：

• “低于 300 万托曼、评分至少 4 星的最便宜 AirPods 风格耳机是哪款？”
• “比较一下 Galaxy A07 64 GB 和 128 GB。更大容量的版本值得多花钱吗？”
• “这个卖家靠谱吗？CGDG9”
• “今天耳机的超值优惠有哪些？按折扣力度从高到低排列。”
• “哪些由 Digikala 自营、容量为 256 GB 的 Android 手机价格低于 2000 万托曼？”
• 超市里最便宜的低脂牛奶多少钱？
• 最便宜的三星 A07 手机是哪款？现在适合买入吗？
• 今天耳机有什么超值优惠？

工具

产品 ID 是 digikala.com/product/dkp-<id>/ 链接中的数字。每个列表都会返回紧凑的产品卡片： ID、标题、品牌、价格、折扣、库存、卖家、评分、照片 URL（image）和产品链接。

所有 23 个工具都标注了 readOnlyHint: true，并返回紧凑的结构化 JSON，不会让 Agent 的上下文被大量信息淹没。

工作原理

  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 在本地运行，并调用 digikala.com Web 应用使用的相同公共端点。过程中没有 托管服务，不需要 API 密钥，也不会将你的任何信息发送到其他地方。

需要了解的信息

• 价格单位为托曼。 Digikala API 返回的单位是里亚尔；每个工具都会除以 10，使数值与网站一致。黄金和金币的价格已经是托曼。
• 评分范围为 0–5，与网站一致（API 中的 0–100 除以 20）；null 表示尚未评分。评论星级范围为 1–5。
• 支持波斯语和英语查询（گوشی سامسونگ、airpods pro）。类别和品牌代码使用英文 slug（mobile-phone、samsung）。
• 文本搜索中使用 sort=cheapest 会优先显示配件；这是 Digikala 的排序方式。要查找“最便宜的 X”，请使用 dk_find_cheapest。
• 搜索总会返回结果，即便查询词毫无意义（Digikala 的搜索采用语义搜索）。dk_search 会为每个结果标注 match: all / some / none（并列出未匹配的词），而 dk_find_cheapest 和 dk_best_for_budget 只保留标题包含所有查询词的结果。
• 按特性筛选：dk_filters(category_code="mobile-phone") 会列出 ID，例如操作系统 → Android，然后通过 dk_category_products(attributes={2226: [19239]}) 进行筛选。
• 30 天最低价会忽略仅持续一天的降价。 dk_shortlist 会将今日价格与连续两天保持的最低价格（low_30d）进行比较，因为 Digikala 自己的 30 天最低价（lowest_one_day_30d，即 dk_product 的 lowest_price_30d）可能只是某种颜色单日的价格。dk_price_history 会提供每种颜色的价格历史。
• 照片：商品卡片包含 image，dk_product 包含 images 列表（最多 4 张）；两者都是直接取自 API 的绝对 https URL。URL 以 ?x-oss-process=image/resize,m_lfit,h_300,w_300/quality,q_80 结尾，因此图片是 300 px 的 JPEG；删除此后缀即可获取原始尺寸图片。
• 热门商品的价格每小时可能变动多次，尤其是卖家众多的商品；购买前请重新确认价格。
• 答案会缓存 2 分钟，因此 Agent 重复调用时不会再次访问 Digikala；价格可能因此比网站上的价格滞后 2 分钟。超时、5xx 或 429 错误最多会在退避后重试两次。
• 杂货来自超市商店：dk_product 显示的是该商店的价格，可能与搜索结果中的主店价格不同。
• 运费仅在结账时计算（需要登录）。dk_product 会显示各商品优惠的配送方式，dk_plus_plans 会显示免运费方案。

常见问题

npx @modelcontextprotocol/inspector uvx digikala-mcp

配置

波斯语

claude mcp add digikala -- uvx digikala-mcp

开发

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 .

实时测试也可以在 GitHub 上运行（Actions → Live → Run workflow）。这些测试不会定时运行：从 GitHub 的美国 Runner 运行时，Digikala 每次运行都会有几次调用超时，而通过伊朗网络连接运行相同的测试则能通过。

工具位于 src/digikala_mcp/catalog.py、product.py 和 services.py 中；每个工具都是带类型注解的异步函数，并附有说明 Agent 何时应使用它的文档字符串。欢迎提交 Issue 和 PR，尤其是新工具以及针对 API 变更的修复。

发布版本：更新 pyproject.toml 和 server.json 中的版本号，然后推送 v* 标签。GitHub Actions 会运行测试、发布到 PyPI 和 MCP Registry，并创建 GitHub Release。

相关服务

• Technolife MCP server 提供电子产品价格和分期价格
• MasterKala MCP server 提供小工具和手机配件
• Torob MCP server 比较伊朗各商店的价格
• Okala MCP server 提供在线杂货购物服务
• Banimode MCP server 提供时尚服饰
• iran-mcp：伊朗服务 MCP 服务目录

免责声明

本项目为非官方项目，与 Digikala 无关，也未获得其认可。它使用 digikala.com Web 应用的公共端点，这些端点可能随时变更，恕不另行通知。请合理控制请求频率。

作者

由 Sepehr Radmard（سپهر رادمرد）构建并维护。欢迎在 LinkedIn 上联系，或在 GitHub 上关注 @sepehr071，获取更多面向伊朗网站的 MCP 服务，所有服务都列在 iran-mcp 中。如果这为你节省了时间，请给仓库点个星，帮助其他人发现它。

许可证

MIT

如果这为你省去了几次点击，请给个星，帮助其他人发现它。