Banimode

banimode-mcp：面向 AI Agent 的 Banimode MCP 服务

让你的 AI Agent 在 Banimode（بانی‌مد）上选购时尚商品。
这是一个非官方、只读的 Banimode MCP 服务。Banimode 是一家伊朗线上时尚与生活方式商店：搜索服装、鞋子、包袋和配饰， 比较以 Toman 计价的价格、查看哪些尺码有库存、阅读客户评论、发现今日限时特惠；以上操作均可在 Claude、Cursor 或 Copilot 中完成。

面向 AI Agent · 原因 · 功能 · 快速开始 · 工具 · 常见问题 · فارسی

面向 AI Agent

• 简介： 面向 Banimode（banimode.com，بانی‌مد）的非官方 MCP 服务。Banimode 是一家伊朗时尚商店，销售服装、鞋子、包袋、手表、美妆和家居用品。使用波斯语查询效果最佳；价格以 Toman 计。
• 安装： uvx banimode-mcp 或 claude mcp add banimode -- uvx banimode-mcp。传输方式：stdio。需要安装 uv（Python 3.10+）。
• 身份验证： 无需身份验证、API 密钥或账号。可选设置 BANIMODE_MCP_PROXY（HTTP 代理，或按顺序尝试的逗号分隔代理列表）。
• 访问权限： 只读。无需登录，不支持购物车、订单或发布评论，因此调用任何工具前都无需确认。
• 工具： 共 7 个，名称均以 bm_ 开头。可从 bm_search、bm_browse 或 bm_deals 开始。典型调用顺序：bm_search -> bm_product -> bm_reviews。
• 适用场景： 比较 Banimode 上的时尚商品价格、尺码库存、折扣或评论。
• 不适用场景： 用户想要购买商品（不支持购物车或结账），或需要查询运费（仅在结账时显示）。
• 输出： 紧凑的 JSON。价格以 Toman 计：final_price 是买家实际支付的价格，price 是折扣前的标价（若与 final_price 相同则省略），discount_pct 是整数百分比。搜索结果卡片对应一种颜色的一件商品，因此同一商品 ID 可能因颜色不同而重复；bm_product 会列出该商品的所有颜色及各尺码的库存。
• 机器可读信息： server.json 和 iran-mcp 目录（TOOLS.md、servers.json、llms.txt）。

原因

选购时尚商品往往需要打开许多标签页：同一条连衣裙有五种颜色、有些尺码已售罄，还有些折扣未必真实， 而评论则埋在页面底部。借助 banimode-mcp，Agent 可以按价格和尺码筛选、隐藏缺货商品、按折扣排序，并代你阅读评论，最后附上链接，给你一份简短的商品清单。

功能

• 搜索：按关键词搜索，并可按排序方式（最便宜、最贵、折扣最大、最新）、托曼价格范围、尺码、有货状态、类别和品牌筛选
• 浏览：使用 bm_categories 和 bm_brands 中的 ID 浏览某个类别和／或品牌
• 查看商品：查看每种颜色的价格、折扣、各尺码库存、特点和简短描述
• 阅读评价：查看星级、文本、日期和店铺回复
• 捕捉限时促销：查看今天的限时折扣及剩余时间
• 只读设计：无需登录，没有购物车，也不能下单

示例提示词：

• “在 Banimode 上寻找售价低于 200 万托曼、有 38 码现货、折扣从高到低排列的黑色女士运动鞋。”
• “Banimode 今天有哪些限时促销？只显示折扣超过 40% 的商品。”
• “给我看看这件商品的评价，并告诉我尺码是否偏小。”
• 寻找 Banimode 上售价低于 300 万托曼的女士礼服。
• 有 43 码现货的男士运动鞋中，哪款最便宜？
• 显示 Banimode 今天的限时折扣。

快速开始

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

claude mcp add banimode -- uvx banimode-mcp

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

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

codex mcp add banimode -- uvx banimode-mcp

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

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

工具

工作原理

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  banimode-mcp  (runs on your machine)
      │
      │  HTTPS
      └──────▶  mobapi.banimode.com   products, categories, brands, deals, reviews

banimode-mcp 在本地运行，并调用 banimode.com 网站本身使用的开放 JSON API。中间没有托管服务， 也无需 API 密钥。请求会受到速率限制，并在超时、429 和 5xx 错误时重试。

需要了解的信息

• 价格单位为 Toman。 API 使用 Rial；服务端会除以 10，使数字与网站上的一致。
• 每种颜色对应一张商品卡片。 同一商品 ID 可能在列表中出现多次；调用 bm_product 可查看所有颜色和尺码。
• 默认隐藏缺货商品（in_stock 为 true），因为否则按价格排序时会优先显示缺货商品。
• 使用波斯语查询效果最好（مانتو مجلسی、کفش اسپرت مردانه）。
• 每次查询最多返回 10,000 条结果，每页最多包含 50 件商品（默认 20 件，以控制回答长度）。
• 限时促销价格有时效限制；工具会返回剩余分钟数。
• 运费不包含在内。 只有结账时才会显示运费，因此实际费用为 final_price 加上未知的运费。
• 评论和商品描述文本来自网站及其用户；服务端会提示 Agent 将其视为数据，而不是指令。
• 不支持： 登录、购物车、订单、愿望清单、钱包、发布评论。
• 代理： 系统代理变量会被有意忽略；如需使用代理，请设置 BANIMODE_MCP_PROXY。

常见问题

配置

波斯语：Banimode MCP 服务

claude mcp add banimode -- uvx banimode-mcp

开发

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

工具位于 src/banimode_mcp/catalog.py 和 product.py 中；每个工具都是带类型注解的异步函数，并附有说明 Agent 应在何时使用它。 欢迎提交问题和 PR。

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

相关服务

• iran-mcp：伊朗各类服务 MCP 服务目录
• 面向伊朗最大网店的 Digikala MCP 服务
• 面向美容和个人护理的 Khanoumi MCP 服务
• 用于跨商店比价的 Torob MCP 服务
• 面向时尚购物的 Shopino MCP 服务
• 面向独立卖家市场的 Basalam MCP 服务

免责声明

本项目为非官方项目，与 Banimode 无关联，也未获其认可。它使用 banimode.com 网站开放的 JSON API，该 API 可能随时变更，恕不另行通知。 请合理控制请求频率。

作者

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

许可证

MIT