shopino-mcp
An unofficial, read-only MCP server for Shopino (the Iranian fashion marketplace) that lets an AI agent search, compare and vet clothing, bag and shoe listings from ~11,000 shops in Persian.
Search products (
sh_search) across all shops by keyword, with filters for category, shop, size/size-system, price range, courier city, stock and discounts, plus sorting and cursor paging.Find the cheapest offer (
sh_find_cheapest) for a keyword — a flat list sorted by price to pay, optionally in one category or with same-day courier in a city.Browse listings (
sh_browse) by category, shop, tag, curated listing or watch brand, sorted by price, newest or biggest discount.Inspect one product (
sh_product): every color/size variant with its own price and units left, size guide, description, tags, shop trust signals and the shop-site link.Find the same item elsewhere (
sh_similar) by photo similarity or Shopino's related products, cheapest first.Judge a shop (
sh_shops,sh_shop): rating, buyer survey percentages, Instagram followers, categories, courier city, contacts, website and similar shops.Catch deals (
sh_deals,sh_campaign): flash sale with end time, best sellers, themed rows, running campaigns and shop discount codes.Discover taxonomy and filters (
sh_categories,sh_filters,sh_brands): category tree with ids, size systems and sizes, sort orders, courier cities, and brand ids for watch shops.Read the style blog (
sh_blog_search,sh_blog_post) for outfit guides and model galleries.Not supported: no login, cart, checkout, orders, likes, returns or shipping-fee quotes — it is strictly read-only and needs no API key.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@shopino-mcp Cheapest linen manteau in stock in my size from a well-rated shop?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
shopino-mcp: Shopino MCP server for AI agents
Let your AI agent shop for clothes, bags and shoes on Shopino (شاپینو). An unofficial, read-only MCP server for Shopino, the Iranian fashion marketplace that gathers the products of about 11,000 online and Instagram shops: search one catalog, 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.
For AI agents · Why · What it can do · Quick start · Tools · How it works · Good to know · FAQ · Configuration · فارسی · Development · Related
For AI agents
What: unofficial MCP server (model context protocol) for Shopino (shopino.app, شاپینو), an Iranian fashion marketplace that gathers products from thousands of online and Instagram shops. Queries work best in Persian; prices are in Toman.
Install:
uvx shopino-mcporclaude mcp add shopino -- uvx shopino-mcp. Transport: stdio. Needs uv (Python 3.10+).Auth: none, no API key or account. Optional
SHOPINO_MCP_PROXYsets an HTTP proxy (or a comma-separated list) for requests to shopino.app; system proxy settings are ignored.Access: read-only. No login, cart, orders or likes, so no write tools exist and no confirmation is needed before calling any tool.
Tools: 14, all prefixed
sh_. Start withsh_find_cheapest,sh_search,sh_product,sh_shoporsh_deals. Typical sequence:sh_find_cheapest->sh_product->sh_shop, thensh_similarto compare the same item at other shops.Use when: comparing clothing, bag and shoe prices, sizes and stock, judging a shop by its rating and buyer surveys, or checking the flash sale and discount codes.
Do not use when: the user wants to buy something (no cart or checkout), or needs a shipping fee (quoted per shop and address at checkout, which needs a login).
Output: compact JSON. Prices in Toman.
final_priceis what the buyer pays,priceis before discount,discount_pctis a whole percent,nullprice means no price shown (usually out of stock). Pass a product'sidfromsh_searchorsh_browseasproduct_idtosh_productandsh_similar, and itsshop_idtosh_shop. Page with the returnednext_cursor.Network: talks to
api-go.shopino.appandapi.shopino.appdirectly from your machine. If Shopino serves a bot-check page, see the FAQ.Machine-readable:
server.json, and the catalog of all Iranian MCP servers at iran-mcp (TOOLS.md, servers.json, llms.txt).
Related MCP server: torob-mcp
Why
Shopino puts the products of about 11,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-mcpSettings → Developer → Edit Config, then add:
{
"mcpServers": {
"shopino": { "command": "uvx", "args": ["shopino-mcp"] }
}
}Click Install in Cursor above, or add the Claude Desktop block to ~/.cursor/mcp.json.
Click Install in VS Code above, or add to .vscode/mcp.json:
{
"servers": {
"shopino": { "type": "stdio", "command": "uvx", "args": ["shopino-mcp"] }
}
}codex mcp add shopino -- uvx shopino-mcpOr in ~/.codex/config.toml:
[mcp_servers.shopino]
command = "uvx"
args = ["shopino-mcp"]Add to ~/.gemini/settings.json:
{
"mcpServers": {
"shopino": { "command": "uvx", "args": ["shopino-mcp"] }
}
}Add the Claude Desktop block to ~/.codeium/windsurf/mcp_config.json.
It's a standard stdio MCP server: run uvx shopino-mcp, or pip install shopino-mcp and run 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?"
"Show the watch shops and the brands they sell, then list the cheapest watches in stock."
"Find me a well-rated shop for gold jewelry that delivers by courier in Tehran."
ارزان‌ترین کفش ورزشی سایز ۴۰ با ارسال پیک در تهران چند است؟
مانتو کتان زنانه زیر ۱ میلیون تومان از فروشگاه‌های خوش‌نام پیدا کن.
تخفیف شگفت‌انگیز امروز شاپینو چیست؟
Tools
Every list returns compact product cards (id, title, price, discount, stock, shop, a photo URL in image and the product url).
Tool | What it does |
| Search every shop by keyword: price, discount, stock, shop; filter by category, shop, size, price, city |
| Cheapest in-stock matches for a keyword, one flat list sorted by price to pay |
| A category, shop, tag or curated listing sorted by price / date / discount, with price range and size filters |
| Size systems and sizes, sort orders, courier cities and the sub-categories of a category |
| Category tree with ids and paths, plus total product and shop counts |
| Featured official brand shops, or the brands (with ids) a watch shop sells |
| Flash sale with end time, best sellers and themed rows, biggest discount first, campaigns and discount codes |
| A campaign page's product rows and tabs |
Tool | What it does |
| Every color / size with its own price and units in stock, size guide, description, shop trust signals, original link |
| Products that look like this one at other shops (cheapest first), or Shopino's related products |
Tool | What it does |
| Find shops by name, category group, gender or courier city, with rating, surveys and followers |
| A shop's rating, buyer survey, followers, main categories, contacts, website and similar shops |
Tool | What it does |
| Style guides and model galleries from the Shopino blog |
| One blog post as plain text |
All 14 tools are annotated readOnlyHint: true and return compact structured JSON, so they don't flood the agent's context.
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, blogshopino-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.
Requests go out with a browser-like TLS fingerprint, at most two at a time with a short random pause, and
the server retries a timeout, 429 or 5xx reply twice with backoff.
Good to know
Prices are in Toman.
final_priceis what you pay,priceis before discount,discount_pctis a whole percent.nullmeans the shop shows no price (usually out of stock). Shop ratings are 0-5,nullwhen not rated.Every product has an
image(absolute https URL of its first photo);sh_productalso gives up to 4 inimages.Sizes and colors can differ in price and stock. A product's
final_priceis its cheapest variant;sh_productlists each color / size with its own price andstock(units left).Each product is sold by one shop. Many can be bought in the Shopino cart;
shop_site_only/shopino_cart: falsemeans 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_citymeans 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_saleitems 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/surveyscome from Shopino's buyer surveys; the stars the site shows next to a shop arecustomer_rating(customer_rating_count) insh_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.
Paging uses a cursor.
sh_searchandsh_browsereturnnext_cursor; Shopino's ownpagenumbers drop the sort order, so this server does not send them.Persian queries match best (
مانتو کتان,کفش ورزشی مردانه).Brands exist only for watch shops;
sh_brandswithout a shop lists featured official brand shops.One card per product. Some shops list one card per color under the same id; the server merges them.
What it does not do: no login, cart, checkout, discount-code entry, gift cards, likes, notify-me, saved shops, returns, tickets or image-upload search. Shipping fees and the order total are not available.
Be gentle. Shopino's
robots.txtasks crawlers not to hit search pages hard; the server keeps two requests at a time with jitter, so keep agent loops modest.
FAQ
No, and that's deliberate. It has no login and never touches the cart, checkout, discount code, like, follow, board, review or ticket endpoints. The agent finds the best option; you buy it on shopino.app or the shop's own site.
Shopino doesn't publish an official API for agents. shopino-mcp is an unofficial MCP server that wraps the public
endpoints of shopino.app as 14 read-only tools, so any MCP client can search and compare products.
Install the server once (see Quick start), then ask in plain language, in Persian or English. In Claude Code
the install is claude mcp add shopino -- uvx shopino-mcp.
It is unofficial and free (MIT). It is read-only, needs no account or API key, and runs on your machine with no hosted server in between.
sh_search and sh_browse return a next_cursor. Pass it back as cursor with the same other arguments for the
next page. (Shopino's own page numbers drop the sort order, so this server pages with the API's cursor.)
It keeps only in-stock items with a price whose title or shop name contains every word of your query
(match_all_words: false turns that off). It scans up to 400 results, cheapest first; complete: false means more
matches lie past that, so raise scan (up to 1,000) or narrow with category_id.
Shops show a price of 0 for items that are out of stock, and the server turns that into null. Searches that need a
price, like sh_find_cheapest, skip those items.
The server retries a dropped connection or a 429/5xx reply twice with a short backoff. If it still fails, check your
internet connection. System proxy variables are ignored on purpose; set SHOPINO_MCP_PROXY if you need a proxy. If
Shopino serves a bot-check page, install the browser extra (pip install shopino-mcp[browser], then
patchright install chromium) so a headless browser can clear it.
Use the full path to uvx (where uvx on Windows, which uvx on macOS/Linux) as command.
npx @modelcontextprotocol/inspector uvx shopino-mcpConfiguration
Variable | Default | Meaning |
| unset | HTTP proxy for every request, e.g. |
فارسی
سرور MCP شاپینو برای دستیار هوش مصنوعی
shopino-mcp یک سرور MCP غیررسمی و فقط‌خواندنی برای شاپینو است؛ بازار اینترنتی ایرانی پوشاک که محصولات حدود ۱۱ هزار فروشگاه اینترنتی و اینستاگرامی را یک‌جا جمع می‌کند. این سرور به دستیار هوش مصنوعی شما (Claude، Cursor، Copilot و ...) اجازه می‌دهد در شاپینو جستجو کند، ارزان‌ترین محصول موجود را پیدا کند، موجودی هر رنگ و سایز را ببیند، امتیاز و نظرسنجی خریداران هر فروشگاه را بررسی کند و تخفیف‌های شگفت‌انگیز و کدهای تخفیف را پیدا کند.
چه کارهایی می‌کند
جستجو در همه فروشگاه‌ها به فارسی یا انگلیسی، با قیمت، تخفیف، موجودی و نام فروشگاه.
ارزان‌ترین محصول موجود برای یک کلیدواژه، در یک دسته یا با پیک در شهر شما.
مرور دسته‌ها، فروشگاه‌ها و برچسب‌ها بر اساس قیمت، تاریخ یا بیشترین تخفیف، با فیلتر بازه قیمت و سایز.
سایز و رنگ: قیمت و موجودی هر رنگ و سایز و راهنمای سایز فروشگاه.
ارزیابی فروشگاه: امتیاز، نظرسنجی خریداران (رضایت، کیفیت، قیمت، به‌موقع بودن)، دنبال‌کننده‌ها و راه‌های تماس.
همان کالا در فروشگاه‌های دیگر با شباهت تصویری، از ارزان به گران.
تخفیف‌ها: شگفت‌انگیز با زمان پایان، پرفروش‌ها، کمپین‌ها و کدهای تخفیف فروشگاه‌ها.
مقاله‌های وبلاگ شاپینو درباره استایل و ست لباس.
نکته‌ها
فقط خواندنی است: وارد حساب نمی‌شود، سبد خرید نمی‌سازد، سفارش ثبت نمی‌کند و چیزی را لایک نمی‌کند.
قیمت‌ها به تومان است.
هزینه ارسال عمومی نیست و فقط هنگام پرداخت (پس از ورود) محاسبه می‌شود.
روی سیستم خود شما اجرا می‌شود، کلید API لازم ندارد و به هیچ سرور واسطی داده نمی‌فرستد.
جستجوی فارسی بهترین نتیجه را می‌دهد.
کلیدواژه‌ها: شاپینو، shopino، سرور MCP شاپینو، خرید آنلاین لباس، مانتو، کیف و کفش، مقایسه قیمت، ارزان‌ترین قیمت، تخفیف شگفت‌انگیز، فروشگاه اینستاگرامی، پوشاک زنانه و مردانه، ساعت، طلا و جواهر.
نصب (اول uv را نصب کنید). در Claude Code:
claude mcp add shopino -- uvx shopino-mcpدر Claude Desktop، Cursor و بقیه برنامه‌ها همان تنظیم بخش Quick start را بگذارید.
نمونه پرسش‌ها
«ارزان‌ترین مانتو کتان زنانه سایز L زیر ۲ میلیون تومان از یک فروشگاه خوش‌نام کدام است؟»
«کفش ورزشی مردانه سایز ۴۰ با پیک در تهران چند است؟»
«این محصول در فروشگاه دیگری ارزان‌تر هست؟»
«تخفیف شگفت‌انگیز امروز چیست و کد تخفیفی هست؟»
Development
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 .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.
Related servers
Banimode MCP server for fashion and clothing
Khanoumi MCP server for cosmetics and skin care prices
Asal Banoo MCP server for skin care, hair care and make-up
Torob MCP server for price comparison across Iranian shops
Digikala MCP server for Iran's largest online store
iran-mcp: catalog of all Iranian-service MCP servers
Listed on mcpfarsi.ir, the Persian MCP marketplace
Disclaimer
Unofficial and not affiliated with or endorsed by Shopino. It is read-only and uses the public endpoints of the shopino.app website, which can change without notice. Please keep request rates reasonable.
Author
Built and maintained by Sepehr Radmard (سپهر رادمرد). Connect on LinkedIn or follow @sepehr071 on GitHub for more MCP servers for Iranian websites, all listed in iran-mcp. If this saves you time, a star on the repo helps other people find it.
License
If this saves you clicks, a star helps others find it.
Available Tools
14 toolssh_blog_postRead a blog postARead-onlyIdempotent
Read one blog post as plain text, with its category id for sh_browse (after sh_blog_search).
Inputs: slug (required), max_chars.
sh_blog_searchSearch the style blogARead-onlyIdempotent
Search the style blog (guides and model galleries), newest first; no query = latest posts.
Use for what is in fashion; read a post with sh_blog_post(slug).
Inputs: page, query.
sh_brandsBrandsARead-onlyIdempotent
Without shop_id: featured official brand shops. With shop_id: that watch shop's brands, with ids for the brand_id filter of sh_browse.
Inputs: shop_id.
sh_browseBrowse a category, shop, tag or listingARead-onlyIdempotent
List products of a category, shop, tag or curated listing, with sort, price range and filters.
Use for "cheapest manteau in size L under 2,000,000 Toman" or "biggest discounts in bags". With no category / shop / tag / listing it browses all shops. Ids: sh_categories, sh_shops, sh_brands; sizes: sh_filters.
Inputs: tag, city, sort, limit, +11 more.
sh_campaignCampaign pageARead-onlyIdempotent
Open a campaign or landing page: its product rows (with prices) and tabs.
A tab's listing / shop_id / category_id go to sh_browse; flash_sale -> sh_deals.
Inputs: slug (required), per_row.
sh_categoriesList categoriesARead-onlyIdempotent
List the category tree with ids, URL paths and levels, plus total product and shop counts.
Use to get a category_id. A query searches every level; without one only levels up to max_level are listed.
Inputs: query, max_level.
sh_dealsDeals, flash sale and campaignsARead-onlyIdempotent
List today's home-page deals (flash sale with end time, best sellers, themed rows), biggest discount first, plus running campaigns and shop discount codes.
Use for "what's on sale". Open a campaign: sh_campaign(slug).
Inputs: limit.
sh_filtersFilters for listingsARead-onlyIdempotent
List the filter values sh_search / sh_browse accept: size systems and sizes, sorts, courier cities, and (with category_id) sub-categories.
Use before filtering by size or city.
Inputs: category_id.
sh_find_cheapestFind cheapest productARead-onlyIdempotent
Find the cheapest in-stock products for a keyword across all shops, one flat list sorted by price to pay.
Use for the lowest price of X. Drops loose matches and unpriced items. complete=false: raise scan.
Inputs: query (required), city, scan, limit, +2 more.
sh_productProduct detailsARead-onlyIdempotent
Get one product's full record: price, every color / size variant with price and stock, size guide, description, tags, the selling shop with trust signals, and the shop-site link.
Use to check a size / color is in stock and the shop is trustworthy. Same item elsewhere: sh_similar.
Inputs: product_id (required), full_text.
sh_searchSearch productsARead-onlyIdempotent
Search products across all shops by keyword: price to pay, discount, stock, selling shop.
Use first for "price of X" / "where to buy X". Cheapest as a flat list: sh_find_cheapest. Sizes: sh_product.
Inputs: query (required), city, sort, limit, +9 more.
sh_shopShop profileARead-onlyIdempotent
Get a shop's profile: ratings, buyer survey %, followers, product count, main categories, courier city, contacts and website.
Use to judge whether a shop is trustworthy. Its products: sh_browse(shop_id=...); its brands: sh_brands.
Inputs: shop (required), full_text, similar_shops.
sh_shopsFind shopsARead-onlyIdempotent
Find shops by name, category group, gender or courier city, with rating, surveys, followers and product count.
Use to get a shop_id for sh_shop / sh_browse / sh_search.
Inputs: city, page, limit, order, +3 more.
sh_similarSimilar productsARead-onlyIdempotent
Find products like this one at other shops (itself left out).
Use when it is out of stock or too dear (kind='visual', sort='cheapest' finds the same item cheaper).
Inputs: product_id (required), kind, sort, limit, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 14 tools
Descriptions actively disambiguate the closest pairs: sh_search vs sh_find_cheapest, sh_browse vs sh_search, and sh_deals vs sh_campaign each include explicit cross-references and 'use for' guidance. The only residual overlap is that sh_find_cheapest and sh_browse can both return product lists for a keyword/category, but the flat-cheapest vs filtered-browse distinction is stated clearly enough to prevent misselection.
Every tool follows the same sh_ prefix plus lowercase snake_case convention (sh_search, sh_product, sh_blog_post, sh_find_cheapest). Noun-style (sh_product, sh_campaign) and verb-style (sh_find_cheapest, sh_blog_search) mix slightly, but the prefix and casing pattern is uniform throughout, making the set predictable.
14 tools for a product-discovery domain (search, browse, taxonomy, shops, deals, blog) is well within the comfortable range. Each tool maps to a distinct resource or lookup, and none appears redundant padding.
The surface covers the full discovery lifecycle: keyword search, cheapest lookup, filtered browsing, taxonomy (categories/brands/filters), shop lookup and profiles, product detail, similar-item fallback, deals/campaigns, and blog content. Minor gaps remain—no review/comment retrieval and no dedicated per-brand or per-shop product listing (only reachable via sh_browse parameters)—but these are workable.
Maintenance
Related MCP Connectors
Read-only fashion and beauty product search across popular online shops, any price, any language.
AI-agent product catalog: search, lookup & purchase routing over verified merchant data.
Search and get fashion products recommendations across multiple e-ecom stores
Live product search for AI agents across Shopify merchants and major retailers.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables AI agents to search Digikala's catalogue, compare every seller's offers and prices, review ~30 days of price history, read customer reviews and Q&A, and surface current deals, all through read-only tools.23528 PyPI43MIT
- AlicenseBqualityBmaintenanceEnables AI agents to compare prices across Iranian online and in-person shops, inspect each seller's offer with warranty and installment details, review roughly a year of price history, score deals, and find the cheapest shop for a whole basket. It is read-only, requires no account or API key, and runs locally for Claude, Cursor or Copilot.26401 PyPI1MIT
- AlicenseAqualityBmaintenanceEnables AI agents to search products on Iran's marketplace of independent shops with price, category, shipping and discount filters, find the cheapest in-stock offers, and read product details, shops, categories and customer reviews. It is read-only and needs no authentication, so it can be used straight from Claude, Cursor or Copilot.7144 PyPIMIT
- AlicenseAqualityBmaintenanceEnables AI agents to search Banimode's fashion catalog in Persian and compare Toman prices, discounts, per-size stock, and customer reviews. Also surfaces today's flash deals, all through read-only tools requiring no authentication.7127 PyPIMIT