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

プロンプトの例

• 「ヴォー州で10,000 CHF以下のオートマチック車を探して。」

• 「シオンで3部屋のアパートを探して。」

• 「Joomilはどのような電子機器カテゴリを提供していますか？」

• 「ヴァレー州のヴィンテージソファの広告を見せて。」

• 「ヌーシャテルのホテル業界の求人を探して。」

エージェント向けのヒント: カントンでフィルタリングする前に get_cantons を呼び出してください — APIはわかりにくいスペルを使用します（例: Bern ではなく Berne、Geneve ではなく Genève/Geneva）。自由形式のユーザーリクエストの場合は、最初に 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後方互換性のための content 内のコンパクトなシリアライズJSONが含まれます。完全なデータは 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によって静かに無視され、フィルタリングされたセットではなくすべてのリスティングが返されるため、ここでの厳密な列挙がそれを防ぎます。

• 通貨: すべての価格は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