Snapp! Shop

snappshop-mcp：AI エージェント向け Snapp! Shop MCP サーバー

AI エージェントが Snapp! Shop（اسنپ‌شاپ）で買い物できるようにします。
イランの Snapp マーケットプレイスである Snapp! Shop 向けの、非公式な読み取り専用 MCP サーバーです。
Claude、Cursor、Copilot から、商品の検索、各販売者のトマン価格の比較、仕様による絞り込み、購入者レビューの閲覧、今日のフラッシュセールの確認ができます。

AI エージェント向け · 理由 · できること · クイックスタート · ツール · 仕組み · 知っておくとよいこと · FAQ · 設定 · ペルシア語 · 開発

AI エージェント向け

• 概要： Snapp! Shop（snappshop.ir）向けの非公式 MCP サーバー（Model Context Protocol）です。イランの多数のショップや薬局が集まるマーケットプレイスで、家電、携帯電話、健康・美容、家庭用品、ファッションを扱っています。ペルシャ語でのクエリが最も適しています。価格の単位はトマンです。
• インストール： uvx snappshop-mcp または claude mcp add snappshop -- uvx snappshop-mcp を実行します。トランスポートは stdio です。uv が必要です（Python 3.10 以降）。
• 認証： 不要です。API キーやアカウントは必要ありません（サイトがすべての訪問者に提供するゲストセッションを使用します）。Snapp! Shop はイランの IP アドレスからのアクセスのみ受け付けます。VPN を使わずにイランから実行するか、イランを経由する HTTP プロキシを SNAPPSHOP_MCP_PROXY に設定してください。システムのプロキシ設定は無視されます。
• アクセス： 読み取り専用です。ログイン、買い物かご、注文、支払いには対応していないため、ツールの呼び出し前に確認は必要ありません。13 個すべてのツールに readOnlyHint: true が設定されています。
• ツール： 13 個：ss_search、ss_suggest、ss_filters、ss_categories、ss_category、ss_brand、ss_product、ss_compare、ss_reviews、ss_similar、ss_seller、ss_promotions、ss_collection。 一般的な手順：ss_search -> ss_product（販売者すべてを最安値順に表示） -> ss_reviews。商品を探す場合：ss_categories -> ss_filters -> ss_category。
• ID： product_id（数字）は ss_product と ss_compare に指定します。id（6 文字）は ss_reviews と ss_similar に指定します。seller_id は ss_seller に、collection_id は ss_collection に指定します。
• 単位： サイトに表示される、テヘランへの配送価格です。単位は トマン です。
• 使用する場面： イランで販売されている商品の価格、販売者、仕様、レビューの比較や、フラッシュセールの確認に適しています。
• 使用しない場面： ユーザーが注文や支払いを希望する場合、またはイラン国外にいてイランの IP アドレスやプロキシを利用できない場合（サイトは HTTP 403 を返します）。
• 出力： コンパクトな JSON です。null および空のフィールドは省略されます（rating がない場合は未評価です）。リストは 1 ページあたり 12 件で、サイトのリスト上限は 10,000 件です。レビュー投稿者の名前は省略されます。
• 機械可読データ： server.json と、サーバーが掲載された後の iran-mcp カタログ。

概要

Snapp! Shop では、同じ商品を複数の販売者がそれぞれ異なる価格、保証、配送条件で販売しています。最良のオファーを見つけるには、商品ページを一つずつ開く必要があります。snappshop-mcp を使うエージェントなら、すべてを数秒で確認できます。

あなた： Snapp! Shop で Samsung Galaxy A07（64 GB）を最安値で販売しているのはどこですか？保証内容も教えてください。

エージェント： 呼び出し ss_search(query="Galaxy A07 64") → ss_product(product="25751584")

価格（トマン）	販売者	色	保証
44,600,000	دیجی لند سانا	سبز	گارانتی ۱۸ ماهه شرکتی
44,770,000	سام پلاس	بنفش	گارانتی ۱۸ ماهه هماهنگ (داریا همراه)
45,500,000	ویراوین	سبز	گارانتی ۱۸ ماهه شرکتی

販売者は合計 12 件、370 件の評価に基づく評価は 4.3 です。ss_reviews でレビューを確認しますか？

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

できること

• 商品を検索：商品名で検索し、価格帯、ブランド、仕様、色、在庫、割引、迅速配送の条件で絞り込めます
• 販売者を比較：商品のすべての販売オファーを、価格、割引、在庫、保証、配送方法、販売者評価とともに確認できます
• 商品を比較：価格、評価、異なる仕様のみを並べて比較できます
• 閲覧：カテゴリー階層、ブランドページ、販売者ページを閲覧できます。ss_filters でリストに実際に適用できるフィルターを確認できます
• レビューを読む：評価点、長所、短所を確認し、類似商品を見つけられます
• お得な商品を見つける：終了時刻付きのフラッシュセール、キャンペーンページ、プロモーション対象の全商品を確認できます
• 設計上、読み取り専用です：ログイン、カート、注文、支払いはありません

プロンプトの例：

