Asal Banoo

asalbanoo-mcp：面向 AI Agent 的 Asal Banoo MCP 服务

让你的 AI Agent 在 Asal Banoo（عسل بانو）选购化妆品和护肤品。
一款面向 asalbanooshop.com 的非官方只读 MCP 服务。这是一家伊朗网店，销售护肤品、护发产品、彩妆和香水：
可通过 Claude、Cursor 或 Copilot 搜索商品、查找有货商品中的最低价、比较规格和价格、阅读评价并发现折扣。

面向 AI Agent · 为什么选择它 · 功能 · 快速开始 · 工具 · 工作原理 · 须知 · 常见问题 · 配置 · فارسی · 开发

面向 AI Agent

• **内容：**非官方的 Asal Banoo MCP 服务（模型上下文协议），适用于 Asal Banoo（asalbanooshop.com，عسل بانو）。这是一家伊朗护肤、护发、彩妆和香水商店，在 Bandar Abbas 设有分店。支持用波斯语和英语查询。
• 安装：uvx asalbanoo-mcp 或 claude mcp add asalbanoo -- uvx asalbanoo-mcp。传输方式：stdio。需要 uv（Python 3.10+）。
• **身份验证：**无需身份验证，无需 API 密钥或账户。可选的 ASALBANOO_MCP_PROXY 用于为发往 asalbanooshop.com 的请求设置 HTTP 代理（或以逗号分隔的代理列表）；系统代理设置不会生效。
• **访问权限：**只读。它无法登录、使用购物车、下单或发布评论，因此调用任何工具前都无需确认。
• **工具：**共 12 个，名称均以 ab_ 开头。可从 ab_find_cheapest、ab_search、ab_product 或 ab_deals 开始。典型调用顺序：ab_find_cheapest -> ab_product -> ab_reviews。从 ab_search 或 ab_browse 获取商品的 id，并将其作为 product_id 传给 ab_product 和 ab_reviews。ab_browse 所需的类别和品牌 slug 可从 ab_categories 和 ab_brands 获取。
• 单位：价格以托曼计。final_price 是买家实际支付的价格，price 是折扣前价格，discount_pct 是整数百分比，评分为 1 到 5，或 null。商品列表中会省略值为 null 的字段：没有 price 表示其价格等于 final_price；没有 discount_pct 表示折扣为 0；没有 rating 表示暂无评论。评论文本会截断至 400 个字符（在 ab_reviews 中设置 full_text=true 可返回完整文本）。
• **适用场景：**用户想比较 Asal Banoo 上化妆品和护肤品的价格、规格、库存、评论或当前折扣，或想了解商店的护理指南和配送规则。
• **不适用场景：**用户想购买商品（不支持购物车或结账）、需要查询运费（商店仅在结账时显示运费），或询问其他商店。
• 机器可读信息：server.json，以及伊朗 MCP 服务目录 iran-mcp（TOOLS.md、servers.json、llms.txt）。

为什么要用

Asal Banoo（عسل بانو）上架了约 3,500 种护肤、护发、彩妆和香水产品。搜索“防晒霜”时，结果中却混杂着眼霜、已售罄商品，以及只在描述中提到防晒的产品。要找到实际可以下单、且规格符合你需求的最便宜商品，就得翻阅商品列表并逐个打开商品页面。使用 asalbanoo-mcp 的 Agent 几秒钟就能完成：

**你：**现在能下单的最便宜防晒霜是什么？

**Agent：**调用 ab_find_cheapest(query="ضد آفتاب") → ab_product(product_id=28470)

价格	商品	备注
427,300	ضد آفتاب دور چشم آیسول	眼周适用，无色；有色款（432,200）已售罄
499,800	ضدآفتاب دور چشم فتوتیپیک SPF30 درماتیپیک	眼周适用，评分 1.5
599,800	ضد آفتاب پوست خشک درماتیپیک Hydra	面部适用，适合干性皮肤，有 5 种色号，最高价 899,800

最便宜的两款都适用于眼周。Dermatypique Hydra 面部防晒霜的标价从 599,800 托曼起，但只有浅米色有库存，价格为 899,800。要我用 ab_reviews 查查它的评论吗？

_{来自 2026-10-06 的真实工具输出；价格随时可能变化。价格以托曼计。}

功能

• 按名称搜索波斯语或英语商品，查看价格、折扣、库存和评分
• 查找最便宜的商品：在标题确实包含你输入关键词的匹配商品中，查找有货且价格最低的商品
• 浏览任意分类或品牌，并按价格、日期、人气或评分排序；还可使用价格区间、容量和头发／肤质筛选
• 查看商品详情：每种规格／颜色各自的价格和库存、关键信息（容量、肤质、产地），以及商家回复的评价
• 寻找优惠：查看当前所有折扣商品，按折扣力度从高到低排序
• 获取建议：查阅商家的护理指南和商品对比，以及配送、退货和钱包规则
• 专为只读而设计：无需登录，没有购物车、订单，也不能发布评价

示例提示词：

• “100 万到 200 万托曼之间最便宜的去屑洗发水是哪款？哪款评价最好？”
• “1000 ml 的 Roverhair Detox 洗发水多少钱？有货吗？”
• “油性皮肤用 Vichy Mineral 89 还是 Clinique Moisture Surge？”
• “今天哪些 Asal Banoo 商品的折扣最大？”
• تخفیف‌های امروز عسل بانو روی ضد آفتاب چیه؟
• ارزان‌ترین شامپو ضد شوره موجود در عسل بانو کدومه؟
• نظر خریداران درباره سرم ویتامین سی چیه؟

