마켓컬리 스킬

[vkehfdl1]

마켓컬리 상품 조회 가격 가져오기 등

[vkehfdl1]

• AI-understood issue summary

  • 사용자가 마켓컬리 상품을 검색하고, 상품 상세 핵심 정보 중 특히 현재 가격을 조회할 수 있는 조회형 스킬을 만들자는 요청으로 이해했습니다.
  • 최소 범위는 상품명/키워드 → 후보 목록 → 가격/판매 상태/링크 정도이고, 확장 범위로는 할인 정보·카테고리 탐색·정렬 조건이 포함될 수 있습니다.

• Why this issue is needed

  • k-skill 저장소에는 이미 소매/커머스 조회형 스킬이 여러 개 있고, 마켓컬리는 식품·생필품 쪽에서 사용자가 자주 찾는 채널이라 사용성이 있습니다.
  • 특히 장보기 맥락에서는 “지금 얼마인지”, “구매 가능한지”, “어떤 상품이 맞는지”를 빠르게 확인하는 니즈가 분명합니다.
  • 기존 retail 스킬 패턴(질의 정리 → 후보 검색 → 핵심 필드 요약)을 재사용하기 좋아 저장소 방향성과도 맞습니다.

• Why this issue may not be needed

  • 마켓컬리의 안정적인 공개 조회 표면이 없거나 로그인/앱 세션 의존성이 크면, 유지보수 비용 대비 가치가 낮을 수 있습니다.
  • 단순 가격 조회만 원한다면 범용 웹 검색/브라우저 기반 확인으로도 어느 정도 대체 가능할 수 있습니다.
  • 상품명 정규화, 옵션별 가격 차이, 지역/배송 가능 여부 차이까지 생기면 “정확한 가격 조회” 기대치를 만족시키기 어려울 수 있습니다.

• Expected Outcome

  • 사용자가 상품명 또는 키워드를 주면 마켓컬리 상품 후보와 함께 다음을 짧게 반환:
    • 상품명
    • 현재 표시 가격
    • 필요 시 원가/할인가 여부
    • 판매 상태(가능하면)
    • 상품 링크
  • 응답은 조회형 스킬답게 보수적으로 작성하고, 가격/재고/노출 정보는 시점에 따라 달라질 수 있음을 고지합니다.

• Concise implementation plan

  1. 마켓컬리에 로그인 없이 안정적으로 접근 가능한 공식/준공식 조회 표면이 있는지 먼저 확인합니다.
  2. 가능하면 기존 retail skill 패턴에 맞춰 search + normalize + format response의 최소 흐름으로 v1 범위를 정의합니다.
  3. 가격/상품명/링크 등 핵심 필드만 우선 지원하고, 할인/카테고리/정렬은 후순위로 둡니다.
  4. 실제 조회 결과가 불안정하면 브라우저/프록시 의존도를 명확히 문서화하고, 신뢰 가능한 범위만 응답하도록 제한합니다.
  5. SKILL.md 사용법과 실패 모드(로그인 필요, 지역/재고 차이, 가격 변동)를 함께 정리합니다.

• Agent Signature

  • dani / issue-request review

[vkehfdl1]

실제 로그인 없이 구현할 수 있는지 마켓컬리 조회 표면을 확인해봐. MCP /CLI/API 가 있는지부터 확인해봐

[vkehfdl1]

후속 확인 결과입니다. 2026-04-09 기준으로는 로그인 없이 v1 조회형 구현이 가능합니다.

확인한 표면

1. 공식 검색 페이지는 비로그인 접근 가능

   • https://www.kurly.com/search?sword=우유

2. 공식 웹앱이 쓰는 비로그인 JSON 검색 API가 실제로 열려 있음

   • 검색:
     • https://api.kurly.com/search/v4/sites/market/normal-search?keyword=우유&page=1
   • 검색 개수:
     • https://api.kurly.com/search/v3/sites/market/normal-search/count?keyword=우유&filters=&allow_replace=true
   • 위 두 엔드포인트를 로그인 쿠키 없이 직접 호출했을 때 200 응답을 확인했습니다.
   • 응답 필드에는 실제로 no, name, salesPrice, discountedPrice, discountRate, isSoldOut, deliveryTypeNames 같은 조회형 스킬에 필요한 값이 들어 있습니다.

3. 상품 상세 페이지도 비로그인 접근 가능

   • 예시: https://www.kurly.com/goods/5063110
   • SSR __NEXT_DATA__ 안에 name, basePrice, discountedPrice, isSoldOut, deliveryTypeNames 등이 포함되는 것도 확인했습니다.

MCP / CLI / API 관점 정리

• MCP: 마켓컬리 상품 조회용으로 바로 재사용할 공개 MCP는 찾지 못했습니다.
• CLI: 마켓컬리 조회 전용 공개 CLI도 찾지 못했습니다.
• API: 문서화된 공식 개발자용 Open API는 못 찾았지만, 웹 프런트가 실제 사용하는 비로그인 공개 JSON endpoint는 확인했습니다.

구현 판단

즉, 이 이슈는 브라우저 자동화나 로그인 세션 없이도 아래 흐름으로 v1 구현이 가능합니다.

1. keyword로 /search/v4/sites/market/normal-search 호출
2. 결과에서 상품번호/이름/가격/품절 여부 추출
3. 필요하면 /goods/<productNo> 페이지를 보조 조회로 사용

권장 범위

• v1 포함: 상품 검색, 현재 가격, 할인 여부, 품절 여부, 상품 링크
• v1 제외: 장바구니/주문/개인화 추천/주소 기반 배송 가능 여부/회원 전용 정보

리스크

가능은 하지만, 이건 공식 개발자 문서가 있는 Open API가 아니라 웹 내부 사용 표면이라서 스키마/헤더 요구사항이 바뀌면 깨질 수 있습니다. 그래서 구현한다면:

• 검색 API 우선
• 상세 페이지 SSR 데이터는 fallback
• 실패 모드 문서화
• 과도한 기능 확장 금지

정도로 보수적으로 가져가는 게 맞겠습니다.

[vkehfdl1]

/approve

[vkehfdl1]

close at #95