Divar

divar-mcp：AI エージェント向け Divar MCP サーバー

AI エージェントにイランのどの都市でも Divar（دیوار）の広告を検索させ、価格が妥当かどうかを判断させましょう。
Divar（イラン最大のクラシファイド広告サイト。住宅、自動車、携帯電話、求人、サービスを掲載）向けの非公式な読み取り専用 MCP サーバーです。
Claude、Cursor、Copilot から広告の検索・閲覧・比較、最安値やお得な広告の検索、価格査定、地図の閲覧ができます。価格の単位はトマンです。

AI エージェント向け · 理由 · できること · クイックスタート · ツール · 仕組み · 知っておくとよいこと · FAQ · 設定 · فارسی · 開発

AI エージェント向け

• 概要： Divar（دیوار、divar.ir。イランのクラシファイド広告サイト）向けの非公式 MCP サーバー（Model Context Protocol）です。ペルシャ語のクエリが最適に機能します。アラビア文字の異体字（ي/ك）は統一されます。
• インストール： uvx divar-mcp または claude mcp add divar -- uvx divar-mcp。トランスポート：stdio。uv（Python 3.10 以降）が必要です。
• 認証： 不要です。API キーもアカウントも必要ありません。DIVAR_MCP_PROXY（HTTP プロキシ URL、またはカンマ区切りのリスト）は任意です。システムのプロキシ設定は無視されます。
• アクセス： Divar への操作は読み取り専用です。ログイン、投稿、チャット、ブックマーク、販売者の電話番号の表示はできないため、ツールを呼び出す前の確認は不要です。書き込みを行うのは dv_watch と dv_price_trend のみで、書き込み先は自分の検索内容を保存するローカルファイルだけです。
• ツール： 31 個すべてが dv_ で始まります。まずは dv_search、dv_post、dv_cheapest、dv_best_for_budget、dv_market を使ってください。
• 一般的な手順： dv_cities / dv_categories -> dv_filters -> dv_search -> dv_post -> dv_similar / dv_appraise / dv_compare。
• その他： リソース divar://cities、divar://categories、divar://category-filters/{slug}、プロンプト compare_ads、best_under_budget、appraise_listing、watch_market。
• 単位： 価格は トマン（Divar 独自の単位。換算は行いません）。売買では price、賃貸では deposit + rent（full_deposit が設定されていて rent が 0 の場合は رهن کامل）。価格がない場合は価格交渉可能です。
• 使用する場面： ユーザーが Divar の広告を探す、価格を確認する、またはモニタリングする場合（購入・賃貸用のアパート、中古車、携帯電話、家具、求人など）、あるいは特定の都市での価格を尋ねる場合。
• 使用しない場面： ユーザーが広告の投稿、販売者へのメッセージ送信、電話番号の取得を希望する場合（Divar ではログインが必要）、または Divar 以外の市場を必要とする場合。
• 出力： コンパクトな JSON 形式の広告カードです。ツール間で token を渡し、next_cursor は cursor として渡してください。
• 機械可読データ： server.json と iran-mcp カタログ（TOOLS.md、servers.json、llms.txt）。

概要

Divar はイランの人々がマンションや車、携帯電話を売買する場所ですが、「ヴァナクで寝室が2つあるマンションの適正価格は？」と調べるには、何十もの広告をスクロールし、偽の価格を見分けなければなりません。divar-mcp を使うと、エージェントが広告を取得し、仮の価格を除外して、提示価格の中央値と四分位数を計算し、それらを大きく下回る広告を教えてくれます。

あなた： ヴァナクで、敷金が10億トマン未満の寝室が2つある賃貸マンションを探してください。

エージェント： 呼び出し dv_parse_query -> dv_best_for_budget -> dv_post

条件に合う広告の中央値を基準に、コストパフォーマンスの高い広告を、それぞれの評価理由とともに一覧表示し、選んだ広告を開きます。

できること

