joomil-mcp

Servidor MCP para Joomil.ch — el principal mercado de anuncios clasificados de habla francesa de Suiza, activo desde 2007.

Explora y busca más de 45.000 anuncios activos en 34 categorías: inmuebles, vehículos, empleo, animales, electrónica, moda y más, todo desde las regiones francófonas de Suiza (Romandía).

Herramientas

Related MCP server: willhaben-mcp

Inicio rápido

Este es un servidor MCP remoto: no requiere instalación local.

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

Claude Desktop

Añade a ~/.claude/claude_desktop_config.json:

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

Cursor

Añade a tu configuración de MCP:

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

Ejemplos de 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."

Consejo para agentes: llama a get_cantons antes de filtrar por cantón: la API usa ortografías poco evidentes (p. ej. Bern no Berne, Geneve no Genève/Geneva). Para solicitudes de texto libre, llama primero a suggest_filters y luego pasa el objeto filters devuelto a search_classifieds.

Referencia de la API

suggest_filters

Devuelve un objeto filters listo para usar en search_classifieds, además de una puntuación de confianza de categoría y advertencias cuando la coincidencia es incierta. Los metadatos de categoría se almacenan en caché brevemente en la capa MCP para evitar volver a obtener el árbol de categorías en cada sugerencia.

Ejemplos útiles:

{
  "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

Las respuestas de la herramienta incluyen un breve resumen legible seguido de JSON serializado compacto en content para compatibilidad con MCP. Los datos completos también se devuelven en structuredContent con results, total, limit, offset, has_more, next_offset y filtered_out (elementos eliminados de la página actual por restricciones de categoría del lado MCP).

Forma del resultado (cada elemento):

{
  "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

Devuelve los detalles completos del anuncio, incluida la descripción completa, imágenes, ruta de categoría, fecha de caducidad, nivel de impulso y datos del vendedor.

get_categories

get_cantons

Sin parámetros. Devuelve los valores de cantón aceptados por el filtro canton de search_classifieds, con sus etiquetas en francés:

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

Pasa siempre el campo name (no label_fr ni code) al filtro canton.

Datos

• Fuente: API REST pública de Joomil.ch

• Cobertura: más de 45.000 anuncios activos, 34 categorías de nivel superior, más de 190.000 usuarios registrados

• Ubicación: Suiza (regiones francófonas — Romandía)

• Idioma: francés

• Frecuencia de actualización: tiempo real

• Autenticación: no se requiere

Limitaciones

Este servidor MCP es de solo lectura y utiliza solo datos públicos.

• Sin operaciones de escritura: no se pueden crear, editar ni eliminar anuncios; no se puede contactar con los vendedores.

• Sin autenticación: no hay cuentas de usuario, ni mensajes, ni favoritos, ni búsquedas guardadas.

• Sin contacto con el vendedor: no se exponen números de teléfono ni direcciones de correo electrónico; usa la url del anuncio para abrir Joomil.ch directamente.

• Sin publicación: publicar un anuncio debe hacerse en joomil.ch.

• Categorías restringidas: Erotique (28), Rencontres & Amitié (14000), Voyance & Astrologie (651) y sus descendientes se filtran en la capa MCP según la política de contenido. La API PHP subyacente sigue disponible para uso directo.

• El filtro de cantón es estricto: solo se aceptan los valores devueltos por get_cantons. Otras ortografías (Berne, Genève, Geneva, GE, VD...) son ignoradas silenciosamente por la API ascendente y devolverían todos los anuncios en lugar de un conjunto filtrado; el enum estricto aquí lo evita.

• Moneda: todos los precios están en CHF. Los anuncios pueden tener price.amount: null (precio bajo petición) o 0 (gratis).

• Errores ascendentes: los fallos de la API de Joomil se devuelven como errores de herramienta MCP con isError: true.

Despliega el tuyo

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

Licencia

MIT