# 오픈스토어

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

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

## 찾기
- 상품 피드(JSON, 판매 중인 전체 목록): https://openstore.dev.giig.app/feeds/products.json
- 검색 API: GET https://openstore.dev.giig.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.dev.giig.app/api/listings/<id>
- 상품 페이지: https://openstore.dev.giig.app/listings/<id> (schema.org Product/Service JSON-LD 포함)
- 사이트맵: https://openstore.dev.giig.app/sitemap.xml

## AI 비서 연결 (MCP)
- MCP 엔드포인트(Streamable HTTP): https://openstore.dev.giig.app/mcp
- 도구: list_categories, search_listings, get_listing, create_checkout, update_checkout, get_checkout, get_order
- 안내: https://openstore.dev.giig.app/ai

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

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