joomil-mcp

MCP-Server für Joomil.ch — der führende französischsprachige Kleinanzeigen-Marktplatz der Schweiz, aktiv seit 2007.

Durchsuchen und suchen Sie 45.000+ aktive Inserate in 34 Kategorien: Immobilien, Fahrzeuge, Jobs, Tiere, Elektronik, Mode und mehr – alles aus den französischsprachigen Regionen der Schweiz (Romandie).

Tools

Related MCP server: willhaben-mcp

Schnellstart

Dies ist ein Remote-MCP-Server – keine lokale Installation erforderlich.

Endpunkt: https://joomil-mcp.snowy-surf-deec.workers.dev/mcp

Claude Desktop

Fügen Sie zu ~/.claude/claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "joomil": {
      "command": "npx",
      "args": ["mcp-remote", "https://joomil-mcp.snowy-surf-deec.workers.dev/mcp"]
    }
  }
}

Cursor

Fügen Sie zu Ihren MCP-Einstellungen hinzu:

{
  "joomil": {
    "url": "https://joomil-mcp.snowy-surf-deec.workers.dev/mcp"
  }
}

Beispiel-Prompts

• "Trouve-moi une voiture automatique à moins de 10'000 CHF dans le canton de Vaud."

• "Cherche un appartement 3 pièces à Sion."

• "Quelles catégories d'électronique propose Joomil ?"

• "Montre-moi les annonces de canapés vintage en Valais."

• "Cherche des offres d'emploi dans l'hôtellerie à Neuchâtel."

Tipp für Agenten: Rufen Sie get_cantons auf, bevor Sie nach Kanton filtern – die API verwendet nicht offensichtliche Schreibweisen (z. B. Bern statt Berne, Geneve statt Genève/Geneva). Bei Freitext-Anfragen von Benutzern rufen Sie zuerst suggest_filters auf und übergeben Sie dann das zurückgegebene filters-Objekt an search_classifieds.

API-Referenz

suggest_filters

Gibt ein gebrauchsfertiges filters-Objekt für search_classifieds zurück, plus einen Kategorie-Konfidenzwert und Warnungen, wenn die Zuordnung unsicher ist. Die Kategoriemetadaten werden von der MCP-Schicht kurz zwischengespeichert, um ein erneutes Abrufen des Kategoriebaums für jeden Vorschlag zu vermeiden.

Nützliche Beispiele:

{
  "query": "appartement 3 pièces à Sion",
  "filters": {
    "q": "3 pièces",
    "cat_id": 10255,
    "canton": null,
    "location": "Sion",
    "price_min": null,
    "price_max": null,
    "sort": "recent",
    "limit": 20
  },
  "category": {
    "id": 10255,
    "name": "Appartements",
    "url": "https://www.joomil.ch/annonces/immobilier/locations/appartements/10255",
    "parent_id": 339,
    "confidence": 0.82,
    "reason": "requête immobilière appartement"
  },
  "confidence": 0.74,
  "warnings": [],
  "next_step": "Call search_classifieds with the filters object. Adjust q or cat_id if the result set is too broad."
}

search_classifieds

Tool-Antworten enthalten eine kurze, für Menschen lesbare Zusammenfassung, gefolgt von kompaktem serialisiertem JSON in content für die MCP-Rückwärtskompatibilität. Vollständige Daten werden auch in structuredContent zurückgegeben, mit results, total, limit, offset, has_more, next_offset und filtered_out (Elemente, die von der aktuellen Seite durch MCP-seitige Kategoriebeschränkungen entfernt wurden).

Ergebnisform (jedes Element):

{
  "id": 366872, "title": "Maison avec étangs",
  "price": { "amount": 237977.5, "currency": "CHF" },
  "location": { "city": "Saint Eugène", "postal_code": "71320", "canton": "Geneve", "country": "FR" },
  "category": { "id": 10261, "name": "Maisons & Villas", "url": "https://..." },
  "url": "https://www.joomil.ch/annonce/.../366872",
  "created_at": "2026-06-26T22:17:11+02:00",
  "has_picture": true,
  "seller": { "name": "jpclair", "certified": false }
}

get_classified

Gibt vollständige Inseratsdetails zurück, einschließlich vollständiger Beschreibung, Bilder, Kategoriepfad, Ablaufdatum, Boost-Level und Verkäuferdetails.

get_categories

get_cantons

Keine Parameter. Gibt die vom canton-Filter von search_classifieds akzeptierten Kantonswerte mit ihren französischen Bezeichnungen zurück:

{
  "cantons": [
    { "name": "Geneve", "label_fr": "Genève", "code": "GE", "region": "Romandie" },
    { "name": "Bern", "label_fr": "Berne", "code": "BE", "region": "Suisse alémanique" }
  ],
  "total": 12
}

Übergeben Sie immer das name-Feld (nicht label_fr oder code) an den canton-Filter.

Daten

• Quelle: Joomil.ch öffentliche REST-API

• Abdeckung: 45.000+ aktive Inserate, 34 Hauptkategorien, 190.000+ registrierte Benutzer

• Standort: Schweiz (französischsprachige Regionen – Romandie)

• Sprache: Französisch

• Aktualisierungshäufigkeit: Echtzeit

• Authentifizierung: Keine erforderlich

Einschränkungen

Dieser MCP-Server ist schreibgeschützt und verwendet nur öffentliche Daten.

• Keine Schreibvorgänge: Kann keine Inserate erstellen, bearbeiten oder löschen; kann Verkäufer nicht kontaktieren.

• Keine Authentifizierung: keine Benutzerkonten, keine Nachrichten, keine Favoriten, keine gespeicherten Suchen.

• Kein Verkäuferkontakt: Telefonnummern und E-Mail-Adressen werden nicht offengelegt – verwenden Sie die url des Inserats, um Joomil.ch direkt zu öffnen.

• Kein Einstellen: Das Veröffentlichen einer Anzeige muss auf joomil.ch erfolgen.

• Eingeschränkte Kategorien: Erotique (28), Rencontres & Amitié (14000), Voyance & Astrologie (651) und deren Unterkategorien werden von der MCP-Schicht gemäß der Inhaltsrichtlinie herausgefiltert. Die zugrunde liegende PHP-API bleibt für die direkte Nutzung verfügbar.

• Kanton-Filter ist strikt: Nur die von get_cantons zurückgegebenen Werte werden akzeptiert. Andere Schreibweisen (Berne, Genève, Geneva, GE, VD...) werden von der vorgelagerten API stillschweigend ignoriert und würden alle Inserate statt einer gefilterten Menge zurückgeben – die strikte Aufzählung hier verhindert das.

• Währung: Alle Preise sind in CHF. Inserate können price.amount: null (Preis auf Anfrage) oder 0 (kostenlos) haben.

• Fehler der vorgelagerten API: Fehler der Joomil-API werden als MCP-Tool-Fehler mit isError: true zurückgegeben.

Eigene Instanz bereitstellen

git clone https://github.com/Valmo-Sarl/joomil-mcp
cd joomil-mcp
npm install
npx wrangler login
npm run deploy

Lizenz

MIT