🏠 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