with one click
coupang-product-search
// retention-corp/coupang_partners의 로컬 Coupang MCP 호환 레이어로 쿠팡 상품 검색, 로켓배송 필터, 가격대 검색, 상품 비교, 베스트 상품, 골드박스 특가를 조회한다.
// retention-corp/coupang_partners의 로컬 Coupang MCP 호환 레이어로 쿠팡 상품 검색, 로켓배송 필터, 가격대 검색, 상품 비교, 베스트 상품, 골드박스 특가를 조회한다.
네이버 지도(NAVER Cloud Platform Maps) 기반 출발지→목적지 자동차 길찾기·지오코딩·역지오코딩을 k-skill-proxy 경유로 조회한다. 수동 입력 MVP, mock 기본, live opt-in.
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.
After installing the full k-skill bundle, configure and verify the shared cross-platform setup, then optionally wire update checks and GitHub starring with explicit user consent.
서울 따릉이 실시간 대여소의 대여 가능 자전거와 빈 거치대를 좌표 주변 또는 대여소 이름으로 조회한다.
Look up Daiso products by store name and product keyword using official Daiso Mall store/search/stock surfaces. Use when the user wants to know whether a product is available at a specific Daiso store.
| 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 계약을 확인했다.