n8n-nodes-immometrica/README.md

n8n community node for ImmoMetrica real estate data extraction

# n8n-nodes-immometrica

[![npm version](https://badge.fury.io/js/n8n-nodes-immometrica.svg)](https://badge.fury.io/js/n8n-nodes-immometrica)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Ein n8n Community Node für die Integration mit ImmoMetrica - der führenden Plattform für Immobilienbewertung und -analyse in Deutschland.

## 🚀 Features

### Umfassende Immobiliendaten-Extraktion
- **Automatische Datenextraktion** von ImmoMetrica-Immobilienangeboten
- **76,3% Feldabdeckung** (90/118 Felder) mit 100% Erfolgsrate für Kernbereiche
- **Deutsche Sprachunterstützung** für alle Immobilienbegriffe und KPIs
- **Multi-Platform Integration** für alle großen deutschen Immobilienportale

### Unterstützte Datenkategorien
- ✅ **Grunddaten**: 100% (22/22 Felder) - Kaufpreis, Wohnfläche, Zimmer, Baujahr
- ✅ **Finanzdaten & KPIs**: 100% (19/19 Felder) - Bruttorendite, Nettorendite, Cashflow
- ✅ **Immobilienmerkmale**: 100% (15/15 Felder) - Balkon, Terrasse, Garten, Garage
- ✅ **Energiedaten**: 100% (8/8 Felder) - Energieeffizienz, Heizungsart, Verbrauch

### Robuste Datenverarbeitung
- **Deutsche Zahlenformate** (3.400.000 €, 675 m²) werden korrekt verarbeitet
- **Intelligente Feldmappings** zwischen verschiedenen Datenquellen
- **Fehlerbehandlung** mit umfassender Null-Safety
- **Strukturierte JSON-Ausgabe** für einfache Weiterverarbeitung

## 📦 Installation

```bash
npm install n8n-nodes-immometrica
```

## 🔧 Konfiguration

1. **ImmoMetrica API Credentials** in n8n hinzufügen:
   - Email: Ihre ImmoMetrica Login-Email
   - Passwort: Ihr ImmoMetrica Passwort

2. **ImmoMetrica Node** zu Ihrem Workflow hinzufügen

3. **URL der Immobilie** eingeben, die analysiert werden soll

## 💡 Verwendung

### Basis-Workflow
```javascript
// Beispiel-Output für eine Immobilie
{
  "base_data": {
    "purchasePrice": 3400000,
    "livingArea": 675,
    "rooms": 6,
    "yearBuilt": 1997,
    "propertyType": "Mehrfamilienhaus"
  },
  "financial_data": {
    "bruttorendite": 4.2,
    "nettorendite": 3.8,
    "cashflow": 1250,
    "eigenkapitalrendite": 8.5
  },
  "features": {
    "balcony": true,
    "terrace": true,
    "garden": true,
    "garage": true
  }
}
```

### Erweiterte Funktionen
- **Batch-Verarbeitung** mehrerer Immobilien
- **Datenvalidierung** und -bereinigung
- **Export** in verschiedene Formate (JSON, CSV, Excel)
- **Integration** mit anderen n8n Nodes für komplexe Workflows

## 🔄 Aktuelle Version: 1.0.39

### Neueste Verbesserungen
- **Kritischer Pipeline-Fix**: Behebt Datenverlust in der Extraktions-Pipeline
- **Verbesserte Null-Safety**: Verhindert Laufzeitfehler bei undefinierten Werten
- **Optimierte Feldmappings**: 100% Datenerhaltung durch Normalisierungsprozess
- **Deutsche KPI-Unterstützung**: Vollständige Unterstützung aller deutschen Immobilien-KPIs

## 🛠️ Entwicklung

### Lokale Entwicklung
```bash
# Repository klonen
git clone https://github.com/julez4125/n8n-nodes-immometrica.git
cd n8n-nodes-immometrica

# Dependencies installieren
npm install

# Build
npm run build

# Linting
npm run lint
```

### Testing
```bash
# Fokussierte Extraktion testen
node test_focused_extraction.js

# Umfassende Extraktion testen
node test_comprehensive_extraction.js

# Pipeline-Fix testen
node test_extraction_pipeline_fix.js
```

## 📊 Leistungsmetriken

- **Extraktionsgeschwindigkeit**: ~2-3 Sekunden pro Immobilie
- **Erfolgsrate**: 100% für Kerndaten, 76,3% gesamt
- **Unterstützte Portale**: ImmoScout24, Immowelt, Scout24, eBay Kleinanzeigen
- **Datenqualität**: Automatische Validierung und Bereinigung

## 🤝 Beitragen

Beiträge sind willkommen! Bitte:
1. Fork das Repository
2. Erstelle einen Feature-Branch
3. Committe deine Änderungen
4. Erstelle einen Pull Request

## 📄 Lizenz

MIT License - siehe [LICENSE](LICENSE) Datei für Details.

## 🔗 Links

- [n8n Community](https://community.n8n.io/)
- [ImmoMetrica](https://www.immometrica.com/)
- [npm Package](https://www.npmjs.com/package/n8n-nodes-immometrica)

## 📞 Support

Bei Fragen oder Problemen:
- GitHub Issues für Bug Reports und Feature Requests
- n8n Community Forum für allgemeine Fragen
- Email: [Kontakt über GitHub]

---

**Entwickelt für die deutsche Immobilienbranche** 🏠 **Powered by n8n** ⚡