Digikala

digikala-mcp：AI エージェント向け Digikala MCP サーバー

AI エージェントに Digikala（دیجی‌کالا）で買い物をさせましょう。
イラン最大のオンラインストア向けの非公式な読み取り専用 MCP サーバーです。Claude、Cursor、Copilot から商品の検索、各販売者の価格比較、
商品の価格履歴の確認、レビューやQ&Aの閲覧、本日の特別セールの確認ができます。

AI エージェント向け · 理由 · できること · クイックスタート · ツール · 仕組み · 知っておくと便利なこと · FAQ · 設定 · فارسی · 開発 · 関連

AI エージェント向け

• 概要： Digikala（digikala.com、イラン）とそのFreshスーパーマーケット向けの非公式 MCP サーバー（model context protocol）です。ペルシャ語または英語で問い合わせでき、価格はトマンで表示されます。
• インストール： 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。
• 使用する場面： Freshスーパーマーケットを含むDigikalaの商品や販売者を探したり、比較したり、価格を判断したりするときに使用します。
• 使用しない場面： ユーザーが購入を希望している場合、配送費用（チェックアウト時にのみ計算されます）が必要な場合、またはログインが必要な情報を求めている場合は使用しないでください。
• 出力： コンパクトなJSONです。価格はトマン、評価は0～5です（null は未評価）。数値の商品ID（dkp-<id> の <id>）をツール間で受け渡します。
• ネットワーク： お使いのマシンから api.digikala.com に直接接続します。すべての呼び出しで「request refused（HTTP 403）」が表示される場合は、DIGIKALA_MCP_PROXY を設定してください。
• 機械可読情報： server.json と iran-mcp カタログ（TOOLS.md、servers.json、llms.txt）。

理由

Digikalaでは、同じスマートフォンが何度も掲載されています。色やメモリ容量、セット内容が異なり、1つの商品に何十もの販売者がいて、価格は毎日変動します。「価格の安い順」で並べると、スマートフォンケースが先に表示されます。本当に最安値の販売者はどこか、今日の価格はお買い得なのかを調べるには、何度もクリックしなければなりません。digikala-mcpを使うエージェントなら、3回の呼び出しで完了します。

あなた： DigikalaでSamsung Galaxy A07の最安値を教えてください。今は買いどきですか？

エージェント： 呼び出し 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の実際のツール出力です。価格は常に変動します。価格の単位はトマンです。}

できること

• 検索： ペルシャ語または英語でカタログ全体を検索できます。価格、ブランド、機能（OS、ストレージなど）、色、販売者、速達配送のフィルターを指定でき、各検索結果にはタイトルが実際に一致しているかどうかも表示されます
• 本当の最安値を検索： アクセサリーを除外して、条件に一致する商品の最安値と、その商品の各販売者の価格を確認できます
• 予算に合わせたおすすめ商品： 評価した購入者数を加味した評価で順位付けし、選定理由も表示します
• 候補リストを再確認： 最大10商品について、価格、最安値、在庫、過去30日間の最安値との差を1回の呼び出しで確認できます
• 価格を判断： 約30日間の日次価格履歴と、過去30日間の最安値を確認できます
• 閲覧： カテゴリ、ブランド、販売者、人気商品を、価格、販売数、閲覧数、新着順、購入者おすすめ順で表示できます
• 品質を確認： レビュー、メリット・デメリット、購入者からの質問と回答、販売者の評判を確認できます
• お買い得品を見つける： Incredible Offersやスーパーマーケット（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スマートフォンで、2,000万トマン以下のものはどれですか？」
• ارزان‌ترین شیر کم‌چرب در سوپرمارکت دیجی‌کالا چند است؟
• ارزان‌ترین گوشی سامسونگ A07 کدام است و الان وقت خرید است؟
• امروز چه شگفت‌انگیزی برای هدفون هست؟

ツール

商品 ID は、digikala.com/product/dkp-<id>/ リンク内の数字です。各リストは、コンパクトな商品カードを返します： ID、タイトル、ブランド、価格、割引、在庫、販売者、評価、写真の URL（image）、商品リンク。

23 個すべてのツールには readOnlyHint: true が付与され、コンパクトな構造化 JSON を返すため、エージェントのコンテキストを過度に消費しません。

