MasterKala

masterkala-mcp：AI エージェント向け MasterKala MCP サーバー

AI エージェントに MasterKala（مسترکالا）でガジェットを探してもらいましょう。
イランのガジェット・モバイルアクセサリーショップであるMasterKala向けの、非公式の読み取り専用 MCP サーバーです。Claude、Cursor、Copilot から、イヤホン、充電器、
モバイルバッテリー、スマートウォッチを検索し、実際の価格や仕様を比較し、レビューを読んだり、在庫や配送日を確認したり、今日の割引情報を探したりできます。

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

AI エージェント向け

• 概要： MasterKala（masterkala.com、イラン）向けの非公式 MCP（モデルコンテキストプロトコル）サーバーです。自社在庫を販売するガジェット・モバイルアクセサリーショップです。ペルシャ語または英語で検索でき、価格はトマンで表示されます。
• インストール： uvx masterkala-mcp または claude mcp add masterkala -- uvx masterkala-mcp。トランスポート：stdio。uv（Python 3.10 以降）が必要です。
• 認証： 不要です。API キーもアカウントも必要ありません。オプションの MASTERKALA_MCP_PROXY（masterkala.com へのリクエストに使う HTTP プロキシ URL、またはカンマ区切りのリスト）を設定できます。システムのプロキシ設定は無視されます。
• アクセス： 読み取り専用です。ログイン、カートの使用、注文、レビューの投稿はできないため、ツールを呼び出す前の確認は不要です。
• ツール： 14 個あり、すべて mk_ で始まります。まずは mk_find_cheapest、mk_search、mk_deals、mk_browse をお試しください。 一般的な手順：mk_find_cheapest -> mk_product -> mk_shipping。
• 用途： 最安の注文可能な商品、仕様や価格の比較、レビュー、在庫、配送予定、現在の割引情報、または MasterKala の購入ガイドをユーザーが求めている場合に使用します。
• 使用しない場合： ユーザーが購入を希望している場合（エージェントが商品を見つけた後、ユーザーが masterkala.com で注文します）、別のショップを必要としている場合、または特定の住所への配送を必要としている場合。配送情報はテヘラン向け、および「郵便によるその他の都市向け」の見積もりで、デフォルトのテヘラン住所に基づいています。
• 出力： コンパクトな JSON です。価格はトマン（final_price が支払額）、評価は 1～5（null はレビューなし）です。数値の商品 ID はツール間で引き継がれます。
• 機械可読データ： server.json と iran-mcp カタログ（TOOLS.md、servers.json、llms.txt）。

理由

MasterKala には何千ものアクセサリーが掲載されており、「モバイルバッテリー」で検索すると、本物のモバイルバッテリーにシリコンカバー、在庫切れの商品、店舗でしか販売されていない商品が混在します。実際に注文できる最安の商品と、配送料込みの価格を調べるには、検索結果を何ページもたどって商品ページを開く必要があります。masterkala-mcp を使うエージェントなら、数秒で調べられます。

あなた： 今注文できる、テヘランまで配送可能な最安のXiaomiのモバイルバッテリーは？

エージェント： 呼び出し mk_find_cheapest(query="پاوربانک شیائومی") → mk_shipping(product_id=26935)

合計	商品	価格	配送料
4,338,000	پاوربانک 10000 شیائومی گلوریمی Glorimi LightCore 22.5W	4,188,000（5%オフ）	150,000、土曜日15:00～18:00
5,291,000	پاوربانک فوق نازک مگنتی 5000 Glorimi FitCore Mag 20W	5,291,000（4%オフ）	無料（5M以上）
5,401,000	پاوربانک 20000 شیائومی گلوریمی Glorimi LightCore 22.5W	5,401,000（6%オフ）	無料（5M以上）

10,000 mAhのLightCoreは、150,000の配送料を含めても最安です。20,000 mAhのLightCoreは送料無料で、容量が2倍になる分、価格は1,063,000高くなります。mk_specs で仕様を比較しますか？

_{2026-10-03の実際のツール出力です。価格は常に変動します。価格の単位はトマンです。}

できること

• ペルシャ語または英語の商品名で検索し、価格、割引、在庫を確認
• ケースやカバーを除外して、在庫のある商品の中から最安商品を検索
• 価格、在庫、日付順に、価格帯やブランド・色のフィルターを使って、任意のカテゴリ、ブランド、タグを閲覧
• 色、在庫数、仕様、並べての比較、レビューなど、商品情報を確認
• 配送を確認：テヘランへの次回の宅配便の時間帯、他都市への郵送、配送料、当日配送の締め切り
• 割引ページのお買い得情報に加え、MasterKalaブログの購入ガイドや読者からの質問を確認
• 店舗を検索：テヘランにあるMasterKalaの実店舗の住所、電話番号、地図上の場所
• 設計上、読み取り専用：ログイン、カート、注文、レビュー投稿はできません

プロンプトの例：

• 「300万～500万トマンのBluetoothイヤホンで最安のものと、レビュー評価が最も高いものは？」
• 「Green Lion OceanとAwei T66の仕様を比較して。」
• 「青色のCMF Buds Pro 2は在庫がありますか？テヘランにはいつ届きますか？」
• 「今日のスマートウォッチの最大割引は？」
• 「テヘランにあるMasterKalaの実店舗はどこですか？」
• بهترین تخفیف‌های امروز مسترکالا روی پاوربانک چیه؟
• ارزان‌ترین هندزفری بلوتوث موجود را پیدا کن و بگو کی به تهران می‌رسد.
• مشخصات دو ساعت هوشمند را کنار هم مقایسه کن و نظر خریداران را بگو.

