zameen-mcp

Servidor MCP para investigar listados de propiedades en Zameen.com

Filtrado verificado / agente Titanium · listas de seguimiento locales · detalles de listados · redacción de mensajes a agentes — mediante 9 herramientas estructuradas en cualquier cliente MCP.

Un servidor MCP (Model Context Protocol) para investigar listados de propiedades en Zameen.com — el portal inmobiliario más grande de Pakistán — mediante herramientas estructuradas en lugar de un frágil raspado de pantalla.

Aviso de marca registrada: "Zameen" y el logotipo de Zameen.com son marcas registradas de Zameen.com (EMPG). Se utilizan aquí únicamente para identificar el servicio con el que esta herramienta interactúa. Este proyecto no está afiliado ni respaldado por Zameen.com.

Funciona con cualquier cliente MCP: Claude Desktop, Hermes Agent, Cursor y otros.

Instalación

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

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

Regístralo en tu cliente MCP

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

Eso es todo: aparecen 9 herramientas en tu cliente de IA.

Related MCP server: Zillow MCP Server

Herramientas

Filtrado a nivel de insignia que la propia interfaz de Zameen no puede hacer: verified_only, agent_tier (p. ej. "titanium"), exclude_promoted.

Referencia completa de parámetros + hoja de trucos en lenguaje natural: docs/TOOLS.md

Opcional: inicia sesión en tu cuenta de Zameen

La búsqueda anónima funciona de inmediato. Para también usar tu sesión iniciada (búsquedas guardadas, páginas personalizadas):

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

Tu contraseña nunca es vista ni almacenada por este software — solo las cookies de sesión resultantes, guardadas en ~/.zameen-mcp/ en tu máquina. Bórralas en cualquier momento: zameen-mcp-login --logout.

Ubicación de los datos

Todo el estado reside en ~/.zameen-mcp/ (watches.json, session_state.json, chrome-profile/). Sobrescríbelo con la variable de entorno ZAMEEN_MCP_HOME. Trata session_state.json como una contraseña: otorga acceso a tu cuenta mientras sea válido.

Desarrollo

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

Cumplimiento y uso justo

• El robots.txt de Zameen.com prohíbe rastrear sus páginas de listados en las principales ciudades. Este servidor está diseñado para investigación interactiva, a ritmo humano — una persona haciendo preguntas a su asistente — no para recolección masiva ni redistribución.

• Las solicitudes se envían de una en una con cabeceras similares a las de un navegador. No elimines el ritmo ni ejecutes bucles de búsqueda sin supervisión.

• Los datos de los listados pertenecen a Zameen.com y sus anunciantes; "Zameen" es una marca registrada de Zameen.com. Este proyecto no está afiliado ni respaldado.

• Los precios son ingresados por los agentes, tal como se publican — no son valoraciones de mercado verificadas.

Limitaciones

• Solo lectura por diseño: sin publicaciones, mensajes ni cambios de cuenta — contactar a los agentes es deliberadamente una acción humana (draft_agent_message solo redacta).

• Los filtros de insignia operan sobre las páginas de resultados obtenidas (hasta 3 por llamada).

• El análisis se dirige al HTML actual de Zameen; los rediseños del sitio pueden requerir actualizaciones del analizador (los fixtures facilitan detectar regresiones).

Licencia MIT — ver LICENSE.