zameen-mcp

Zameen.com 부동산 매물 조사를 위한 MCP 서버

인증됨 / Titanium 에이전트 필터링 · 로컬 관심 목록 · 매물 상세 정보 · 에이전트 메시지 초안 작성 — 모든 MCP 클라이언트에서 9개의 구조화된 도구로 제공.

Zameen.com — 파키스탄 최대 부동산 포털 — 의 매물을 취약한 화면 스크래핑 대신 구조화된 도구를 통해 조사하기 위한 MCP(Model Context Protocol) 서버입니다.

상표 고지: "Zameen" 및 Zameen.com 로고는 Zameen.com(EMPG)의 상표입니다. 이는 이 도구가 연동하는 서비스를 식별하기 위한 목적으로만 사용됩니다. 이 프로젝트는 Zameen.com과 제휴 관계가 없으며 Zameen.com의 보증을 받지 않습니다.

Claude Desktop, Hermes Agent, Cursor 등 모든 MCP 클라이언트에서 작동합니다.

설치

# 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.com 자체 UI로는 할 수 없는 배지 수준 필터링: 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

비밀번호는 이 소프트웨어에 의해 절대 노출되거나 저장되지 않습니다 — 결과로 생성된 세션 쿠키만 본인 기기의 ~/.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 참조.