deweloperuch.pl (unofficial)

deweloperuch-mcp

ウェブサイト · ポーランド語のドキュメント（視覚的なインストールガイド付き）

ポーランドの新築マンションについて、販売価格とその履歴、実際の取引価格、公式統計を AI アシスタントに質問できます。

deweloperuch.pl の公開データを利用する、非公式の MCP サーバー兼コマンドラインツールです。デベロッパーの販売価格（価格履歴付き）、不動産価格登録簿（RCN）の取引価格、GUS および NBP の統計を扱います。読み取り専用ツールが 13 個あり、Claude Desktop や Claude Code などの MCP クライアントから、または deweloperuch CLI から利用できます。

免責事項。 本プロジェクトは独立したプロジェクトです。deweloperuch.pl、GUS、NBP、または登録簿の発行元との提携、承認、スポンサー関係はありません。deweloperuch.pl の運営者は、本プロジェクトによる同サービスの利用に同意しています。クライアントは deweloperuch-mcp/<version> として識別され、このリポジトリへのリンクを示します。

• 読み取り専用です。サービス上で何かを作成したり変更したりすることはありません。
• サービスに配慮したクライアントです。リクエストは最大で毎秒 1 件、同時に 1 件までで、マシン上のすべてのプロセスで共有されます。レスポンスはキャッシュされます。401、403、429、または CAPTCHA／WAF のチャレンジを受けると、ロックを手動で解除するまでリクエストの送信を停止します。
• サービスを大切に利用してください。 運営しているのは他の人たちです。質問は絞り込み、このツールを使ったループ処理や一括ダウンロードは行わないでください。
• データの正確性は保証されません。価格は販売価格または登録価格であり、査定や助言ではありません。
• サービスの利用規約を含め、ツールとデータの利用方法はご自身の責任となります。

質問できること

• マンションの購入：「クラクフのポドグジェ地区で、面積 40～55 m²、価格 800 000 PLN 以下のマンションを探して。1 m² あたりの価格が安い順にして。」（サービスでは部屋数で絞り込めません。代わりに面積で絞り込んでください。）
• 物件価格の判断：「この物件はお買い得ですか？価格履歴、過去 30 日間と 90 日間の最低価格、値下げが不審に見えるかどうかを示してください。」
• デベロッパーの確認：「このデベロッパーは何を建設していますか？どの都市で何件の物件が販売中ですか？」
• 市場価格と取引価格：「グダニスクの販売価格は、過去数四半期の登録取引価格と比べてどうですか？」
• 価格査定：「近隣の取引をもとに、この住所にある 55 m² のマンションの価値を大まかに教えてください。」
• 都市の比較：「取引価格を 1 m² あたりで都市別に順位付けし、賃金と失業率も並べてください。」

インストール

ご自身に合った最初の方法を選んでください。ターミナルを使わない方法から上級者向けの方法まであります。対応システム：macOS、Linux、Windows 10（1903 以降）／11。ローカルの NTFS キャッシュディレクトリが必要です。

Windows は 0.1.3 からサポートされています。PyPI パッケージと .mcpb 拡張機能も対象です。0.1.2 以前のリリースは macOS と Linux のみをサポートしています。

画面を見ながら手順を確認したいですか？プロジェクトのウェブサイトにあるインストールガイド（ポーランド語）では、インストール手順を順を追って説明しており、AI エージェントにインストールを任せるプロンプトも用意されています。

1. Claude Desktop、ターミナル不要

1. 最新のリリースから deweloperuch-mcp-<version>.mcpb をダウンロードします。
2. ダブルクリックするか、Claude Desktop → 設定 → 拡張機能 → インストールにドラッグしてから、Claude Desktop を再起動します。

利用できるもの：Claude Desktop の 13 個のツールと 4 個のプロンプト。拡張機能は uv ランタイムを使用します（マニフェストの server.type は uv）。そのため初回起動時に Python と依存関係を取得し、約 1 分かかります。ご自身で何かをインストールする必要はありません。コマンドラインツールは含まれていません。サーバーが停止（STOP）した場合は、チェックアウトなしで STOP を解除する方法を参照してください。

