Shopino

shopino-mcp：AI エージェント向け Shopino MCP サーバー

AI エージェントに Shopino（شاپینو）で服、バッグ、靴を買ってもらいましょう。
約11,000のオンラインショップやInstagramショップの商品を集めたイランのファッションマーケットプレイス、Shopino向けの非公式な読み取り専用 MCP サーバーです。
Claude、Cursor、Copilotから、ひとつのカタログを検索し、実際の価格を比較し、どのサイズや色が在庫にあるかを確認し、ショップを評価して、今日のフラッシュセールを見つけられます。

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

AI エージェント向け

• 概要： Shopino（shopino.app、شاپینو）向けの非公式 MCP サーバー（Model Context Protocol）です。Shopino は、数千ものオンラインショップや Instagram ショップの商品を集めたイランのファッションマーケットプレイスです。検索はペルシャ語が最適で、価格はトマンです。
• インストール： uvx shopino-mcp または claude mcp add shopino -- uvx shopino-mcp。トランスポート：stdio。uv（Python 3.10 以降）が必要です。
• 認証： 不要です。API キーもアカウントも必要ありません。オプションの SHOPINO_MCP_PROXY で、shopino.app へのリクエストに使用する HTTP プロキシ（またはカンマ区切りのリスト）を設定できます。システムのプロキシ設定は無視されます。
• アクセス： 読み取り専用です。ログイン、カート、注文、いいね機能はないため、書き込みツールは存在せず、ツールを呼び出す前の確認も必要ありません。
• ツール： すべて sh_ で始まる14個のツールがあります。まずは sh_find_cheapest、sh_search、sh_product、sh_shop、sh_deals をお試しください。 一般的な手順：sh_find_cheapest -> sh_product -> sh_shop、続いて sh_similar を使い、同じ商品をほかのショップと比較します。
• 使用する場面： 衣類、バッグ、靴の価格、サイズ、在庫を比較するとき、評価や購入者アンケートを基にショップを判断するとき、フラッシュセールや割引コードを確認するときに使用します。
• 使用しない場面： ユーザーが商品の購入を希望する場合（カートやチェックアウト機能はありません）、または送料が必要な場合（送料はチェックアウト時にショップと住所ごとに提示され、ログインが必要です）。
• 出力： コンパクトな JSON です。価格は トマン 表記です。final_price は購入者が支払う金額、price は割引前の金額、discount_pct は整数のパーセントです。価格が null の場合、価格が表示されていません（通常は在庫切れです）。sh_search または sh_browse で取得した商品の id を product_id として sh_product および sh_similar に渡し、shop_id を sh_shop に渡してください。返された next_cursor を使ってページを移動します。
• ネットワーク： お使いのマシンから api-go.shopino.app および api.shopino.app に直接アクセスします。Shopino がボット確認ページを返す場合は、FAQ をご覧ください。
• 機械可読データ： server.json、および iran-mcp にあるイランの MCP サーバー全カタログ（TOOLS.md、servers.json、llms.txt）。

その理由

Shopino は、約11,000のイランのオンラインショップや Instagram ショップの商品を1か所に集めています。 「リネンのマントー」を検索すると、在庫切れの商品や、それぞれ独自の在庫を持つ色・サイズ、聞いたことのないショップ、目立たないラベルに隠れた割引コードが混在します。信頼できるショップから、自分のサイズの最安商品を見つけるには、何度もクリックする必要があります。shopino-mcp を使えば、エージェントが数秒で見つけます。

あなた： 今すぐ在庫がある、評価の高いショップのリネンのマントーで最安のものは？

エージェント： 呼び出し sh_find_cheapest(query="مانتو کتان") → sh_shop(shop="489")

価格	商品	ショップ
999,000（56%オフ）	مانتو کتان ازالیا (1123)	وایت گالری پلاس（評価はまだありません）
999,000（47%オフ）	مانتو کتان زنانه 442170	صنم گالری、4.6、テヘラン市内で当日配達
1,100,000（21%オフ）	6556-مانتو کتان قلبی	پاپیون لیدی、購入者アンケート3,507件で4.9、満足度92%

