Divar

divar-mcp：面向 AI Agent 的 Divar MCP 服务

让你的 AI Agent 在伊朗任意城市搜索 Divar（دیوار）上的广告，并判断价格是否合理。
一个非官方、只读的 MCP 服务，适用于 Divar——伊朗最大的分类信息网站（房屋、汽车、手机、工作、服务）。
通过 Claude、Cursor 或 Copilot 搜索、查看广告、比较价格、查找最便宜和性价比最高的广告、评估价格并浏览地图。价格单位为 Toman。

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

面向 AI Agent

• 是什么： 面向 Divar（دیوار，divar.ir）的非官方 MCP 服务（模型上下文协议）。使用波斯语查询效果最佳；阿拉伯字母变体（ي/ك）会统一处理。
• 安装： uvx divar-mcp 或 claude mcp add divar -- uvx divar-mcp。传输方式：stdio。需要 uv（Python 3.10+）。
• 身份验证： 无需 API 密钥或账户。可选配置 DIVAR_MCP_PROXY（HTTP 代理 URL 或逗号分隔的列表）；系统代理设置会被忽略。
• 访问权限： 对 Divar 仅有只读权限。它无法登录、发布广告、聊天、收藏广告或查看卖家的电话号码，因此调用工具前无需确认。只有 dv_watch 和 dv_price_trend 会写入数据，且仅写入你自己的搜索记录所在的本地文件。
• 工具： 共 31 个，名称均以 dv_ 开头。建议从 dv_search、dv_post、dv_cheapest、dv_best_for_budget、dv_market 开始。
• 典型流程： dv_cities / dv_categories -> dv_filters -> dv_search -> dv_post -> dv_similar / dv_appraise / dv_compare。
• 此外： 资源 divar://cities、divar://categories、divar://category-filters/{slug}；提示词 compare_ads、best_under_budget、appraise_listing、watch_market。
• 单位： 价格单位为 Toman（Divar 自身使用的单位，不进行换算）。出售房源使用 price；出租房源使用 deposit + rent（当 full_deposit 为 رهن کامل 时，rent 为 0）；没有价格表示可议价。
• 适用场景： 用户想查找、核对价格或监控 Divar 上的广告（待售或出租的公寓、二手车、手机、家具、工作等），或询问某个城市的物品价格。
• 不适用场景： 用户想发布广告、联系卖家或获取电话号码（这些操作在 Divar 上需要登录），或需要查询 Divar 以外的市场。
• 输出： 紧凑的 JSON 广告卡片。在工具间传递 token，并将 next_cursor 作为 cursor 传回。
• 机器可读信息： server.json 和 iran-mcp 目录（TOOLS.md、servers.json、llms.txt）。

为什么选择它

Divar 是伊朗人买卖公寓、汽车和手机的平台，但要回答“瓦纳克一套两居室公寓的合理价格是多少？”，就得翻看几十条广告，还要排除虚假价格。使用 divar-mcp，Agent 会获取广告、剔除占位价格、计算标价的中位数和四分位数，并告诉你哪些广告的价格远低于这些数值。

你： 找一套瓦纳克最划算的两居室出租公寓，押金低于 10 亿 Toman。

Agent： 调用 dv_parse_query -> dv_best_for_budget -> dv_post

它会根据符合条件的广告中位数，列出性价比最高的广告并说明每项评分的原因，然后打开你选中的广告。

功能

• 搜索：按类别、文本、街区、价格（租房还可按押金）、品牌和型号、照片、新鲜度以及类别中的其他筛选条件，在一个或多个城市搜索广告；合并多个页面并去除重复项；使用游标继续浏览
• 读取完整广告： 价格（单位为 Toman）、规格、功能、描述、所有图片、地图位置、卖家类型、占位价格检测
• 寻找划算选择： 最便宜的广告（跳过垃圾价格）、性价比最高和预算内最多的广告、价格远低于中位数的广告、仅显示差异的并排比较、类似广告
• 判断价格： 提供百分位数和置信度的合理价格评估，按区域和日期统计市场数据
• 监控： 使用上次的时间戳轮询 dv_new_since，只查看新广告；在本地保存搜索条件和每日中位数价格趋势；将结果导出为 CSV 或 JSON 行
• 使用地图： 查找 GPS 点或地标周边的广告并显示距离；查询街区、相邻街区、边界和某个点的地址
• 查看卖家和经销商： 查看卖家的广告数量、名片及其广告

示例提示词：

• “找出德黑兰最便宜的二手 Peugeot 206，并判断与类似广告相比价格是否合理。”
• “找出瓦纳克附近 80 亿 Toman 以下的出租公寓，并比较排名前三的广告。”
• “显示今天早上以来马什哈德发布的 iPhone 15 新广告。”
• “吉沙待售公寓的每平方米中位价是多少？”
• ارزان‌ترین آپارتمان ۲ خوابه اجاره‌ای در ونک با ودیعه زیر ۱ میلیارد کدام است؟
• قیمت این ماشین نسبت به آگهی‌های مشابه گران است یا ارزان؟
• آگهی‌های جدید گوشی آیفون ۱۵ در مشهد را از امروز صبح نشان بده.