2. uv を使って任意の MCP クライアントで利用

利用できるもの：Claude Desktop、Claude Code、または stdio サーバーを起動する任意のクライアントで、同じツールを利用できます。クローンは不要です。

uv を一度インストールします（macOS および Linux）：

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows では PowerShell を使用します（uv のインストール）：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

インストール後、新しいターミナルを開き、PATH 上の uv が認識されるようにしてください。

Claude Code：

claude mcp add deweloperuch -- uvx deweloperuch-mcp

Claude Desktop（claude_desktop_config.json。ほかのクライアントでも同じ command と args を使用します）：

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

PyPI の代わりに GitHub から直接実行するには、uvx --from git+https://github.com/MBratkowski/[email protected] deweloperuch-mcp を使用します（@v0.1.3 はリリースを固定します。省略すると main を追跡します）。pip install deweloperuch-mcp も使用できます。

Windows の MCP クライアントが uvx を見つけられない場合は、(Get-Command uvx).Source で確認できる実行ファイルのフルパスを command に指定してください。JSON 内ではバックスラッシュをエスケープします。例："C:\\Users\\YOUR_NAME\\.local\\bin\\uvx.exe"。ソースをチェックアウトしている場合は、代わりに "command": "uv" と "args": ["run", "--directory", "C:\\path\\to\\deweloperuch-mcp", "deweloperuch-mcp"] を使用します。

3. CLI 用エージェントスキル

利用できるもの：deweloperuch CLI の使い方（実行するコマンド、出力の読み方、STOP 時の対応）を理解した AI コーディングエージェント。MCP サーバーは必要ありません。このスキルの名前は deweloperuch-cli です。新しいエージェントセッションで自動的に読み込まれます。

npx skills add MBratkowski/deweloperuch-mcp

これは skills CLI（Node.js が必要）を使用し、対応する任意のエージェントで動作します。使用するエージェントは自分で選びます。Node.js を使わない場合：

uvx --from deweloperuch-mcp deweloperuch skill install

~/.claude/skills/deweloperuch-cli に書き込みます（Claude Code のユーザー用）。オプション：--project（このプロジェクトの ./.claude/skills）、--agent codex|cursor|gemini-cli|github-copilot、--dir PATH（PATH/deweloperuch-cli に書き込み）、--force（異なるコピーを置き換えます。指定しない場合、変更されたコピーは上書きされず、インストーラーがシンボリックリンクを介して書き込むこともありません）。deweloperuch skill show はスキルを表示し、deweloperuch skill path はそのフォルダーを表示します。詳細：docs/cli/commands/skill.md。

Claude Code プラグインマーケットプレイス：

/plugin marketplace add MBratkowski/deweloperuch-mcp
/plugin install deweloperuch@deweloperuch-mcp

4. CLI のみを利用

利用できるもの：ターミナルやスクリプトで使う deweloperuch コマンド。docs/cli/README.mdを参照してください。

uvx --from deweloperuch-mcp deweloperuch --help    # one-off, nothing installed
uv tool install deweloperuch-mcp                   # installs deweloperuch and deweloperuch-mcp
deweloperuch locations search krak

5. ソースから（コントリビューター向け）

要件：Python 3.11 以降と uv。

git clone https://github.com/MBratkowski/deweloperuch-mcp.git
cd deweloperuch-mcp
uv sync
uv run deweloperuch --help                  # sends no requests

クライアントのコマンドには uv run --directory /path/to/deweloperuch-mcp deweloperuch-mcp を使用してください（Claude Code：claude mcp add deweloperuch -- uv run --directory /path/to/deweloperuch-mcp deweloperuch-mcp）。詳細：CONTRIBUTING.md と docs/mcp/README.md。

トラブルシューティング

