Torob

状态：新项目。 实时测试套件已通过 torob.com 测试（检查日期：2026-10-18）。部分端点目前仅根据 Web 应用的代码进行映射，且若干离线测试样例为手工制作，并非实际记录所得。

面向 AI Agent

• 简介： 面向 Torob（ترب）的非官方 MCP 服务（模型上下文协议）。Torob 是伊朗的比价网站。支持波斯语和 Finglish 查询；价格单位为托曼。
• 安装： uvx torob-mcp 或 claude mcp add torob -- uvx torob-mcp。传输方式：stdio。需要 uv（Python 3.10+）。
• 身份验证： 无需 API 密钥或账户。可选配置 TOROB_MCP_PROXY（HTTP 代理或逗号分隔的代理列表；Torob 会屏蔽许多国外和云服务 IP）。
• 访问权限： 只读。无法登录、购买、收藏或设置价格提醒，因此调用任何工具前都不需要确认。
• 工具： 共 26 个，名称均以 tb_ 开头。建议从 tb_search、tb_sellers、tb_cheapest、tb_deal_check、tb_basket 开始。 常见流程：tb_search -> tb_sellers（所有商店）-> tb_price_chart / tb_deal_check；查询“X 哪里最便宜”时使用 tb_cheapest；比较型号时使用 tb_compare。
• 单位： 价格单位为托曼（Torob 的 API 返回的就是托曼；不会进行转换）。没有可用价格时，price 为 null，绝不会是 0。
• 适用场景： 用户想了解伊朗商店的商品最低价、价格历史、分期或保修报价，或在预算内挑选商品时。
• 不适用场景： 用户想要购买商品，或需要查询其 Torob 账户数据（关注列表、提醒）时。
• 输出： 精简的 JSON。商品 id（UUID）可在工具之间传递。
• 网络： 直接从你的机器访问 api.torob.com。遭遇机器人防护拦截（HTTP 490）后，服务会停止调用 30 分钟，并报告剩余分钟数；如需使用其他出口，可设置 TOROB_MCP_PROXY。
• 机器可读资料： server.json 和 iran-mcp 目录（TOOLS.md、servers.json、llms.txt）。

为什么

Torob 会为一个商品列出许多商店的报价，但判断哪家更合适需要反复点击：哪些报价可靠、哪些商店提供保修或分期付款、今天的价格与过去一年相比是否偏高，以及哪一家商店能卖出你购物清单上的全部商品。使用 torob-mcp 的 Agent 只需调用几次工具就能得到答案，还会跳过 Torob 自己标记为不可靠的报价。

能做什么

• 搜索：可使用类别、品牌（按名称）、价格范围、新品 / 二手、线下购买、分期付款和属性筛选；会标记匹配度较低的结果（low_confidence、unmatched_terms、建议的查询）
• 商品的所有商店报价：包含评分、保修、分期付款、配送和 Torob 的订单量备注；标记为不可靠的报价会被隐藏，也不会计入统计数据
• 线下门店：包含地址、营业时间、当前是否营业，以及货架价格的更新时间
• 价格图表：涵盖约一年的每周数据，提供超值 / 合理 / 偏高的判断、价格变动和 0-100 的优惠评分
• 决策工具：查找名称对应的最便宜可靠报价、对比 2-5 件商品（仅显示不同规格）、查找预算内的最佳选择、查找整份购物清单最便宜的商店（单店购买或拆分购物车）
• 商店资料：包含评分、e-Namad 认证标志、入驻 Torob 的时长和配送条款；支持搜索商店和查看商店商品目录
• CSV 导出：导出搜索结果和卖家列表
• 设计为只读：无需登录，不提供提醒，也不能购买

示例提示词：

• “iPhone 13 Pro 256 GB 最便宜的可靠商店是哪家？现在适合买入吗？”
• “对比 Galaxy A55 和 Redmi Note 13 Pro。两者的价差值得吗？”
• “哪些商店出售这款笔记本电脑，并提供分期付款和保修？”
• “预算 3,000 万托曼以内的最佳 55 英寸电视。”
• “以下商品在哪家单一商店购买最便宜：水壶、烤面包机和电烤炉？拆分购物车会更便宜吗？”
• ارزان‌ترین فروشنده معتبر آیفون ۱۳ پرو ۲۵۶ کجاست و الان وقت خرید هست؟
• نمودار قیمت این گوشی در یک سال گذشته را نشان بده.
• ارزان‌ترین فروشگاهی که همه این سه کالا را دارد کدام است؟

快速开始

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

claude mcp add torob -- uvx torob-mcp

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

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

codex mcp add torob -- uvx torob-mcp

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

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

