Asal Banoo

asalbanoo-mcp：AI エージェント向け Asal Banoo MCP サーバー 🧴

イランのオンラインショップ Asal Banoo（عسل بانو）で、AI エージェントが化粧品やスキンケア用品を探せる、非公式の読み取り専用 MCP サーバーです。
シャンプー、日焼け止め、美容液、メイクアップ用品を検索し、実際の価格やサイズを比較できます。
Claude、Cursor、Copilot から、レビューやショップのスキンケアに関するアドバイスを読んだり、在庫を確認したり、今日の割引を見つけたりできます。

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

AI エージェント向け

• 概要： イランのスキンケア、ヘアケア、メイクアップ、香水のショップ Asal Banoo（asalbanooshop.com、عسل بانو）向けの非公式 MCP サーバーです。ペルシャ語と英語で検索でき、価格はトマン表記です。
• インストール： claude mcp add asalbanoo -- uvx asalbanoo-mcp（stdio トランスポート。uv と Python 3.10 以降が必要です）。
• 認証： 不要です。オプションの ASALBANOO_MCP_PROXY を設定すると、asalbanooshop.com へのリクエストに HTTP プロキシを使用できます。
• アクセス： 読み取り専用です。ログイン、カート、注文、レビュー投稿には対応していないため、書き込みツールはありません。
• ツール： 12 個あり、すべて ab_ で始まります。まずは ab_find_cheapest、ab_search、ab_product、または ab_deals をお試しください。一般的な手順：ab_find_cheapest → ab_product → ab_reviews。
• 利用する場面： Asal Banoo の化粧品やスキンケア用品の価格、サイズ、在庫、レビュー、現在の割引を比較する場合に利用します。
• 利用しない場面： ユーザーが商品の購入を希望している場合（カートやチェックアウトには対応していません）、または送料が必要な場合（ショップではチェックアウト時にのみ表示されます）。
• 出力： コンパクトな JSON です。final_price は購入者が支払う価格、price は割引前価格、discount_pct は整数のパーセンテージ、評価は 1～5 または null です。商品一覧では null フィールドは省略されます。price がない場合は final_price と同額、discount_pct がない場合は 0、rating がない場合はレビューなしを意味します。レビュー本文は 400 文字で切り詰められます（ab_reviews で full_text=true を指定すると全文が返されます）。ab_search または ab_browse の商品の id を product_id として ab_product や ab_reviews に渡してください。
• 機械可読データ： server.json、および awesome-iran-mcp に掲載されたイランの MCP サーバー一覧（TOOLS.md、servers.json、llms.txt）。

理由

Asal Banoo（عسل بانو）には、スキンケア、ヘアケア、メイクアップ、香水の商品が約3,500点掲載されています。「日焼け止め」で検索すると、アイクリームや売り切れの商品、説明文に日焼け止めという言葉があるだけの商品も混ざってしまいます。実際に注文できて、希望のサイズを選べる最安の商品を見つけるには、一覧を何ページもめくり、商品ページを開かなければなりません。asalbanoo-mcp を使うエージェントなら、数秒で調べられます。

あなた： 今注文できる日焼け止めで最安のものは？

エージェント： 呼び出し ab_find_cheapest(query="ضد آفتاب") → ab_product(product_id=28470)

価格	商品	備考
427,300	ضد آفتاب دور چشم آیسول	目元用、色なし。色付きタイプ（432,200）は売り切れです
499,800	ضدآفتاب دور چشم فتوتیپیک SPF30 درماتیپیک	目元用、評価1.5
599,800	ضد آفتاب پوست خشک درماتیپیک Hydra	顔用、乾燥肌向け。5色あり、最大899,800

最安の2点は目元用です。顔用では、Dermatypique Hydraが599,800トマンから掲載されていますが、在庫があるのはライトベージュのみで、価格は899,800です。ab_reviews でレビューを確認しましょうか？

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

できること