• uvx: command not found または spawn uvx ENOENT：uv をインストールしてください（オプション 2）。Claude Desktop からシェルの PATH が見えない場合があるため、command に which uvx（macOS/Linux）または (Get-Command uvx).Source（PowerShell）で確認したフルパスを指定してください。
• Claude Desktop にサーバーが表示されない：拡張機能のインストール後、または設定の編集後に、Claude Desktop を終了して再起動してください。
• リリース 0.1.2 以前の Windows：0.1.3 以降に更新してください。uv ツールをインストールしている場合は uv tool upgrade deweloperuch-mcp を、pip の場合は python -m pip install --upgrade deweloperuch-mcp を、uvx の場合は uvx --refresh deweloperuch-mcp --help を実行してください。古い .mcpb 拡張機能は最新リリースに置き換えてください。
• STOP／終了コード 3：401、403、429、または CAPTCHA／WAF のチャレンジが発生すると、サービスへの負荷を避けるため、クライアントはすべてのプロセスでリクエストの送信を停止します。429 は一時停止後（少なくとも 60 秒）に自動的に解除されます。それ以外の原因による停止は、原因を確認したうえで、あなた自身が解除するまで続きます（deweloperuch stop status で状態を確認できます。AI エージェントは解除してはいけません）。MCP サーバーは再起動するまで停止したままです。詳細とコマンド：docs/configuration.md。
• キャッシュの保存場所：レスポンスはメモリ内にのみキャッシュされます。リミッターのロックと STOP の記録は ~/.cache/deweloperuch-mcp（$XDG_CACHE_HOME/deweloperuch-mcp）に保存されます。このディレクトリを削除しないでください。STOP も解除されてしまいます。

ツール

概要、引数のルール、エラー、結果のサイズについては、docs/mcp/README.mdをご覧ください。

ツール	説明
search_locations	名前の一部から都市、地区、通りを検索し、city_slugを返します。
search_offers	都市またはポーランド全域のデベロッパー物件を、価格、面積、㎡単価、地区、ステータス、値下げのフィルターや並べ替えを指定して1ページ分取得します。
get_offer	1件の物件について、価格履歴全体と価格フラグ（過去30日／90日間の最低価格、疑わしい値下げ）を取得します。
search_investments	都市内の投資案件（平均価格、並べ替え、デベロッパーによるフィルター）またはポーランド全域の名前で検索します。
get_investment	デベロッパー、平均価格、物件一覧を含む投資案件を取得します。
search_developers	名前の一部からデベロッパーを検索し、developer_slugを返します。
get_developer	デベロッパーのプロフィール（概要、販売中の物件がある投資案件、都市）を取得します。
get_market_statistics	1つの都市の物件市場統計（件数、価格、㎡単価、面積の分布、最大手デベロッパー）を取得します。
get_transaction_statistics	都市の取引価格（RCN）を月別または四半期別に取得します。
rank_locations	RCN取引と㎡単価に基づいて、地域または郡をランキングします。
get_building	RCNに登録された建物と、その住戸および取引を取得します。
estimate_property_value	近隣のRCN取引に基づき、指定地点のマンションのおおよその価値を推定します。
get_government_statistics	ポーランド、集計データ、66都市を対象に、公式のGUSおよびNBP時系列データ（住宅、NBP価格、失業率、賃金、人口動態）を取得します。

各ツールは、スキーマにない引数を、許可されている名前を列挙したエラーとともに拒否します。サービスとその利用者がポーランド語を使用しているため、ツールの説明、エラーメッセージ、CLIの出力はポーランド語です。

プロンプト

すぐに使える4つのプロンプトが、Claude Desktopでコマンドとして表示されます。プロンプト自体がリクエストを送信することはなく、上記のツールを使うようモデルを案内します。引数と詳細については、docs/mcp/prompts.mdをご覧ください。

