👗 shopino-mcp

Let your AI agent shop for clothes, bags and shoes across thousands of Iranian shops on Shopino.
Search one catalog of about 960,000 products from 10,000 online and Instagram shops, compare real prices,
check which size and color is in stock, judge the shop, and catch today's flash sale, all from Claude, Cursor or Copilot.

Quick start · What it can do · Tools · FAQ · فارسی

Why

Shopino puts the products of about 10,000 Iranian online and Instagram shops in one place. A search for "linen manteau" mixes out-of-stock items, colors and sizes with their own stock, shops you've never heard of, and discount codes hidden in small labels. Finding the cheapest one in your size from a shop you can trust means a lot of clicking. An agent with shopino-mcp does that in seconds:

You: Cheapest linen manteau in stock right now, from a well-rated shop?

Agent: calls sh_find_cheapest(query="مانتو کتان") → sh_shop(shop="489")

Price	Product	Shop
999,000 (56% off)	مانتو کتان ازالیا (1123)	وایت گالری پلاس (not rated yet)
999,000 (47% off)	مانتو کتان زنانه 442170	صنم گالری, 4.6, same-day courier in Tehran
1,100,000 (21% off)	6556-مانتو کتان قلبی	پاپیون لیدی, 4.9 from 3,507 buyer surveys, 92% satisfied

The two cheapest cost the same; Sanam Gallery is rated and delivers same-day in Tehran. Papion Lady costs 101,000 more but has the best buyer record. Want me to check which sizes are left with sh_product?

_{Real tool output from 2026-10-06; prices change all the time. Prices are in Toman.}

What it can do

• 🔎 Search every shop at once in Persian or English, with price, discount, stock and the selling shop
• 💸 Find the cheapest in-stock match for a keyword, optionally in one category or with courier delivery in your city
• 🗂️ Browse any category, shop, tag or curated listing sorted by price, date or biggest discount, with price range and size filters
• 📏 Check sizes: every color and size of a product with its own price and units left, plus the shop's size guide
• 🏪 Judge the shop: rating, buyer surveys (satisfied, quality, price, on-time %), followers, contacts and website
• 🪞 Find the same item elsewhere by photo similarity, cheapest first
• ⚡ Catch deals: the flash sale with its end time, best sellers, campaigns and the shops' discount codes
• 📝 Read style guides from the Shopino blog
• 🔒 Read-only by design: no login, no cart, no orders, no likes

Quick start

You need uv. No API key or account.

claude mcp add shopino -- uvx shopino-mcp

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

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

Then just ask:

• "Cheapest women's manteau in size L under 2,000,000 Toman, from a shop with good reviews?"
• "Is this product (2578018) cheaper at another shop?"
• "What's in today's flash sale, and are there any discount codes?"
• ارزان‌ترین کفش ورزشی سایز ۴۰ با ارسال پیک در تهران چند است؟

How it works

  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 runs locally and calls the same public endpoints the shopino.app website uses. There's no hosted server in between, no API key, and nothing about you is sent anywhere else.

Tools

All tools are annotated readOnlyHint: true and return compact structured JSON, so they don't flood the agent's context.

Good to know

• Prices are in Toman. final_price is what you pay, price is before discount, discount_pct is a whole percent. null means the shop shows no price (usually out of stock).
• Sizes and colors can differ in price and stock. A product's final_price is its cheapest variant; sh_product lists each color / size with its own price and stock (units left).
• Each product is sold by one shop. Many can be bought in the Shopino cart; shop_site_only / shopino_cart: false means only on the shop's own site (original_url).
• Shipping is not public. It is quoted per shop and address at checkout (needs a login), so the order total is items + the shop's shipping − one discount code. courier_city means same-day courier delivery in that city.
• Discount codes come from the shops' promotion labels (promo, e.g. "1 میلیون تخفیف با کد: hana70"); one code per order, entered at checkout.
• Some "before" prices are inflated. A 90% discount can be real or a made-up list price; compare with sh_similar.
• Flash-sale items sort and filter on their pre-sale price. Shopino ranks flash_sale items by their usual price, so in a "cheapest" list or a price range they can show up below the range or out of order (the site shows them the same way).
• Two shop ratings. rating / surveys come from Shopino's buyer surveys; the stars the site shows next to a shop are customer_rating (customer_rating_count) in sh_product / sh_shop.
• There is no working color filter on Shopino (the site's own color filter returns nothing); put the color in the search words.
• Persian queries match best (مانتو کتان, کفش ورزشی مردانه).

FAQ

npx @modelcontextprotocol/inspector uvx shopino-mcp

Configuration

فارسی

claude mcp add shopino -- uvx shopino-mcp

Development

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

Tools live in src/shopino_mcp/catalog.py, product.py, shop.py and info.py; each is a typed async function with a docstring that tells the agent when to use it. Issues and PRs are welcome, especially new tools and fixes for site changes.

Releases: bump the version in pyproject.toml and server.json, then push a v* tag. GitHub Actions tests, publishes to PyPI and the MCP Registry, and creates the GitHub Release.

Disclaimer

Unofficial and not affiliated with or endorsed by Shopino. It uses the public endpoints of the shopino.app website, which can change without notice. Please keep request rates reasonable.

License

MIT