概要
任意のAIアシスタントからIdealistaの不動産物件情報（スペイン、イタリア、ポルトガル）を検索できます。売買・賃貸のアパートや住宅を探し、物件の詳細を読み取り、周辺地域データを確認できます。4ツール、認証不要: Idealistaモバイルアプリをリバースエンジニアリング。
こう聞いてみよう
Idealista のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
セルフホスト専用。 Idealista はデータセンターの IP アドレスからのリクエストを拒否します。AnythingMCP Cloud はデータセンターで稼働しているため、このコネクタは AnythingMCP Cloud では利用できません。自宅やオフィスの一般的なインターネット回線につながったパソコンやサーバーで、ご自身で運用する AnythingMCP インスタンスなら動作します。
Idealista + Cursor
任意の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 — Cursor にコネクタを追加
Cursor はお使いのパソコン上で動くため、ローカルのエンドポイントを使えます。~/.cursor/mcp.json（全プロジェクト）または .cursor/mcp.json（1 つのプロジェクト）にサーバーを追加します。
{
"mcpServers": {
"idealista": {
"url": "http://localhost:4000/mcp/<server-id>",
"headers": { "X-API-Key": "<your-api-key>" }
}
}
}
その後、Cursor の MCP 設定でサーバーが有効になっていて、ツールが一覧に表示されていることを確認します。
利用可能なツール
| 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
Cursor の Free プランでカスタム MCP サーバは使えますか? はい — Hobby/Pro/Business で利用可能です。
なぜ Idealista は AnythingMCP Cloud で使えないのですか? Idealista はデータセンターの IP アドレスからのリクエストを拒否します。AnythingMCP Cloud はデータセンターで稼働しているため、すべての呼び出しが失敗します。自宅やオフィスの回線上の AnythingMCP インスタンスであれば、通常は動作します。
次のステップ
このガイドは役に立ちましたか?