プロンプト	説明
znajdz_mieszkanie（「アパートを探す」）	1つの都市で、予算、面積、地区を指定してデベロッパー物件を検索し、㎡単価の安い順に物件を表形式で表示します。
ocen_oferte（「物件を評価する」）	1件の物件の価格評価を行います。価格履歴、都市の市場との比較、近隣取引に基づく評価額との比較を含みます。
przeswietl_dewelopera（「デベロッパーを調査する」）	デベロッパーのプロフィールを表示します。建設地域と建設規模、投資案件、販売中の物件、価格とその推移を確認できます。
porownaj_miasta（「都市を比較する」）	複数の都市（最大5都市）のマンション市場を1つの表で比較します。売出価格、RCN取引価格、必要に応じて賃金と失業率を確認できます。

CLI コマンド

概要、出力形式、終了コードについては、docs/cli/README.mdをご覧ください。

コマンド	説明
deweloperuch locations search QUERY	都市、地区、通りを検索し、都市のスラッグを返します。
deweloperuch offers search CITY	フィルターと並べ替えを使って、都市またはポーランド全土の物件情報を検索します。
deweloperuch offers get OFFER_ID --investment SLUG	価格履歴と価格フラグを含む物件情報を表示します。
deweloperuch investments search [CITY]	都市または名称で投資案件を検索します。
deweloperuch investments get SLUG	デベロッパーと物件情報を含む投資案件を表示します。
deweloperuch developers search NAME	名称でデベロッパーを検索し、デベロッパーのスラッグを返します。
deweloperuch developers get SLUG	デベロッパーのプロフィールを表示します。
deweloperuch buildings get SLUG	RCN の建物と、その住戸および取引を表示します。
deweloperuch valuation estimate --lat --lng --area	指定地点におけるアパートの価値を推定します。
deweloperuch stats market CITY	1 つの都市の物件市場統計を表示します。
deweloperuch stats transactions CITY	都市の RCN 取引価格を月別または四半期別に表示します。
deweloperuch stats cities	RCN 取引に基づく地域または郡のランキングを表示します。
deweloperuch stats government LOCATION DATASET	地域の GUS および NBP 統計を期間別の表として表示します。
deweloperuch stop status [--json]	すべてのプロセスで共有される STOP ロックを表示します（オフライン。ロックが有効な場合は終了コード 3）。
deweloperuch stop clear	原因を確認した後、STOP ロックを解除します。
deweloperuch skill install|show|path	deweloperuch-cli エージェントスキルをインストール、出力、または検索します（オフライン）。

仕組み

deweloperuch.pl  →  api  →  models  →  usecases  →  consumers (CLI, MCP server)

レイヤー	役割
api/	サービスと通信します。共有リミッター、キャッシュ、STOP ロックを備えた HTTP トランスポート、JSON API とページデータのリーダー、レスポンスをモデルにマッピングする DTO が含まれます。
models/	単純な不変のデータクラス（物件情報、投資案件、価格履歴、統計情報）です。I/O は行いません。
usecases/	操作ごとに 1 つのモジュール（例：SearchOffers）を配置し、api/ が実装するポートを通じて記述します。
consumers/	CLI と MCP サーバーです。どちらも薄い層で、引数を解析し、ユースケースを呼び出して結果を提示します。

各レイヤーは bootstrap.py で接続されます。tooling/ には、CLI のみが使用する業務ロジック以外のヘルパー（スキルインストーラー）が含まれます。Import-linter がインポートの依存方向を検証します。設計上の決定とその理由については、docs/decisions.mdをご覧ください。サービスのデータ、エンドポイント、制限については、docs/discovery/README.mdをご覧ください。設定、リミッター、STOP ロックについては、docs/configuration.mdをご覧ください。

開発

uv sync
make fast     # ruff, ruff format --check, mypy, import-linter (a few seconds)
make check    # fast + the offline tests + dead-code check + complexity and duplication reports

すべての make ターゲットはオフラインで実行されます。テストがネットワークソケットを開くことはなく、docs/discovery/samples/ と tests/fixtures/ に保存された実際のレスポンスを使用します。