最安の2商品は同じ価格です。Sanam Gallery は評価があり、テヘラン市内で当日配達します。Papion Lady は101,000高くなりますが、購入者の実績は最も優れています。sh_product で残っているサイズを確認しましょうか？

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

できること

• 検索：ペルシャ語または英語で、すべてのショップを一度に検索できます。価格、割引、在庫状況、販売ショップも確認できます
• 最安値を検索：キーワードに一致する在庫ありの商品から最安値を見つけられます。カテゴリを指定したり、お住まいの都市への宅配便配送で絞り込んだりすることもできます
• 閲覧：カテゴリ、ショップ、タグ、厳選リストを、価格、日付、割引率の大きい順に並べ替えて閲覧できます。価格帯やサイズで絞り込むこともできます
• サイズを確認：商品の各色・各サイズの価格と残りの数量、ショップのサイズガイドを確認できます
• ショップを評価：評価、購入者アンケート（満足度、品質、価格、定時配送率）、フォロワー数、連絡先、ウェブサイトを確認できます
• 他のショップで同じ商品を検索：写真の類似度をもとに、最安値から表示できます
• お得な情報をチェック：終了時刻付きのフラッシュセール、売れ筋商品、キャンペーン、ショップの割引コードを確認できます
• スタイルガイドを読む：Shopino ブログのスタイルガイドを読めます
• 読み取り専用として設計：ログイン、カート、注文、いいねは利用できません

クイックスタート

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

claude mcp add shopino -- uvx shopino-mcp

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

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

codex mcp add shopino -- uvx shopino-mcp

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

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

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

• 「レビュー評価の高いショップで、サイズ L、2,000,000 トマン未満の最安値の女性用マントーはありますか？」
• 「この商品（2578018）は、他のショップのほうが安いですか？」
• 「今日のフラッシュセールには何がありますか？割引コードもありますか？」
• 「時計を扱うショップと販売ブランドを表示してから、在庫のある最安値の時計を一覧表示してください。」
• 「テヘランまで宅配便で配送してくれる、評価の高い金のアクセサリーショップを探してください。」
• テヘランで宅配便配送が可能な、サイズ 40 の最安値のスポーツシューズはいくらですか？
• 評判の良いショップから、100 万トマン未満の女性用コットンマントーを探してください。
• 今日の Shopino のフラッシュセールは何ですか？

ツール

各リストは、コンパクトな商品カード（id、タイトル、価格、割引、在庫、ショップ、image 内の商品写真 URL、商品 url）を返します。

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

仕組み

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  shopino-mcp  (runs on your machine)
      │
      │  HTTPS
      ├──────▶  api-go.shopino.app   search, products, shops, deals
      └──────▶  api.shopino.app      curated listings, similar shops, blog

shopino-mcp はローカルで実行され、shopino.app ウェブサイトが使用するものと同じ公開エンドポイントを呼び出します。 その間にホストされたサーバーはなく、API キーも不要で、あなたに関する情報がほかの場所に送信されることもありません。 リクエストはブラウザーに似た TLS フィンガープリントで送信され、同時に最大 2 件まで、短いランダムな間隔を空けて実行されます。また、サーバーはタイムアウト、429、または 5xx の応答があった場合、バックオフを行って 2 回再試行します。

知っておくと便利なこと

