짓닷 카탈로그 API · MCP 안내

짓닷에 공개된 인테리어 마감재 카탈로그를 AI 에이전트와 개발자 코드가 읽는 방법입니다. MCP 서버와 REST API 모두 읽기 전용이고 인증 없이 부릅니다.

읽을 수 있는 것

웹에 공개된 타일 · 마루 · 카펫타일 · LVT · 포보(LVS) 자재의 짓닷코드, 표시명, 분류, 재질, 마감, 규격(mm), 대표 사진, 설계 파일 유무입니다. 재고는 수량이 아니라 「재고 있음 · 재고 확인 필요 · 품절」 가운데 하나로 나옵니다. 소비자가는 가격이 공개된 자재에만 붙고, 회원 등급 가격과 공급처는 나오지 않습니다.

MCP 서버

주소는 https://jitdot.com/mcp 입니다. Streamable HTTP 로 붙고 인증은 없습니다. 도구는 다섯이고 모두 읽기 전용입니다.

도구	하는 일
`search_materials`	분류 · 규격 · 재질 · 마감 · 낱말로 자재를 찾습니다.
`get_materials`	짓닷코드로 표시명 · 규격 · 사진 · 설계 파일 유무 · 재고 상태 · 공개 소비자가를 봅니다.
`get_design_files`	스케치업 .skm · 캐드 .pat · .dxf · 텍스처를 받을 수 있는지와 받는 곳을 봅니다.
`check_stock`	재고 상태를 「재고 있음 · 재고 확인 필요 · 품절」 가운데 하나로 봅니다.
`list_filters`	고를 수 있는 규격 · 재질 · 마감과 종수를 봅니다.

claude.ai

설정의 커넥터에서 맞춤 커넥터를 추가하고 주소에 https://jitdot.com/mcp 를 넣습니다. 인증은 로그인 없음을 고릅니다.

클로드 코드

claude mcp add --transport http jitdot https://jitdot.com/mcp

커서

프로젝트의 .cursor/mcp.json 에 아래 한 벌을 넣습니다.

{
  "mcpServers": {
    "jitdot": {
      "url": "https://jitdot.com/mcp"
    }
  }
}

REST API

모두 GET 이고 JSON 으로 답합니다. 응답에는 응답 시각과 출처가 함께 실립니다.

주소	하는 일
`https://jitdot.com/api/catalog/v1/search?category=타일&size=600x600&finish=무광`	조건 · 낱말 검색. 한 번에 24개, 5쪽까지
`https://jitdot.com/api/catalog/v1/materials/{짓닷코드}`	자재 하나의 공개 정보
`https://jitdot.com/api/catalog/v1/materials?codes=A,B`	여러 자재(10개까지)
`https://jitdot.com/api/catalog/v1/materials/{짓닷코드}/design-files`	설계 파일 유무와 받는 곳
`https://jitdot.com/api/catalog/v1/stock?codes=A,B`	재고 상태(10개까지)
`https://jitdot.com/api/catalog/v1/filters?category=타일`	고를 수 있는 조건과 종수

캐드 해치(.pat)와 범례(.dxf)는 /materials/{짓닷코드}/files/hatch.pat · /files/legend.dxf 에서 바로 받습니다. 스케치업 .skm 은 회원 가입 뒤 라이브러리에서 받습니다.

요청 상한

IP 하나에 분당 30회, 하루 1,000회입니다. 넘으면 429 와 Retry-After 머리로 답합니다. 검색 한 번에 24개, 5쪽까지 넘겨 볼 수 있고 짓닷코드는 한 번에 10개까지 묻습니다. 전체 목록을 한 번에 내려받는 주소는 없습니다.

이용 조건

짓닷 카탈로그 정보는 자재를 찾고 비교하는 데 쓸 수 있습니다. 출처(짓닷 · jitdot.com 링크)를 밝혀야 하고, 데이터를 모아 다시 파는 일 · 다른 카탈로그를 만드는 일 · 가격 비교 서비스에 넣는 일은 서면 허락이 있어야 합니다.

요청 기록에는 IP 원문을 남기지 않고, 90일이 지나면 월별 집계만 남깁니다.

문의

문의와 제휴는 support@jitdot.com 으로 받습니다.