joomil-mcp

Joomil.ch용 MCP 서버 — 2007년부터 운영 중인 스위스 대표 프랑스어 중고거래 마켓플레이스

34개 카테고리에서 45,000개 이상의 활성 매물을 탐색하고 검색하세요: 부동산, 차량, 일자리, 동물, 전자제품, 패션 등 — 모두 스위스 프랑스어권 지역(로망디)에서 제공됩니다.

도구

Related MCP server: willhaben-mcp

빠른 시작

원격 MCP 서버입니다 — 로컬 설치가 필요 없습니다.

엔드포인트: https://joomil-mcp.snowy-surf-deec.workers.dev/mcp

Claude Desktop

~/.claude/claude_desktop_config.json에 추가:

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

Cursor

MCP 설정에 추가:

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

예시 프롬프트

• "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."

에이전트를 위한 팁: 캉통으로 필터링하기 전에 get_cantons를 호출하세요 — API는 직관적이지 않은 표기를 사용합니다 (예: Berne이 아닌 Bern, Genève/Geneva가 아닌 Geneve). 자유 텍스트 사용자 요청의 경우 먼저 suggest_filters를 호출한 다음 반환된 filters 객체를 search_classifieds에 전달하세요.

API 참조

suggest_filters

search_classifieds에 바로 사용할 수 있는 filters 객체를 반환하며, 카테고리 신뢰도 점수와 매칭이 불확실할 때 경고도 함께 반환합니다. 카테고리 메타데이터는 MCP 레이어에서 잠시 캐시되어 제안마다 카테고리 트리를 다시 가져오지 않습니다.

유용한 예:

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

도구 응답에는 MCP 하위 호환성을 위해 간단한 사람이 읽을 수 있는 요약과 함께 압축된 직렬화 JSON이 content에 포함됩니다. 전체 데이터는 structuredContent에도 반환되며 results, total, limit, offset, has_more, next_offset, filtered_out(MCP 측 카테고리 제한으로 현재 페이지에서 제거된 항목)이 포함됩니다.

결과 형태 (각 항목):

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

전체 매물 세부 정보를 반환합니다: 전체 설명, 이미지, 카테고리 경로, 만료일, 부스트 레벨, 판매자 정보.

get_categories

get_cantons

매개변수 없음. search_classifieds의 canton 필터가 허용하는 캉통 값과 프랑스어 라벨을 반환합니다:

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

canton 필터에는 항상 name 필드(label_fr나 code가 아닌)를 전달하세요.

데이터

• 소스: Joomil.ch 공개 REST API

• 범위: 45,000개 이상의 활성 매물, 34개의 최상위 카테고리, 190,000명 이상의 등록 사용자

• 지역: 스위스 (프랑스어권 지역 — 로망디)

• 언어: 프랑스어

• 업데이트 주기: 실시간

• 인증: 필요 없음

제한 사항

이 MCP 서버는 읽기 전용이며 공개 데이터만 사용합니다.

• 쓰기 작업 불가: 매물 생성, 수정, 삭제 불가; 판매자에게 연락 불가.

• 인증 없음: 사용자 계정, 메시지, 즐겨찾기, 저장된 검색 없음.

• 판매자 연락 불가: 전화번호와 이메일 주소는 노출되지 않습니다 — 매물 url을 사용하여 Joomil.ch를 직접 여세요.

• 게시 불가: 광고 게시는 joomil.ch에서 해야 합니다.

• 제한된 카테고리: Erotique (28), Rencontres & Amitié (14000), Voyance & Astrologie (651) 및 그 하위 카테고리는 콘텐츠 정책에 따라 MCP 레이어에서 필터링됩니다. 기본 PHP API는 직접 사용할 수 있습니다.

• 캉통 필터는 엄격함: get_cantons가 반환한 값만 허용됩니다. 다른 표기(Berne, Genève, Geneva, GE, VD...)는 업스트림 API에서 조용히 무시되며 필터링된 결과 대신 모든 매물을 반환합니다 — 여기의 엄격한 enum이 이를 방지합니다.

• 통화: 모든 가격은 CHF입니다. 매물은 price.amount: null(가격 문의) 또는 0(무료)일 수 있습니다.

• 업스트림 오류: Joomil API 실패는 isError: true가 포함된 MCP 도구 오류로 반환됩니다.

직접 배포

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

라이선스

MIT