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 は主要都市のリスティングページのクロールを禁止しています。 このサーバーは対話的で人間のペースに合わせた調査 — ユーザーがアシスタントに質問する形 — のために構築されており、 一括取得や再配布を目的としていません。

• リクエストはブラウザ風のヘッダーで一度に 1 件ずつ送信されます。ペーシングを削除したり、 無人で検索をループさせたりしないでください。

• リスティングデータは Zameen.com およびその広告主に帰属します。「Zameen」は Zameen.com の商標です。本プロジェクトは無関係であり、承認を受けていません。

• 価格はエージェントが入力した掲載時点のものであり、検証済みの市場評価ではありません。

制限事項

• 設計上読み取り専用: 投稿、メッセージ送信、アカウント変更はできません — エージェントへの連絡は 意図的に人間のアクションとなっています (draft_agent_message は下書きのみ)。

• バッジフィルターは取得した結果ページ (呼び出しあたり最大 3 ページ) に対して動作します。

• パーサーは Zameen の現在の HTML を対象としています。サイトのリニューアルによりパーサーの更新が 必要になる場合があります (フィクスチャにより回帰を簡単に検出できます)。

MIT ライセンス — LICENSE を参照。