概要
任意のAIアシスタントからIdealistaの不動産物件情報（スペイン、イタリア、ポルトガル）を検索できます。売買・賃貸のアパートや住宅を探し、物件の詳細を読み取り、周辺地域データを確認できます。4ツール、認証不要: Idealistaモバイルアプリをリバースエンジニアリング。
こう聞いてみよう
Idealista のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
セルフホスト専用。 Idealista はデータセンターの IP アドレスからのリクエストを拒否します。AnythingMCP Cloud はデータセンターで稼働しているため、このコネクタは AnythingMCP Cloud では利用できません。自宅やオフィスの一般的なインターネット回線につながったパソコンやサーバーで、ご自身で運用する AnythingMCP インスタンスなら動作します。
Idealista + ChatGPT
任意のAIアシスタントからIdealistaの不動産物件情報（スペイン、イタリア、ポルトガル）を検索できます。売買・賃貸のアパートや住宅を探し、物件の詳細を読み取り、周辺地域データを確認できます。4ツール、認証不要: Idealistaモバイルアプリをリバースエンジニアリング。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
(none — public API)
ステップ 1 — 認証情報を取得
This connector wraps the Idealista mobile app's internal API (app.idealista.it).
Setup: nothing. The mobile API endpoints used here do not require OAuth for read access.
Markets: Idealista operates in Italy, Spain, and Portugal. The locale path segment in URLs (/api/3.5/it/..., /api/3.5/es/..., /api/3.5/pt/...) selects the market. Pass locale as a tool parameter.
What it does NOT do: contact sellers, save searches, post listings. Use this connector to find and read listings; act on them in the Idealista app/site.
…(continued in the in-app connector instructions)
ステップ 2 — アダプターをインストール
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
http://localhost:3000を開いてアカウントを登録します。最初のアカウントが管理者になります。- コネクタストア（
http://localhost:3000/connectors/store）を開いて Idealista を選び、求められた認証情報を入力して（不要なコネクタもあります）インストールします。 - MCP Servers でサーバーを作成し、Idealista コネクタを割り当てます。サーバーのページで MCP endpoint（
http://localhost:4000/mcp/<server-id>）をコピーし、API keys でキーを発行します。
クイックスタートは localhost でのみ待ち受けます。他の人やクラウド上の AI クライアントから接続できるインスタンスが必要な場合は、リポジトリをクローンして ./setup.sh を実行してください。ドメイン、HTTPS、OAuth を設定します（デプロイガイド）。
ステップ 3 — ChatGPT にコネクタを追加
ChatGPT は OpenAI のクラウドから MCP サーバーに接続するため、クイックスタートの localhost エンドポイントには届きません。Idealista が受け付ける回線上で、公開 HTTPS アドレスを持つ AnythingMCP インスタンス（上記の ./setup.sh を参照）が必要です。以下の手順では Cloud の URL ではなく、そのインスタンスの MCP endpoint を入力します。
ChatGPT は開発者モード（Developer mode）で MCP サーバーをカスタムアプリとして接続します。有料プランで利用でき、無料プランでは使えません。Business・Enterprise のワークスペースでは、先に管理者が許可する必要がある場合があります。
- ChatGPT で Settings → Security and login を開き、Developer mode をオンにします。
- chatgpt.com/plugins を開き、+ をクリックします。
- 名前と短い説明を入力します（例: Name:
Idealista）。 - Connection に MCP サーバー URL
https://<your-anythingmcp-domain>/mcp/<server-id>を入力し、接続を作成します。 - ChatGPT に求められたら AnythingMCP にサインイン（OAuth）し、アクセスを許可します。
公開インスタンスを用意できない場合は、パソコン上で動くクライアントを使ってください。Claude Code、Cursor、Gemini CLI は localhost に直接接続できます。
利用可能なツール
| Tool | What it does |
|---|---|
idealista_search | Search Idealista listings with filters |
idealista_get_listing | Full detail of one Idealista listing by ID — full description, all photos, agency, contact, geocoordinate, energy class, characteristics |
idealista_search_locations | Search for Idealista location IDs (cities, neighborhoods, districts) |
idealista_map_search | Search Idealista listings within a geo bounding box (map-driven search) |
FAQ
ChatGPT の無料プランでカスタム MCP コネクタは使えますか? いいえ。カスタム MCP 接続には開発者モードが必要で、有料プランでのみ利用できます。
なぜ Idealista は AnythingMCP Cloud で使えないのですか? Idealista はデータセンターの IP アドレスからのリクエストを拒否します。AnythingMCP Cloud はデータセンターで稼働しているため、すべての呼び出しが失敗します。自宅やオフィスの回線上の AnythingMCP インスタンスであれば、通常は動作します。
次のステップ
このガイドは役に立ちましたか?
