리옵트 플레이스 개발자 문서

MCP 서버 (Model Context Protocol)

https://place.reopt.ai/mcp

Streamable HTTP 전송, 프로토콜 2026-07-28. 읽기 전용 도구 6개.

Claude, ChatGPT 등 MCP를 지원하는 클라이언트에 그대로 연결하면 컬렉션·장소·행사를 도구로 호출할 수 있습니다. 도구는 list_collections, get_collection, search_places, get_place, list_events, get_event 입니다. 공개 서버라 인증도 오리진 제한도 없습니다 — 토큰 설정이 필요 없고, CORS가 열려 있어 브라우저에서 도는 에이전트도 그대로 붙습니다. 모든 도구가 읽기 전용이라 부수 효과가 없습니다. 핸드셰이크 방식의 이전 리비전(2025-03-26 ~ 2025-11-25)도 함께 받습니다.

{
  "mcpServers": {
    "reopt-place": {
      "type": "http",
      "url": "https://place.reopt.ai/mcp"
    }
  }
}

마크다운 콘텐츠 협상

https://place.reopt.ai/collections/seoul-cafes

모든 canonical URL이 `Accept: text/markdown`으로 마크다운을 반환합니다.

acceptmarkdown.com 규격을 따릅니다. q-value 랭킹과 q=0 거부를 처리하고, 지원하지 않는 타입에는 406을 돌려줍니다. 마크다운 응답에는 `Vary: Accept`와 canonical `Link` 헤더가 붙습니다. Accept 헤더를 보내기 어려우면 URL 뒤에 `.md`를 붙이세요(홈은 `/index.md`).

curl -H "Accept: text/markdown" https://place.reopt.ai/collections/seoul-cafes
curl https://place.reopt.ai/collections/seoul-cafes.md

지도 데이터셋 (JSON)

https://place.reopt.ai/map-data

컬렉션, 장소, 브랜드, 행사 전체가 담긴 단일 JSON.

지도가 실제로 쓰는 데이터셋 그대로입니다. 전체 데이터가 필요하면 페이지를 훑지 말고 이 URL 하나만 받으세요. 정적으로 생성되어 CDN에서 바로 나갑니다.

curl https://place.reopt.ai/map-data | jq '.collections[0].title'

OpenAPI 설명

https://place.reopt.ai/openapi.json

위 엔드포인트들의 OpenAPI 3.1 기술서.

인증 스킴이 비어 있는 것이 의도된 상태입니다 — 공개 읽기 전용 엔드포인트라 자격 증명이 없습니다. 코드 생성이나 도구 등록에 사용하세요.

llms.txt / llms-full.txt

https://place.reopt.ai/llms.txt

에이전트용 색인과 '언제 쓰면 좋은가' 안내, 그리고 전체 본문 한 파일.

llms.txt에는 이 사이트가 답할 수 있는 질문과 답할 수 없는 질문을 함께 적어 두었습니다. llms-full.txt는 홈·소개·전 컬렉션·전 행사·정책 문서를 한 파일로 이어 붙인 것입니다.

사이트맵과 RSS

https://place.reopt.ai/sitemap.xml

이미지 확장을 포함한 사이트맵, 그리고 RSS 피드.

사이트맵은 컬렉션·장소·행사·브랜드의 모든 canonical URL을 담고 이미지 확장을 포함합니다. 새 컬렉션과 장소 업데이트는 https://place.reopt.ai/rss.xml 에서 받아볼 수 있습니다.

인증 없음, 무료

API 키, 가입, 할당량, 요금제가 없습니다. 샌드박스와 프로덕션이 같은 URL이고, 모든 엔드포인트가 읽기 전용이라 테스트가 데이터를 바꾸지 않습니다. 영업 문의 없이 바로 쓰세요.

요청 예의

초당 1회 이하를 권장합니다. 데이터 전체가 필요하면 페이지를 순회하지 말고 /map-data 또는 /llms-full.txt를 한 번 받으면 됩니다. 캐시가 걸려 있으므로 같은 URL을 반복해서 받아도 원본에 부담이 가지 않습니다.

데이터 출처와 정정

장소는 도로명 주소가 확인되는 곳만 등록하고 좌표는 주소를 기준으로 다시 맞춥니다. 사진과 영상은 출처를 함께 표기합니다. 잘못된 내용을 발견하면 해당 URL과 함께 contact@reopt.ai로 알려 주세요.

라이선스와 인용

개별 페이지를 읽고 인용하거나 링크하는 것은 자유롭습니다. 인용할 때는 출처로 place.reopt.ai를 표기해 주세요. 데이터베이스 전체를 복제해 재배포하는 것은 이용약관에서 금지하고 있습니다.