kurly 사용 가이드

마켓컬리 상품 검색·가격·상세를 로그인 없이 조회합니다. Claude에게 말로 부탁하면 됩니다 — "마켓컬리에서 우유 얼마야?", "컬리에서 딸기 검색해줘", "이 상품 품절인지 보고 링크도 줘"처럼요. 터미널 명령을 직접 입력할 필요는 없습니다.

주문·장바구니·결제·로그인은 하지 않습니다. 보기만 하는 조회 전용 스킬입니다.

---

무엇을 할 수 있나요?

기능	이렇게 실행하세요
상품 검색	/kurly 마켓컬리에서 우유 검색해줘
가격·상세 조회 (상품 번호로)	/kurly 이 상품 가격이랑 배송 알려줘
가격·상세 조회 (상품명으로)	/kurly 컬리에서 전용목장우유 가격 봐줘

검색은 상품명·현재가·정가·할인율·품절 여부·상품 링크를 함께 보여줍니다. 가격·상세 조회는 검색 결과에는 없는 배송 타입(예: 샛별배송)·판매자·브랜드·재고 임박 여부까지 상품 상세 페이지에서 가져옵니다.

---

자주 쓰는 시나리오

상품을 검색해서 가격 훑어보기

/kurly 마켓컬리에서 우유 검색해줘라고 말하면 마켓컬리에서 파는 상품 목록을 가져옵니다. 각 상품의 이름·현재가·할인 중이면 정가·할인율·품절 여부·상품 링크가 함께 나옵니다.

• /kurly 마켓컬리에서 우유 검색해줘 — 기본 검색.
• /kurly 마켓컬리에서 딸기 검색해서 10개만 보여줘 — 보여줄 상품 수를 조절할 수 있습니다.
• /kurly 마켓컬리 우유 검색 다음 페이지도 보여줘 — 결과가 많으면 다음 페이지를 이어서 볼 수 있습니다.

정확 매칭이 없으면 추천 상품으로 대체될 수 있어요. 검색어가 마켓컬리에 정확히 매칭되지 않으면, 마켓컬리가 의미가 비슷한 상품을 대신 보여줍니다. 이 경우 결과에 "정확 매칭 없음 → 추천 상품"이라는 경고가 함께 표시됩니다. 추천으로 대체된 결과를 정확히 찾은 상품으로 오해하지 마세요. 더 구체적인 검색어로 다시 요청하면 정확도를 높일 수 있습니다.

특정 상품의 가격·배송·판매자 상세 보기

상품 번호를 알고 있다면 /kurly 이 상품 가격이랑 배송 알려줘처럼 말하세요. 검색 목록에는 없는 자세한 정보 — 배송 타입(예: 샛별배송)·판매자·브랜드·재고 임박 여부 — 까지 함께 조회합니다.

• /kurly 이 상품(번호) 가격이랑 배송 타입 알려줘
• /kurly 이 상품 품절인지 보고 링크도 같이 줘

상품 번호 대신 상품 이름으로도 상세를 볼 수 있습니다.

• /kurly 컬리에서 전용목장우유 가격이랑 배송 알려줘 — 이름으로 검색한 첫 번째 결과의 상세를 조회합니다.

상품 이름으로 조회할 때, 그 검색이 정확 매칭이 아니라 추천 대체였다면 결과에 추천 상품임을 알리는 표시가 함께 붙습니다. 정확히 그 상품을 찾은 상세인지, 비슷한 추천 상품의 상세인지 구분해서 보세요.

결과를 마크다운으로 보기 좋게 받기

/kurly 검색 결과 표로 보여줘처럼 말하면 상품명·가격·할인·품절·링크가 정리된 표로 보여줍니다. 상세 조회는 가격·배송 타입·판매자·브랜드·품절·재고 임박·링크가 담긴 카드 형태로 보여줍니다.

---

결과 저장

/kurly 우유 검색 결과 마크다운으로 저장해줘라고 말하면 파일로 저장합니다. 파일명이나 경로를 함께 말하면 그 위치에 저장합니다.

이 스킬은 결과를 자동으로 저장하지 않습니다(캐시 없음·매번 신선 조회). 보관하려면 저장을 명시적으로 요청하세요.

---

안 될 때

증상	원인 / 해결
"차단됐다"는 안내	마켓컬리 서버가 자동 조회를 차단(403·429)했습니다. 잠시 후 다시 시도하세요. 이 스킬은 차단을 우회하지 않습니다.
결과가 0건	검색어를 바꾸거나 범위를 넓혀 다시 말해보세요. 성인 인증이 필요한 상품은 비로그인 조회로는 볼 수 없어 결과가 비어 나올 수 있습니다.
정확히 찾던 상품이 아닌 것 같음	정확 매칭이 없어 추천 상품으로 대체됐을 수 있습니다(위 안내 참고). 더 구체적인 검색어로 다시 요청하세요.
네트워크 오류	인터넷 연결을 확인하고 잠시 후 다시 시도하세요.
마켓컬리 외 다른 곳 요청	이 스킬은 마켓컬리만 지원합니다. 다이소는 별도 스킬(daiso)에서 처리합니다.

---

알아두세요

• 조회 전용입니다. 주문·결제·장바구니·로그인은 지원하지 않습니다. 보기만 합니다.
• 마켓컬리만 지원합니다. 다른 리테일은 별도 스킬(예: daiso)에서 처리합니다.
• 봇 차단을 우회하지 않습니다. 차단(403·429)이 감지되면 우회를 시도하지 않고 즉시 멈춥니다.
• 비공식 공개 표면을 사용합니다. 공식 개발자 Open API가 아니라 마켓컬리 웹앱이 쓰는 비로그인 공개 표면을 사용하므로, 마켓컬리 측 사양 변경으로 예고 없이 동작이 달라질 수 있습니다.
• 회원·주소 전용 정보는 볼 수 없습니다. 회원 전용가·주소별 배송 가능 여부·개인화 추천이나 찜은 비로그인 조회로 확정할 수 없습니다.
• 가격·품절·노출은 조회 시점 기준 참고값입니다. 시점에 따라 달라질 수 있습니다.
• 추천 대체에 주의하세요. 정확 매칭이 없으면 마켓컬리가 비슷한 추천 상품으로 대체하며, 결과에 그 사실이 표시됩니다.
• 자가차단 방지. 같은 상품·검색어를 반복해서 연속 조회하면 차단될 수 있습니다. 필요한 정보를 한 번에 요청하고 결과를 저장해두는 것이 좋습니다.