Shopino

shopino-mcp：面向 AI Agent 的 Shopino MCP 服务

让你的 AI Agent 在 Shopino（شاپینو）上选购衣服、包包和鞋子。
这是一个面向 Shopino 的非官方只读 MCP 服务。Shopino 是一个伊朗时尚市场，汇集了约 11,000 家线上商店和 Instagram 商店的商品：
从 Claude、Cursor 或 Copilot 中搜索一个商品目录、比较实际价格、查看有哪些尺码和颜色有货、评估店铺，还能抓住今日限时特惠。

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

面向 AI Agent

• 简介： 适用于 Shopino（shopino.app，شاپینو）的非官方 MCP 服务（Model Context Protocol）。Shopino 是一家伊朗时尚购物平台，汇集了数千家网店和 Instagram 商店的商品。使用波斯语查询效果最佳；价格以托曼计价。
• 安装： uvx shopino-mcp 或 claude mcp add shopino -- uvx shopino-mcp。传输方式：stdio。需要 uv（Python 3.10+）。
• 身份验证： 无需验证，无需 API 密钥或账户。可选的 SHOPINO_MCP_PROXY 用于为发往 shopino.app 的请求设置 HTTP 代理（或逗号分隔的代理列表）；系统代理设置会被忽略。
• 访问权限： 只读。没有登录、购物车、订单或点赞功能，因此没有写入工具，调用任何工具前也无需确认。
• 工具： 共 14 个，前缀均为 sh_。可从 sh_find_cheapest、sh_search、sh_product、sh_shop 或 sh_deals 开始。 典型流程：sh_find_cheapest -> sh_product -> sh_shop，然后调用 sh_similar，比较其他商店的同款商品。
• 适用场景： 比较服装、包和鞋子的价格、尺码和库存；根据商店评分和买家调查评价商店；或查看限时促销和折扣码。
• 不适用场景： 用户想购买商品（没有购物车或结账功能），或需要查询运费（运费按商店和地址计算，并在结账时显示，且需要登录）。
• 输出： 紧凑的 JSON。价格以 托曼计价。final_price 是买家实际支付的价格，price 是折扣前价格，discount_pct 是整数百分比，null 价格表示未显示价格（通常是缺货）。将 sh_search 或 sh_browse 返回的商品 id 作为 product_id 传给 sh_product 和 sh_similar，将其 shop_id 传给 sh_shop。使用返回的 next_cursor 翻页。
• 网络： 从你的设备直接连接 api-go.shopino.app 和 api.shopino.app。如果 Shopino 显示了机器人验证页面，请参阅 常见问题。
• 机器可读信息： server.json，以及 iran-mcp 中的伊朗 MCP 服务目录（TOOLS.md、servers.json、llms.txt）。

为什么使用

Shopino 将约 11,000 家伊朗网店和 Instagram 商店的商品汇集在一处。搜索 “亚麻长外套”会混杂有货和缺货商品，也会混杂各自有货的不同颜色和尺码、你从未听说过的商店， 以及藏在小标签里的折扣码。要找到尺码合适、来自可信商店的最便宜商品，需要大量点击。使用 shopino-mcp 的 Agent 几秒钟就能完成：

你： 现在有货的亚麻长外套，来自评分较高商店的最便宜款？

Agent： 调用 sh_find_cheapest(query="مانتو کتان") → sh_shop(shop="489")

价格	商品	商店
999,000（折扣 56%）	مانتو کتان ازالیا (1123)	وایت گالری پلاس（尚无评分）
999,000（折扣 47%）	مانتو کتان زنانه 442170	صنم گالری，4.6 分，德黑兰当日送达
1,100,000（折扣 21%）	6556-مانتو کتان قلبی	پاپیون لیدی，3,507 份买家调查评分为 4.9 分，满意度 92%

最便宜的两款价格相同；Sanam Gallery 有评分，且在德黑兰提供当日送达。Papion Lady 贵 101,000，但买家评价记录最佳。要我用 sh_product 查查还剩哪些尺码吗？

_{工具实际输出，日期为 2026-10-06；价格随时可能变化。价格以托曼计价。}

可以做什么

• 一次搜索所有商店，支持波斯语或英语，并显示价格、折扣、库存和售卖商店
• 查找最便宜的有货关键词匹配商品，可选限定一个类别，或查找所在城市支持快递配送的商品
• 浏览任何类别、商店、标签或精选列表，可按价格、日期或折扣力度排序，并筛选价格范围和尺码
• 查看尺码：商品每种颜色和尺码的价格及剩余数量，以及商店的尺码指南
• 评估商店：评分、买家调查（满意度、质量、价格、准时率）、关注者、联系方式和网站
• 按照片相似度查找其他地方售卖的同款商品，按价格从低到高排列
• 发现优惠：限时特卖及结束时间、畅销商品、促销活动和商店折扣码
• 阅读 Shopino 博客中的风格指南
• 按设计仅提供只读功能：无需登录，不支持购物车、下单或点赞

快速开始

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

claude mcp add shopino -- uvx shopino-mcp

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

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

