instruction.md
# 소비자 가격·안전 조회
## Draft status
이 스킬은 #390의 **draft scaffold**다. 참가격과 소비자24는 서로 다른
upstream이다. 소비자24는 `openapiSvcId`(서비스 카탈로그 ID), 서비스별
승인 `serviceKey`, 리콜 메뉴 `cntntsId`를 분리해 관리해야 한다.
## Planned v1
- 참가격 품목·지역별 가격
- 소비자24 물품정보
- 소비자24 전체 신청 서비스의 리콜 정보
- 서비스별 키 allowlist와 공식 오류 코드 보존
## Credential model
`serviceKey`만 secret이며 gpu01 runtime env에 보관한다. `openapiSvcId`와
`cntntsId`는 공개 매핑이므로 저장소 코드에 둘 수 있다. 최종 env 이름과
서비스별 성공 여부는 live probe 후 확정한다.
## Official sources
- 참가격: https://www.data.go.kr/dataset/3043385/openapi.do
- 소비자24 목록: https://www.consumer.go.kr/user/ftc/consumer/openApiSvcUser/120/selectOpenApiSvcList.do
## Draft stop condition
전체 신청 서비스별 키가 실제 성공하는지 확인하고 실패하는 live E2E부터
추가한 뒤 proxy route, helper, parser, 문서와 manual QA를 완성한다.
skill.json
{
"name": "consumer-price-safety-search",
"description": "한국소비자원 참가격과 소비자24 물품·리콜정보를 공식 API로 조회한다. 현재는 서비스별 인증키·메뉴 매핑을 검증하는 draft scaffold다.",
"profiles": ["proxy", "lookup"],
"frontmatter": "name: consumer-price-safety-search\ndescription: 한국소비자원 참가격과 소비자24 물품·리콜정보를 공식 API로 조회한다. 현재는 서비스별 인증키·메뉴 매핑을 검증하는 draft scaffold다.\nlicense: MIT\nmetadata:\n category: consumer\n locale: ko-KR\n phase: draft"
}
SKILL.md
---
name: consumer-price-safety-search
description: 한국소비자원 참가격과 소비자24 물품·리콜정보를 공식 API로 조회한다. 현재는 서비스별 인증키·메뉴 매핑을 검증하는 draft scaffold다.
license: MIT
metadata:
category: consumer
locale: ko-KR
phase: draft
---
# consumer-price-safety-search
<!-- k-skill:cli-stub — generated by scripts/generate-skill-stubs.js; edit skill.json / instruction.md instead -->
## Get the full instructions (required first step)
Run this and follow its output as the primary instructions for this skill:
```bash
npx -y @nomadamas/k-skill@0 instruct consumer-price-safety-search
```
The CLI detects the current runtime (Dolshoi vault/CloakBrowser vs generic) and prints only the applicable instructions, always up to date. Helper files bundled with the CLI are listed by:
```bash
npx -y @nomadamas/k-skill@0 files consumer-price-safety-search
```
If `npx` is unavailable, install Node.js 18+ or follow https://github.com/NomaDamas/k-skill#readme, or read the source instructions at https://github.com/NomaDamas/k-skill/blob/main/consumer-price-safety-search/instruction.md.
## Hard rules even without the CLI
- Never execute payment, message/email delivery, final submission, cancellation, or public posting without the user's explicit approval immediately beforehand.
- Never ask for, print, or store plaintext credentials in chat, files, or shell arguments.
- Never bypass legal, physical-presence, CAPTCHA, identity-proofing, or electronic-signature boundaries.