• 「在庫があり、ストレージが 256 GB で黒色の、最も安い Samsung のスマートフォン。」
• 「Xiaomi Poco X7 Pro と Galaxy A56 を比較して、仕様の違いを教えてください。」
• 「このマグネシウムサプリメントを最も安く販売している販売者はどこですか？購入者の評価も教えてください。」
• 「今夜終了する Snapp! Shop のフラッシュセールは何ですか？」
• 在庫のある、ストレージ 256 GB の最も安い Samsung のスマートフォンを見つけてください。
• この商品の販売者を、価格と保証で比較してください。
• 今日、Snapp! Shop ではどのような特別セールがありますか？

クイックスタート

uv と イランの IP アドレスが必要です （Snapp! Shop は国外の IP アドレスをブロックします。FAQ をご覧ください）。API キーやアカウントは不要です。

claude mcp add snappshop -- uvx snappshop-mcp

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

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

codex mcp add snappshop -- uvx snappshop-mcp

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

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

ツール

すべてのツールは読み取り専用です。リストは 1 ページあたり 12 件を返します（page は 1 から始まります）。

フィルターには ID ではなく名前を指定します：specs=["حافظه داخلی=256 گیگابایت"]、colors=["مشکی"]。カテゴリーで利用できるフィルターを確認するには、まず ss_filters を呼び出してください。

仕組み

サーバーは、Snapp! Shop のウェブアプリが使用するものと同じ JSON API（apix.snappshop.ir）を、サイトがすべての訪問者に渡すゲストトークンを使って呼び出します。リクエストは Chrome の TLS フィンガープリントと、サイトのフロントエンド自体が送信するヘッダーを付けて送信されるため、通常の閲覧のように見えます。共有の HTTP クライアントが読み取り結果を 60 秒間キャッシュし、同時実行数を制限して、タイムアウトやサーバーエラーを再試行し、apix.snappshop.ir 以外のホストへの接続を拒否します。

データは保存されず、ほかの場所に送信されることもありません。ログイン機能はありません。サーバーからアカウントを確認したり変更したりすることはできません。

知っておくとよいこと

• イランの IP アドレスのみ対応しています。 海外からアクセスすると、サイトは HTTP 403（「VPN をオフにしてください」）を返します。イランの回線を使うか、SNAPPSHOP_MCP_PROXY を設定してください。
• 価格はトマンです。 サイトの表示どおりの価格で、テヘランへの配送が対象です。在庫と価格は日中に変動します。
• 合計件数はサイトによって 10,000 件が上限に設定されており、呼び出しごとに 1、2 件異なる場合があります。
• 検索語句に一致するものがない場合、関連のない商品が表示されることがあります。商品名を確認してください。
• 最上位カテゴリ（mobile など）には商品一覧がありません。ss_categories からサブカテゴリを選んでください。
• レビュー投稿者の名前は返されません。

FAQ

API キーやアカウントは必要ですか？ いいえ。すべての訪問者に付与されるゲストセッションを使用します。

商品を購入したり、カートに追加したりできますか？ いいえ。読み取り専用として設計されています。

HTTP 403 が返されるのはなぜですか？ サイトはイランの IP アドレスからのアクセスにのみ応答します。VPN を使わずにイランからサーバーを実行するか、イランを経由する HTTP プロキシを SNAPPSHOP_MCP_PROXY に設定してください。

これは snapp-mcp と同じですか？ いいえ。snapp-mcp は Snappfood（レストラン）と SnappMarket（食料品）に対応しています。このサーバーは Snapp! Shop のマーケットプレイスに対応しています。

どの言語で質問すればよいですか？ 商品名や仕様はペルシア語なので、ペルシア語が最も適しています。英語のブランド名やモデル名も使用できます。

ストレージ容量でスマートフォンを絞り込むにはどうすればよいですか？ ss_filters(path="mobile/samsung") を呼び出し、続けて ss_category(path="mobile/samsung", specs=["حافظه داخلی=256 گیگابایت"]) を呼び出してください。

設定

ペルシア語：Snapp‌Shop MCP サーバー

claude mcp add snappshop -- uvx snappshop-mcp

git clone https://github.com/sepehr071/snappshop-mcp && cd snappshop-mcp
uv sync
uv run python -m pytest            # offline, against recorded responses
uv run python -m pytest -m live    # real API (needs an Iranian IP)
uv run ruff check .

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

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

関連サーバー

• iran-mcp：イランのサービス向け MCP サーバーの一覧
• snapp-mcp：Snappfood と SnappMarket（レストランと食料品）
• digikala-mcp：Digikala の商品検索と価格
• torob-mcp：イランのショップ間での価格比較
• basalam-mcp：Basalam の手作り品と地元の製品

免責事項

非公式のものであり、Snapp との提携や推奨を受けていません。読み取り専用で、snappshop.ir のウェブアプリの公開エンドポイントを読み取るだけですが、予告なく変更される場合があります。リクエスト頻度は適切に保ってください。

作者

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

ライセンス

MIT

クリックの手間が省けたら、スターを付けてほかの人にも見つけてもらいましょう。