k-skill/docs/features
Jeffrey (Dongkyu) Kim f2204f752e Document Coupang hosted fallback contract and affiliate disclosure
retention-corp/coupang_partners#1 is merged, so upstream now transparently falls back to the Retention Corp hosted backend at https://a.retn.kr/v1/public/assist when Coupang Partners API credentials are missing. The k-skill wrapper already passes environment variables through unchanged, so this commit lines up the documented contract with the actual two-path behavior without changing runtime logic.

- SKILL.md and docs/features/coupang-product-search.md describe both execution paths (operator local HMAC vs credentialless hosted fallback), the honored OPENCLAW_SHOPPING_* env vars, the allowlist client-id convention including the k-skill-specific coupang-mcp-fallback value, and the mandatory affiliate disclosure when a.retn.kr/s/ shortlinks or lptag=AF deeplinks appear in responses.
- docs/sources.md adds the hosted assist endpoint and the merged upstream PR so the source surface stays truthful.
- README.md reflects the 선택사항 semantics for the 쿠팡 상품 검색 row and extends the column legend so 선택사항 is distinct from 불필요.
- coupang_partners_mcp.py expands its --help epilog so operators discover the honored upstream env vars without reading the wrapper source; no runtime behavior change.
- scripts/test_coupang_partners_mcp_wrapper.py locks env pass-through as a regression, asserts the new --help contract, and adds an opt-in K_SKILL_COUPANG_SMOKE=1 live smoke test that verifies the credentialless hosted path returns a Coupang deeplink.
- scripts/skill-docs.test.js extends the docs regression to require the hosted assist URL, OPENCLAW_SHOPPING_* env prefix, affiliate disclosure wording, and hosted fallback concept while keeping the yuju777 HF Space negative assertion.

Verified: npm run ci exits 0, live smoke test (K_SKILL_COUPANG_SMOKE=1) returns a.retn.kr/s/ shortlinks via credentialless wrapper, and manual env -u COUPANG_ACCESS_KEY -u COUPANG_SECRET_KEY call returns isRocket+lptag=AF3727577 responses through the hosted fallback.