動作の仕組み

  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 のウェブアプリと同じ公開エンドポイントを呼び出します。その間にホストされたサーバーはなく、API キーも不要で、あなたに関する情報がほかの場所に送信されることもありません。

知っておくと便利な情報

• 価格はトマン表記です。 Digikala API の応答はリアル表記ですが、すべてのツールで 10 で割ってウェブサイトと同じ数値にしています。金と硬貨の価格は、すでにトマン表記です。
• 評価はサイトと同じ 0～5 です（API の 0～100 を 20 で割っています）。null は未評価を意味します。レビューの星評価は 1～5 です。
• ペルシャ語と英語のどちらでも検索できます（گوشی سامسونگ、airpods pro）。カテゴリコードとブランドコードは英語のスラッグです（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") で、オペレーティングシステム → Android のような ID を一覧表示し、dk_category_products(attributes={2226: [19239]}) で絞り込みます。
• 30 日間の最安値では、1 日だけの値下がりは無視されます。 dk_shortlist は、今日の価格を 2 日連続で維持された最安値（low_30d）と比較します。これは、Digikala 独自の 30 日間の最安値（lowest_one_day_30d、dk_product の lowest_price_30d）が、ある色の 1 日だけの価格である場合があるためです。dk_price_history では、色ごとの両方の値を確認できます。
• 写真：商品カードには image、dk_product には images リスト（最大 4 枚）が含まれます。どちらも API からそのまま取得した絶対 https URL です。末尾には ?x-oss-process=image/resize,m_lfit,h_300,w_300/quality,q_80 が付いており、300 px の JPEG です。元のサイズを表示するには、この接尾辞を削除してください。
• 人気の出品商品は、販売者が多いため、価格が 1 時間に何度も変わります。購入直前に再確認してください。
• 回答は 2 分間キャッシュされます。エージェントが同じ呼び出しを繰り返しても、再度 Digikala にアクセスしません。その分、価格がサイトより遅れることがあります。タイムアウト、5xx、429 が発生した場合は、バックオフを行い最大 2 回再試行します。
• 食料品はスーパーマーケットストアから取得されます。dk_product に表示される価格は、検索結果のメインストア価格と異なる場合があります。
• 送料はチェックアウト時（ログイン後）にのみ計算されます。dk_product では各オファーの配送方法を確認でき、dk_plus_plans では送料無料プランを確認できます。

FAQ

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 の米国ランナーからは、実行のたびに Digikala へのいくつかの呼び出しがタイムアウトしますが、同じテストはイランの接続環境では成功します。

ツールは src/digikala_mcp/catalog.py、product.py、services.py にあります。それぞれ、エージェントがいつ使用するべきかを説明する docstring を備えた、型付きの非同期関数です。Issue や PR は歓迎します。特に、新しいツールや API の変更への修正をお待ちしています。

リリース：pyproject.toml と server.json のバージョンを更新し、v* タグを push します。GitHub Actions がテストを実行し、PyPI と MCP Registry に公開して、GitHub Release を作成します。

関連サーバー

• 分割払い価格を含む家電価格を調べる Technolife MCP サーバー
• ガジェットやスマートフォン用アクセサリーを扱う MasterKala MCP サーバー
• イランのショップ間で価格を比較する Torob MCP サーバー
• オンライン食料品ショッピング用の Okala MCP サーバー
• ファッションや衣料品を扱う Banimode MCP サーバー
• イランのサービス向け MCP サーバーをすべてまとめたカタログ iran-mcp

免責事項

非公式のものであり、Digikala との提携や、同社からの承認を受けたものではありません。digikala.com ウェブアプリの公開エンドポイントを使用しており、予告なく変更される場合があります。リクエスト頻度は適切に保ってください。

作者

Sepehr Radmard（سپهر رادمرد）が開発・保守しています。LinkedIn でつながるか、GitHub の @sepehr071 をフォローして、イランのウェブサイト向け MCP サーバーをご覧ください。すべて iran-mcp に掲載されています。時間の節約に役立ったら、リポジトリにスターを付けていただくと、ほかの人にも見つけてもらいやすくなります。

ライセンス

MIT

クリック数の削減に役立ったら、スターを付けていただくと、ほかの人にも見つけてもらいやすくなります。