kurly 사용 가이드
마켓컬리 상품 검색·가격·상세를 로그인 없이 조회합니다. Claude에게 말로 부탁하면 됩니다 — “마켓컬리에서 우유 얼마야?”, “컬리에서 딸기 검색해줘”, “이 상품 품절인지 보고 링크도 줘”처럼요. 터미널 명령을 직접 입력할 필요는 없습니다.
주문·장바구니·결제·로그인은 하지 않습니다. 보기만 하는 조회 전용 스킬입니다.
무엇을 할 수 있나요?
| 기능 | 이렇게 말하세요 |
|---|---|
| 상품 검색 | ”마켓컬리에서 우유 검색해줘” |
| 가격·상세 조회 (상품 번호로) | “이 상품 가격이랑 배송 알려줘” |
| 가격·상세 조회 (상품명으로) | “컬리에서 전용목장우유 가격 봐줘” |
검색은 상품명·현재가·정가·할인율·품절 여부·상품 링크를 함께 보여줍니다. 가격·상세 조회는 검색 결과에는 없는 배송 타입(예: 샛별배송)·판매자·브랜드·재고 임박 여부까지 상품 상세 페이지에서 가져옵니다.
자주 쓰는 시나리오
상품을 검색해서 가격 훑어보기
“마켓컬리에서 우유 검색해줘”라고 말하면 마켓컬리에서 파는 상품 목록을 가져옵니다. 각 상품의 이름·현재가·할인 중이면 정가·할인율·품절 여부·상품 링크가 함께 나옵니다.
- “마켓컬리에서 우유 검색해줘” — 기본 검색.
- “마켓컬리에서 딸기 검색해서 10개만 보여줘” — 보여줄 상품 수를 조절할 수 있습니다.
- “마켓컬리 우유 검색 다음 페이지도 보여줘” — 결과가 많으면 다음 페이지를 이어서 볼 수 있습니다.
정확 매칭이 없으면 추천 상품으로 대체될 수 있어요. 검색어가 마켓컬리에 정확히 매칭되지 않으면, 마켓컬리가 의미가 비슷한 상품을 대신 보여줍니다. 이 경우 결과에 “정확 매칭 없음 → 추천 상품”이라는 경고가 함께 표시됩니다. 추천으로 대체된 결과를 정확히 찾은 상품으로 오해하지 마세요. 더 구체적인 검색어로 다시 요청하면 정확도를 높일 수 있습니다.
특정 상품의 가격·배송·판매자 상세 보기
상품 번호를 알고 있다면 “이 상품 가격이랑 배송 알려줘”처럼 말하세요. 검색 목록에는 없는 자세한 정보 — 배송 타입(예: 샛별배송)·판매자·브랜드·재고 임박 여부 — 까지 함께 조회합니다.
- “이 상품(번호) 가격이랑 배송 타입 알려줘”
- “이 상품 품절인지 보고 링크도 같이 줘”
상품 번호 대신 상품 이름으로도 상세를 볼 수 있습니다.
- “컬리에서 전용목장우유 가격이랑 배송 알려줘” — 이름으로 검색한 첫 번째 결과의 상세를 조회합니다.
상품 이름으로 조회할 때, 그 검색이 정확 매칭이 아니라 추천 대체였다면 결과에 추천 상품임을 알리는 표시가 함께 붙습니다. 정확히 그 상품을 찾은 상세인지, 비슷한 추천 상품의 상세인지 구분해서 보세요.
결과를 마크다운으로 보기 좋게 받기
“검색 결과 표로 보여줘”처럼 말하면 상품명·가격·할인·품절·링크가 정리된 표로 보여줍니다. 상세 조회는 가격·배송 타입·판매자·브랜드·품절·재고 임박·링크가 담긴 카드 형태로 보여줍니다.
결과 저장
“우유 검색 결과 마크다운으로 저장해줘”라고 말하면 파일로 저장합니다. 파일명이나 경로를 함께 말하면 그 위치에 저장합니다.
이 스킬은 결과를 자동으로 저장하지 않습니다(캐시 없음·매번 신선 조회). 보관하려면 저장을 명시적으로 요청하세요.
안 될 때
| 증상 | 원인 / 해결 |
|---|---|
| ”차단됐다”는 안내 | 마켓컬리 서버가 자동 조회를 차단(403·429)했습니다. 잠시 후 다시 시도하세요. 이 스킬은 차단을 우회하지 않습니다. |
| 결과가 0건 | 검색어를 바꾸거나 범위를 넓혀 다시 말해보세요. 성인 인증이 필요한 상품은 비로그인 조회로는 볼 수 없어 결과가 비어 나올 수 있습니다. |
| 정확히 찾던 상품이 아닌 것 같음 | 정확 매칭이 없어 추천 상품으로 대체됐을 수 있습니다(위 안내 참고). 더 구체적인 검색어로 다시 요청하세요. |
| 네트워크 오류 | 인터넷 연결을 확인하고 잠시 후 다시 시도하세요. |
| 마켓컬리 외 다른 곳 요청 | 이 스킬은 마켓컬리만 지원합니다. 다이소는 별도 스킬(daiso)에서 처리합니다. |
알아두세요
- 조회 전용입니다. 주문·결제·장바구니·로그인은 지원하지 않습니다. 보기만 합니다.
- 마켓컬리만 지원합니다. 다른 리테일은 별도 스킬(예: daiso)에서 처리합니다.
- 봇 차단을 우회하지 않습니다. 차단(403·429)이 감지되면 우회를 시도하지 않고 즉시 멈춥니다.
- 비공식 공개 표면을 사용합니다. 공식 개발자 Open API가 아니라 마켓컬리 웹앱이 쓰는 비로그인 공개 표면을 사용하므로, 마켓컬리 측 사양 변경으로 예고 없이 동작이 달라질 수 있습니다.
- 회원·주소 전용 정보는 볼 수 없습니다. 회원 전용가·주소별 배송 가능 여부·개인화 추천이나 찜은 비로그인 조회로 확정할 수 없습니다.
- 가격·품절·노출은 조회 시점 기준 참고값입니다. 시점에 따라 달라질 수 있습니다.
- 추천 대체에 주의하세요. 정확 매칭이 없으면 마켓컬리가 비슷한 추천 상품으로 대체하며, 결과에 그 사실이 표시됩니다.
- 자가차단 방지. 같은 상품·검색어를 반복해서 연속 조회하면 차단될 수 있습니다. 필요한 정보를 한 번에 요청하고 결과를 저장해두는 것이 좋습니다.