리옵트 플레이스 · Reopt Place
리옵트 플레이스 개발자 문서
리옵트 플레이스(Reopt Place)는 사람이 보는 지도 외에 에이전트와 개발자가 바로 쓸 수 있는 표현을 함께 제공합니다. API 키도, 가입도, 승인 절차도 없습니다. 아래 URL을 그대로 GET 하거나 MCP 서버를 붙이면 됩니다.
엔드포인트
REST API · 오류와 요청 한도
https://place.reopt.ai/api/v1/dataset
컬렉션·장소·브랜드·행사 JSON. RFC 9457 application/problem+json 오류.
GET /api/v1/dataset (쿼리 없음). 오류에는 code, message, resolution이 포함됩니다. RateLimit-Policy와 RateLimit은 draft-ietf-httpapi-ratelimit-headers-11 형식이며, 서버 프로세스마다 모든 클라이언트가 60초당 120회를 공유합니다. 재시작 시 초기화되며 전역 할당량이 아닙니다. 429에서는 Retry-After 초만큼 기다리세요. 기존 /map-data는 캐시된 지도 데이터입니다.
curl -i https://place.reopt.ai/api/v1/dataset공식 CLI (출시 준비 중)
https://place.reopt.ai/developers#cli
@reopt/place-cli 패키지는 저장소에서 실행할 수 있으며 npm에는 아직 게시되지 않았습니다.
Node.js 20 이상. dataset과 openapi 명령이 JSON을 출력합니다. 오류는 stderr와 종료 코드 1로 전달하며 자동 재시도하지 않습니다. npm scope 소유권과 라이선스 확인 후 게시할 예정입니다.
node packages/cli/cli.mjs datasetMCP 서버 (Model Context Protocol)
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 키, 가입, 요금제가 없습니다. REST API 요청 한도는 위 정책을 확인하세요. 샌드박스와 프로덕션이 같은 URL이고, 모든 엔드포인트가 읽기 전용이라 테스트가 데이터를 바꾸지 않습니다. 영업 문의 없이 바로 쓰세요.
요청 예의
초당 1회 이하를 권장합니다. 데이터 전체가 필요하면 페이지를 순회하지 말고 /map-data 또는 /llms-full.txt를 한 번 받으면 됩니다. 캐시가 걸려 있으므로 같은 URL을 반복해서 받아도 원본에 부담이 가지 않습니다.
데이터 출처와 정정
장소는 도로명 주소가 확인되는 곳만 등록하고 좌표는 주소를 기준으로 다시 맞춥니다. 사진과 영상은 출처를 함께 표기합니다. 잘못된 내용을 발견하면 해당 URL과 함께 contact@reopt.ai로 알려 주세요.
라이선스와 인용
개별 페이지를 읽고 인용하거나 링크하는 것은 자유롭습니다. 인용할 때는 출처로 place.reopt.ai를 표기해 주세요. 데이터베이스 전체를 복제해 재배포하는 것은 이용약관에서 금지하고 있습니다.