zameen-mcp

MCP-сервер для исследования объявлений о недвижимости на Zameen.com

Фильтрация «Проверено» / титановые агенты · локальные списки наблюдения · детали объявлений · составление сообщений агентам — через 9 структурированных инструментов в любом MCP-клиенте.

MCP-сервер (Model Context Protocol) для исследования объявлений о недвижимости на Zameen.com — крупнейшем портале недвижимости Пакистана — через структурированные инструменты вместо хрупкого скрейпинга страниц.

Уведомление о товарном знаке: «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

Соответствие требованиям и добросовестное использование

• Файл robots.txt сайта Zameen.com запрещает сканирование страниц объявлений в крупных городах. Этот сервер предназначен для интерактивного исследования в человеческом темпе — человек задаёт вопросы своему ассистенту, — а не для массового сбора или распространения данных.

• Запросы отправляются по одному с заголовками, имитирующими браузер. Не убирайте паузы между запросами и не запускайте циклы поиска без присмотра.

• Данные объявлений принадлежат Zameen.com и его рекламодателям; «Zameen» является товарным знаком Zameen.com. Этот проект не связан с ним и не одобрен им.

• Цены вводятся агентами и приводятся как есть — это не проверенные рыночные оценки.

Ограничения

• Только чтение по замыслу: никаких публикаций, сообщений или изменений аккаунта — связь с агентами намеренно является действием человека (draft_agent_message только составляет черновик).

• Фильтры по бейджам работают по загруженным страницам результатов (до 3 за вызов).

• Парсинг нацелен на текущий HTML Zameen; редизайны сайта могут потребовать обновления парсера (фикстуры упрощают обнаружение регрессий).

Лицензия MIT — см. LICENSE.