Khanoumi

khanoumi-mcp：AI エージェント向け Khanoumi MCP サーバー 💄

イランのビューティーショップ Khanoumi（خانومی）で、AI エージェントが化粧品やスキンケア商品を探せる、非公式の読み取り専用 MCP サーバーです。
Claude、Cursor、Copilot から、メイクアップ、スキンケア、ヘアケア、香水を検索し、実際の価格や色味を比較したり、肌タイプで絞り込んだり、
レビューを読んだり、今日のピンクボックスセールをチェックしたりできます。

クイックスタート · AI エージェント向け · できること · ツール · FAQ · فارسی

AI エージェント向け

• 概要： イランの化粧品・スキンケアショップ Khanoumi（khanoumi.com、خانومی）向けの非公式 MCP サーバーです。ペルシャ語と英語で検索でき、価格はトマン表示です。
• インストール： claude mcp add khanoumi -- uvx khanoumi-mcp（stdio トランスポート。 uv と Python 3.10 以降が必要です）。
• 認証： 不要です。任意の KHANOUMI_MCP_PROXY で、khanoumi.com へのリクエストに使用する HTTP プロキシを設定できます。
• アクセス： 読み取り専用です。ログイン、カート、注文、レビュー投稿には対応していないため、書き込みツールはありません。
• ツール： 12 個あり、すべて kh_ で始まります。まずは kh_find_cheapest、kh_search、kh_product、kh_browse、kh_store_info をお試しください。一般的な手順は kh_find_cheapest → kh_product → kh_reviews です。
• 用途： Khanoumi の化粧品、スキンケア、ヘアケア商品の価格、色味、成分、レビュー、今日のセールを比較するときに使用します。
• 使用しない場面： ユーザーが商品の購入を希望している場合（カートや決済には対応していません）、または住所を指定した正確な送料見積もりが必要な場合（サイトへのログインが必要です）。
• 出力： コンパクトな JSON です。final_price は購入者が支払う金額、price は割引前の価格、discount_pct は整数の割引率、評価は 0～5 または null です。検索結果の製品 ID またはスラッグを kh_product、kh_reviews、kh_similar に渡してください。kh_browse には kh_categories または kh_filters から取得した category_id を渡してください。
• 機械可読データ： server.json と、イランのすべての MCP サーバーのカタログ awesome-iran-mcp（TOOLS.md、servers.json、llms.txt）。

理由

Khanoumi では、3,200 ブランドの美容製品を約 67,000 点掲載しています。「日焼け止め」を検索すると、スポンサー商品、在庫切れの商品、価格の異なる色展開の商品が混在し、送料はチェックアウト時まで表示されません。実際に注文できる最安の商品と、配送料込みの価格を調べるには、何度もクリックする必要があります。khanoumi-mcp を使うエージェントなら、数秒で調べられます。

あなた： 今すぐ注文できるシネレの日焼け止めで、テヘランへの配送込みで最安なのは？

エージェント： 呼び出し kh_find_cheapest(query="ضد آفتاب سینره") → kh_store_info(topic="delivery")

合計	商品	価格
924,000	کرم ضد آفتاب بی رنگ با SPF45 مناسب آقایان	785,000（25% オフ）
926,500	کرم ضد آفتاب بی رنگ Oil Free SPF50 مناسب پوست چرب	787,500（25% オフ）
964,000	ضد آفتاب رنگی +SPF60 مات کننده پوست چرب (2 shades)	825,000（25% オフ）

合計には、梱包料 20,000 とテヘランへの宅配料金 119,000 が含まれます。男性向け SPF45 が最安です。脂性肌なら、オイルフリー SPF50 はわずか 2,500 の追加で購入できます。kh_product で、どの色付きタイプが在庫ありか確認しましょうか？

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

できること

