Menu
retention-corp/coupang_partners의 로컬 Coupang MCP 호환 레이어로 쿠팡 상품 검색, 로켓배송 필터, 가격대 검색, 상품 비교, 베스트 상품, 골드박스 특가를 조회한다.
Use when the user asks for nearby restaurants or 근처 맛집 and wants 블루리본 picks. Always ask the user's current location first, then search official Blue Ribbon nearby restaurants via k-skill-proxy.
네이버 지도(NAVER Cloud Platform Maps) 기반 출발지→목적지 자동차 길찾기·지오코딩·역지오코딩을 k-skill-proxy 경유로 조회한다. 수동 입력 MVP, mock 기본, live opt-in.
Look up available Korean national forest recreation lodging or camping slots on foresttrip.go.kr. Use when the user asks for 숲나들e or 자연휴양림 빈 객실/빈자리 조회, not for booking.
Search, reserve, inspect, and cancel KTX or Korail tickets in Korea with the korail2 + pycryptodome Python packages. Use when the user asks for KTX seats, Korail bookings, train changes, reservation status, remaining seat numbers, car-by-car seats, or power-outlet/good-seat tips.
Kakao Local (장소 검색·주소-좌표 변환) + Kakao Mobility (자동차 길찾기) 를 k-skill-proxy 경유로 조회한다. 사용자 키 불필요.
Convert incoming Korean text into a deterministic Korean Middle Korean-style rewrite with archaic particles, endings, Hanja hints, and tone-mark flavor.
| name | coupang-product-search |
| description | retention-corp/coupang_partners의 로컬 Coupang MCP 호환 레이어로 쿠팡 상품 검색, 로켓배송 필터, 가격대 검색, 상품 비교, 베스트 상품, 골드박스 특가를 조회한다. |
| license | MIT |
| metadata | {"category":"retail","locale":"ko-KR","phase":"v2"} |
retention-corp/coupang_partners 저장소의 로컬 Coupang MCP 호환 레이어를 사용해 쿠팡 상품 조회 도구를 실행한다. 기존 유지보수형 HF Space MCP 엔드포인트 대신, 이 저장소의 bin/coupang_mcp.py가 제공하는 local://coupang-mcp 계약을 호출한다.
Claude Code / Codex
→ coupang-product-search/scripts/coupang_partners_mcp.py
→ git clone/update retention-corp/coupang_partners (user cache)
→ python3 bin/coupang_mcp.py
→ local://coupang-mcp compatible tool layer
├─ Coupang Partners API client (operator keys present)
└─ hosted fallback → https://a.retn.kr/v1/public/assist (no keys)
Hard rules:
COUPANG_MCP_ENDPOINT는 호환성 knob로만 유지한다. 기본값은 local://coupang-mcp다.https://github.com/retention-corp/coupang_partners.git만 사용한다.tools와 init은 로컬 MCP 계약 확인용으로 먼저 실행한다.retention-corp/coupang_partners는 하나의 CLI 뒤에서 두 가지 경로를 자동으로 선택한다. 래퍼(coupang_partners_mcp.py)는 두 경로 모두를 그대로 통과시킨다.
COUPANG_ACCESS_KEY와 COUPANG_SECRET_KEY가 둘 다 설정된 경우. upstream이 Coupang Partners API를 HMAC 서명해 직접 호출한다. 키/시크릿은 절대 답변·문서·커밋에 노출하지 않는다.OPENCLAW_SHOPPING_FORCE_HOSTED=1). upstream이 자동으로 Retention Corp의 hosted 백엔드(https://a.retn.kr/v1/public/assist)로 떨어진다. 이 경로는 X-OpenClaw-Client-Id allowlist로 게이트되어 있으며, upstream이 기본으로 실어 보내는 openclaw-skill 값이 현재 Retention Corp allowlist에 등록된 값이다. k-skill 래퍼는 OPENCLAW_SHOPPING_CLIENT_ID를 별도로 설정하지 않고 이 upstream 기본값을 그대로 사용한다.두 경로 모두 JSON envelope(ok/data.session_id/data.tool/data.payload/data.result) 모양은 동일하므로, 답변 로직은 경로를 구별할 필요가 없다. short deeplink는 hosted fallback에서는 https://a.retn.kr/s/... 형태로, operator path에서는 https://link.coupang.com/... 형태로 온다.
| 환경변수 | 역할 | 기본값 |
|---|---|---|
COUPANG_ACCESS_KEY, COUPANG_SECRET_KEY | 운영자 Coupang Partners API 크리덴셜. 둘 다 있을 때만 로컬 HMAC 경로가 활성화된다. | 없음 (없으면 hosted fallback) |
OPENCLAW_SHOPPING_CLIENT_ID | hosted fallback이 보낼 X-OpenClaw-Client-Id. upstream이 openclaw-skill을 기본으로 실어 보내며 이 값이 현재 Retention Corp allowlist에 등록되어 있다. k-skill 래퍼는 이 변수를 오버라이드하지 않는 것을 권장한다. | openclaw-skill |
OPENCLAW_SHOPPING_FORCE_HOSTED | 1이면 키가 있어도 hosted 경로를 강제한다. | 비어있음 |
OPENCLAW_SHOPPING_BASE_URL | hosted 백엔드 base URL 오버라이드. 스테이징/로컬 backend 테스트용. | https://a.retn.kr |
local://coupang-mcp
프로토콜 호환 버전: MCP 2025-03-26. 네트워크로 붙는 Streamable HTTP 서버가 아니라, upstream 저장소의 로컬 MCP 호환 CLI가 같은 도구 이름과 JSON-RPC 모양의 payload를 반환한다.
검색어가 너무 넓으면 먼저 의도를 좁힌다.
어떤 용도/예산/브랜드/용량을 우선할까요?래퍼는 기본적으로 ~/.cache/k-skill/coupang_partners에 upstream 저장소를 clone한다. 이미 clone되어 있으면 그대로 사용하고, 최신화가 필요할 때만 --update를 붙인다.
python3 coupang-product-search/scripts/coupang_partners_mcp.py tools
python3 coupang-product-search/scripts/coupang_partners_mcp.py init
기존 checkout을 명시하거나 CI/검증에서 네트워크 clone을 막으려면:
python3 coupang-product-search/scripts/coupang_partners_mcp.py \
--repo-dir /path/to/coupang_partners \
--no-clone \
tools
python3 coupang-product-search/scripts/coupang_partners_mcp.py \
--repo-dir /path/to/coupang_partners \
--no-clone \
init
구체적인 사용자 요청에 맞춰 upstream CLI 명령을 호출한다. 결과는 ok, data.tool, data.payload, data.result를 포함하는 JSON으로 반환된다.
# 일반 검색 (키 없이도 hosted fallback으로 작동)
python3 coupang-product-search/scripts/coupang_partners_mcp.py search "32인치 4K 모니터"
# 로켓배송 필터
python3 coupang-product-search/scripts/coupang_partners_mcp.py rocket "에어팟"
# 가격대 검색
python3 coupang-product-search/scripts/coupang_partners_mcp.py budget "키보드" --max-price 100000
# 비교
python3 coupang-product-search/scripts/coupang_partners_mcp.py compare "아이패드 vs 갤럭시탭"
# 골드박스 (운영자 키가 필요한 upstream 경로)
python3 coupang-product-search/scripts/coupang_partners_mcp.py goldbox
운영자 키가 있는 상태에서도 hosted fallback 경로를 점검하고 싶으면 OPENCLAW_SHOPPING_FORCE_HOSTED=1만 추가하면 된다. OPENCLAW_SHOPPING_CLIENT_ID는 upstream이 보내는 기본값 openclaw-skill이 현재 Retention Corp allowlist에 등록된 값이므로 별도로 설정하지 않는다.
export OPENCLAW_SHOPPING_FORCE_HOSTED=1
python3 coupang-product-search/scripts/coupang_partners_mcp.py search "에어팟"
| 도구명 | CLI 명령 | 기능 | 파라미터 예시 |
|---|---|---|---|
search_coupang_products | search | 일반 상품 검색 | "생수" |
search_coupang_rocket | rocket | 로켓배송만 필터링 | "에어팟" |
search_coupang_budget | budget | 가격대 범위 검색 | "키보드" --max-price 100000 |
compare_coupang_products | compare | 상품 비교표 생성 | "아이패드 vs 갤럭시탭" |
get_coupang_recommendations | recommendations | 인기 검색어 제안 | --category 전자제품 |
get_coupang_seasonal | seasonal | 계절/상황별 추천 | "설날 선물" |
get_coupang_best_products | best | 카테고리별 베스트 | --category-id 1016 |
get_coupang_goldbox | goldbox | 당일 특가 정보 | --limit 10 |
주의: get_coupang_goldbox와 get_coupang_best_products는 upstream 기준 Coupang Partners API 권한이 필요한 경로이므로, 키가 없는 환경에서는 실패할 수 있다. 이런 경우 에러 메시지를 그대로 전달하고 hosted fallback이 커버하는 search/rocket/budget/compare 경로로 우회 제안한다.
upstream CLI는 JSON을 출력한다. data.result 안의 상품 배열 또는 도구별 객체를 읽고, 답변에서는 로켓배송(rocket)과 일반배송(normal)을 구분한다.
{
"ok": true,
"data": {
"session_id": "session-...",
"tool": "search_coupang_products",
"payload": {
"jsonrpc": "2.0",
"result": {
"content": [
{"type": "text", "text": "[...]"}
]
}
},
"result": []
}
}
사용자에게 보여줄 때는 다음처럼 짧게 정리한다.
## rocket (상위 후보)
1) LG전자 4K UHD 모니터
가격: 397,750원 (참고용)
보러가기: https://a.retn.kr/s/... # hosted fallback shortlink
또는: https://link.coupang.com/a/... # operator HMAC 경로 딥링크
## normal (상위 후보)
1) 삼성전자 QHD 오디세이 G5 게이밍 모니터
가격: 283,000원 (참고용)
보러가기: https://a.retn.kr/s/...
https://a.retn.kr/s/...)와 직접 coupang 딥링크(link.coupang.com/...?lptag=AF...)는 Retention Corp의 쿠팡 파트너스(affiliate) 채널로 트래킹된다. upstream이 돌려주는 disclosure 문자열("파트너스 활동을 통해 일정액의 수수료를 제공받을 수 있음")이 있으면 그대로 노출하고, 없으면 같은 취지의 고지를 답변 말미에 덧붙인다.tools와 init 또는 실제 명령으로 retention-corp/coupang_partners 로컬 MCP 계약을 확인했다.