codex mcp add shopino -- uvx shopino-mcp

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

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

然后直接提问：

• “有没有尺码为 L、价格低于 2,000,000 Toman、评价不错的商店售卖最便宜的女士 manteau？”
• “这件商品（2578018）在别的商店卖得更便宜吗？”
• “今天的限时特卖有什么商品？有没有折扣码？”
• “列出手表商店及其售卖的品牌，然后列出有货的最便宜手表。”
• “帮我找一家评价不错、在德黑兰提供快递配送的黄金首饰商店。”
• ارزان‌ترین کفش ورزشی سایز ۴۰ با ارسال پیک در تهران چند است؟
• مانتو کتان زنانه زیر ۱ میلیون تومان از فروشگاه‌های خوش‌نام پیدا کن.
• تخفیف شگفت‌انگیز امروز شاپینو چیست؟

工具

每个列表都会返回紧凑的商品卡片（包含 id、标题、价格、折扣、库存、商店、image 中的图片 URL 和商品 url）。

全部 14 个工具都标注了 readOnlyHint: true，并返回紧凑的结构化 JSON，不会让 Agent 的上下文充斥大量内容。

工作原理

  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 在本地运行，并调用 shopino.app 网站使用的相同公共端点。 中间没有托管服务，不需要 API 密钥，也不会将任何关于你的信息发送到其他地方。 请求使用类似浏览器的 TLS 指纹发出，并发数最多为 2，期间会随机短暂暂停；如果出现超时、429 或 5xx 响应，服务端会在退避等待后重试两次。

需要了解的信息

• 价格单位为 Toman。 final_price 是实际支付金额，price 是折扣前价格，discount_pct 是整数百分比。null 表示商店未显示价格（通常是缺货）。商店评分范围为 0-5，未评分时为 null。
• 每件商品都有 image（第一张照片的绝对 https URL）；sh_product 还会提供最多 4 张 images。
• 不同尺码和颜色的价格与库存可能不同。 商品的 final_price 是最便宜款式的价格；sh_product 会列出每种颜色 / 尺码各自的价格和 stock（剩余件数）。
• 每件商品仅由一家商店销售。 许多商品可以加入 Shopino 购物车；shop_site_only / shopino_cart: false 表示只能在商店自有网站（original_url）购买。
• 运费不公开。 结账时会根据商店和地址报价（需要登录），因此订单总额为商品金额 + 商店运费 − 一张折扣码。courier_city 表示该城市提供当日快递配送。
• 折扣码来自商店的促销标签（promo，例如“1 میلیون تخفیف با کد: hana70”）；每笔订单可用一张，结账时输入。
• 有些“原价”被虚高了。 90% 的折扣可能是真的，也可能是虚构的标价；请与 sh_similar 中的商品比较。
• 闪购商品按促销前价格排序和筛选。 Shopino 会根据 flash_sale 商品的常规价格进行排名，因此它们可能出现在“最便宜”列表或价格范围之外，也可能顺序不对（网站上的显示方式也一样）。
• 有两种商店评分。 rating / surveys 来自 Shopino 买家调查；网站在商店旁显示的星级则是 sh_product / sh_shop 中的 customer_rating（customer_rating_count）。
• Shopino 没有可用的颜色筛选功能（网站自带的颜色筛选不会返回结果）；请将颜色写进搜索词。
• 翻页使用游标。 sh_search 和 sh_browse 会返回 next_cursor；Shopino 自带的 page 页码会丢失排序顺序，因此此服务不会发送这些页码。
• 用波斯语查询效果最佳（مانتو کتان、کفش ورزشی مردانه）。
• 品牌仅适用于手表商店；不带商店参数的 sh_brands 会列出精选的官方品牌商店。
• 每件商品只显示一张卡片。 有些商店会按颜色为同一 ID 列出多张卡片；此服务会将它们合并。
• **此服务不支持：**登录、购物车、结账、输入折扣码、礼品卡、点赞、到货提醒、收藏商店、退货、工单或上传图片搜索。运费和订单总额也无法获取。
• 请温和使用。 Shopino 的 robots.txt 要求爬虫不要频繁访问搜索页面；此服务会通过随机延迟将并发请求限制为两个，因此请控制 Agent 循环的频率。

常见问题

npx @modelcontextprotocol/inspector uvx shopino-mcp

配置

波斯语

claude mcp add shopino -- uvx shopino-mcp

开发

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 .

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

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

相关服务

• Banimode MCP server，用于时尚和服装
• Khanoumi MCP server，用于化妆品和护肤品价格
• Asal Banoo MCP server，用于护肤、护发和化妆品
• Torob MCP server，用于比较伊朗各商店的价格
• Digikala MCP server，用于伊朗最大的网店
• iran-mcp：伊朗所有服务的 MCP 服务目录

免责声明

本项目为非官方项目，与 Shopino 无关联，也未获得其认可。该服务为只读，并使用 shopino.app 网站的公开接口，这些接口可能随时变更，恕不另行通知。请合理控制请求频率。

作者

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

许可证

MIT

如果这为你省去了点击操作，请点个星，帮助其他人找到它。