• 価格はトマン表記です。 final_price は支払う金額、price は割引前の価格、discount_pct は整数の割引率です。null はショップに価格が表示されていないことを意味します（通常は在庫切れです）。ショップの評価は0〜5で、未評価の場合は null です。
• すべての商品に image があります（1枚目の写真の絶対 https URL）。sh_product には最大4枚の images も含まれます。
• サイズや色によって価格や在庫が異なる場合があります。 商品の final_price は最も安いバリエーションの価格です。sh_product には各色・サイズごとの価格と stock（残りの数量）が表示されます。
• 商品はそれぞれ1つのショップで販売されています。 多くの商品はShopinoのカートで購入できます。shop_site_only / shopino_cart: false は、ショップ独自のサイト（original_url）でのみ購入できることを意味します。
• 送料は公開されていません。 ログインが必要なため、送料は購入手続き時にショップと住所ごとに提示されます。注文合計は商品の合計＋ショップの送料−割引コード1つです。courier_city は、その都市で当日配達の宅配便を利用できることを意味します。
• 割引コードはショップのプロモーションラベル（promo。例：「1 میلیون تخفیف با کد: hana70」）に記載されています。1回の注文で使えるコードは1つで、購入手続き時に入力します。
• 割引前の価格が水増しされている場合があります。 90％の割引が実際のものか、作られた定価に基づくものかは、sh_similar と比較してください。
• フラッシュセール商品は、セール前の価格で並べ替えや絞り込みが行われます。 Shopinoは flash_sale 商品を通常価格で順位付けするため、「最安値」リストや価格帯で、範囲外に表示されたり順序が前後したりする場合があります（サイトでも同じように表示されます）。
• ショップの評価は2種類あります。 rating / surveys はShopinoの購入者アンケートによるものです。サイトでショップの横に表示される星評価は、sh_product / sh_shop の customer_rating（customer_rating_count）です。
• Shopinoには機能する色フィルターがありません（サイトの色フィルターでは何も返されません）。検索語に色を含めてください。
• ページ送りにはカーソルを使います。 sh_search と sh_browse は next_cursor を返します。Shopino独自の page 番号では並べ替え順が維持されないため、このサーバーはページ番号を送りません。
• ペルシャ語の検索語が最もよく一致します（مانتو کتان、کفش ورزشی مردانه）。
• ブランドは時計を扱うショップにのみあります。ショップを指定せずに sh_brands を使うと、注目の公式ブランドショップが一覧表示されます。
• 商品ごとにカードは1枚です。 一部のショップでは同じIDで色ごとにカードを掲載していますが、サーバーが統合します。
• 対応していないこと： ログイン、カート、購入手続き、割引コードの入力、ギフトカード、いいね、再入荷通知、保存済みショップ、返品、問い合わせチケット、画像アップロードによる検索には対応していません。送料と注文合計は取得できません。
• 負荷をかけすぎないでください。 Shopinoの robots.txt では、クローラーが検索ページに過剰なリクエストを送らないよう求めています。サーバーはジッターを加えつつ、同時リクエストを2件に抑えています。エージェントのループは控えめにしてください。

よくある質問

npx @modelcontextprotocol/inspector uvx shopino-mcp

設定

ペルシア語

claude mcp add shopino -- uvx shopino-mcp

開発

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

ツールは src/shopino_mcp/catalog.py、product.py、shop.py、info.py にあります。それぞれ、エージェントがいつ使用すべきかを説明する docstring を備えた、型付きの非同期関数です。問題の報告やプルリクエストを歓迎します。特に、新しいツールやサイトの変更への対応を歓迎します。

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

関連サーバー

• ファッションや衣料品向けの Banimode MCP server
• 化粧品やスキンケア商品の価格向けの Khanoumi MCP server
• スキンケア、ヘアケア、メイクアップ向けの Asal Banoo MCP server
• イランのショップ間で価格を比較する Torob MCP server
• イラン最大のオンラインストア向けの Digikala MCP server
• イランのサービス向け MCP サーバーをすべて収録したカタログ、iran-mcp

免責事項

これは非公式のプロジェクトであり、Shopino とは提携関係になく、Shopino の承認も受けていません。読み取り専用であり、予告なく変更される可能性のある shopino.app ウェブサイトの公開エンドポイントを使用します。リクエスト頻度は適切に保ってください。

作者

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

ライセンス

MIT

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