zameen-mcp

用于在 Zameen.com 上研究房产列表的 MCP 服务器

已验证 / 钛金经纪人筛选 · 本地监视列表 · 房源详情 · 经纪人消息草稿 —— 通过任意 MCP 客户端中的 9 个结构化工具实现。

一个用于在 Zameen.com 上研究房产列表的 MCP（Model Context Protocol）服务器——巴基斯坦最大的房地产门户网站——通过结构化工具而非脆弱的屏幕抓取来实现。

商标声明： "Zameen" 和 Zameen.com 徽标是 Zameen.com (EMPG) 的商标。此处使用它们仅用于标识此工具所对接的服务。本项目与 Zameen.com 无关联，也未获得其认可。

适用于任何 MCP 客户端：Claude Desktop、Hermes Agent、Cursor 等。

安装

# run directly with no permanent install (recommended)
uvx zameen-mcp

# or install as an isolated CLI tool
pipx install zameen-mcp

在您的 MCP 客户端中注册

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

就这样——您的 AI 客户端中会出现 9 个工具。

Related MCP server: Zillow MCP Server

工具

Zameen 自身界面无法实现的徽章级筛选：verified_only、agent_tier（例如 "titanium"）、exclude_promoted。

完整参数参考 + 自然语言速查表：docs/TOOLS.md

可选：登录您的 Zameen 账户

匿名搜索开箱即用。若要同时使用您已登录的会话（已保存的搜索、个性化页面）：

pipx inject zameen-mcp playwright && .venv/bin/playwright install chromium   # pipx
uv tool install zameen-mcp --with playwright && playwright install chromium  # uv

zameen-mcp-login   # opens a Chromium window; YOU log in; cookies stay local

您的密码绝不会被此软件查看或存储——仅保留生成的会话 cookie，存放在您机器上的 ~/.zameen-mcp/ 中。随时清除：zameen-mcp-login --logout。

数据位置

所有状态都保存在 ~/.zameen-mcp/ 中（watches.json、session_state.json、chrome-profile/）。可通过 ZAMEEN_MCP_HOME 环境变量覆盖。请将 session_state.json 视为密码：它在有效期内可访问您的账户。

开发

git clone <repo-url> && cd zameen.com
uv venv .venv && uv pip install -p .venv/Scripts/python.exe -e ".[dev]"
.venv/Scripts/python.exe -m pytest -q          # offline suite against real captured pages
.venv/Scripts/python.exe smoke_test.py         # live end-to-end check

合规与合理使用

• Zameen.com 的 robots.txt 禁止爬取其主要城市的列表页面。此服务器专为交互式、人工节奏的研究而构建——即用户向其助手提问——而非批量采集或再分发。

• 请求以浏览器风格的标头逐个发出。请勿移除节奏控制或无人值守地循环搜索。

• 列表数据归 Zameen.com 及其广告商所有；"Zameen" 是 Zameen.com 的商标。本项目无关联且未获认可。

• 价格由经纪人按原样录入——并非经过验证的市场估值。

限制

• 设计上为只读：不支持发布、消息或账户更改——联系经纪人是刻意保留的人工操作（draft_agent_message 仅生成草稿）。

• 徽章筛选作用于获取的结果页面（每次调用最多 3 页）。

• 解析针对 Zameen 当前的 HTML；网站改版可能需要更新解析器（测试夹具使回归问题易于发现）。

MIT 许可——参见 LICENSE。