booli-mcp について
booli-mcpは、スウェーデンの不動産ポータルBooliの物件情報や市場データを検索するMCPサーバーです。読み取り専用のツールを提供し、直接接続が阻まれた場合はContextMint Bridge経由でログイン済みブラウザーセッションを利用します。
主な機能
- 01販売中の物件検索
- 02成約物件と価格の検索
- 03地名からエリアIDを解決
- 04物件詳細と市場統計の取得
- 05接続経路とブリッジ状態の確認
活用シーン
- 01指定エリアの販売中物件を探す
- 02成約価格とエリア別統計を比較する
- 03特定物件の詳細を取得する
MCP 対応
エリア、物件、成約価格、物件詳細、市場統計、ヘルスチェックのツールをMCPクライアントに公開します。直接接続のほか、ContextMint Bridgeを介してログイン済みBooliブラウザータブからクエリを送信できます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y @chrischall/booli-mcpBOOLI_TRANSPORTSelects the path: auto (default — direct fetch first, browser-bridge fallback when walled), fetchproxy (always the bridge), or direct.BOOLI_WS_PORTOverride the fetchproxy WebSocket port (the fleet shares 37149).FETCHPROXY_WS_HOSTBridge bind interface, a literal IP only (default 127.0.0.1). Keep on loopback; exists for a hosted child in its own network namespace.FETCHPROXY_IDENTITY_DIRAbsolute path for the long-term bridge identity keypair (default ~/.fetchproxy/identity/). Exists for a host that runs a separate child per caller.ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
6掲載時のツール一覧 · 1 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| limit | integer | いいえ | 結果の最大数(デフォルトは 10)。 |
| query | string | はい | 地名の検索文字列(例:"Nacka"、"Södermalm")。 |
詳細
booli-mcp
スウェーデンの不動産ポータルサイト Booli 用の MCP サーバーです。Claude から販売中の物件、成約価格(slutpriser)、地域の特定、市場統計の計算を行えます。
AI(Claude Code)によって開発・保守されています。ご自身の判断のもと、booli.se の利用規約に従ってご利用ください。
仕組み
Booli は www.booli.se と GraphQL API を Cloudflare のボット対策で保護しており、サーバー側のクライアントをブロックします。そのため booli-mcp は fetchproxy ブリッジ(ContextMint Bridge ブラウザー拡張機能)を使い、ログイン済みの www.booli.se ブラウザータブ経由で各クエリを送信し、Cloudflare を通過済みのセッションを再利用して、Booli の一般ユーザー向け GraphQL API を読み取ります。Booli へのログインは不要で、通常のページを表示するだけで利用できます。すべてのツールは読み取り専用です。
BOOLI_TRANSPORT で接続経路を選択します。auto(デフォルト。まず直接フェッチし、壁に阻まれた場合はブラウザーブリッジにフォールバック)、fetchproxy(常にブリッジを使用)、または direct を指定できます。fetchproxy フリートは WS ポート 37149(BOOLI_WS_PORT)を共有します。
セットアップ
-
ContextMint Bridge を リリースページからインストールします。Chrome の場合は、chrome zip をダウンロードして解凍し、
chrome://extensionsで展開した拡張機能を読み込みます(デベロッパーモード)。Safari 版はまだ提供されていません(一般公開されていない ContextMint アプリ内で提供予定です)。当面は Chrome をご利用ください。 www.booli.se のタブを開いたままにしてください。ContextMint Bridge は、同じメンテナーによる fetchproxy ブラウザー拡張機能の新名称です。fetchproxy の README からも案内されています。 ソースコードは公開されているため、 nullnet-app/contextmint-bridge から自分でビルドするか、リリース zip と同じ場所に公開されている
.sha256ファイルを使って検証できます (shasum -a 256 -c contextmint-bridge-chrome-<version>.zip.sha256)。 -
初回リクエスト時に、ContextMint Bridge で一度限りのペアリングプロンプトを承認します。
-
booli_healthcheckを実行して、接続経路が動作していることを確認します。transportフィールドには、プローブに使用された経路(directまたはfetchproxy)が表示されます。ブリッジが起動すると、bridge.session_stateに拡張機能の状態(linked、pair_pending(表示されたペアコードを承認してください)、またはextension_disconnected)が表示されます。
インストール
// mcp config
{
"mcpServers": {
"booli": {
"command": "npx",
"args": ["-y", "@chrischall/booli-mcp"]
}
}
}
ツール
| ツール | 説明 |
|---|---|
booli_search_areas | 地名から Booli の地域 ID を特定します |
booli_search_listings | 地域とフィルターを指定して販売中の物件を検索します |
booli_get_listing | 物件 ID を指定して、1 件の物件の詳細(販売中または成約済み)を取得します |
booli_search_sold | 成約価格付きの成約済み物件(slutpriser)を検索します |
booli_market_stats | 地域の成約価格の中央値・平均値を算出します |
booli_healthcheck | データ経路を確認し、transport(direct / fetchproxy、BOOLI_TRANSPORT のモード)を報告します。ブリッジの起動後は、次の手順のヒントとともに bridge(役割、ポート、拡張機能の接続状態 session_state、保留中のペアコード)も報告します |
検索対象は、area_id(booli_search_areas で取得)またはフリーテキストの location で指定します。金額の単位は SEK、面積の単位は m² です。基盤となる GraphQL API については
docs/BOOLI-API.md を参照してください。
開発
npm install
npm test # vitest, no network
npm run build # tsc + esbuild bundle
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。