概要
任意のAIアシスタントからIdealistaの不動産物件情報（スペイン、イタリア、ポルトガル）を検索できます。売買・賃貸のアパートや住宅を探し、物件の詳細を読み取り、周辺地域データを確認できます。4ツール、認証不要: Idealistaモバイルアプリをリバースエンジニアリング。
こう聞いてみよう
Idealista のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
セルフホスト専用。 Idealista はデータセンターの IP アドレスからのリクエストを拒否します。AnythingMCP Cloud はデータセンターで稼働しているため、このコネクタは AnythingMCP Cloud では利用できません。自宅やオフィスの一般的なインターネット回線につながったパソコンやサーバーで、ご自身で運用する AnythingMCP インスタンスなら動作します。
Idealista + Claude
任意の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 を設定します（デプロイガイド）。
Step 3 — Idealista コネクターを Claude に追加
Claude から MCP サーバーへの接続方法は 2 つあり、localhost のクイックスタートで使えるのはそのうち 1 つだけです。
Claude Code はお使いのパソコン上で動くため、ローカルのエンドポイントを直接使えます。
claude mcp add --transport http idealista http://localhost:4000/mcp/<server-id> --header "X-API-Key: <your-api-key>"
claude mcp list で接続を確認できます。
Claude.ai と Claude Desktop では、リモートサーバーをカスタムコネクタとして追加します。Customize → Connectors を開き、+ をクリックして Add custom connector を選びます（Team / Enterprise プランでは、先にオーナーが Organization settings → Connectors で追加します）。この接続はお使いのパソコンからではなく Anthropic のクラウドから行われるため、localhost の URL は使えません。Idealista が受け付ける回線上で、公開 HTTPS アドレスを持つ AnythingMCP インスタンス（上記の ./setup.sh を参照）が必要です。そのインスタンスの MCP endpoint を貼り付け、Claude に求められたら AnythingMCP にサインインします。
利用可能なツール
| 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
なぜ Idealista は AnythingMCP Cloud で使えないのですか? Idealista はデータセンターの IP アドレスからのリクエストを拒否します。AnythingMCP Cloud はデータセンターで稼働しているため、すべての呼び出しが失敗します。自宅やオフィスの回線上の AnythingMCP インスタンスであれば、通常は動作します。
次のステップ
このガイドは役に立ちましたか?
