zameen-mcp

MCP-Server zur Recherche von Immobilienangeboten auf Zameen.com

Verifizierte / Titanium-Agenten-Filterung · lokale Beobachtungslisten · Angebotsdetails · Entwurf von Agentennachrichten – über 9 strukturierte Tools in jedem MCP-Client.

Ein MCP-Server (Model Context Protocol) zur Recherche von Immobilienangeboten auf Zameen.com – dem größten Immobilienportal Pakistans – über strukturierte Tools statt fragiler Screen-Scraping-Methoden.

Hinweis zu Markenrechten: „Zameen“ und das Zameen.com-Logo sind Marken von Zameen.com (EMPG). Sie werden hier ausschließlich zur Identifizierung des Dienstes verwendet, mit dem dieses Tool interagiert. Dieses Projekt ist weder mit Zameen.com verbunden noch von ihm unterstützt.

Funktioniert mit jedem MCP-Client: Claude Desktop, Hermes Agent, Cursor und anderen.

Installation

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

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

In Ihrem MCP-Client registrieren

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

Das war's – 9 Tools erscheinen in Ihrem KI-Client.

Related MCP server: Zillow MCP Server

Tools

Badge-Filter, die Zameens eigene Oberfläche nicht kann: verified_only, agent_tier (z. B. "titanium"), exclude_promoted.

Vollständige Parameterreferenz + Spickzettel in natürlicher Sprache: docs/TOOLS.md

Optional: Bei Ihrem Zameen-Konto anmelden

Anonymes Suchen funktioniert sofort. Um auch Ihre angemeldete Sitzung zu nutzen (gespeicherte Suchen, personalisierte Seiten):

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

Ihr Passwort wird von dieser Software nie gesehen oder gespeichert – nur die resultierenden Sitzungscookies, die in ~/.zameen-mcp/ auf Ihrem Rechner liegen. Jederzeit löschen: zameen-mcp-login --logout.

Datenablage

Der gesamte Zustand liegt in ~/.zameen-mcp/ (watches.json, session_state.json, chrome-profile/). Überschreiben Sie dies mit der Umgebungsvariable ZAMEEN_MCP_HOME. Behandeln Sie session_state.json wie ein Passwort: Es gewährt Zugriff auf Ihr Konto, solange es gültig ist.

Entwicklung

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

Compliance & faire Nutzung

• Zameen.coms robots.txt verbietet das Crawlen seiner Listenseiten für Großstädte. Dieser Server ist für interaktive, menschengemäße Recherche gedacht – eine Person, die ihrem Assistenten Fragen stellt – nicht für Massenabruf oder Weiterverbreitung.

• Anfragen werden einzeln mit browserähnlichen Headern gesendet. Entfernen Sie nicht die Taktung oder lassen Sie Schleifen unbeaufsichtigt laufen.

• Listendaten gehören Zameen.com und seinen Werbetreibenden; „Zameen“ ist eine Marke von Zameen.com. Dieses Projekt ist unabhängig und nicht unterstützt.

• Preise sind vom Agenten eingegeben, wie gelistet – keine verifizierten Marktbewertungen.

Einschränkungen

• Von Natur aus schreibgeschützt: kein Posten, Nachrichten oder Kontoänderungen – die Kontaktaufnahme mit Agenten ist bewusst eine menschliche Handlung (draft_agent_message erstellt nur Entwürfe).

• Badge-Filter arbeiten auf abgerufenen Ergebniseiten (maximal 3 pro Aufruf).

• Das Parsing zielt auf Zameens aktuelles HTML; Website-Redesigns können Parser-Updates erfordern (Fixtures machen Regressionen leicht erkennbar).

MIT-lizenziert – siehe LICENSE.