• 広告を検索： カテゴリ、テキスト、近隣地域、価格（賃貸の場合は敷金も）、ブランドとモデル、写真、新しさ、およびカテゴリのその他すべてのフィルターを使って、1つまたは複数の都市の広告を検索できます。重複を除いて複数ページの結果を統合し、カーソルを使って続きを取得できます。
• 広告の詳細を読む： トマン建ての価格、仕様、特徴、説明、すべての画像、地図上の位置、販売者の種類、仮価格の検出
• お買い得商品を見つける： 最安広告（不適切な価格は除外）、コストパフォーマンスの高い広告、予算内で最も条件のよい広告、中央値を大きく下回る価格の広告、違いのみを示す並列比較、類似広告
• 価格を評価： パーセンタイルと信頼度を含む適正価格の査定、地区別および日別の市場統計
• モニタリング： 最後のタイムスタンプを指定して dv_new_since をポーリングし、新しい広告のみを確認できます。保存した検索条件と日ごとの中央値の推移をローカルに保持し、結果を CSV または JSON Lines としてエクスポートできます。
• 地図を利用： GPS 座標やランドマーク周辺の広告を距離付きで表示。近隣地域、隣接地域、境界、地点の住所も確認できます。
• 販売者やディーラーを確認： 販売者の広告数、ビジネスカード、掲載広告

プロンプトの例：

• 「テヘランで最も安い中古の Peugeot 206 を探し、類似広告と比べて適正な価格かどうか教えてください。」
• 「ヴァナク近辺で80億トマン未満の賃貸マンションを探し、上位3件を比較してください。」
• 「今朝以降にマシュハドで掲載された iPhone 15 の広告を見せてください。」
• 「ギーシャで販売中のマンションの1平方メートルあたりの中央値はいくらですか？」
• ارزان‌ترین آپارتمان ۲ خوابه اجاره‌ای در ونک با ودیعه زیر ۱ میلیارد کدام است؟
• قیمت این ماشین نسبت به آگهی‌های مشابه گران است یا ارزان؟
• آگهی‌های جدید گوشی آیفون ۱۵ در مشهد را از امروز صبح نشان بده.

クイックスタート

uv が必要です。API キーやアカウントは不要です。

claude mcp add divar -- uvx divar-mcp

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

{
  "servers": {
    "divar": { "type": "stdio", "command": "uvx", "args": ["divar-mcp"] }
  }
}

codex mcp add divar -- uvx divar-mcp

[mcp_servers.divar]
command = "uvx"
args = ["divar-mcp"]

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

広告カードには、token、title、price（販売価格）、または deposit + rent（rent が 0 で full_deposit の場合は رهن کامل）、info（走行距離、状態など）、district、seller（代理店のラベル）、age_h（最後の掲載更新からの経過時間）、photos、image（サムネイル URL。thumbnails を指定した dv_search のみ）、chat、tag（有料プロモーション）、url、価格が仮の値に見える場合の suspect_price が含まれます。フラグがない場合は false です。デフォルトのページサイズは広告 10～20 件です。

すべてのツール名は dv_ で始まり、読み取り専用と注記されています。ただし dv_watch と dv_price_trend はローカルファイルにのみ書き込みます。

場所とカテゴリを探す

検索と価格

1 件の広告とその販売者

仕組み

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  divar-mcp  (runs on your machine)
      │
      │  HTTPS
      └──────▶  api.divar.ir   ads, categories, places, map

divar-mcp はローカルで動作し、divar.ir のウェブアプリと同じ JSON ゲートウェイを呼び出します。間にホスト型サーバーはなく、API キーも不要です。送信する POST はすべて読み取り専用のクエリです。リクエストは Chrome を偽装するクライアント（TLS/HTTP2 フィンガープリントとヘッダー）経由で送信され、一度に最大 2 件、短いランダムな間隔を空けて実行されます。失敗した呼び出しは最大 2 回まで再試行されます。Divar の一覧レスポンスはウィジェット JSON です。サーバーはこれを簡潔な広告カードに変換し、取得した提示価格からランキングと統計を算出します。

知っておくとよいこと