• 🔎 商品を検索：ペルシャ語または英語の商品名で検索できます。価格、割引、在庫、商品画像の URL（image。kh_product では images ギャラリーも追加）が表示され、スポンサー商品は除外されます
• 💸 最安商品を検索：キーワードに一致する在庫あり商品の中から、任意でカテゴリーを指定して最安商品を検索します
• 🗂️ 閲覧：カテゴリー、ブランド、キャンペーンを、価格、人気度、日付で並べ替えて閲覧できます。価格帯やフィルターも指定できます
• 🧴 絞り込み：肌質、髪質、フリー成分（パラベン、硫酸塩）、主な成分、色、ブランドで絞り込めます
• 💋 商品詳細を確認：各色やサイズの価格と在庫、販売者、金価格の内訳を含む、商品の詳細をすべて確認できます
• 💬 レビューを確認：類似商品や、ショップがその商品と組み合わせているルーティン商品も確認できます
• ⚡ お得情報をチェック：カウントダウン付きの毎日のピンクボックス、注目商品一覧、現在利用できる公開割引コードを確認できます
• 🚚 料金を確認：公式 FAQ に掲載されている梱包、配送、返品、支払いのルールに加えて、ブログの美容ガイドも確認できます
• 🔒 読み取り専用設計：ログイン、カート、注文、レビュー投稿はできません

クイックスタート

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

claude mcp add khanoumi -- uvx khanoumi-mcp

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

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

あとは、次のように尋ねるだけです。

• 「トマン 500,000 以下で脂性肌向けの最安の保湿剤は？購入者のレビューも教えて」
• 「ゴールデンローズのシアーブライトリップスティックは、どの色が在庫あり？価格は同じ？」
• 「今日のピンクボックスには何が入ってる？割引コードはある？」
• ارزان‌ترین شامپوی ضد ریزش سریتا با ارسال به تهران چند درمیاد؟

仕組み

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  khanoumi-mcp  (runs on your machine)
      │
      │  HTTPS
      └──────▶  www.khanoumi.com   JSON API, FAQ page, blog

khanoumi-mcp はローカルで動作し、khanoumi.com のウェブサイトが利用するものと同じ公開エンドポイントを呼び出します。 間にホスト型サーバーはなく、API キーも不要です。また、あなたに関する情報がほかの場所に送信されることもありません。

ツール

12個のツールすべてに readOnlyHint: true の注釈が付いており、コンパクトな構造化 JSON を返すため、エージェントのコンテキストを圧迫しません。

知っておくとよいこと

• 価格はトマンです。 final_price は支払価格、price は割引前の価格、discount_pct は整数の割引率です。
• 色によって価格が異なる場合があります。 商品の final_price は、色またはサイズの中で最も安い価格です。kh_product では、各バリエーションの価格、在庫（in_stock）、注文ごとの最大数量を確認できます。
• 注文費用：商品代金＋梱包費20,000＋送料（2026-10-06時点で、テヘラン／アルボルズへの宅配は119,000、その他の州への郵送は113,000。「ارسال رایگان」タグが付いた商品は送料無料で、商品の badges には FreeShipping と表示されます）。kh_store_info で現在の料金を確認できます。住所ごとの正確な見積もりにはログインが必要なため、ここでは確認できません。
• スポンサー商品は検索結果と商品一覧から除外されます。total は実際に一致した商品だけを数えます。ページは重複や抜けがないように続きます。サイト独自のページャーでは、広告がページに表示されるとこのように処理できません。
• 評価は0～5です。まだ商品を評価した人がいない場合は null になります。レビューのコメントには星評価がありません。
• ペルシャ語での検索が最適です（کرم آبرسان、رژ لب）。英語のブランド名も検索できます（cerave、golden rose）。

よくある質問

npx @modelcontextprotocol/inspector uvx khanoumi-mcp

設定

ペルシャ語：Khanoumi MCP サーバー

claude mcp add khanoumi -- uvx khanoumi-mcp

開発

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

ツールは src/khanoumi_mcp/catalog.py、product.py、info.py にあります。それぞれ型付きの非同期関数で、エージェントが使用するタイミングを説明する docstring が付いています。サイトの変更に対応する修正や新しいツールなど、Issue や PR を歓迎します。

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

関連サーバー

• 化粧品やスキンケアの価格を調べる Asal Banoo MCP server
• イラン各地の数千のショップのファッション商品を扱う Shopino MCP server
• イランの MCP サーバー一覧：awesome-iran-mcp

クリックの手間が省けたら、ほかの人が見つけやすくなるよう、スターを付けてください。

免責事項

非公式であり、Khanoumi との提携や同社による推奨はありません。予告なく変更される可能性がある、khanoumi.com ウェブサイトの公開エンドポイントを使用しています。リクエスト頻度は適切な範囲に抑えてください。

ライセンス

MIT