coupang-product-search은(는) 무엇을 하나요?
retention-corp/coupang_partners의 로컬 Coupang MCP 호환 레이어로 쿠팡 상품 검색, 로켓배송 필터, 가격대 검색, 상품 비교, 베스트 상품, 골드박스 특가를 조회합니다.
기능
- 상품 검색: 키워드를 기반으로 쿠팡 상품을 검색합니다.
- 로켓배송 필터: 로켓배송 가능한 상품만 필터링합니다.
- 가격대 검색: 최소/최대 가격 범위 내 상품을 검색합니다.
- 상품 비교: 여러 상품의 상세 정보를 비교합니다.
- 베스트 상품: 베스트셀러 상품 목록을 조회합니다.
- 골드박스 특가: 골드박스 할인 상품 정보를 조회합니다.
설치
npm install nomadamas/coupang-product-search
설정
쿠팡 파트너스 API 접근 키가 필요합니다. 환경 변수에 다음과 같이 설정하세요:
COUPANG_API_KEY=your_api_key
COUPANG_API_SECRET=your_api_secret
사용법
MCP를 지원하는 에이전트 (예: Claude Code, Cursor, Windsurf 등)에서 다음과 같이 호출할 수 있습니다:
{
"action": "search_products",
"keyword": "노트북",
"rocket_delivery": true,
"min_price": 500000,
"max_price": 1500000
}
API
searchProducts(options)
keyword(string, 필수): 검색할 상품 키워드rocket_delivery(boolean, 선택): 로켓배송 필터min_price(number, 선택): 최소 가격max_price(number, 선택): 최대 가격page(number, 선택): 페이지 번호 (기본값: 1)page_size(number, 선택): 페이지당 결과 수 (기본값: 10)
compareProducts(productIds)
productIds(string[], 필수): 비교할 상품 ID 목록
getBestProducts(categoryId)
categoryId(string, 선택): 특정 카테고리 ID (생략 시 전체)
getGoldBoxDeals()
인자가 없습니다. 현재 골드박스 특가 상품 목록을 반환합니다.
지원 플랫폼
- Claude Code
- Cursor
- Windsurf
- 기타 MCP 호환 에이전트
라이선스
MIT