快速开始

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

claude mcp add divar -- uvx divar-mcp

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

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

codex mcp add divar -- uvx divar-mcp

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

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

一张广告卡片包含 token、title、price（售价）或 deposit + rent（当 rent 为 0 且有 full_deposit 时表示 رهن کامل）、info（里程、状况等）、district、seller（中介标签）、age_h（距上次刷新已过的小时数）、photos、image（缩略图 URL，仅来自带有 thumbnails 的 dv_search）、chat、tag（付费推广）、url，以及价格看起来像占位值时的 suspect_price。未出现的标志表示为 false。默认每页显示 10 到 20 条广告。

除 dv_watch 和 dv_price_trend 仅写入本地文件外，所有工具名称均以 dv_ 开头，并标注为只读。

查找地点和类别

搜索和价格

一条广告及其卖家

工作原理

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  divar-mcp  (runs on your machine)
      │
      │  HTTPS
      └──────▶  api.divar.ir   ads, categories, places, map

divar-mcp 在本地运行，并调用 divar.ir Web 应用使用的同一 JSON 网关。它不经过中间托管服务，也不需要 API 密钥。它发送的每个 POST 都是只读查询。请求通过模拟 Chrome 的客户端发出（TLS/HTTP2 指纹和请求头），同时最多发送 2 个请求，并加入短暂的随机延迟；失败的调用最多重试两次。Divar 的列表响应是 widget JSON；服务会将其转换为精简的广告卡片，并根据获取到的要价计算排名和统计数据。

须知

• 价格单位为 Toman。 Divar 上的价格本来就是 Toman，不会进行转换。缺少价格表示可议价（توافقی），绝不表示 0。租赁房源包含 deposit（ودیعه）和 rent（اجاره）；rent 为 0 且带有 full_deposit 时，表示 رهن کامل。
• 要价。 所有价格都是卖家填写的，并非最终成交价。有些卖家会填写无效价格（如 1,111,111，或把押金填成汽车价格）：suspect_price 会标记此类占位价格；排名和统计会跳过这些价格，以及低于中位数十分之一的价格。
• 省级范围。 city: "استان مشهد"（或 province:مشهد）会搜索该城市所在的整个省份；搜索区域和边界时必须指定城市。
• 排序。 Divar 的 API 仅按最新时间返回结果；最前面的 1-3 条可能是付费推广，日期较早。dv_search 的 sort 和价格工具只会对本次调用获取的广告排序，而非整个市场的广告。分页使用时间游标（next_cursor -> cursor）。
• 时效性。 age_h 表示距上次刷新（نردبان）的时间，而非距发布时间的时间；只有广告页面才显示实际发布时间。
• 筛选条件。 dv_filters 会列出某个类别的筛选键；类别不支持的筛选条件会列在 ignored 中，不会被静默丢弃。Web URL 中使用的 slug（car）和 API 中使用的 slug（light）都可用。
• 地图位置：大多数广告的位置会被模糊处理约 500 m（approximate_location）。
• 不提供电话号码。 Divar 仅向已登录用户显示电话号码；此服务不会登录。使用 url 打开广告。
• 大额价格。 详情页价格取自广告的价格行；广告其他位置的 Divar 原始数值在数值较大时会因浮点数舍入而失真。
• 不可用功能： Divar 网站本身的价格估值、在 Divar 端按价格排序、翻阅某个商家的全部广告，以及任何需要登录才能访问的内容。
• 速率限制： 测试时未发现速率限制，但请适度调用。
• 机器人检查： 如果 Divar 提供了验证页面，请安装 divar-mcp[browser] 并运行 patchright install chromium；之后服务会通过无头浏览器处理一次验证。未安装时，调用会失败并返回相应提示。

常见问题

npx @modelcontextprotocol/inspector uvx divar-mcp

配置

波斯语：Divar MCP 服务

claude mcp add divar -- uvx divar-mcp

开发

git clone https://github.com/sepehr071/divar-mcp && cd divar-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, one test per tool
uv build

工具位于 src/divar_mcp/（places.py、catalog.py、search.py、post.py、market.py、watch.py、meta.py）；每个工具都是带有类型注解的异步函数，并附有说明何时使用它的文档字符串。欢迎提交问题和 PR。

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

相关服务

• iran-mcp：伊朗服务 MCP 服务目录
• digikala-mcp：提供 Digikala 商品和价格信息
• torob-mcp：比较 Torob 上伊朗商店的商品价格
• snapp-mcp：提供 Snapp 服务
• technolife-mcp：提供 Technolife 电子产品信息
• jabama-mcp：提供 Jabama 住宿信息

免责声明

本项目为非官方项目，与 Divar 无关联，也未获得 Divar 认可。它通过 divar.ir Web 应用的接口读取公开数据，这些接口可能随时更改，恕不另行通知。它返回的所有内容都是卖家填写的要价，不构成建议。请保持较低的请求频率。

如果这个项目帮您减少了点击操作，点个星标可以帮助其他人发现它。

作者

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

许可证

MIT