クイックスタート

uv が必要です。APIキーやアカウントは不要です。

claude mcp add masterkala -- uvx masterkala-mcp

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

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

codex mcp add masterkala -- uvx masterkala-mcp

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

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

すべてのツールには mk_ という接頭辞が付きます。製品 ID は 24855 のような数字で、カテゴリ ID は mk_categories から取得し、ブランドのスラッグは mk_brands から取得します。

14 個すべてのツールには readOnlyHint: true のアノテーションが付いており、エージェントのコンテキストを圧迫しないよう、コンパクトな JSON を返します。

動作の仕組み

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  masterkala-mcp  (runs on your machine)
      │
      │  HTTPS
      └──────▶  masterkala.com   JSON API, listing fragments, product pages

masterkala-mcp はローカルで動作し、masterkala.com のウェブサイトが使用するものと同じ公開エンドポイントを呼び出します。 ホストされたサーバーを経由せず、API キーも不要で、あなたに関する情報がほかの場所に送信されることもありません。 リクエストは Chrome を装う HTTP クライアント経由で送信され、一度に最大 2 件、短いランダムな遅延を挟んで処理されます。接続が切れた場合は最大 2 回まで再試行します。カテゴリとブランドの一覧は 1 時間キャッシュされます。レビュー、コメント、説明のテキストは信頼できないサイトコンテンツとして扱い、短い長さに切り詰めます。

知っておくと便利な情報

• 価格の単位はトマンです。 final_price は支払う金額、price は割引前の価格、discount_pct は整数の割引率です。サイトの構造化データはリアル単位ですが、サーバーが変換します。
• ほとんどの商品は、注文ごとに5,000,000トマン以上で送料無料です（大型スピーカーなどの大型商品は送料無料になりません。これらの商品では mk_shipping の free_shipping_from: null が返されます）。それ未満の場合、2026-10-03時点でテヘラン市内の宅配便と郵便の料金は、それぞれ150,000トマン／155,000トマンでした。住所 API はないため、mk_shipping はテヘラン市内と「郵便によるその他の都市」について料金を推定します。
• 在庫状況：in_stock は現在オンラインで注文可能であることを意味します。その他のステータスは、ناموجود（売り切れ）、به زودی（近日発売）、موجود در شعب حضوری（実店舗のみで販売）です。
• 画像：すべての商品に image があり、絶対 https URL です（mk_search、mk_find_cheapest、mk_browse では328 pxのWebP、mk_deals では240 px、mk_specs では元のJPG）。mk_product は600 pxの image と images リスト（最大4枚）を返します。null／空のフィールドは結果から省略され、stock_status は「موجود」（在庫あり）でない場合にのみ表示されます。また、レビュー／コメントのテキストは400文字で切り詰められます（ブログのスレッドには返信が3件含まれ、残りの件数は more_replies に表示されます）。
• 評価は1～5です。商品にまだレビューがない場合は null です。
• ペルシャ語のクエリが最もよく一致します（هندزفری、پاوربانک）。英語のブランド名やモデル名も使用できます（xiaomi、Buds Pro）。
• キーワード検索の一覧では並べ替えは適用されません。 キーワードで検索する場合は mk_search または mk_find_cheapest を使用してください。並べ替え、価格帯、フィルターが必要な場合は、カテゴリ ID、ブランドスラッグ、またはタグ ID を指定して mk_browse を使用してください。
• レート制限：サイトの robots.txt ではクローラーによる API パスへのアクセスが禁止されているため、リクエスト頻度を低く保ってください（1秒に約1回）。サーバー側でも同時実行数を制限し、短い遅延を加えています。
• このツールではできないこと：ログイン、カート、注文、決済、ウィッシュリスト、レビューの投稿、他店舗の商品検索、特定住所への配送には対応していません。
• プロキシ：必要な場合は MASTERKALA_MCP_PROXY を設定してください（設定を参照）。

FAQ

npx @modelcontextprotocol/inspector uvx masterkala-mcp

設定

ペルシア語：MasterKala MCP サーバー

claude mcp add masterkala -- uvx masterkala-mcp

開発

git clone https://github.com/sepehr071/masterkala-mcp && cd masterkala-mcp
uv sync
uv run python -m pytest          # offline, against recorded responses
uv run python -m pytest -m live  # real masterkala.com
uv run ruff check .

ツールは src/masterkala_mcp/catalog.py、product.py、blog.py にあります。それぞれ、エージェントがいつ使用するかを説明する docstring を備えた、型付きの非同期関数です。特に、新しいツールやサイトの変更への対応に関する Issue や PR を歓迎します。

リリースするには、pyproject.toml と server.json のバージョンを更新し、v* タグをプッシュしてください。GitHub Actions がテストを実行し、PyPI と MCP Registry に公開して、GitHub Release を作成します。

関連サーバー

• iran-mcp：イランのサービス向け MCP サーバーの一覧
• イラン最大のオンラインストア向け Digikala MCP サーバー
• 分割払い価格も扱う、電子機器の価格情報向け Technolife MCP サーバー
• イランのショップ間で価格を比較する Torob MCP サーバー
• オンライン食料品の買い物向け Okala MCP サーバー
• ファッション向け Banimode MCP サーバー

免責事項

非公式であり、MasterKala との提携や、同社による推奨を受けたものではありません。読み取り専用で、masterkala.com の公開エンドポイントを使用しています。これらは予告なく変更される場合があります。リクエスト頻度は適切に抑えてください。

作者

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

ライセンス

MIT

クリックの手間を省けたら、スターを付けていただくと、ほかの人にも見つけてもらいやすくなります。