🏠 HomeRadar MCP

🏠 HomeRadar MCP

Cerca immobili in Italia direttamente da Claude — in linguaggio naturale.

HomeRadar è un MCP server che permette a Claude di cercare annunci immobiliari su Immobiliare.it, Idealista.it e Casa.it con un semplice messaggio.

✨ Come funziona

Scrivi a Claude quello che cerchi:

"Cercami un trilocale in affitto a Milano Navigli, massimo 1.500€"

"Ci sono bilocali in vendita a Roma Prati sotto i 400.000€ con ascensore?"

"Trova appartamenti a Bologna, almeno 80 mq, con giardino"

Claude risponde con annunci, prezzi, indirizzi e link diretti alle pagine filtrate dei portali.

🚀 Installazione rapida

Requisiti

• Claude Desktop
• Python 3.10+
• API key Anthropic (console.anthropic.com)

1. Clona il repository

git clone https://github.com/simonedelvecchio93/homeradar-mcp.git
cd homeradar-mcp

2. Installa le dipendenze

pip install -r requirements.txt

3. Configura Claude Desktop

Apri il file di configurazione di Claude Desktop:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

Aggiungi questa sezione (sostituisci il percorso e la tua API key):

{
  "mcpServers": {
    "homeradar": {
      "command": "python",
      "args": ["/percorso/homeradar-mcp/server.py"],
      "env": {
        "ANTHROPIC_API_KEY": "sk-ant-..."
      }
    }
  }
}

4. Riavvia Claude Desktop

Chiudi e riapri Claude Desktop. Vedrai l'icona 🔨 attiva nella chat.

🛠️ Strumenti disponibili

homeradar_cerca_immobili

Cerca annunci con filtri completi e analisi di mercato.

Parametri:| Parametro | Tipo | Descrizione ||-----------|------|-------------|| zona | string | Città o quartiere (es. "Milano Navigli") || operazione | vendita / affitto | Tipo di operazione || tipo | appartamento, villa, ufficio... | Tipo di immobile || budget | string | Prezzo massimo in euro || superficie | string | m² minimi || locali | monolocale...5+ | Numero locali || ascensore | bool | Richiede ascensore || garage | bool | Richiede garage || giardino | bool | Richiede giardino || animali | bool | Animali ammessi || note | string | Preferenze libere || numero_risultati | 1-10 | Quanti annunci (default 5) || analisi_mercato | bool | Analisi prezzi zona || formato | markdown / json | Formato risposta |

homeradar_link_portali

Genera i link filtrati ai portali senza generare annunci.

📦 Struttura progetto

homeradar-mcp/
├── server.py          # MCP server principale
├── requirements.txt   # Dipendenze Python
├── smithery.yaml      # Configurazione Smithery
└── README.md

💶 Costi

HomeRadar usa Claude Haiku (il modello più economico di Anthropic).Ogni ricerca costa circa €0,001 — praticamente gratuito.

📄 Licenza

MIT — libero di usare, modificare e distribuire.

🙋 Autore

Creato da Simone Del Vecchio