フォルダー	内容
tests/unit/	src/ に対応するユニットテストです。
tests/contract/	保存されたサービスレスポンスと DTO、アダプターを照合します。
tests/integration/	モックサービス上で実際のアダプターを使用するユースケースです。
tests/characterization/	CLI と MCP サーバーの期待出力です（tests/golden/）。
tests/architecture/、tests/safeguards/	レイヤリングと命名のルール、リポジトリ全体の一貫性（識別情報、公開アセット、メタデータ）、ネットワークを使用しない保証を検証します。
tests/support/	テスト用インフラストラクチャ（フェイク、ビルダー、チェック）です。テストは含まれません。
tests/e2e/	以下で説明する、オプトイン方式のライブテストスイートです。

意図した出力を変更した後は、DEWELOPERUCH_UPDATE_GOLDEN=1 uv run pytest tests/characterization で期待出力を更新し、差分を確認してください（tests/golden/README.md）。

ライブのエンドツーエンドテストはデフォルトで無効です。インストール済みのサーバー、CLI、ヘルパースクリプトを実際のサービスに対して検証するため、実際のリクエストを送信します。変更に必要な場合に限り、慎重に実行してください。

DEWELOPERUCH_LIVE=1 uv run pytest -m live tests/e2e -rs --maxfail=3

環境変数と -m live の両方が必要です。シナリオとリクエストの予算については、tests/e2e/README.md を参照してください。コントリビューションガイドとリリース手順については、CONTRIBUTING.md を参照してください。

ドキュメント

ドキュメント	内容
ウェブサイト とそのドキュメント	プロジェクトのランディングページとポーランド語のユーザードキュメントです。図解付きのインストールガイドもあります。
docs/mcp/README.md	MCP サーバー：ツール、プロンプト、クライアントの設定、引数のルール、エラー、結果のサイズ
docs/cli/README.md	deweloperuch CLI：コマンド、出力形式、終了コード
docs/configuration.md	環境変数、ファイル、リクエスト制限、キャッシュ、STOP ロック
docs/discovery/README.md	データレイヤーの概要：サービスアーキテクチャ、アクセスチャネル、主な調査結果
docs/discovery/endpoints.md	サービスの /api/* エンドポイント一覧
docs/discovery/pages-rsc.md	データソースとしてのページ：フィルター、並べ替え、ページネーション
docs/discovery/entities.md	エンティティ、識別子、リレーション、値の辞書
docs/discovery/samples/	レスポンスの抜粋サンプル（コントラクトテストの基礎）
docs/capability-matrix.md	機能、その実現に必要なリクエスト、および機能を提供するツールやコマンド
docs/open-questions.md	サービスに関する既知の不足点と、未検証の前提
docs/decisions.md	アーキテクチャ上の決定
CHANGELOG.md	バージョン間の変更点

データソースとライセンス

• deweloperuch.pl：すべての物件情報、投資、デベロッパー、統計データのソースです。データの利用には同サイトの利用規約が適用されます。
• RCN（不動産価格登録簿）の取引データは、サービスを通じて取得します。サービスの作成者は、公開リポジトリで未加工の RCN データを CC0 として公開しています。
• GUS（中央統計局）と NBP（ポーランド国立銀行）の統計データは、サービスを通じて取得します。数値を再公開する場合は、出典として明記してください。

コードは MIT ライセンス の下でライセンスされています。このライセンスの対象はコードのみです。テストで使用するサンプルとフィクスチャには上記のデータソースのデータが含まれており、NOTICE に記載されています。プロジェクトのアイコンも MIT ライセンスの対象外であり、すべての権利が留保されています。deweloperuch.pl の作成者の許可を得て使用しています（NOTICE を参照してください）。

貢献

Issue とプルリクエストを歓迎します。まずはCONTRIBUTING.md、特に丁寧なクライアントに関するルールをお読みください。セキュリティに関する報告はSECURITY.mdをご覧ください。