Joomil — Swiss Classifieds MCP

Search Swiss classifieds on Joomil.ch — top marketplace in French-speaking Switzerland since 2007.

사용해야 할까요

품질 및 안전성

A
설명 품질
96%
스키마 완전성
82%
이름 품질
96%
오염 위험
100%
권한 일치
100%
프로토콜 준수
100%

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~2,386토큰 (도구 정의)
~4.5 KB일반적인 응답 크기
중간 정도의 주의 영향 (128k 컨텍스트의 1.86%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

`claude_desktop_config.json` 파일에 다음을 추가하세요:

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

원격 엔드포인트

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

할 수 있는 일

도구 목록

도구 (5)

🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢suggest_filters(query)

Infer search_classifieds filters from a natural-language query. Use this before search_classifieds when the user mentions a category, location, canton or price in free text. Returns a ready-to-use filters object, a category confidence score and warnings for uncertain matches.

입력 스키마

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Natural-language search request, e.g. 'appartement 3 pièces à Sion' or 'Tesla Model 3 moins de 25000 CHF'."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

출력 스키마

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "filters": {
      "type": "object",
      "properties": {
        "q": {
          "type": [
            "string",
            "null"
          ]
        },
        "cat_id": {
          "type": [
            "number",
            "null"
          ]
        },
        "canton": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "Geneve",
                "Vaud",
                "Valais",
                "Fribourg",
                "Neuchatel",
                "Jura",
                "Bern",
                "Argovie",
                "Zurich",
                "Lucerne",
                "Bale-Ville",
                "Etranger"
              ]
            },
            {
              "type": "null"
            }
          ]
        },
        "location": {
          "type": [
            "string",
            "null"
          ]
        },
        "price_min": {
          "type": [
            "number",
            "null"
          ]
        },
        "price_max": {
          "type": [
            "number",
            "null"
          ]
        },
        "sort": {
          "type": "string",
          "enum": [
            "recent",
            "price_asc",
            "price_desc",
            "views"
          ]
        },
        "limit": {
          "type": "number"
        }
      },
      "required": [
        "q",
        "cat_id",
        "canton",
        "location",
        "price_min",
        "price_max",
        "sort",
        "limit"
      ],
      "additionalProperties": false
    },
    "category": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "number"
            },
            "name": {
              "type": "string"
            },
            "url": {
              "type": "string"
            },
            "parent_id": {
              "type": "number"
            },
            "confidence": {
              "type": "number"
            },
            "reason": {
              "type": "string"
            }
          },
          "required": [
            "id",
            "name",
            "url",
            "parent_id",
            "confidence",
            "reason"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "confidence": {
      "type": "number"
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "next_step": {
      "type": "string"
    }
  },
  "required": [
    "query",
    "filters",
    "category",
    "confidence",
    "warnings",
    "next_step"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢search_classifieds(q, cat_id, canton, location, price_min, ...)

Search classified ads on Joomil.ch — Switzerland's leading French-speaking classifieds marketplace (since 2007). Returns a paginated list of public listings with title, description (truncated to 300 chars), price, location, category and vendor info. All parameters are optional — call with no arguments to browse the latest listings. Use get_classified to fetch full details of a specific listing.

입력 스키마

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Full-text search query (searches title and description)"
    },
    "cat_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "Category ID filter — includes subcategories automatically. Use get_categories to browse available categories."
    },
    "canton": {
      "type": "string",
      "enum": [
        "Geneve",
        "Vaud",
        "Valais",
        "Fribourg",
        "Neuchatel",
        "Jura",
        "Bern",
        "Argovie",
        "Zurich",
        "Lucerne",
        "Bale-Ville",
        "Etranger"
      ],
      "description": "Swiss canton filter — strict enum. Use get_cantons for the official list. WARNING: values are API-specific (e.g. 'Bern' not 'Berne', 'Geneve' not 'Genève'/'Geneva'). Supported: Geneve, Vaud, Valais, Fribourg, Neuchatel, Jura, Bern, Argovie, Zurich, Lucerne, Bale-Ville, Etranger."
    },
    "location": {
      "type": "string",
      "description": "City name or postal code (NPA) — partial match"
    },
    "price_min": {
      "type": "number",
      "minimum": 0,
      "description": "Minimum price in CHF (inclusive)"
    },
    "price_max": {
      "type": "number",
      "minimum": 0,
      "description": "Maximum price in CHF (inclusive)"
    },
    "sort": {
      "type": "string",
      "enum": [
        "recent",
        "price_asc",
        "price_desc",
        "views"
      ],
      "description": "Sort order: recent (newest first, default), price_asc, price_desc, views"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Results per page (1–50, default 20)"
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Pagination offset. Use next_offset from previous response to get next page."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

출력 스키마

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number"
          },
          "title": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "price": {
            "type": "object",
            "properties": {
              "amount": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "currency": {
                "type": "string",
                "const": "CHF"
              }
            },
            "required": [
              "amount",
              "currency"
            ],
            "additionalProperties": false
          },
          "location": {
            "type": "object",
            "properties": {
              "city": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "postal_code": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "canton": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "country": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "city",
              "postal_code",
              "canton",
              "country"
            ],
            "additionalProperties": false
          },
          "category": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "number"
                  },
                  "name": {
                    "type": "string"
                  },
                  "url": {
                    "type": "string"
                  }
                },
                "required": [
                  "id",
                  "name",
                  "url"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "url": {
            "type": "string"
          },
          "created_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "has_picture": {
            "type": "boolean"
          },
          "seller": {
            "type": "object",
            "properties": {
              "name": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "certified": {
                "type": "boolean"
              }
            },
            "required": [
              "name",
              "certified"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "id",
          "title",
          "price",
          "location",
          "category",
          "url",
          "created_at",
          "has_picture",
          "seller"
        ],
        "additionalProperties": false
      }
    },
    "total": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "has_more": {
      "type": "boolean"
    },
    "next_offset": {
      "type": [
        "number",
        "null"
      ]
    },
    "filtered_out": {
      "type": "number"
    }
  },
  "required": [
    "results",
    "total",
    "limit",
    "offset",
    "has_more",
    "next_offset",
    "filtered_out"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢get_classified(id)

Get full details of a single classified ad on Joomil.ch by its numeric ID. Returns complete description, all images URLs, category breadcrumb (full_path), vendor info (name, certified status, pro company), expiry date and boost level. Use search_classifieds first to find relevant listing IDs.

입력 스키마

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "Numeric listing ID — visible in the URL and in search_classifieds results"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

출력 스키마

{
  "type": "object",
  "properties": {
    "id": {
      "type": "number"
    },
    "title": {
      "type": "string"
    },
    "description": {
      "type": [
        "string",
        "null"
      ]
    },
    "price": {
      "type": "object",
      "properties": {
        "amount": {
          "type": [
            "number",
            "null"
          ]
        },
        "currency": {
          "type": "string",
          "const": "CHF"
        }
      },
      "required": [
        "amount",
        "currency"
      ],
      "additionalProperties": false
    },
    "location": {
      "type": "object",
      "properties": {
        "city": {
          "type": [
            "string",
            "null"
          ]
        },
        "postal_code": {
          "type": [
            "string",
            "null"
          ]
        },
        "canton": {
          "type": [
            "string",
            "null"
          ]
        },
        "country": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "city",
        "postal_code",
        "canton",
        "country"
      ],
      "additionalProperties": false
    },
    "category": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "number"
            },
            "name": {
              "type": "string"
            },
            "url": {
              "type": "string"
            },
            "path": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "id",
            "name",
            "url",
            "path"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "url": {
      "type": "string"
    },
    "created_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "has_picture": {
      "type": "boolean"
    },
    "seller": {
      "type": "object",
      "properties": {
        "name": {
          "type": [
            "string",
            "null"
          ]
        },
        "certified": {
          "type": "boolean"
        },
        "type": {
          "type": "string",
          "enum": [
            "pro",
            "private"
          ]
        },
        "company": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "name",
        "certified",
        "type",
        "company"
      ],
      "additionalProperties": false
    },
    "images": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "expires_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "boost": {
      "type": [
        "number",
        "null"
      ]
    }
  },
  "required": [
    "id",
    "title",
    "description",
    "price",
    "location",
    "category",
    "url",
    "created_at",
    "has_picture",
    "seller",
    "images",
    "expires_at",
    "boost"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢get_categories(parent_id)

List active categories of the Joomil.ch marketplace. Returns a flat list with parent_id for hierarchy reconstruction. Omit parent_id for all categories, use parent_id=0 for root categories only, or pass a specific ID to get direct children of that category.

입력 스키마

{
  "type": "object",
  "properties": {
    "parent_id": {
      "type": "integer",
      "minimum": 0,
      "description": "Filter to direct children of this category ID. Omit for all categories. Use 0 for root categories only."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

출력 스키마

{
  "type": "object",
  "properties": {
    "categories": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number"
          },
          "name": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "parent_id": {
            "type": "number"
          },
          "ad_count": {
            "type": "number"
          },
          "allow_ads": {
            "type": "boolean"
          }
        },
        "required": [
          "id",
          "name",
          "url",
          "parent_id"
        ],
        "additionalProperties": true
      }
    },
    "total": {
      "type": "number"
    }
  },
  "required": [
    "categories",
    "total"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢get_cantons

List the Swiss cantons supported by Joomil's `canton` filter. Returns the exact `name` value to pass to search_classifieds, plus a readable French label. Call this before filtering by canton — the API values are non-obvious (e.g. 'Bern' not 'Berne', 'Geneve' not 'Genève' or 'Geneva').

입력 스키마

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

출력 스키마

{
  "type": "object",
  "properties": {
    "cantons": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "label_fr": {
            "type": "string"
          },
          "code": {
            "type": [
              "string",
              "null"
            ]
          },
          "region": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "label_fr",
          "code",
          "region"
        ],
        "additionalProperties": false
      }
    },
    "total": {
      "type": "number"
    }
  },
  "required": [
    "cantons",
    "total"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

커뮤니티

이 서버 평가하기

증거

최근 관측

검증됨버전이 기록되지 않음도구 5개
검증됨버전이 기록되지 않음도구 5개
검증됨버전이 기록되지 않음도구 5개
검증됨버전이 기록되지 않음도구 5개
검증됨버전이 기록되지 않음도구 5개
검증됨버전이 기록되지 않음도구 5개
검증됨버전이 기록되지 않음도구 5개