• 価格の単位はトマンです。 Divar の価格はもともとトマンなので、換算は行われません。価格がない場合は交渉可能（توافقی）を意味し、0 ではありません。賃貸には deposit（ودیعه）と rent（اجاره）があり、full_deposit の場合、rent が 0 なら رهن کامل（全額保証金）です。
• 提示価格です。 表示されるのは販売者が入力した価格であり、取引成立時の価格ではありません。販売者が不適切な値（1,111,111 や、車の価格として入力された保証金など）を入力する場合があります。suspect_price はプレースホルダーを示し、ランキングと統計ではそれらと中央値の 10 分の 1 未満の価格を除外します。
• 州の範囲。 city: "استان مشهد"（または province:مشهد）を指定すると、その都市が属する州全体を検索します。地区や境界を指定するには都市が必要です。
• 並び順。 Divar の API が返すのは新しい順のみです。最初の 1～3 行は、日付が古い有料広告の場合があります。dv_search の sort と価格ツールは、取得した広告を並べ替えます。市場全体の広告を並べ替えるわけではありません。ページ送りには時間カーソルを使います（next_cursor -> cursor）。
• 鮮度。 age_h は最後の掲載順位引き上げ（نردبان）からの経過時間であり、公開からの経過時間ではありません。実際の公開時刻は広告ページにのみ表示されます。
• フィルター。 dv_filters はカテゴリーのキーを一覧表示します。カテゴリーにないフィルターは、暗黙に除外されるのではなく、ignored に報告されます。ウェブ URL のスラッグ（car）と API のスラッグ（light）のどちらも使えます。
• ほとんどの広告の地図上の位置は、約 500 m ぼかされています（approximate_location）。
• 電話番号は取得できません。 Divar ではログインユーザーにのみ表示されます。このサーバーはログインしません。url を使って広告を開いてください。
• 大きな価格。 詳細価格は広告の価格行から取得します。広告内の別の場所にある Divar の生の数値は、大きな値の場合、浮動小数点数への変換で丸められています。
• 利用できない機能： サイト独自の Divar 価格査定、Divar 側での価格順ソート、販売店の広告すべてを対象にしたページ送り、ログインが必要な情報。
• レート制限： テストでは確認されませんでしたが、呼び出しは控えめにしてください。
• ボットチェック： Divar がチャレンジページを表示するようになった場合は、divar-mcp[browser] をインストールして patchright install chromium を実行してください。その後、サーバーがヘッドレスブラウザーを使って一度だけチャレンジをクリアします。これがない場合、呼び出しはその旨を示すメッセージとともに失敗します。

FAQ

npx @modelcontextprotocol/inspector uvx divar-mcp

設定

ペルシャ語：Divar MCP サーバー

claude mcp add divar -- uvx divar-mcp

開発

git clone https://github.com/sepehr071/divar-mcp && cd divar-mcp
uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q            # offline, recorded fixtures
uv run python -m pytest -m live -q    # real API, one test per tool
uv build

ツールは src/divar_mcp/（places.py、catalog.py、search.py、post.py、market.py、watch.py、meta.py）にあります。それぞれ型付けされた非同期関数で、エージェントがいつ使用すべきかを説明する docstring が付いています。Issue や PR を歓迎します。

リリースするには、pyproject.toml と server.json のバージョンを更新し、v* タグをプッシュします。GitHub Actions が PyPI に公開します。

関連サーバー

• iran-mcp：イランのサービス向け MCP サーバーの一覧
• digikala-mcp：Digikala の商品と価格向け
• torob-mcp：Torob 上のイランのショップ間で価格を比較するためのサーバー
• snapp-mcp：Snapp 向け
• technolife-mcp：Technolife の電子機器向け
• jabama-mcp：Jabama の宿泊施設向け

免責事項

非公式のものであり、Divar との提携や承認を受けていません。divar.ir ウェブアプリのエンドポイントを通じて公開データを読み取りますが、予告なく変更される場合があります。返される情報はすべて販売者が入力した希望価格であり、助言ではありません。リクエスト頻度は低く抑えてください。

クリックの手間が省けた場合は、スターを付けていただけると、ほかの人にも見つけてもらいやすくなります。

作者

Sepehr Radmard（سپهر رادمرد）が開発・保守しています。LinkedInでつながるか、GitHub の @sepehr071をフォローして、イランのウェブサイト向けのほかの MCP サーバーをご覧ください。すべてiran-mcpに掲載されています。時間の節約になった場合は、リポジトリにスターを付けていただけると、ほかの人にも見つけてもらいやすくなります。

ライセンス

MIT