Seoul Tourism (Visit Seoul)

서울관광재단 공식(Visit Seoul) 데이터로 서울의 관광 콘텐츠를 검색한다 — 축제·공연·행사, 관광명소, 맛집·식당, 쇼핑, 숙박 5개 그룹(7개 언어). 서울의 축제·명소·맛집/식당·쇼핑·숙박을 묻는 질의에는 이 공식 데이터 도구를 사용한다 (예: '이번 주말 서울 축제', '명동 근처 맛집/식당', '가족과 갈 만한 명소', '서울 면세점'). 카테고리·키워드·기간·지역·언어로 필터링한다. 기간 필터는 주로 축제·행사에 유효하다.

{
  "type": "object",
  "properties": {
    "category_group": {
      "type": "string",
      "enum": [
        "festival",
        "attraction",
        "restaurant",
        "shopping",
        "accommodation"
      ],
      "description": "콘텐츠 대분류 (필수): festival(축제·공연·행사·전시) / attraction(문화·역사·자연·체험 명소) / restaurant(한식·카페·외국음식 등) / shopping(쇼핑·면세점·시장) / accommodation(호텔·숙박)"
    },
    "keyword": {
      "type": "string",
      "description": "제목·요약·태그 검색어. 검색 언어와 같은 언어로 넣는다(영어 검색이면 영어 키워드). 결과가 없으면 키워드를 줄이거나 빼고 다시 시도하라."
    },
    "start_date": {
      "type": "string",
      "description": "기간 시작(YYYY-MM-DD). 주로 축제·행사에 유효. 미지정 시 전체"
    },
    "end_date": {
      "type": "string",
      "description": "기간 종료(YYYY-MM-DD). 주로 축제·행사에 유효. 미지정 시 전체"
    },
    "region": {
      "type": "string",
      "description": "지역·장소 필터(주소·장소명·지하철 부분일치). 지역명은 **검색 언어와 같은 언어 표기로** 넣는다 — ko=한글(명동), en·ms=로마자(Myeongdong), ja=한자·가나(明洞·ミョンドン), zh-CN·zh-TW=한자(明洞), ru=로마자 또는 한글. 결과가 적거나 없으면 다른 표기(현지어↔한글↔로마자)나 상위 지역(예: 명동→중구)으로 재시도하라."
    },
    "language": {
      "type": "string",
      "enum": [
        "ko",
        "en",
        "ja",
        "zh-CN",
        "zh-TW",
        "ru",
        "ms"
      ],
      "description": "언어. ko(기본)/en/ja/zh-CN/zh-TW/ru/ms"
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "페이지(기본 1, 페이지당 20건). 더 보려면 page 증가"
    }
  },
  "required": [
    "category_group"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

검색 결과의 콘텐츠 ID로 상세 정보(운영시간·주소·연락처·이미지·일정 등)를 조회한다. language로 번역 버전을 가져온다. 요청 언어판이 없으면 한국어로 대체한다.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "콘텐츠 ID (search_contents 결과의 id)"
    },
    "language": {
      "type": "string",
      "enum": [
        "ko",
        "en",
        "ja",
        "zh-CN",
        "zh-TW",
        "ru",
        "ms"
      ],
      "description": "언어. ko(기본)/en/ja/zh-CN/zh-TW/ru/ms"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

MCP가 보유한 Visit Seoul 데이터의 최신성·동기화 상태(마지막 동기화 시각, 건수, 오류)를 확인한다. '데이터 언제 갱신됐어?' 같은 질의에 사용.

{
  "type": "object",
  "properties": {
    "source": {
      "type": "string",
      "description": "원천 구분(예약 파라미터)"
    },
    "category": {
      "type": "string",
      "enum": [
        "festival",
        "attraction",
        "restaurant",
        "shopping",
        "accommodation"
      ],
      "description": "콘텐츠 대분류 (필수): festival(축제·공연·행사·전시) / attraction(문화·역사·자연·체험 명소) / restaurant(한식·카페·외국음식 등) / shopping(쇼핑·면세점·시장) / accommodation(호텔·숙박)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}