n8n-nodes-immometrica

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

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

4. Detail-Scraping aktivieren (optional): Aktiviert das Scraping von Detail-Seiten für zusätzliche Immobiliendaten wie das "Art" Feld aus der Eigenschaften-Box

💡 Verwendung

Basis-Workflow

// 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
• Detail-Scraping aktivierbar: Optionales Scraping von Detail-Seiten für zusätzliche Immobiliendaten wie "Art" Feld aus der Eigenschaften-Box
• Datenvalidierung und -bereinigung
• Export in verschiedene Formate (JSON, CSV, Excel)
• Integration mit anderen n8n Nodes für komplexe Workflows

🔄 Aktuelle Version: 1.0.9

Neueste Verbesserungen (Version 1.0.9)

• enableDetailScraping Parameter: Neuer optionaler Parameter zur Aktivierung des Detail-Scrapings
• "Art" Feld Extraktion: Automatische Extraktion des "Art" Feldes aus der Eigenschaften-Box als propertyType
• Verbesserte Limitierung: Korrekte Anwendung der maxResults-Begrenzung auf CSV-Verarbeitung und Detail-Scraping
• Fallback-Logik: Robuste Fallback-Mechanismen für propertyType-Extraktion

Frühere Verbesserungen (Version 1.0.39)

• 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

# 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

# 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 Datei für Details.

🔗 Links

• n8n Community
• ImmoMetrica
• npm Package

📞 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 ⚡