快速开始

你需要安装 uv。无需 API 密钥或账号。

claude mcp add asalbanoo -- uvx asalbanoo-mcp

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

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

codex mcp add asalbanoo -- uvx asalbanoo-mcp

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

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

全部 12 个工具均以 ab_ 为前缀，并标注了 readOnlyHint: true。它们会返回精简的 JSON，不会让 Agent 的上下文塞满。

工作原理

  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 在本地运行，并调用 asalbanooshop.com 网站使用的相同公开页面和端点。 中间没有托管服务，不需要 API 密钥，也不会将你的任何信息发送到其他地方。

该商店没有公开的商品 API：价格来自商品列表卡片、商品快速预览和网站的实时搜索， 因此服务会使用 Python 标准库解析这些 HTML。请求通过模拟 Chrome 的 客户端发送，一次最多 2 个请求，并加入少量随机延迟。它会自动解决网站的小型 Cookie 验证（HTTP 418）， 对超时、连接中断、429 和 5xx 最多重试两次，并将类别和品牌列表缓存一小时。它只读取数据。

需知

• 价格单位为 Toman。 final_price 是实际支付的价格，price 是折扣前价格，discount_pct 是整数百分比。网站的结构化数据以 Rial 为单位；服务不会使用其中的价格。
• 图片：每个商品都有 image（绝对路径、百分号编码的 https URL）；ab_product 还包含 images（图库）。要自行下载图片，请发送浏览器的 User-Agent：普通的 python/httpx 会被网站的 WAF 返回 HTTP 403。
• 尺码和颜色：含有多个变体的商品，会以最便宜变体的价格（final_price）至最高价格（max_price）列出，并显示折扣最大的变体的折扣（discount_pct）；ab_product 会提供每个变体的价格、库存和 max_qty。
• 配送：Bandar Abbas 以外的地区仅通过 Post Pishtaz 配送，需 7-10 个工作日。在 Bandar Abbas，可由快递配送（13:00 前下单，次日送达），也可到两家分店自提。运费仅在结账时显示，不对外公布。
• 库存：in_stock 表示当前可在线下单；剩余数量较少时，stock_status 会显示具体库存（“فقط 2 عدد در انبار موجود است”）。没有匹配的商品有库存时，ab_search 会添加 out_of_stock_matches，以免将缺货品牌误认为商店从未经营过的品牌。
• 评分为 1-5 分，尚无人评价的商品显示为 null。评价日期使用 Jalali 日期（例如 1405-07-13）。
• 波斯语查询效果最佳（شامپو、ضد آفتاب），但英文品牌名也可使用（vichy、la roche）。没有单独的自动补全工具：ab_search 可实现网站页眉的实时搜索功能。
• 搜索也会匹配商品描述，因此请检查标题；ab_find_cheapest 会为你按标题筛选。
• 隐私：不会提取或返回评价作者的联系方式。
• 请求频率限制：每秒约 1 次请求时未发现限制。网站的 robots.txt 禁止爬虫访问带有查询参数的商品列表页面，因此请保持较低的请求频率。
• 不支持的功能：登录、购物车、结账、优惠券、钱包、愿望清单、发布评价或联系表单；不提供运费（未公布）；不支持其他商店。

常见问题

npx @modelcontextprotocol/inspector uvx asalbanoo-mcp

配置

波斯语：عسل بانو MCP 服务

claude mcp add asalbanoo -- uvx asalbanoo-mcp

开发

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

工具位于 src/asalbanoo_mcp/catalog.py、product.py 和 content.py 中；每个工具都是带类型标注的异步函数，并附有说明何时使用它的文档字符串。欢迎提交问题和 PR，尤其是新增工具以及针对网站变更的修复。

发布：更新 pyproject.toml 和 server.json 中的版本，然后推送 v* 标签。GitHub Actions 会运行测试，发布到 PyPI 和 MCP Registry，并创建 GitHub Release。

相关服务

• iran-mcp：伊朗各类服务 MCP 服务目录
• Khanoumi MCP server：提供化妆品和护肤品的价格与色号信息
• Shopino MCP server：汇集数千家伊朗商店的时尚商品
• Banimode MCP server：提供 Banimode 时尚商品的价格与尺码信息
• Digikala MCP server：提供 Digikala 商品与价格信息
• Torob MCP server：比较伊朗各家商店的价格

如果它帮您少点几次鼠标，欢迎点个星，帮助其他人发现这个项目。

免责声明

本项目为非官方项目，与 Asal Banoo 无关联，也未得到其认可。它仅供读取，使用 asalbanooshop.com 网站的公开页面和接口，这些内容可能会随时更改，恕不另行通知。请合理控制请求频率。

作者

由 Sepehr Radmard（سپهر رادمرد）构建并维护。欢迎通过 LinkedIn 联系，或在 GitHub 上关注 @sepehr071，了解更多适用于伊朗网站的 MCP 服务；所有服务均列于 iran-mcp。如果这个项目为你节省了时间，请给仓库点个星，帮助其他人发现它。

许可证

MIT