• 🔎 ペルシャ語または英語の商品名で検索し、価格、割引、在庫、評価を確認
• 💸 タイトルに検索語が実際に含まれる在庫あり商品のうち、最安の商品を検索
• 🗂️ 価格、日付、人気度、評価順で、カテゴリやブランドを閲覧。価格帯、容量、髪質・肌質で絞り込み
• 📋 商品詳細を確認：サイズ・色ごとの価格と在庫、主要情報（容量、肌質、原産地）、ショップからの返信を含むレビュー
• ⚡ お買い得品をチェック：現在割引中の商品を割引率の高い順に表示
• 📚 ショップのケアガイドや比較記事に加え、配送、返品、ウォレットの規則からアドバイスを取得
• 🔒 読み取り専用の設計：ログイン、カート、注文、レビュー投稿は行いません

クイックスタート

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

claude mcp add asalbanoo -- uvx asalbanoo-mcp

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

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

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

• 「100万〜200万トマンのフケ防止シャンプーで最安のものと、レビュー評価が最も高いものは？」
• 「Roverhair Detox シャンプーの1000 mlはいくらで、在庫はありますか？」
• 「脂性肌には Vichy Mineral 89 と Clinique Moisture Surge のどちらがいいですか？」
• تخفیف‌های امروز عسل بانو روی ضد آفتاب چیه؟

仕組み

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  asalbanoo-mcp  (runs on your machine)
      │
      │  HTTPS
      └──────▶  asalbanooshop.com   listing pages, quick-view fragments, WordPress REST

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

ツール

全12個のツールには readOnlyHint: true が注釈として付与されており、コンテキストを圧迫しない簡潔な構造化JSONを返します。

知っておくと便利な情報

• 価格はトマン表記です。 final_price は支払う金額、price は割引前の価格、discount_pct は整数の割引率です。サイトの構造化データはリアル表記ですが、サーバーは価格の取得に使用しません。
• 画像：すべての商品に image（絶対URL、パーセントエンコードされたhttps URL）があります。ab_product には images（ギャラリー）もあります。画像を自分でダウンロードするには、ブラウザーの User-Agent を送信してください。通常のpython/httpxでは、サイトのWAFからHTTP 403が返されます。
• サイズとカラー：バリエーションがある商品は、最安のバリエーションの価格（final_price）から max_price までの範囲で表示され、discount_pct にはバリエーションのうち最大の割引率が設定されます。ab_product では、各バリエーションの価格、在庫、max_qty を確認できます。
• 配送：バンダレ・アッバース市外への配送はPost Pishtazのみで、7～10営業日かかります。バンダレ・アッバース市内は宅配で、13:00までに注文すると翌日配達されます。または2つの支店で受け取れます。送料はチェックアウト時にのみ表示され、公開されていません。
• 在庫：in_stock はオンラインで今すぐ注文できることを示します。stock_status は残りわずかな場合に正確な数量を表示します（「فقط 2 عدد در انبار موجود است」）。一致する在庫あり商品がない場合、ab_search は out_of_stock_matches を追加するため、売り切れのブランドをショップで取り扱ったことがないブランドと誤認しません。
• 評価は1～5です。 商品にまだレビューがない場合は null です。
• ペルシャ語のクエリが最もよく一致します（شامپو、ضد آفتاب）。英語のブランド名（vichy、la roche）も使用できます。オートコンプリート専用のツールはありません。ab_search がサイトのヘッダーにあるライブ検索に対応しています。

よくある質問

npx @modelcontextprotocol/inspector uvx asalbanoo-mcp

設定

ペルシア語：عسل بانو MCP サーバー

claude mcp add asalbanoo -- uvx asalbanoo-mcp

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

ツールは src/asalbanoo_mcp/catalog.py、product.py、content.py にあります。各ツールは型指定された非同期関数で、エージェントがいつ使用すべきかを説明する docstring が付いています。Issue や PR は歓迎します。特に、新しいツールやサイトの変更に対応する修正を歓迎します。

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

関連サーバー

• 化粧品やスキンケア用品の価格と色展開については、Khanoumi MCP サーバー
• イランの数千のショップのファッション商品については、Shopino MCP サーバー
• イランの MCP サーバー一覧：awesome-iran-mcp

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

免責事項

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

ライセンス

MIT