retention-corp/coupang_partners의 로컬 Coupang MCP 호환 레이어로 쿠팡 상품 검색, 로켓배송 필터, 가격대 검색, 상품 비교, 베스트 상품, 골드박스 특가를 조회한다.

SKILL.md

Coupang Product Search

What this skill does

retention-corp/coupang_partners 저장소의 로컬 Coupang MCP 호환 레이어를 사용해 쿠팡 상품 조회 도구를 실행한다. 기존 유지보수형 HF Space MCP 엔드포인트 대신, 이 저장소의 bin/coupang_mcp.py가 제공하는 local://coupang-mcp 계약을 호출한다.

키워드 상품 검색

로켓배송 전용 필터 검색

가격대 범위 검색

상품 비교표 생성

카테고리별 베스트 상품

골드박스 당일 특가

인기 검색어/계절 상품 추천

How it works
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다.

구형 HF Space hosted MCP 엔드포인트를 사용하거나 새로 지어내지 않는다.

upstream 저장소는 https://github.com/retention-corp/coupang_partners.git만 사용한다.

tools와 init은 로컬 MCP 계약 확인용으로 먼저 실행한다.

Execution paths

retention-corp/coupang_partners는 하나의 CLI 뒤에서 두 가지 경로를 자동으로 선택한다. 래퍼(coupang_partners_mcp.py)는 두 경로 모두를 그대로 통과시킨다.

Operator (local HMAC) path — COUPANG_ACCESS_KEY와 COUPANG_SECRET_KEY가 둘 다 설정된 경우. upstream이 Coupang Partners API를 HMAC 서명해 직접 호출한다. 키/시크릿은 절대 답변·문서·커밋에 노출하지 않는다.

Credentialless hosted fallback path — 위 두 키 중 하나라도 없는 경우(또는 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-product-search

SKILL.md

related skills