Idealista MCP Server and API by Cotlet

Claude Code、ChatGPT、あらゆる AI エージェントをIdealistaに接続する方法

はい。Claude、ChatGPT、その他の AI エージェントは、あなたのIdealistaアカウントで操作できます。 Idealista公式のChatGPTアプリとClaudeコネクターは、スペイン、イタリア、ポルトガルで購入・賃貸物件を検索します。Cotlet.devを使うと、ログイン済みのあなたのIdealistaアカウントをあらゆる AI エージェントに接続できるため、AIがあなたの物件情報を一覧表示、確認、更新してくれます。

できること

価格、閲覧数、掲載日数とともに、公開中の物件情報をすべて一覧表示してください。

マドリードのCalle Alcalá 120にあるマンションの価格を€385,000から€369,000に下げてください。

リスボンにある寝室2部屋の物件の説明文を、新しいキッチンとテラスをアピールする内容に書き換えてください。先に下書きを見せてください。

過去14日間に問い合わせがなかった物件はどれですか？価格順に並べてください。

新しい写真を6枚、バルセロナのロフト物件に追加し、テラスの写真を先頭にしてください。

2分で接続

https://cotlet.dev/app でAPIキーを取得し、COTLET_API_KEYとしてエクスポートします。

Claude Code

claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"

ChatGPT

設定 → アプリ → コネクターURL https://cotlet.dev/mcp/v1 を追加し、Cotlet.devにサインインします。APIキーは不要です。

Cursor

このリポジトリの.cursor/mcp.jsonをプロジェクトにコピーします。

{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": {
        "Authorization": "Bearer ${COTLET_API_KEY}"
      }
    }
  }
}

ローカルで実行する（stdio）

このリポジトリは実際に動作するMCPサーバーです。stdio経由でMCPを使用し、キーがなくてもIdealistaのツールを一覧表示します。また、すべてのツール呼び出しをホスト型のCotlet.devサーバーに転送します。上記のホスト型URLを引き続き推奨します。クライアントがローカルサーバーしか起動できない場合は、こちらを使ってください。

{"mcpServers":{"idealista":{"command":"uvx","args":["idealista-mcp"],"env":{"COTLET_API_KEY":"your-key"}}}}

またはDockerを使います。

docker build -t idealista-mcp .
docker run -i --rm -e COTLET_API_KEY idealista-mcp

ツール：idealista_guide、idealista_status、idealista_open、idealista_read、idealista_click、idealista_type、idealista_close。COTLET_API_KEYが設定されていない場合、ツール呼び出しは「Set COTLET_API_KEY. Get a key at https://cotlet.dev/app」と応答します。

コマンドライン

Python 3.10以降が必要です。ほかにインストールするものはありません。PyPIからインストールする場合：

pip install idealista-mcp        # or run it once: uvx idealista-mcp connect
idealista-mcp connect

または、このリポジトリから直接インストールする場合：

export COTLET_API_KEY="your-key"
python3 idealista_agent.py connect   # ready config for Claude Code, Cursor, ChatGPT
python3 idealista_agent.py status    # is Idealista ready in your Cotlet.dev account
python3 idealista_agent.py guide     # Idealista screens and sign-in link
python3 idealista_agent.py read      # open Idealista, read the page, close the browser
python3 idealista_agent.py tools     # list Cotlet.dev tools
python3 idealista_agent.py serve     # start the stdio MCP server (same as no argument)

Idealistaユーザーからの質問

IdealistaにはAPIがありますか？

Idealistaには、自分の物件情報や問い合わせ情報を扱う公開APIはありません（2026年10月11日確認）。検索APIは読み取り専用で、申請後にのみ利用できます。また、公式のClaudeアプリとChatGPTアプリはログイン機能がなく、公開物件のみを検索します。Cotlet.devは、ログイン済みのあなたのIdealistaアカウントで動作するため、AI エージェントがAPIキーもコードも使わずに、あなたの物件情報を一覧表示、更新できます。

IdealistaをChatGPTに接続するにはどうすればよいですか？

Idealista公式のChatGPTアプリでは、物件を検索できます。自分の物件情報を扱うには、ChatGPTにアプリとしてCotlet.devを追加し（設定 → アプリ、コネクターURL https://cotlet.dev/mcp/v1）、Cotlet.dev Cloud BrowserでIdealistaに一度サインインしてから、ChatGPTに普通の言葉で指示してください。コードもIdealistaのAPIキーも不要です。

ClaudeでIdealistaを使う方法はありますか？

はい。Idealista独自のClaudeコネクターでは、物件を検索できます。物件情報を管理するには、Claude Codeで上記の1行のclaude mcp addコマンドを実行するか、Claudeアプリでカスタムコネクターとしてhttps://cotlet.dev/mcp/v1を追加します。これでClaudeが、あなたのIdealistaアカウントで操作できるようになります。

IdealistaのMCPサーバーはありますか？

Idealista公式のコネクターは、スペイン、イタリア、ポルトガルでの物件検索を中心としています。Cotlet.devはホスト型のMCPサーバーで、Claude、ChatGPT、Cursor、Codex、n8n、Make、Zapierを使い、24時間いつでもあなたのIdealistaアカウントで操作できます。

掲載先

• Cotlet.devのIdealista
• PyPIパッケージ idealista-mcp
• ステップごとのガイド（PDF）、Internet Archive

こちらとも連携できます

• Mangomint MCP
• Wanderlog MCP
• SmugMug MCP
• Garmin Connect MCP
• Housecall Pro MCP
• Medium MCP
• Crexi MCP
• DistroKid MCP
• LinkedIn MCP
• EstimateOne MCP
• Google Search Console MCP
• Lichess MCP
• Strava MCP
• StreamElements MCP
• Meetup MCP
• AccuRanker MCP
• GetYourGuide MCP
• Riverside MCP
• Udemy MCP
• Faire MCP
• Buildertrend MCP
• Cotlet.dev を通じて連携するすべてのアプリ

---

詳細はこちら：https://cotlet.dev/integrations/idealista-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=idealista

無料で始める：https://cotlet.dev/signup?app=idealista&utm_source=github&utm_medium=readme&utm_campaign=idealista