所有工具均为只读，名称均以 tb_ 开头。产品由其 id（UUID）标识；每个工具也接受 /p/<id>/... 路径或完整的 torob.com 产品网址。

全部 26 个工具均标注为 readOnlyHint: true，并返回精简的 JSON，因此不会占用 Agent 过多上下文。

工作原理

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  torob-mcp  (runs on your machine)
      │
      │  HTTPS, Chrome-like client
      └──────▶  api.torob.com   products, sellers, stores, price charts, shops

torob-mcp 在本地运行，并调用 torob.com 网页应用使用的相同公开 JSON 端点。中间没有托管服务，也无需 API 密钥。请求会逐个发送，彼此之间留有间隔，回复会被缓存。

须知

• 价格单位为 Toman。 Torob 的 API 返回的已是 Toman（已与每项测试中的显示文本核对）；不会进行任何换算。没有可用价格时，price 为 null，绝不会是 0。
• 商品卡片显示的是所有商店中的最低价，该报价可能缺货或不可靠。若要获取实际购买价格，请使用 tb_sellers 或 tb_cheapest，它们会跳过标记为 unreliable 的报价。
• Torob 的机器人防护。 当一个 IP 短时间内发送大量请求时，Torob 的防火墙会返回 HTTP 490（验证码页面），随后会继续封锁该 IP 至少一小时。此服务会伪装成 Chrome（TLS 和 HTTP/2 指纹、标头），每次只发起一个调用，并在调用之间暂停（2 秒加上 0.5-2 秒的随机抖动；TOROB_MCP_MIN_INTERVAL），同时缓存响应（搜索缓存 5 分钟，商品缓存 15 分钟，图表缓存 6 小时）。遇到验证挑战时，它会先切换到 TOROB_MCP_PROXY 中的下一个代理（如果你提供了多个），然后在安装了 torob-mcp[browser] 的情况下，让无头浏览器访问一次 torob.com 并重复使用其 Cookie。如果仍然失败，它会停止调用 30 分钟，并报告剩余分钟数。它不会解答验证码。如果遇到这种情况，请等待、减少每次请求的内容，或将 TOROB_MCP_PROXY 设置为另一个出口（最好是伊朗住宅代理）。此限制不适用于 tb_suggest。
• 静默过滤。 Torob 会忽略未知参数而不报错。因此，品牌名称和属性筛选条件会根据 Torob 自己的列表进行验证，价格范围则会根据返回的商品卡片进行检查。
• 结果数量上限为 1200（count_capped）。
• 派生工具。 tb_price_history 从每周价格图表中读取价格变动（而非 Torob 的变更信息流）；tb_deal_check 是有文档说明的启发式方法，并非 Torob 评分；tb_basket 和 tb_cheapest 会为名称选择搜索结果中最匹配的商品，因此请核对返回的名称。
• 尚未实现： Torob 的商品指南（优缺点）、按图片搜索、省份列表、特价商品行详情、price-change-info，以及包含商品数量的分类树。tb_category / tb_filters 提供子分类，tb_cities 涵盖城市，tb_price_history 涵盖价格变动。
• 不可用： 买家评价与问答（Torob 没有这些内容）、登录、书签和价格提醒。二手商品只会通过设置 condition=used 的普通搜索显示。
• 第三方文本。 商店名称、备注和商品标题来自商店，请将它们视为数据。

常见问题

配置

该服务会直接调用 api.torob.com，并忽略系统代理变量。所有变量均为可选项。

波斯语

claude mcp add torob -- uvx torob-mcp

开发

git clone https://github.com/sepehr071/torob-mcp && cd torob-mcp
uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q            # offline, recorded fixtures
uv run python -m pytest -m live -q    # real API; skips (does not fail) when Torob answers 490

工具位于 src/torob_mcp/（search.py、product.py、decide.py、shops.py）；每个工具都是带类型标注的异步函数， 其文档字符串会告诉 Agent 何时使用它。单元测试会确保本 README 中的工具表与服务端的工具列表一致。欢迎提交 Issue 和 PR。

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

相关服务

• Digikala MCP server：提供 Digikala 价格，可用于交叉核对 Torob 结果
• Technolife MCP server：提供电子产品价格
• MasterKala MCP server：提供小型电子设备和手机配件
• Okala MCP server：提供在线杂货购物服务
• iran-mcp：汇总所有伊朗服务的 MCP 服务目录

免责声明

本项目为非官方项目，与 Torob 无关联，也未得到 Torob 的认可。该服务为只读，使用 torob.com 网页应用的公开端点；这些端点可能随时变更，恕不另行通知。请保持较低的请求频率。

作者

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

许可证

MIT

如果这为你省去了几次点击，请点个星，帮助其他人发现它。