Refs: #134
2026-04-21 00:19:08 +09:00
..
blue-ribbon-nearby.md Merge dev into main: new skills & proxy enhancements (#72) 2026-04-06 17:44:23 +09:00
bunjang-search.md Sync dev → main: 84 commits incl. korea-weather, korean-stock-search, korean-patent-search, bunjang-search (#80) 2026-04-08 21:13:55 +09:00
cheap-gas-nearby.md Merge dev into main: new skills & proxy enhancements (#72) 2026-04-06 17:44:23 +09:00
coupang-product-search.md Document Coupang hosted fallback contract and affiliate disclosure 2026-04-21 00:19:08 +09:00
daiso-product-search.md Keep Daiso online-stock lookups aligned with live product ids 2026-03-27 19:31:24 +09:00
delivery-tracking.md Document the verified public tracking outputs explicitly 2026-03-27 02:44:48 +09:00
fine-dust-location.md Replace sops+age encryption with plain dotenv and agent-native credential resolution 2026-03-30 22:12:04 +09:00
geeknews-search.md Add a repeatable GeekNews lookup path without unofficial APIs 2026-04-13 00:16:35 +09:00
han-river-water-level.md Merge dev into main: new skills & proxy enhancements (#72) 2026-04-06 17:44:23 +09:00
hipass-receipt.md Sync dev → main: 84 commits incl. korea-weather, korean-stock-search, korean-patent-search, bunjang-search (#80) 2026-04-08 21:13:55 +09:00
hola-poke-yeoksam.md Keep the Hola Poke contract claims aligned with verified coverage 2026-04-16 12:43:53 +09:00
household-waste-info.md feat(k-skill-proxy): 생활쓰레기 페이지네이션 검증 및 문서 보강 2026-04-11 03:02:09 +09:00
hwp.md Keep HWP docs runnable against the published kordoc package 2026-04-16 14:45:38 +09:00
joseon-sillok-search.md Merge dev into main: new skills & proxy enhancements (#72) 2026-04-06 17:44:23 +09:00
k-schoollunch-menu.md NEIS 급식·학교검색 프록시, k-schoollunch-menu 스킬 및 문서 2026-04-10 13:14:15 +09:00
k-skill-proxy.md Add library book search skill 2026-04-18 21:24:04 +09:00
kakao-bar-nearby.md Keep Kakao smoke docs aligned with verified live output 2026-03-29 17:05:17 +09:00
kakaotalk-mac.md Feature/#121 (#127) 2026-04-18 01:08:06 +09:00
kbl-results.md Feature/#129 (#131) 2026-04-18 11:20:42 +09:00
kbo-results.md Prepare k-skill for packaged releases and broader skill discovery 2026-03-25 23:57:53 +09:00
kleague-results.md Add an official K League results client and skill 2026-03-29 15:57:15 +09:00
korea-weather.md Sync dev → main: 84 commits incl. korea-weather, korean-stock-search, korean-patent-search, bunjang-search (#80) 2026-04-08 21:13:55 +09:00
korean-character-count.md Keep published Korean count examples aligned with the shipped helper 2026-04-08 23:57:31 +09:00
korean-law-search.md Release: coupang, korean-law, subway proxy improvements (#43) 2026-04-02 23:59:38 +09:00
korean-patent-search.md Sync dev → main: 84 commits incl. korea-weather, korean-stock-search, korean-patent-search, bunjang-search (#80) 2026-04-08 21:13:55 +09:00
korean-privacy-terms.md Bundle Apache-2.0 LICENSE with korean-privacy-terms wrapper 2026-04-20 12:25:05 +09:00
korean-scholarship-search.md Add Korean scholarship search skill and reporting workflow (#116) 2026-04-16 14:58:58 +09:00
korean-spell-check.md Merge dev into main: new skills & proxy enhancements (#72) 2026-04-06 17:44:23 +09:00
korean-stock-search.md Prevent degraded stock search outages from sticking in cache 2026-04-16 13:59:34 +09:00
ktx-booking.md Replace sops+age encryption with plain dotenv and agent-native credential resolution 2026-03-30 22:12:04 +09:00
lck-analytics.md Merge dev into main: new skills & proxy enhancements (#72) 2026-04-06 17:44:23 +09:00
library-book-search.md Fix Data4Library book-exists ISBN-10 handling 2026-04-18 21:59:36 +09:00
lotto-results.md Prepare k-skill for packaged releases and broader skill discovery 2026-03-25 23:57:53 +09:00
market-kurly-search.md Add a supported Market Kurly price-lookup skill 2026-04-09 14:51:30 +09:00
mfds-drug-safety.md Route MFDS drug-safety and food-safety lookups through k-skill-proxy 2026-04-14 00:07:18 +09:00
mfds-food-safety.md Route MFDS drug-safety and food-safety lookups through k-skill-proxy 2026-04-14 00:07:18 +09:00
naver-blog-research.md feat: 네이버 블로그 리서치 스킬 추가 (#107) 2026-04-13 00:06:18 +09:00
naver-shopping-search.md Clarify Naver OpenAPI review sort fallback 2026-04-18 21:09:38 +09:00
olive-young-search.md Merge dev into main: new skills & proxy enhancements (#72) 2026-04-06 17:44:23 +09:00
parking-lot-search.md Add parking lot search skill 2026-04-18 23:03:11 +09:00
public-restroom-nearby.md Document the restroom distance-cap contract with regression coverage 2026-04-16 12:51:54 +09:00
real-estate-search.md Merge dev into main: new skills & proxy enhancements (#72) 2026-04-06 17:44:23 +09:00
seoul-subway-arrival.md Release: coupang, korean-law, subway proxy improvements (#43) 2026-04-02 23:59:38 +09:00
srt-booking.md Replace sops+age encryption with plain dotenv and agent-native credential resolution 2026-03-30 22:12:04 +09:00
subway-lost-property.md Keep LOST112 curl guidance usable under live latency 2026-04-10 13:01:01 +09:00
toss-securities.md Add a safe Toss Securities lookup surface without trading mutations 2026-03-30 11:25:43 +09:00
used-car-price-search.md Release: coupang, korean-law, subway proxy improvements (#43) 2026-04-02 23:59:38 +09:00
zipcode-search.md Document direct zipcode helper execution so the executable follow-up stays discoverable 2026-04-10 10:59:22 +09:00