# 오픈스토어

> 한국의 오픈마켓. 생활 상품과 동네 서비스(심부름·줄서기, 이사·짐 나르기, 대타·단기 일손, 레슨, 수리 등)를 여러 판매자가 등록하고, 구매자는 웹이나 AI 비서로 찾아 주문한다. 오픈스토어는 통신판매중개자이며 거래 당사자는 각 판매자다.

## 카테고리
- 상품 (id: goods, 상품): https://openstore.litoo.app/search?category=goods
- 심부름·줄서기 (id: errand, 서비스): https://openstore.litoo.app/search?category=errand
- 역할대행(하객·친구) (id: role_proxy, 서비스): https://openstore.litoo.app/search?category=role_proxy
- 이사·짐 나르기 (id: moving_help, 서비스): https://openstore.litoo.app/search?category=moving_help
- 대타·단기 일손 (id: shift_cover, 서비스): https://openstore.litoo.app/search?category=shift_cover
- 레슨·과외 (id: lesson, 서비스): https://openstore.litoo.app/search?category=lesson
- 수리·설치 (id: repair, 서비스): https://openstore.litoo.app/search?category=repair

## 찾기
- 상품 피드(JSON, 판매 중인 전체 목록): https://openstore.litoo.app/feeds/products.json
- 검색 API: GET https://openstore.litoo.app/api/listings?q=<검색어>&area=<지역>&category=<id>&kind=product|service&min_price=&max_price=&sort=newest|popular|rating|price_asc|price_desc&limit=&offset=
- 상품 상세 API: GET https://openstore.litoo.app/api/listings/<id>
- 상품 페이지: https://openstore.litoo.app/listings/<id> (schema.org Product/Service JSON-LD 포함)
- 사이트맵: https://openstore.litoo.app/sitemap.xml

## AI 비서 연결 (MCP)
- MCP 엔드포인트(Streamable HTTP, 인증 없음): https://openstore.litoo.app/mcp
- 추천: recommend_products 에 사용자 요청 문장을 그대로 보내면 서버가 요청을 읽고 쿠팡 파트너스 검색과 오픈스토어 상품에서 맞는 것을 골라 이유(reason)와 함께 돌려준다
- 그 밖의 도구: search_listings(조건 검색), list_categories, get_listing, create_checkout, update_checkout, get_checkout, get_order
- 결과 첫 줄의 안내(구매 방법·고지 문구)를 따른다. 쿠팡 등 외부 판매처 상품(purchase=external)은 buy_url 링크로만 안내하고 주문서를 만들지 않는다
- 쿠팡 상품을 추천하면 답변 끝에 「이 게시물은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다.」를 적는다. 가격은 price_checked_at 기준이라 바뀔 수 있다
- 안내: https://openstore.litoo.app/guide/ai

## 주문과 결제
- 에이전트는 주문서(checkout session)를 만들 수 있지만 결제는 하지 않는다.
- 주문서를 만들면 결제 링크(https://openstore.litoo.app/checkout/<checkout_id>)를 사용자에게 전달한다. 사용자가 그 페이지에서 정보를 확인하고 직접 결제한다.
- 결제 후 주문 상세: https://openstore.litoo.app/orders/<order_id>
- 서비스 예약은 희망 일시(appointment_start, RFC3339, 한국 시간 +09:00)와 장소가 필요하다.

## 정책
- 이용약관: https://openstore.litoo.app/terms
- 개인정보 처리방침: https://openstore.litoo.app/privacy
- 고객센터: https://openstore.litoo.app/help
- 연애·애인대행 등 이성 만남 매개 서비스와 법령상 금지 상품은 판매하지 않는다.