asalbanoo-mcp
Advanced tools
Unofficial read-only MCP server for Asal Banoo: search cosmetics, skin and hair care, compare prices and variants, find deals.
Let your AI agent shop for cosmetics and skin care on Asal Banoo (عسل بانو).
An unofficial, read-only MCP server for asalbanooshop.com, an Iranian online shop for skin care, hair care, make-up and perfume:
search products, find the cheapest in-stock match, compare sizes and prices, read reviews and catch discounts, 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
uvx asalbanoo-mcp or claude mcp add asalbanoo -- uvx asalbanoo-mcp. Transport: stdio. Needs uv (Python 3.10+).ASALBANOO_MCP_PROXY sets an HTTP proxy (or a comma-separated list) for requests to asalbanooshop.com; system proxy settings are ignored.ab_. Start with ab_find_cheapest, ab_search, ab_product or ab_deals. Typical sequence: ab_find_cheapest -> ab_product -> ab_reviews. Take a product's id from ab_search or ab_browse and pass it as product_id to ab_product and ab_reviews. Category and brand slugs for ab_browse come from ab_categories and ab_brands.final_price is what the buyer pays, price is before discount, discount_pct is a whole percent, ratings are 1-5 or null. In product lists, null fields are left out: no price means it equals final_price, no discount_pct means 0, no rating means no reviews. Review texts are cut at 400 characters (full_text=true on ab_reviews returns them whole).server.json, and the catalog of all Iranian MCP servers at iran-mcp (TOOLS.md, servers.json, llms.txt).Asal Banoo (عسل بانو) lists about 3,500 skin, hair, make-up and perfume products, and a search for
"sunscreen" mixes in eye creams, sold-out items and products that only mention sunscreen in their
description. Finding the cheapest one you can actually order, in the size you want, means paging
through listings and opening product pages. An agent with asalbanoo-mcp does that in seconds:
You: Cheapest sunscreen I can order now?
Agent: calls
ab_find_cheapest(query="ضد آفتاب")→ab_product(product_id=28470)
Price Product Note 427,300 ضد آفتاب دور چشم آیسول eye area, untinted; the tinted one (432,200) is sold out 499,800 ضدآفتاب دور چشم فتوتیپیک SPF30 درماتیپیک eye-area, rating 1.5 599,800 ضد آفتاب پوست خشک درماتیپیک Hydra face, dry skin, 5 tints up to 899,800 The two cheapest are for the eye area. For the face, the Dermatypique Hydra is listed from 599,800 Toman, but only its Light Beige tint is in stock, at 899,800. Want me to check its reviews with
ab_reviews?
Real tool output from 2026-10-06; prices change all the time. Prices are in Toman.
Example prompts:
You need uv. No API key or account.
claude mcp add asalbanoo -- uvx asalbanoo-mcp
Settings → Developer → Edit Config, then add:
{
"mcpServers": {
"asalbanoo": { "command": "uvx", "args": ["asalbanoo-mcp"] }
}
}
Click Install in Cursor above, or add the Claude Desktop block to ~/.cursor/mcp.json (or .cursor/mcp.json in a project).
Click Install in VS Code above, or add to .vscode/mcp.json:
{
"servers": {
"asalbanoo": { "type": "stdio", "command": "uvx", "args": ["asalbanoo-mcp"] }
}
}
codex mcp add asalbanoo -- uvx asalbanoo-mcp
Or in ~/.codex/config.toml:
[mcp_servers.asalbanoo]
command = "uvx"
args = ["asalbanoo-mcp"]
Add to ~/.gemini/settings.json:
{
"mcpServers": {
"asalbanoo": { "command": "uvx", "args": ["asalbanoo-mcp"] }
}
}
Add the Claude Desktop block to ~/.codeium/windsurf/mcp_config.json.
It's a standard stdio MCP server: run uvx asalbanoo-mcp, or pip install asalbanoo-mcp and run asalbanoo-mcp.
All 12 tools are prefixed ab_ and annotated readOnlyHint: true. They return compact JSON, so they don't flood the agent's context.
| Tool | What it does |
|---|---|
ab_search | Search by keyword: price, discount, stock, rating, with sort and price range |
ab_find_cheapest | Cheapest in-stock matches for a keyword, one flat list (titles must contain every word) |
ab_browse | A category, brand or the whole shop sorted by price / date / popularity / rating, with price range and filters |
ab_filters | Volume, hair/skin type, gender and origin filters of a category or brand, with counts |
ab_categories | Product categories (about 70) with slugs and product counts |
ab_brands | Brands (about 250) with slugs and product counts |
ab_deals | Everything discounted and in stock, biggest discount first |
| Tool | What it does |
|---|---|
ab_product | Price, discount, stock (exact count when low), every size/color variant, brand, rating, key facts |
ab_reviews | Customer reviews and questions with star breakdown and the shop's answers |
| Tool | What it does |
|---|---|
ab_shop_info | FAQ, terms, about and contact pages as text: delivery (outside Bandar Abbas Post Pishtaz 7-10 working days; Bandar Abbas courier, next day before 13:00), returns, wallet, branches |
ab_blog_posts | Skin and hair care guides and comparisons, newest first |
ab_blog_post | One guide as plain text, with the products and categories it links to |
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 runs locally and calls the same public pages and endpoints the asalbanooshop.com website uses.
There's no hosted server in between, no API key, and nothing about you is sent anywhere else.
The shop has no public product API: prices come from listing cards, the product quick view and the site's live search, so the server parses that HTML with the Python standard library. Requests go out through a Chrome-impersonating client, at most 2 at a time with a little jitter. It solves the site's small cookie challenge (HTTP 418) automatically, retries timeouts, dropped connections, 429 and 5xx up to twice, and keeps the category and brand lists for an hour. It only reads.
final_price is what you pay, price is before discount, discount_pct is a whole percent. The site's structured data is in Rial; the server doesn't use it for prices.image (absolute, percent-encoded https URL); ab_product also has images (gallery). To download one yourself send a browser User-Agent: plain python/httpx gets HTTP 403 from the site's WAF.final_price) up to max_price, with the biggest variant discount as discount_pct; ab_product gives each variant's price, stock and max_qty.in_stock means orderable online now; stock_status shows the exact count when few are left ("فقط 2 عدد در انبار موجود است"). When nothing in stock matches, ab_search adds out_of_stock_matches so a sold-out brand isn't mistaken for one the shop never carried.null when nobody has reviewed the product yet. Review dates are Jalali (for example 1405-07-13).شامپو, ضد آفتاب), but English brand names work too (vichy, la roche). There is no separate autocomplete tool: ab_search covers the site's header live search.ab_find_cheapest filters on titles for you.robots.txt disallows the listing query parameters for crawlers, so please keep request rates low.Asal Banoo doesn't publish an official API for agents. asalbanoo-mcp is an unofficial MCP server that reads the
public pages and endpoints of asalbanooshop.com and exposes them as 12 read-only tools.
No, and that's deliberate. It has no login and never touches the cart, checkout, wallet, wishlist or review endpoints. The agent finds the best option; you buy it on asalbanooshop.com.
ab_find_cheapest skip some items?The site's search also matches product descriptions, so ab_find_cheapest keeps only in-stock items whose title
contains every word of your query (match_all_words: false turns that off). It scans the 150 cheapest in-stock
results by default; complete: false in the reply means more lie past that, so raise scan (up to 300).
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 asalbanoo -- uvx asalbanoo-mcp.
Toman. The site's structured data uses Rial, but the server reads the Toman prices shown on the pages.
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.
The site answers new visitors with a small cookie challenge (HTTP 418); the server solves it automatically and
retries timeouts, dropped connections, 429 and 5xx up to twice. Requests use a Chrome TLS and header profile. If the
site serves a browser check instead, install asalbanoo-mcp[browser] and run patchright install chromium; the server
then clears it in a headless browser. If it still fails, check your internet connection. System proxy variables are
ignored on purpose; set ASALBANOO_MCP_PROXY if you need a proxy.
uvx is not foundUse the full path to uvx (where uvx on Windows, which uvx on macOS/Linux) as command.
npx @modelcontextprotocol/inspector uvx asalbanoo-mcp
| Variable | Default | Meaning |
|---|---|---|
ASALBANOO_MCP_PROXY | unset | Optional HTTP proxy URL for asalbanooshop.com requests, e.g. http://user:pass@host:port; system proxy settings are ignored. A comma-separated list is used one at a time, moving on after a block or connect error |
asalbanoo-mcp یک سرور MCP غیررسمی برای فروشگاه اینترنتی عسل بانو (asalbanooshop.com) است؛ فروشگاه ایرانی محصولات مراقبت از پوست، مراقبت از مو، آرایشی و عطر. این سرور به دستیار هوش مصنوعی شما (Claude، Cursor، Copilot و ...) اجازه می‌دهد در عسل بانو جستجو کند، ارزان‌ترین محصول موجود را پیدا کند، قیمت حجم‌ها و رنگ‌های مختلف را مقایسه کند، نظرات و پاسخ مشاوران را بخواند و تخفیف‌های روز را ببیند.
چه کارهایی می‌کند
نکته‌ها
نصب (اول uv را نصب کنید). در Claude Code:
claude mcp add asalbanoo -- uvx asalbanoo-mcp
در Claude Desktop، Cursor و بقیه برنامه‌ها همان تنظیم بخش Quick start را بگذارید.
نمونه پرسش‌ها
برای جستجو کافی است محصول یا برند را به فارسی یا انگلیسی بنویسید، مثلاً «ضد آفتاب» یا «vichy».
git clone https://github.com/sepehr071/asalbanoo-mcp && cd asalbanoo-mcp
uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q # offline, against recorded responses
uv run python -m pytest -m live -q # real asalbanooshop.com
uv build
Tools live in src/asalbanoo_mcp/catalog.py, product.py and content.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.
If this saves you clicks, a star helps others find it.
Unofficial and not affiliated with or endorsed by Asal Banoo. It is read-only and uses the public pages and endpoints of the asalbanooshop.com website, which can change without notice. Please keep request rates reasonable.
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.
FAQs
Unofficial read-only MCP server for Asal Banoo: search cosmetics, skin and hair care, compare prices and variants, find deals.
The pypi package asalbanoo-mcp receives a total of 568 weekly downloads. As such, asalbanoo-mcp popularity was classified as not popular.
We found that asalbanoo-mcp demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Threat Research
/Security News
Socket uncovered secret-stealing workflows that ran in LiteLLM’s GitHub repository 11 days before the supply chain attack on PyPI and Docker.
Security News
Cloudflare introduces tsrs, a Rust port of TypeScript’s compiler promising faster checks and lower memory use, with the TypeScript team’s help.
Security News
The PHP Foundation says Chainguard broke a security embargo ahead of critical RCE patches, as leaks disrupted the coordinated release.