@nomadamas/k-skill 0.2.1 → 0.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (55) hide show
  1. package/package.json +1 -1
  2. package/skills/bunjang-search/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  3. package/skills/catchtable-sniper/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  4. package/skills/coupang-product-search/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  5. package/skills/daangn-cars-search/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  6. package/skills/daangn-jobs-search/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  7. package/skills/daangn-realty-search/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  8. package/skills/daangn-used-goods-search/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  9. package/skills/daishin-report-search/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  10. package/skills/daiso-product-search/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  11. package/skills/danawa-price-search/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  12. package/skills/delivery-tracking/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  13. package/skills/express-bus-booking/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  14. package/skills/flight-ticket-search/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  15. package/skills/foresttrip-vacancy/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  16. package/skills/hankookilbo-news/instruction.md +143 -0
  17. package/skills/hankookilbo-news/skill.json +8 -0
  18. package/skills/hipass-receipt/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  19. package/skills/intercity-bus-booking/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  20. package/skills/job-posting-match/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  21. package/skills/jobkorea-talent-search/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  22. package/skills/kakao-bar-nearby/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  23. package/skills/kakao-map/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  24. package/skills/kakaotalk-mac/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  25. package/skills/kbl-results/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  26. package/skills/kbo-results/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  27. package/skills/kleague-results/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  28. package/skills/korean-cinema-search/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  29. package/skills/korean-transit-route/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  30. package/skills/kosis-stats/instruction.md +24 -3
  31. package/skills/kosis-stats/references/kosis-openapi-guide.md +5 -1
  32. package/skills/kosis-stats/scripts/run_kosis_stats.py +1 -1
  33. package/skills/ktx-booking/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  34. package/skills/lck-analytics/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  35. package/skills/lotto-results/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  36. package/skills/market-kurly-search/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  37. package/skills/myrealtrip-search/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  38. package/skills/naver-ad-performance/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  39. package/skills/naver-blog-research/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  40. package/skills/naver-blog-research/scripts/naver_search.py +6 -1
  41. package/skills/naver-news-search/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  42. package/skills/naver-shopping-search/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  43. package/skills/ohou-today-deal/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  44. package/skills/olive-young-search/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  45. package/skills/popbill/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  46. package/skills/saramin-talent-search/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  47. package/skills/srt-booking/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  48. package/skills/store-longevity-radar/instruction.md +91 -0
  49. package/skills/store-longevity-radar/scripts/store_longevity_radar.py +230 -0
  50. package/skills/store-longevity-radar/skill.json +8 -0
  51. package/skills/ticket-availability/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  52. package/skills/toss-securities/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  53. package/skills/used-car-price-search/references/TRADEMARK-LEGAL-STATEMENT.md +9 -0
  54. package/skills/gangnamunni-clinic-search/instruction.md +0 -113
  55. package/skills/gangnamunni-clinic-search/skill.json +0 -9
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nomadamas/k-skill",
3
- "version": "0.2.1",
3
+ "version": "0.2.3",
4
4
  "description": "k-skill unified CLI: assembles runtime-aware skill instructions and ships bundled helper files",
5
5
  "license": "MIT",
6
6
  "bin": {
@@ -0,0 +1,9 @@
1
+ # 상표 사용 법적 고지 — `bunjang-search`
2
+
3
+ 이 스킬에서 `번개장터` 및 `Bunjang` 명칭은 번개장터 검색·상세조회·찜·채팅 기능의 **대상 서비스**를 식별하기 위해 사용한다. k-skill이나 `bunjang-cli`의 출처를 번개장터 운영사로 표시하려는 사용이 아니다.
4
+
5
+ 대법원 2005. 6. 10. 선고 [2005도1637 판결](https://www.law.go.kr/LSW/precInfoP.do?precSeq=83920)은 타인의 표장을 출처표시가 아니라 상품 기능 또는 적용 기종을 밝히기 위해 사용하고 상표 사용으로 인식될 수 없는 경우 침해가 아니라고 판시했다. [상표법 제2조](https://www.law.go.kr/법령/상표법/제2조), [제89조](https://www.law.go.kr/법령/상표법/제89조), [제90조](https://www.law.go.kr/법령/상표법/제90조), [제108조](https://www.law.go.kr/법령/상표법/제108조)와 대법원 [2011다18802](https://www.law.go.kr/LSW/precInfoP.do?precSeq=167457), [2019후10418](https://law.go.kr/LSW/precInfoP.do?mode=0&precSeq=230725) 판결에 따라 실제 거래계에서 출처표시로 기능하는지는 표시 태양과 사용 경위 등을 종합해 판단해야 한다.
6
+
7
+ 따라서 이 명칭은 필요한 범위의 평문으로만 사용하고, 별도 근거 없이 로고, 공식·제휴·후원·인증·파트너 표현을 사용하지 않는다. 각 상표의 권리는 해당 권리자에게 있다. 이 문서는 저작권, 데이터베이스권, 부정경쟁방지법, 약관·계약, 개인정보 또는 접근 방식의 적법성을 판단하지 않는다.
8
+
9
+ 전체 검토: [제3자 상표의 기능 설명·호환 대상 표시 검토](https://github.com/NomaDamas/k-skill/blob/dev/docs/legal/trademark-use-review.md)
@@ -0,0 +1,9 @@
1
+ # 상표 사용 법적 고지 — `catchtable-sniper`
2
+
3
+ 이 스킬에서 `캐치테이블` 및 `Catchtable` 명칭은 예약 가능 시간 조회와 공식 예약 흐름의 **대상 서비스**를 식별하기 위해 사용한다. k-skill의 출처나 운영주체를 캐치테이블 운영사로 표시하려는 사용이 아니다.
4
+
5
+ 대법원 2005. 6. 10. 선고 [2005도1637 판결](https://www.law.go.kr/LSW/precInfoP.do?precSeq=83920)은 타인의 표장을 출처표시가 아니라 상품 기능 또는 적용 기종을 밝히기 위해 사용하고 상표 사용으로 인식될 수 없는 경우 침해가 아니라고 판시했다. [상표법 제2조](https://www.law.go.kr/법령/상표법/제2조), [제89조](https://www.law.go.kr/법령/상표법/제89조), [제90조](https://www.law.go.kr/법령/상표법/제90조), [제108조](https://www.law.go.kr/법령/상표법/제108조)와 대법원 [2011다18802](https://www.law.go.kr/LSW/precInfoP.do?precSeq=167457), [2019후10418](https://law.go.kr/LSW/precInfoP.do?mode=0&precSeq=230725) 판결에 따라 실제 거래계에서 출처표시로 기능하는지는 표시 태양과 사용 경위 등을 종합해 판단해야 한다.
6
+
7
+ 따라서 이 명칭은 필요한 범위의 평문으로만 사용하고, 별도 근거 없이 로고, 공식·제휴·후원·인증·파트너 표현을 사용하지 않는다. 각 상표의 권리는 해당 권리자에게 있다. 이 문서는 저작권, 데이터베이스권, 부정경쟁방지법, 약관·계약, 개인정보 또는 접근 방식의 적법성을 판단하지 않는다.
8
+
9
+ 전체 검토: [제3자 상표의 기능 설명·호환 대상 표시 검토](https://github.com/NomaDamas/k-skill/blob/dev/docs/legal/trademark-use-review.md)
@@ -0,0 +1,9 @@
1
+ # 상표 사용 법적 고지 — `coupang-product-search`
2
+
3
+ 이 스킬에서 `쿠팡` 및 `Coupang` 명칭은 쿠팡 상품 검색·가격·배송 조건 조회의 **대상 서비스**를 식별하기 위해 사용한다. k-skill 또는 upstream 호환 도구의 출처를 쿠팡 운영사로 표시하려는 사용이 아니다.
4
+
5
+ 대법원 2005. 6. 10. 선고 [2005도1637 판결](https://www.law.go.kr/LSW/precInfoP.do?precSeq=83920)은 타인의 표장을 출처표시가 아니라 상품 기능 또는 적용 기종을 밝히기 위해 사용하고 상표 사용으로 인식될 수 없는 경우 침해가 아니라고 판시했다. [상표법 제2조](https://www.law.go.kr/법령/상표법/제2조), [제89조](https://www.law.go.kr/법령/상표법/제89조), [제90조](https://www.law.go.kr/법령/상표법/제90조), [제108조](https://www.law.go.kr/법령/상표법/제108조)와 대법원 [2011다18802](https://www.law.go.kr/LSW/precInfoP.do?precSeq=167457), [2019후10418](https://law.go.kr/LSW/precInfoP.do?mode=0&precSeq=230725) 판결에 따라 실제 거래계에서 출처표시로 기능하는지는 표시 태양과 사용 경위 등을 종합해 판단해야 한다.
6
+
7
+ 따라서 이 명칭은 필요한 범위의 평문으로만 사용하고, 별도 근거 없이 로고, 공식·제휴·후원·인증·파트너 표현을 사용하지 않는다. 각 상표의 권리는 해당 권리자에게 있다. 이 문서는 저작권, 데이터베이스권, 부정경쟁방지법, 약관·계약, 개인정보 또는 접근 방식의 적법성을 판단하지 않는다.
8
+
9
+ 전체 검토: [제3자 상표의 기능 설명·호환 대상 표시 검토](https://github.com/NomaDamas/k-skill/blob/dev/docs/legal/trademark-use-review.md)
@@ -0,0 +1,9 @@
1
+ # 상표 사용 법적 고지 — `daangn-cars-search`
2
+
3
+ 이 스킬에서 `당근` 및 `Daangn` 명칭은 당근중고차 매물 검색·문의·찜 흐름의 **대상 서비스**를 식별하기 위해 사용한다. k-skill의 출처를 당근 운영사로 표시하려는 사용이 아니다.
4
+
5
+ 대법원 2005. 6. 10. 선고 [2005도1637 판결](https://www.law.go.kr/LSW/precInfoP.do?precSeq=83920)은 타인의 표장을 출처표시가 아니라 상품 기능 또는 적용 기종을 밝히기 위해 사용하고 상표 사용으로 인식될 수 없는 경우 침해가 아니라고 판시했다. [상표법 제2조](https://www.law.go.kr/법령/상표법/제2조), [제89조](https://www.law.go.kr/법령/상표법/제89조), [제90조](https://www.law.go.kr/법령/상표법/제90조), [제108조](https://www.law.go.kr/법령/상표법/제108조)와 대법원 [2011다18802](https://www.law.go.kr/LSW/precInfoP.do?precSeq=167457), [2019후10418](https://law.go.kr/LSW/precInfoP.do?mode=0&precSeq=230725) 판결에 따라 실제 거래계에서 출처표시로 기능하는지는 표시 태양과 사용 경위 등을 종합해 판단해야 한다.
6
+
7
+ 따라서 이 명칭은 필요한 범위의 평문으로만 사용하고, 별도 근거 없이 로고, 공식·제휴·후원·인증·파트너 표현을 사용하지 않는다. 각 상표의 권리는 해당 권리자에게 있다. 이 문서는 저작권, 데이터베이스권, 부정경쟁방지법, 약관·계약, 개인정보 또는 접근 방식의 적법성을 판단하지 않는다.
8
+
9
+ 전체 검토: [제3자 상표의 기능 설명·호환 대상 표시 검토](https://github.com/NomaDamas/k-skill/blob/dev/docs/legal/trademark-use-review.md)
@@ -0,0 +1,9 @@
1
+ # 상표 사용 법적 고지 — `daangn-jobs-search`
2
+
3
+ 이 스킬에서 `당근` 및 `Daangn` 명칭은 당근알바 공고 검색·지원·채팅 흐름의 **대상 서비스**를 식별하기 위해 사용한다. k-skill의 출처를 당근 운영사로 표시하려는 사용이 아니다.
4
+
5
+ 대법원 2005. 6. 10. 선고 [2005도1637 판결](https://www.law.go.kr/LSW/precInfoP.do?precSeq=83920)은 타인의 표장을 출처표시가 아니라 상품 기능 또는 적용 기종을 밝히기 위해 사용하고 상표 사용으로 인식될 수 없는 경우 침해가 아니라고 판시했다. [상표법 제2조](https://www.law.go.kr/법령/상표법/제2조), [제89조](https://www.law.go.kr/법령/상표법/제89조), [제90조](https://www.law.go.kr/법령/상표법/제90조), [제108조](https://www.law.go.kr/법령/상표법/제108조)와 대법원 [2011다18802](https://www.law.go.kr/LSW/precInfoP.do?precSeq=167457), [2019후10418](https://law.go.kr/LSW/precInfoP.do?mode=0&precSeq=230725) 판결에 따라 실제 거래계에서 출처표시로 기능하는지는 표시 태양과 사용 경위 등을 종합해 판단해야 한다.
6
+
7
+ 따라서 이 명칭은 필요한 범위의 평문으로만 사용하고, 별도 근거 없이 로고, 공식·제휴·후원·인증·파트너 표현을 사용하지 않는다. 각 상표의 권리는 해당 권리자에게 있다. 이 문서는 저작권, 데이터베이스권, 부정경쟁방지법, 약관·계약, 개인정보 또는 접근 방식의 적법성을 판단하지 않는다.
8
+
9
+ 전체 검토: [제3자 상표의 기능 설명·호환 대상 표시 검토](https://github.com/NomaDamas/k-skill/blob/dev/docs/legal/trademark-use-review.md)
@@ -0,0 +1,9 @@
1
+ # 상표 사용 법적 고지 — `daangn-realty-search`
2
+
3
+ 이 스킬에서 `당근` 및 `Daangn` 명칭은 당근부동산 매물 검색·문의·방문예약 흐름의 **대상 서비스**를 식별하기 위해 사용한다. k-skill의 출처를 당근 운영사로 표시하려는 사용이 아니다.
4
+
5
+ 대법원 2005. 6. 10. 선고 [2005도1637 판결](https://www.law.go.kr/LSW/precInfoP.do?precSeq=83920)은 타인의 표장을 출처표시가 아니라 상품 기능 또는 적용 기종을 밝히기 위해 사용하고 상표 사용으로 인식될 수 없는 경우 침해가 아니라고 판시했다. [상표법 제2조](https://www.law.go.kr/법령/상표법/제2조), [제89조](https://www.law.go.kr/법령/상표법/제89조), [제90조](https://www.law.go.kr/법령/상표법/제90조), [제108조](https://www.law.go.kr/법령/상표법/제108조)와 대법원 [2011다18802](https://www.law.go.kr/LSW/precInfoP.do?precSeq=167457), [2019후10418](https://law.go.kr/LSW/precInfoP.do?mode=0&precSeq=230725) 판결에 따라 실제 거래계에서 출처표시로 기능하는지는 표시 태양과 사용 경위 등을 종합해 판단해야 한다.
6
+
7
+ 따라서 이 명칭은 필요한 범위의 평문으로만 사용하고, 별도 근거 없이 로고, 공식·제휴·후원·인증·파트너 표현을 사용하지 않는다. 각 상표의 권리는 해당 권리자에게 있다. 이 문서는 저작권, 데이터베이스권, 부정경쟁방지법, 약관·계약, 개인정보 또는 접근 방식의 적법성을 판단하지 않는다.
8
+
9
+ 전체 검토: [제3자 상표의 기능 설명·호환 대상 표시 검토](https://github.com/NomaDamas/k-skill/blob/dev/docs/legal/trademark-use-review.md)
@@ -0,0 +1,9 @@
1
+ # 상표 사용 법적 고지 — `daangn-used-goods-search`
2
+
3
+ 이 스킬에서 `당근` 및 `Daangn` 명칭은 당근 중고거래 매물 검색·찜·채팅 흐름의 **대상 서비스**를 식별하기 위해 사용한다. k-skill의 출처를 당근 운영사로 표시하려는 사용이 아니다.
4
+
5
+ 대법원 2005. 6. 10. 선고 [2005도1637 판결](https://www.law.go.kr/LSW/precInfoP.do?precSeq=83920)은 타인의 표장을 출처표시가 아니라 상품 기능 또는 적용 기종을 밝히기 위해 사용하고 상표 사용으로 인식될 수 없는 경우 침해가 아니라고 판시했다. [상표법 제2조](https://www.law.go.kr/법령/상표법/제2조), [제89조](https://www.law.go.kr/법령/상표법/제89조), [제90조](https://www.law.go.kr/법령/상표법/제90조), [제108조](https://www.law.go.kr/법령/상표법/제108조)와 대법원 [2011다18802](https://www.law.go.kr/LSW/precInfoP.do?precSeq=167457), [2019후10418](https://law.go.kr/LSW/precInfoP.do?mode=0&precSeq=230725) 판결에 따라 실제 거래계에서 출처표시로 기능하는지는 표시 태양과 사용 경위 등을 종합해 판단해야 한다.
6
+
7
+ 따라서 이 명칭은 필요한 범위의 평문으로만 사용하고, 별도 근거 없이 로고, 공식·제휴·후원·인증·파트너 표현을 사용하지 않는다. 각 상표의 권리는 해당 권리자에게 있다. 이 문서는 저작권, 데이터베이스권, 부정경쟁방지법, 약관·계약, 개인정보 또는 접근 방식의 적법성을 판단하지 않는다.
8
+
9
+ 전체 검토: [제3자 상표의 기능 설명·호환 대상 표시 검토](https://github.com/NomaDamas/k-skill/blob/dev/docs/legal/trademark-use-review.md)
@@ -0,0 +1,9 @@
1
+ # 상표 사용 법적 고지 — `daishin-report-search`
2
+
3
+ 이 스킬에서 `대신증권` 및 `Daishin Securities` 명칭은 대신증권 리포트 미러의 검색·원문 연결이라는 **대상 출처**를 식별하기 위해 사용한다. k-skill 또는 미러의 출처를 대신증권으로 표시하거나 공식 배포를 주장하려는 사용이 아니다.
4
+
5
+ 대법원 2005. 6. 10. 선고 [2005도1637 판결](https://www.law.go.kr/LSW/precInfoP.do?precSeq=83920)은 타인의 표장을 출처표시가 아니라 상품 기능 또는 적용 기종을 밝히기 위해 사용하고 상표 사용으로 인식될 수 없는 경우 침해가 아니라고 판시했다. [상표법 제2조](https://www.law.go.kr/법령/상표법/제2조), [제89조](https://www.law.go.kr/법령/상표법/제89조), [제90조](https://www.law.go.kr/법령/상표법/제90조), [제108조](https://www.law.go.kr/법령/상표법/제108조)와 대법원 [2011다18802](https://www.law.go.kr/LSW/precInfoP.do?precSeq=167457), [2019후10418](https://law.go.kr/LSW/precInfoP.do?mode=0&precSeq=230725) 판결에 따라 실제 거래계에서 출처표시로 기능하는지는 표시 태양과 사용 경위 등을 종합해 판단해야 한다.
6
+
7
+ 따라서 이 명칭은 필요한 범위의 평문으로만 사용하고, 별도 근거 없이 로고, 공식·제휴·후원·인증·파트너 표현을 사용하지 않는다. 각 상표의 권리는 해당 권리자에게 있다. 이 문서는 리포트의 저작권·재배포 권한, 데이터베이스권, 부정경쟁방지법, 약관·계약 또는 접근 방식의 적법성을 판단하지 않는다.
8
+
9
+ 전체 검토: [제3자 상표의 기능 설명·호환 대상 표시 검토](https://github.com/NomaDamas/k-skill/blob/dev/docs/legal/trademark-use-review.md)
@@ -0,0 +1,9 @@
1
+ # 상표 사용 법적 고지 — `daiso-product-search`
2
+
3
+ 이 스킬에서 `다이소` 및 `Daiso` 명칭은 다이소 매장·상품·재고 조회의 **대상 서비스**를 식별하기 위해 사용한다. k-skill의 출처를 다이소 운영사로 표시하려는 사용이 아니다.
4
+
5
+ 대법원 2005. 6. 10. 선고 [2005도1637 판결](https://www.law.go.kr/LSW/precInfoP.do?precSeq=83920)은 타인의 표장을 출처표시가 아니라 상품 기능 또는 적용 기종을 밝히기 위해 사용하고 상표 사용으로 인식될 수 없는 경우 침해가 아니라고 판시했다. [상표법 제2조](https://www.law.go.kr/법령/상표법/제2조), [제89조](https://www.law.go.kr/법령/상표법/제89조), [제90조](https://www.law.go.kr/법령/상표법/제90조), [제108조](https://www.law.go.kr/법령/상표법/제108조)와 대법원 [2011다18802](https://www.law.go.kr/LSW/precInfoP.do?precSeq=167457), [2019후10418](https://law.go.kr/LSW/precInfoP.do?mode=0&precSeq=230725) 판결에 따라 실제 거래계에서 출처표시로 기능하는지는 표시 태양과 사용 경위 등을 종합해 판단해야 한다.
6
+
7
+ 따라서 이 명칭은 필요한 범위의 평문으로만 사용하고, 별도 근거 없이 로고, 공식·제휴·후원·인증·파트너 표현을 사용하지 않는다. 각 상표의 권리는 해당 권리자에게 있다. 이 문서는 저작권, 데이터베이스권, 부정경쟁방지법, 약관·계약, 개인정보 또는 접근 방식의 적법성을 판단하지 않는다.
8
+
9
+ 전체 검토: [제3자 상표의 기능 설명·호환 대상 표시 검토](https://github.com/NomaDamas/k-skill/blob/dev/docs/legal/trademark-use-review.md)
@@ -0,0 +1,9 @@
1
+ # 상표 사용 법적 고지 — `danawa-price-search`
2
+
3
+ 이 스킬에서 `다나와` 및 `Danawa` 명칭은 다나와 가격비교·오퍼 정보 조회의 **대상 서비스**를 식별하기 위해 사용한다. k-skill의 출처를 다나와 운영사로 표시하려는 사용이 아니다.
4
+
5
+ 대법원 2005. 6. 10. 선고 [2005도1637 판결](https://www.law.go.kr/LSW/precInfoP.do?precSeq=83920)은 타인의 표장을 출처표시가 아니라 상품 기능 또는 적용 기종을 밝히기 위해 사용하고 상표 사용으로 인식될 수 없는 경우 침해가 아니라고 판시했다. [상표법 제2조](https://www.law.go.kr/법령/상표법/제2조), [제89조](https://www.law.go.kr/법령/상표법/제89조), [제90조](https://www.law.go.kr/법령/상표법/제90조), [제108조](https://www.law.go.kr/법령/상표법/제108조)와 대법원 [2011다18802](https://www.law.go.kr/LSW/precInfoP.do?precSeq=167457), [2019후10418](https://law.go.kr/LSW/precInfoP.do?mode=0&precSeq=230725) 판결에 따라 실제 거래계에서 출처표시로 기능하는지는 표시 태양과 사용 경위 등을 종합해 판단해야 한다.
6
+
7
+ 따라서 이 명칭은 필요한 범위의 평문으로만 사용하고, 별도 근거 없이 로고, 공식·제휴·후원·인증·파트너 표현을 사용하지 않는다. 각 상표의 권리는 해당 권리자에게 있다. 이 문서는 저작권, 데이터베이스권, 부정경쟁방지법, 약관·계약, 개인정보 또는 접근 방식의 적법성을 판단하지 않는다.
8
+
9
+ 전체 검토: [제3자 상표의 기능 설명·호환 대상 표시 검토](https://github.com/NomaDamas/k-skill/blob/dev/docs/legal/trademark-use-review.md)
@@ -0,0 +1,9 @@
1
+ # 상표 사용 법적 고지 — `delivery-tracking`
2
+
3
+ 이 스킬에서 `CJ대한통운`과 `우체국택배` 명칭은 송장 조회를 지원하는 **택배 서비스와 운송사**를 식별하기 위해 사용한다. k-skill의 출처나 운송 주체를 해당 사업자로 표시하려는 사용이 아니다.
4
+
5
+ 대법원 2005. 6. 10. 선고 [2005도1637 판결](https://www.law.go.kr/LSW/precInfoP.do?precSeq=83920)은 타인의 표장을 출처표시가 아니라 상품 기능 또는 적용 기종을 밝히기 위해 사용하고 상표 사용으로 인식될 수 없는 경우 침해가 아니라고 판시했다. [상표법 제2조](https://www.law.go.kr/법령/상표법/제2조), [제89조](https://www.law.go.kr/법령/상표법/제89조), [제90조](https://www.law.go.kr/법령/상표법/제90조), [제108조](https://www.law.go.kr/법령/상표법/제108조)와 대법원 [2011다18802](https://www.law.go.kr/LSW/precInfoP.do?precSeq=167457), [2019후10418](https://law.go.kr/LSW/precInfoP.do?mode=0&precSeq=230725) 판결에 따라 실제 거래계에서 출처표시로 기능하는지는 표시 태양과 사용 경위 등을 종합해 판단해야 한다.
6
+
7
+ 따라서 이 명칭은 필요한 범위의 평문으로만 사용하고, 별도 근거 없이 로고, 공식·제휴·후원·인증·파트너 표현을 사용하지 않는다. 각 상표의 권리는 해당 권리자에게 있다. 이 문서는 저작권, 데이터베이스권, 부정경쟁방지법, 약관·계약, 개인정보 또는 접근 방식의 적법성을 판단하지 않는다.
8
+
9
+ 전체 검토: [제3자 상표의 기능 설명·호환 대상 표시 검토](https://github.com/NomaDamas/k-skill/blob/dev/docs/legal/trademark-use-review.md)
@@ -0,0 +1,9 @@
1
+ # 상표 사용 법적 고지 — `express-bus-booking`
2
+
3
+ 이 스킬에서 `KOBUS` 명칭은 고속버스 시간표·좌석·예매 흐름의 **대상 공식 서비스**를 식별하기 위해 사용한다. k-skill의 출처나 운영주체를 KOBUS 운영기관으로 표시하려는 사용이 아니다.
4
+
5
+ 대법원 2005. 6. 10. 선고 [2005도1637 판결](https://www.law.go.kr/LSW/precInfoP.do?precSeq=83920)은 타인의 표장을 출처표시가 아니라 상품 기능 또는 적용 기종을 밝히기 위해 사용하고 상표 사용으로 인식될 수 없는 경우 침해가 아니라고 판시했다. [상표법 제2조](https://www.law.go.kr/법령/상표법/제2조), [제89조](https://www.law.go.kr/법령/상표법/제89조), [제90조](https://www.law.go.kr/법령/상표법/제90조), [제108조](https://www.law.go.kr/법령/상표법/제108조)와 대법원 [2011다18802](https://www.law.go.kr/LSW/precInfoP.do?precSeq=167457), [2019후10418](https://law.go.kr/LSW/precInfoP.do?mode=0&precSeq=230725) 판결에 따라 실제 거래계에서 출처표시로 기능하는지는 표시 태양과 사용 경위 등을 종합해 판단해야 한다.
6
+
7
+ 따라서 이 명칭은 필요한 범위의 평문으로만 사용하고, 별도 근거 없이 로고, 공식·제휴·후원·인증·파트너 표현을 사용하지 않는다. 각 상표의 권리는 해당 권리자에게 있다. 이 문서는 저작권, 데이터베이스권, 부정경쟁방지법, 약관·계약, 개인정보 또는 접근 방식의 적법성을 판단하지 않는다.
8
+
9
+ 전체 검토: [제3자 상표의 기능 설명·호환 대상 표시 검토](https://github.com/NomaDamas/k-skill/blob/dev/docs/legal/trademark-use-review.md)
@@ -0,0 +1,9 @@
1
+ # 상표 사용 법적 고지 — `flight-ticket-search`
2
+
3
+ 이 스킬에서 `Google Flights` 및 `Google` 명칭은 항공권 검색·가격 비교에 사용하는 **대상 검색 서비스**를 식별하기 위해 사용한다. k-skill의 출처를 Google로 표시하려는 사용이 아니다.
4
+
5
+ 대법원 2005. 6. 10. 선고 [2005도1637 판결](https://www.law.go.kr/LSW/precInfoP.do?precSeq=83920)은 타인의 표장을 출처표시가 아니라 상품 기능 또는 적용 기종을 밝히기 위해 사용하고 상표 사용으로 인식될 수 없는 경우 침해가 아니라고 판시했다. [상표법 제2조](https://www.law.go.kr/법령/상표법/제2조), [제89조](https://www.law.go.kr/법령/상표법/제89조), [제90조](https://www.law.go.kr/법령/상표법/제90조), [제108조](https://www.law.go.kr/법령/상표법/제108조)와 대법원 [2011다18802](https://www.law.go.kr/LSW/precInfoP.do?precSeq=167457), [2019후10418](https://law.go.kr/LSW/precInfoP.do?mode=0&precSeq=230725) 판결에 따라 실제 거래계에서 출처표시로 기능하는지는 표시 태양과 사용 경위 등을 종합해 판단해야 한다.
6
+
7
+ 따라서 이 명칭은 필요한 범위의 평문으로만 사용하고, 별도 근거 없이 로고, 공식·제휴·후원·인증·파트너 표현을 사용하지 않는다. 각 상표의 권리는 해당 권리자에게 있다. 이 문서는 저작권, 데이터베이스권, 부정경쟁방지법, 약관·계약, 개인정보 또는 접근 방식의 적법성을 판단하지 않는다.
8
+
9
+ 전체 검토: [제3자 상표의 기능 설명·호환 대상 표시 검토](https://github.com/NomaDamas/k-skill/blob/dev/docs/legal/trademark-use-review.md)
@@ -0,0 +1,9 @@
1
+ # 상표 사용 법적 고지 — `foresttrip-vacancy`
2
+
3
+ 이 스킬에서 `숲나들e` 및 `Foresttrip` 명칭은 국립 자연휴양림 숙박·야영 예약 조회의 **대상 공식 서비스**를 식별하기 위해 사용한다. k-skill의 출처나 운영주체를 해당 서비스 운영기관으로 표시하려는 사용이 아니다.
4
+
5
+ 대법원 2005. 6. 10. 선고 [2005도1637 판결](https://www.law.go.kr/LSW/precInfoP.do?precSeq=83920)은 타인의 표장을 출처표시가 아니라 상품 기능 또는 적용 기종을 밝히기 위해 사용하고 상표 사용으로 인식될 수 없는 경우 침해가 아니라고 판시했다. [상표법 제2조](https://www.law.go.kr/법령/상표법/제2조), [제89조](https://www.law.go.kr/법령/상표법/제89조), [제90조](https://www.law.go.kr/법령/상표법/제90조), [제108조](https://www.law.go.kr/법령/상표법/제108조)와 대법원 [2011다18802](https://www.law.go.kr/LSW/precInfoP.do?precSeq=167457), [2019후10418](https://law.go.kr/LSW/precInfoP.do?mode=0&precSeq=230725) 판결에 따라 실제 거래계에서 출처표시로 기능하는지는 표시 태양과 사용 경위 등을 종합해 판단해야 한다.
6
+
7
+ 따라서 이 명칭은 필요한 범위의 평문으로만 사용하고, 별도 근거 없이 로고, 공식·제휴·후원·인증·파트너 표현을 사용하지 않는다. 각 상표의 권리는 해당 권리자에게 있다. 이 문서는 저작권, 데이터베이스권, 부정경쟁방지법, 약관·계약, 개인정보 또는 접근 방식의 적법성을 판단하지 않는다.
8
+
9
+ 전체 검토: [제3자 상표의 기능 설명·호환 대상 표시 검토](https://github.com/NomaDamas/k-skill/blob/dev/docs/legal/trademark-use-review.md)
@@ -0,0 +1,143 @@
1
+ # 한국일보 뉴스 조회
2
+
3
+ ## What this skill does
4
+
5
+ 한국일보가 운영하는 공식 원격 MCP 서버를 직접 호출해 기사 메타데이터를 조회한다.
6
+
7
+ - 엔드포인트: `https://mcp.hankookilbo.com/mcp` (Streamable HTTP MCP, 인증 불필요)
8
+ - 공식 MCP Registry 등재명: `com.hankookilbo.mcp/hankookilbo-mcp`
9
+ - 도구 10종 — 편집 헤드라인, 많이 본, 꼼꼼히 본, 시간대 추천, 최신, 섹션별 편집 추천, 주제 검색, 섹션 목록, 오늘의 운세, MBTI 운세
10
+ - 반환값은 기사 메타데이터다: 기사 ID, 제목, 원문 URL, 썸네일 URL, 발행시각, 기사 유형, 원문 접근성, 짧은 발췌(`excerpt`)
11
+ - 기사 본문 전문은 반환하지 않는다
12
+
13
+ 서버가 무상태라 `initialize` 핸드셰이크와 세션 ID 없이 단일 POST 로 `tools/call` 이 동작한다. MCP SDK 를 설치하지 않고 `curl` 로 호출한다.
14
+
15
+ ## When to use
16
+
17
+ - "한국일보 헤드라인 보여줘"
18
+ - "한국일보에서 많이 본 기사"
19
+ - "오늘 한국일보 정치면 추천 기사"
20
+ - "한국일보에 이 사건 기사 있어?"
21
+ - "오늘의 운세", "MBTI 운세" (한국일보 지면 기준)
22
+ - 한국일보가 무엇을 머리기사로 올렸는지, 즉 편집 판단 자체가 필요할 때
23
+
24
+ ## When not to use
25
+
26
+ - 언론사를 가리지 않는 일반 뉴스 키워드 검색 — 이 서버는 한국일보 기사만 반환한다
27
+ - 기사 본문 전문이 필요할 때 — 이 스킬은 메타데이터만 반환한다. 본문은 `item.url` 원문에서만 볼 수 있다
28
+ - 한국경제(한경)나 다른 언론사 기사 — 이 서버는 종합일간지 한국일보 전용이다
29
+ - 로그인 뒤에만 보이는 기사의 본문 — `item.view_type` 이 `LoginWall` 이면 원문 열람에 로그인이 필요하다
30
+ - 주식·환율 시세, 실시간 데이터 — 이 서버는 기사만 다룬다
31
+
32
+ ## Endpoint contract
33
+
34
+ - POST 만 쓴다. GET·PUT·DELETE·OPTIONS 는 405 다.
35
+ - `Accept` 헤더에 `application/json` 과 `text/event-stream` 을 **둘 다** 넣는다. MCP Streamable HTTP 규격이 클라이언트에 요구하는 사항이고, 서버 응답이 나중에 SSE 로 바뀌어도 깨지지 않는다. `Accept` 를 아예 빼면 406 이다.
36
+ - `initialize`, `notifications/initialized`, `Mcp-Session-Id` 는 필요 없다.
37
+ - `User-Agent` 를 `k-skill-hankookilbo/1.0` 으로 보낸다. 한국일보 쪽에서 k-skill 경유 트래픽을 분리 관측한다.
38
+
39
+ 기본 호출:
40
+
41
+ ```bash
42
+ curl -fsS --max-time 35 https://mcp.hankookilbo.com/mcp \
43
+ -H 'Content-Type: application/json' \
44
+ -H 'Accept: application/json, text/event-stream' \
45
+ -H 'User-Agent: k-skill-hankookilbo/1.0' \
46
+ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_top_headlines","arguments":{}}}'
47
+ ```
48
+
49
+ 기사 목록은 `result.structuredContent.items` 에 들어온다. `result.content[0].text` 는 사람이 읽는 요약본이다. 목록을 정리할 때는 `structuredContent` 를 쓴다.
50
+
51
+ ```bash
52
+ curl -fsS --max-time 35 https://mcp.hankookilbo.com/mcp \
53
+ -H 'Content-Type: application/json' \
54
+ -H 'Accept: application/json, text/event-stream' \
55
+ -H 'User-Agent: k-skill-hankookilbo/1.0' \
56
+ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_popular_news","arguments":{"section_cd":"economy","page_size":5}}}' \
57
+ | python3 -c 'import json,sys
58
+ for i in json.load(sys.stdin)["result"]["structuredContent"]["items"]:
59
+ print(i["published_at"], "|", i["title"], "|", i["url"])'
60
+ ```
61
+
62
+ MCP 클라이언트에 직접 등록해도 된다. 이 경로에서는 서버가 보내는 instructions 도 함께 전달된다.
63
+
64
+ ```bash
65
+ claude mcp add --transport http hankookilbo https://mcp.hankookilbo.com/mcp
66
+ codex mcp add hankookilbo --url https://mcp.hankookilbo.com/mcp
67
+ ```
68
+
69
+ ## 도구 선택
70
+
71
+ | 사용자 발화 | 도구 | 인자 |
72
+ | --- | --- | --- |
73
+ | "헤드라인", "오늘 주요 뉴스", "제일 중요한 뉴스" | `list_top_headlines` | 없음 |
74
+ | "많이 본", "인기 뉴스", "지금 뜨는" | `list_popular_news` | `section_cd`, `page_size`, `exclude_section_cd` (전부 선택) |
75
+ | "꼼꼼히 본", "정독할 만한" | `list_most_read_news` | 없음 |
76
+ | "지금 볼만한", "출근길에 볼 뉴스" | `list_timely_news` | 없음 |
77
+ | "최신 기사", "방금 올라온" | `list_latest_news` | `page_num`, `page_size` (선택) |
78
+ | 섹션별 편집 추천 | `list_recommended_articles` | `section_cd` (필수), `page_size` |
79
+ | 주제·인물·사건 검색, "왜 화제야" | `search_news` | `query` (필수), `limit` |
80
+ | 섹션 코드 확인 | `list_sections` | 없음 |
81
+ | "오늘의 운세", "띠별 운세" | `get_daily_horoscope` | `date` (선택) |
82
+ | "MBTI 운세" | `get_mbti_horoscope` | `date` (선택) |
83
+
84
+ `section_cd` 값:
85
+
86
+ - `politics` 정치
87
+ - `economy` 경제
88
+ - `society` 사회
89
+ - `world` 국제
90
+ - `culture` 문화
91
+ - `sports` 스포츠
92
+ - `life` 라이프
93
+ - `people` 사람
94
+ - `local` 지역
95
+ - `opinion` 오피니언
96
+
97
+ 값을 추측하지 말고 불확실하면 `list_sections` 로 확인한다.
98
+
99
+ 세 가지 목록이 서로 다르다.
100
+
101
+ - `list_top_headlines` — 편집부가 비중 있게 배치한 머리기사
102
+ - `list_popular_news` — 조회수 기준 인기 순위. "많이 본"은 이쪽이다
103
+ - `list_recommended_articles` — 섹션별 편집 추천. 순위 값을 갖지 않는다
104
+
105
+ ## Workflow
106
+
107
+ 1. 요청을 위 표로 분류한다. 섹션이 필요한데 불확실하면 `list_sections` 를 먼저 호출한다.
108
+ 2. `curl` 로 해당 도구를 호출한다.
109
+ 3. `result.structuredContent.items` 상위 3~5건을 제목·발행시각·원문 링크로 정리한다.
110
+ 4. `search_news` 는 응답이 30초에 가까울 수 있다. `--max-time 35` 를 주고, 타임아웃되면 재시도하지 말고 질의를 좁혀 다시 묻는다.
111
+
112
+ ## Response style
113
+
114
+ - **기사 제목은 `item.title` 원문을 그대로 인용한다.** 요약·의역·말줄임·기호 변경·맞춤법 교정을 거치면 실제 보도 제목과 달라진다. `[제목](url)` 형태가 원문 표기와 가장 일치한다.
115
+ - `item.excerpt` 는 기사 도입부 일부이고 기사 전체 요약이 아니다. 발췌에 없는 해석·평가·배경·결말을 이 데이터로 단정하지 않는다.
116
+ - 본문 전문은 `item.url` 에서만 확인할 수 있다. 본문 내용을 재구성하지 않고 링크를 제시한다.
117
+ - `item.view_type` 이 `LoginWall` 이면 원문 열람에 로그인이 필요하다고 함께 알린다.
118
+ - `items` 가 비어 있지 않다는 것은 그 조건의 기사가 존재한다는 뜻이다. 목록을 임의로 누락시키지 않는다.
119
+ - 운세 도구는 운세 내용을 반환하지 않는다. 제목·발행일·원문 링크만 전달하고 운세 내용은 원문 링크로 넘긴다.
120
+ - 원문 URL 에는 서버가 `?did=mcp` 유입 파라미터를 붙여 돌려준다. 링크를 제시할 때 이 파라미터를 지우지 않는다.
121
+
122
+ ## Failure modes
123
+
124
+ - `406 Not Acceptable` — `Accept` 헤더가 없다. `application/json, text/event-stream` 을 채워 재시도한다.
125
+ - `405 Method Not Allowed` — POST 가 아닌 메서드를 썼다. POST 로 바꾼다.
126
+ - `result.isError: true` — 도구 인자가 잘못됐다. `section_cd` 오타, `query` 누락을 확인한다.
127
+ - `504` — `search_news` 가 제한 시간을 넘겼다. 재시도 루프를 만들지 말고 질의를 좁힌다.
128
+ - 빈 `items` — 해당 조건의 기사가 없다. 섹션·질의를 바꿔 다시 시도하거나 없다고 답한다.
129
+ - 연결 실패 — 한국일보 측 서버 장애다. 재시도 루프를 만들지 않고 현재 조회 불가임을 분명히 말한다.
130
+
131
+ ## Privacy
132
+
133
+ - 인증·로그인·개인화가 없는 공개 조회 전용이다. 시크릿을 요구하지 않는다.
134
+ - 기사 본문을 요청하거나 저장하지 않는다.
135
+ - 검색어와 결과를 영구 저장하지 않는다.
136
+
137
+ ## Done when
138
+
139
+ - 요청 유형에 맞는 도구를 골랐다.
140
+ - `structuredContent.items` 기준으로 상위 후보를 제목·발행시각·원문 링크로 정리했다.
141
+ - 제목을 원문 그대로 인용하고 `[제목](url)` 링크를 제시했다.
142
+ - 본문이 필요한 요청이면 본문은 원문 링크에서만 볼 수 있다고 안내했다.
143
+ - 실패 시 재시도 루프 없이 원인을 알렸다.
@@ -0,0 +1,8 @@
1
+ {
2
+ "name": "hankookilbo-news",
3
+ "description": "한국일보 공식 원격 MCP 서버(mcp.hankookilbo.com)를 인증 없이 직접 호출해 편집 헤드라인·많이 본·꼼꼼히 본·최신 기사·섹션별 편집 추천·주제 검색·오늘의 운세를 기사 메타데이터(제목·발행시각·원문 링크) 중심으로 조회한다.",
4
+ "profiles": [
5
+ "lookup"
6
+ ],
7
+ "frontmatter": "name: hankookilbo-news\ndescription: 한국일보 공식 원격 MCP 서버(mcp.hankookilbo.com)를 인증 없이 직접 호출해 편집 헤드라인·많이 본·꼼꼼히 본·최신 기사·섹션별 편집 추천·주제 검색·오늘의 운세를 기사 메타데이터(제목·발행시각·원문 링크) 중심으로 조회한다.\nlicense: MIT\nmetadata:\n category: information\n locale: ko-KR\n phase: v1"
8
+ }
@@ -0,0 +1,9 @@
1
+ # 상표 사용 법적 고지 — `hipass-receipt`
2
+
3
+ 이 스킬에서 `하이패스` 및 `Hi-Pass` 명칭은 통행료 사용내역·영수증 조회의 **대상 공식 서비스**를 식별하기 위해 사용한다. k-skill의 출처나 운영주체를 하이패스 운영기관으로 표시하려는 사용이 아니다.
4
+
5
+ 대법원 2005. 6. 10. 선고 [2005도1637 판결](https://www.law.go.kr/LSW/precInfoP.do?precSeq=83920)은 타인의 표장을 출처표시가 아니라 상품 기능 또는 적용 기종을 밝히기 위해 사용하고 상표 사용으로 인식될 수 없는 경우 침해가 아니라고 판시했다. [상표법 제2조](https://www.law.go.kr/법령/상표법/제2조), [제89조](https://www.law.go.kr/법령/상표법/제89조), [제90조](https://www.law.go.kr/법령/상표법/제90조), [제108조](https://www.law.go.kr/법령/상표법/제108조)와 대법원 [2011다18802](https://www.law.go.kr/LSW/precInfoP.do?precSeq=167457), [2019후10418](https://law.go.kr/LSW/precInfoP.do?mode=0&precSeq=230725) 판결에 따라 실제 거래계에서 출처표시로 기능하는지는 표시 태양과 사용 경위 등을 종합해 판단해야 한다.
6
+
7
+ 따라서 이 명칭은 필요한 범위의 평문으로만 사용하고, 별도 근거 없이 로고, 공식·제휴·후원·인증·파트너 표현을 사용하지 않는다. 각 상표의 권리는 해당 권리자에게 있다. 이 문서는 저작권, 데이터베이스권, 부정경쟁방지법, 약관·계약, 개인정보 또는 접근 방식의 적법성을 판단하지 않는다.
8
+
9
+ 전체 검토: [제3자 상표의 기능 설명·호환 대상 표시 검토](https://github.com/NomaDamas/k-skill/blob/dev/docs/legal/trademark-use-review.md)
@@ -0,0 +1,9 @@
1
+ # 상표 사용 법적 고지 — `intercity-bus-booking`
2
+
3
+ 이 스킬에서 `티머니` 및 `Tmoney` 명칭은 시외버스 시간표·좌석·예매 흐름의 **대상 공식 서비스**를 식별하기 위해 사용한다. k-skill의 출처나 운영주체를 티머니 운영사로 표시하려는 사용이 아니다.
4
+
5
+ 대법원 2005. 6. 10. 선고 [2005도1637 판결](https://www.law.go.kr/LSW/precInfoP.do?precSeq=83920)은 타인의 표장을 출처표시가 아니라 상품 기능 또는 적용 기종을 밝히기 위해 사용하고 상표 사용으로 인식될 수 없는 경우 침해가 아니라고 판시했다. [상표법 제2조](https://www.law.go.kr/법령/상표법/제2조), [제89조](https://www.law.go.kr/법령/상표법/제89조), [제90조](https://www.law.go.kr/법령/상표법/제90조), [제108조](https://www.law.go.kr/법령/상표법/제108조)와 대법원 [2011다18802](https://www.law.go.kr/LSW/precInfoP.do?precSeq=167457), [2019후10418](https://law.go.kr/LSW/precInfoP.do?mode=0&precSeq=230725) 판결에 따라 실제 거래계에서 출처표시로 기능하는지는 표시 태양과 사용 경위 등을 종합해 판단해야 한다.
6
+
7
+ 따라서 이 명칭은 필요한 범위의 평문으로만 사용하고, 별도 근거 없이 로고, 공식·제휴·후원·인증·파트너 표현을 사용하지 않는다. 각 상표의 권리는 해당 권리자에게 있다. 이 문서는 저작권, 데이터베이스권, 부정경쟁방지법, 약관·계약, 개인정보 또는 접근 방식의 적법성을 판단하지 않는다.
8
+
9
+ 전체 검토: [제3자 상표의 기능 설명·호환 대상 표시 검토](https://github.com/NomaDamas/k-skill/blob/dev/docs/legal/trademark-use-review.md)
@@ -0,0 +1,9 @@
1
+ # 상표 사용 법적 고지 — `job-posting-match`
2
+
3
+ 이 스킬에서 `잡코리아`와 `사람인` 명칭은 채용공고를 검색·비교하는 **대상 채용 서비스**를 식별하기 위해 사용한다. k-skill의 출처를 각 서비스 운영사로 표시하려는 사용이 아니다.
4
+
5
+ 대법원 2005. 6. 10. 선고 [2005도1637 판결](https://www.law.go.kr/LSW/precInfoP.do?precSeq=83920)은 타인의 표장을 출처표시가 아니라 상품 기능 또는 적용 기종을 밝히기 위해 사용하고 상표 사용으로 인식될 수 없는 경우 침해가 아니라고 판시했다. [상표법 제2조](https://www.law.go.kr/법령/상표법/제2조), [제89조](https://www.law.go.kr/법령/상표법/제89조), [제90조](https://www.law.go.kr/법령/상표법/제90조), [제108조](https://www.law.go.kr/법령/상표법/제108조)와 대법원 [2011다18802](https://www.law.go.kr/LSW/precInfoP.do?precSeq=167457), [2019후10418](https://law.go.kr/LSW/precInfoP.do?mode=0&precSeq=230725) 판결에 따라 실제 거래계에서 출처표시로 기능하는지는 표시 태양과 사용 경위 등을 종합해 판단해야 한다.
6
+
7
+ 따라서 이 명칭은 필요한 범위의 평문으로만 사용하고, 별도 근거 없이 로고, 공식·제휴·후원·인증·파트너 표현을 사용하지 않는다. 각 상표의 권리는 해당 권리자에게 있다. 이 문서는 채용 적합성, 저작권, 데이터베이스권, 부정경쟁방지법, 약관·계약, 개인정보 또는 접근 방식의 적법성을 판단하지 않는다.
8
+
9
+ 전체 검토: [제3자 상표의 기능 설명·호환 대상 표시 검토](https://github.com/NomaDamas/k-skill/blob/dev/docs/legal/trademark-use-review.md)
@@ -0,0 +1,9 @@
1
+ # 상표 사용 법적 고지 — `jobkorea-talent-search`
2
+
3
+ 이 스킬에서 `잡코리아` 및 `JobKorea` 명칭은 기업회원 인재검색·비교의 **대상 채용 서비스**를 식별하기 위해 사용한다. k-skill의 출처를 잡코리아 운영사로 표시하려는 사용이 아니다.
4
+
5
+ 대법원 2005. 6. 10. 선고 [2005도1637 판결](https://www.law.go.kr/LSW/precInfoP.do?precSeq=83920)은 타인의 표장을 출처표시가 아니라 상품 기능 또는 적용 기종을 밝히기 위해 사용하고 상표 사용으로 인식될 수 없는 경우 침해가 아니라고 판시했다. [상표법 제2조](https://www.law.go.kr/법령/상표법/제2조), [제89조](https://www.law.go.kr/법령/상표법/제89조), [제90조](https://www.law.go.kr/법령/상표법/제90조), [제108조](https://www.law.go.kr/법령/상표법/제108조)와 대법원 [2011다18802](https://www.law.go.kr/LSW/precInfoP.do?precSeq=167457), [2019후10418](https://law.go.kr/LSW/precInfoP.do?mode=0&precSeq=230725) 판결에 따라 실제 거래계에서 출처표시로 기능하는지는 표시 태양과 사용 경위 등을 종합해 판단해야 한다.
6
+
7
+ 따라서 이 명칭은 필요한 범위의 평문으로만 사용하고, 별도 근거 없이 로고, 공식·제휴·후원·인증·파트너 표현을 사용하지 않는다. 각 상표의 권리는 해당 권리자에게 있다. 이 문서는 채용 적합성, 저작권, 데이터베이스권, 부정경쟁방지법, 약관·계약, 개인정보 또는 접근 방식의 적법성을 판단하지 않는다.
8
+
9
+ 전체 검토: [제3자 상표의 기능 설명·호환 대상 표시 검토](https://github.com/NomaDamas/k-skill/blob/dev/docs/legal/trademark-use-review.md)
@@ -0,0 +1,9 @@
1
+ # 상표 사용 법적 고지 — `kakao-bar-nearby`
2
+
3
+ 이 스킬에서 `카카오맵` 및 `Kakao Map` 명칭은 주변 술집 검색·장소 상세 확인에 사용하는 **대상 지도 서비스**를 식별하기 위해 사용한다. k-skill의 출처를 카카오로 표시하려는 사용이 아니다.
4
+
5
+ 대법원 2005. 6. 10. 선고 [2005도1637 판결](https://www.law.go.kr/LSW/precInfoP.do?precSeq=83920)은 타인의 표장을 출처표시가 아니라 상품 기능 또는 적용 기종을 밝히기 위해 사용하고 상표 사용으로 인식될 수 없는 경우 침해가 아니라고 판시했다. [상표법 제2조](https://www.law.go.kr/법령/상표법/제2조), [제89조](https://www.law.go.kr/법령/상표법/제89조), [제90조](https://www.law.go.kr/법령/상표법/제90조), [제108조](https://www.law.go.kr/법령/상표법/제108조)와 대법원 [2011다18802](https://www.law.go.kr/LSW/precInfoP.do?precSeq=167457), [2019후10418](https://law.go.kr/LSW/precInfoP.do?mode=0&precSeq=230725) 판결에 따라 실제 거래계에서 출처표시로 기능하는지는 표시 태양과 사용 경위 등을 종합해 판단해야 한다.
6
+
7
+ 따라서 이 명칭은 필요한 범위의 평문으로만 사용하고, 별도 근거 없이 로고, 공식·제휴·후원·인증·파트너 표현을 사용하지 않는다. 각 상표의 권리는 해당 권리자에게 있다. 이 문서는 저작권, 데이터베이스권, 부정경쟁방지법, 약관·계약, 개인정보 또는 접근 방식의 적법성을 판단하지 않는다.
8
+
9
+ 전체 검토: [제3자 상표의 기능 설명·호환 대상 표시 검토](https://github.com/NomaDamas/k-skill/blob/dev/docs/legal/trademark-use-review.md)
@@ -0,0 +1,9 @@
1
+ # 상표 사용 법적 고지 — `kakao-map`
2
+
3
+ 이 스킬에서 `카카오`, `Kakao Local`, `Kakao Map`, `Kakao Mobility` 명칭은 장소 검색·지오코딩·자동차 길찾기의 **대상 API와 서비스**를 식별하기 위해 사용한다. k-skill의 출처를 카카오로 표시하려는 사용이 아니다.
4
+
5
+ 대법원 2005. 6. 10. 선고 [2005도1637 판결](https://www.law.go.kr/LSW/precInfoP.do?precSeq=83920)은 타인의 표장을 출처표시가 아니라 상품 기능 또는 적용 기종을 밝히기 위해 사용하고 상표 사용으로 인식될 수 없는 경우 침해가 아니라고 판시했다. [상표법 제2조](https://www.law.go.kr/법령/상표법/제2조), [제89조](https://www.law.go.kr/법령/상표법/제89조), [제90조](https://www.law.go.kr/법령/상표법/제90조), [제108조](https://www.law.go.kr/법령/상표법/제108조)와 대법원 [2011다18802](https://www.law.go.kr/LSW/precInfoP.do?precSeq=167457), [2019후10418](https://law.go.kr/LSW/precInfoP.do?mode=0&precSeq=230725) 판결에 따라 실제 거래계에서 출처표시로 기능하는지는 표시 태양과 사용 경위 등을 종합해 판단해야 한다.
6
+
7
+ 따라서 이 명칭은 필요한 범위의 평문으로만 사용하고, 별도 근거 없이 로고, 공식·제휴·후원·인증·파트너 표현을 사용하지 않는다. 각 상표의 권리는 해당 권리자에게 있다. 이 문서는 API 이용약관, 저작권, 데이터베이스권, 부정경쟁방지법, 개인정보 또는 접근 방식의 적법성을 판단하지 않는다.
8
+
9
+ 전체 검토: [제3자 상표의 기능 설명·호환 대상 표시 검토](https://github.com/NomaDamas/k-skill/blob/dev/docs/legal/trademark-use-review.md)
@@ -0,0 +1,9 @@
1
+ # 상표 사용 법적 고지 — `kakaotalk-mac`
2
+
3
+ 이 스킬에서 `카카오톡` 및 `KakaoTalk` 명칭은 macOS의 카카오톡 로컬 아카이브 검색이라는 **호환 대상 애플리케이션**을 식별하기 위해 사용한다. k-skill 또는 `katok` CLI의 출처를 카카오로 표시하려는 사용이 아니다.
4
+
5
+ 대법원 2005. 6. 10. 선고 [2005도1637 판결](https://www.law.go.kr/LSW/precInfoP.do?precSeq=83920)은 타인의 표장을 출처표시가 아니라 상품 기능 또는 적용 기종을 밝히기 위해 사용하고 상표 사용으로 인식될 수 없는 경우 침해가 아니라고 판시했다. [상표법 제2조](https://www.law.go.kr/법령/상표법/제2조), [제89조](https://www.law.go.kr/법령/상표법/제89조), [제90조](https://www.law.go.kr/법령/상표법/제90조), [제108조](https://www.law.go.kr/법령/상표법/제108조)와 대법원 [2011다18802](https://www.law.go.kr/LSW/precInfoP.do?precSeq=167457), [2019후10418](https://law.go.kr/LSW/precInfoP.do?mode=0&precSeq=230725) 판결에 따라 실제 거래계에서 출처표시로 기능하는지는 표시 태양과 사용 경위 등을 종합해 판단해야 한다.
6
+
7
+ 따라서 이 명칭은 필요한 범위의 평문으로만 사용하고, 별도 근거 없이 로고, 공식·제휴·후원·인증·파트너 표현을 사용하지 않는다. 각 상표의 권리는 해당 권리자에게 있다. 이 문서는 메시지·첨부파일의 저작권, 개인정보, 통신비밀, 약관·계약 또는 로컬 데이터 접근의 적법성을 판단하지 않는다.
8
+
9
+ 전체 검토: [제3자 상표의 기능 설명·호환 대상 표시 검토](https://github.com/NomaDamas/k-skill/blob/dev/docs/legal/trademark-use-review.md)
@@ -0,0 +1,9 @@
1
+ # 상표 사용 법적 고지 — `kbl-results`
2
+
3
+ 이 스킬에서 `KBL` 명칭은 한국프로농구 경기 결과·순위 조회의 **대상 리그와 데이터 출처**를 식별하기 위해 사용한다. k-skill의 출처를 KBL로 표시하려는 사용이 아니다.
4
+
5
+ 대법원 2005. 6. 10. 선고 [2005도1637 판결](https://www.law.go.kr/LSW/precInfoP.do?precSeq=83920)은 타인의 표장을 출처표시가 아니라 상품 기능 또는 적용 기종을 밝히기 위해 사용하고 상표 사용으로 인식될 수 없는 경우 침해가 아니라고 판시했다. [상표법 제2조](https://www.law.go.kr/법령/상표법/제2조), [제89조](https://www.law.go.kr/법령/상표법/제89조), [제90조](https://www.law.go.kr/법령/상표법/제90조), [제108조](https://www.law.go.kr/법령/상표법/제108조)와 대법원 [2011다18802](https://www.law.go.kr/LSW/precInfoP.do?precSeq=167457), [2019후10418](https://law.go.kr/LSW/precInfoP.do?mode=0&precSeq=230725) 판결에 따라 실제 거래계에서 출처표시로 기능하는지는 표시 태양과 사용 경위 등을 종합해 판단해야 한다.
6
+
7
+ 따라서 이 명칭은 필요한 범위의 평문으로만 사용하고, 별도 근거 없이 로고, 공식·제휴·후원·인증·파트너 표현을 사용하지 않는다. 각 상표의 권리는 해당 권리자에게 있다. 이 문서는 경기 데이터의 저작권·데이터베이스권, 중계권, 약관·계약 또는 접근 방식의 적법성을 판단하지 않는다.
8
+
9
+ 전체 검토: [제3자 상표의 기능 설명·호환 대상 표시 검토](https://github.com/NomaDamas/k-skill/blob/dev/docs/legal/trademark-use-review.md)
@@ -0,0 +1,9 @@
1
+ # 상표 사용 법적 고지 — `kbo-results`
2
+
3
+ 이 스킬에서 `KBO` 명칭은 한국 프로야구 일정·결과 조회의 **대상 리그와 데이터 출처**를 식별하기 위해 사용한다. k-skill의 출처를 KBO로 표시하려는 사용이 아니다.
4
+
5
+ 대법원 2005. 6. 10. 선고 [2005도1637 판결](https://www.law.go.kr/LSW/precInfoP.do?precSeq=83920)은 타인의 표장을 출처표시가 아니라 상품 기능 또는 적용 기종을 밝히기 위해 사용하고 상표 사용으로 인식될 수 없는 경우 침해가 아니라고 판시했다. [상표법 제2조](https://www.law.go.kr/법령/상표법/제2조), [제89조](https://www.law.go.kr/법령/상표법/제89조), [제90조](https://www.law.go.kr/법령/상표법/제90조), [제108조](https://www.law.go.kr/법령/상표법/제108조)와 대법원 [2011다18802](https://www.law.go.kr/LSW/precInfoP.do?precSeq=167457), [2019후10418](https://law.go.kr/LSW/precInfoP.do?mode=0&precSeq=230725) 판결에 따라 실제 거래계에서 출처표시로 기능하는지는 표시 태양과 사용 경위 등을 종합해 판단해야 한다.
6
+
7
+ 따라서 이 명칭은 필요한 범위의 평문으로만 사용하고, 별도 근거 없이 로고, 공식·제휴·후원·인증·파트너 표현을 사용하지 않는다. 각 상표의 권리는 해당 권리자에게 있다. 이 문서는 경기 데이터의 저작권·데이터베이스권, 중계권, 약관·계약 또는 접근 방식의 적법성을 판단하지 않는다.
8
+
9
+ 전체 검토: [제3자 상표의 기능 설명·호환 대상 표시 검토](https://github.com/NomaDamas/k-skill/blob/dev/docs/legal/trademark-use-review.md)
@@ -0,0 +1,9 @@
1
+ # 상표 사용 법적 고지 — `kleague-results`
2
+
3
+ 이 스킬에서 `K League` 및 `K리그` 명칭은 프로축구 경기 결과·순위 조회의 **대상 리그와 데이터 출처**를 식별하기 위해 사용한다. k-skill의 출처를 K League 운영기관으로 표시하려는 사용이 아니다.
4
+
5
+ 대법원 2005. 6. 10. 선고 [2005도1637 판결](https://www.law.go.kr/LSW/precInfoP.do?precSeq=83920)은 타인의 표장을 출처표시가 아니라 상품 기능 또는 적용 기종을 밝히기 위해 사용하고 상표 사용으로 인식될 수 없는 경우 침해가 아니라고 판시했다. [상표법 제2조](https://www.law.go.kr/법령/상표법/제2조), [제89조](https://www.law.go.kr/법령/상표법/제89조), [제90조](https://www.law.go.kr/법령/상표법/제90조), [제108조](https://www.law.go.kr/법령/상표법/제108조)와 대법원 [2011다18802](https://www.law.go.kr/LSW/precInfoP.do?precSeq=167457), [2019후10418](https://law.go.kr/LSW/precInfoP.do?mode=0&precSeq=230725) 판결에 따라 실제 거래계에서 출처표시로 기능하는지는 표시 태양과 사용 경위 등을 종합해 판단해야 한다.
6
+
7
+ 따라서 이 명칭은 필요한 범위의 평문으로만 사용하고, 별도 근거 없이 로고, 공식·제휴·후원·인증·파트너 표현을 사용하지 않는다. 각 상표의 권리는 해당 권리자에게 있다. 이 문서는 경기 데이터의 저작권·데이터베이스권, 중계권, 약관·계약 또는 접근 방식의 적법성을 판단하지 않는다.
8
+
9
+ 전체 검토: [제3자 상표의 기능 설명·호환 대상 표시 검토](https://github.com/NomaDamas/k-skill/blob/dev/docs/legal/trademark-use-review.md)
@@ -0,0 +1,9 @@
1
+ # 상표 사용 법적 고지 — `korean-cinema-search`
2
+
3
+ 이 스킬에서 `CGV`, `메가박스`, `롯데시네마` 명칭은 영화관·상영작·시간표·잔여석 조회의 **대상 영화관 서비스**를 식별하기 위해 사용한다. k-skill의 출처를 각 영화관 운영사로 표시하려는 사용이 아니다.
4
+
5
+ 대법원 2005. 6. 10. 선고 [2005도1637 판결](https://www.law.go.kr/LSW/precInfoP.do?precSeq=83920)은 타인의 표장을 출처표시가 아니라 상품 기능 또는 적용 기종을 밝히기 위해 사용하고 상표 사용으로 인식될 수 없는 경우 침해가 아니라고 판시했다. [상표법 제2조](https://www.law.go.kr/법령/상표법/제2조), [제89조](https://www.law.go.kr/법령/상표법/제89조), [제90조](https://www.law.go.kr/법령/상표법/제90조), [제108조](https://www.law.go.kr/법령/상표법/제108조)와 대법원 [2011다18802](https://www.law.go.kr/LSW/precInfoP.do?precSeq=167457), [2019후10418](https://law.go.kr/LSW/precInfoP.do?mode=0&precSeq=230725) 판결에 따라 실제 거래계에서 출처표시로 기능하는지는 표시 태양과 사용 경위 등을 종합해 판단해야 한다.
6
+
7
+ 따라서 이 명칭은 필요한 범위의 평문으로만 사용하고, 별도 근거 없이 로고, 공식·제휴·후원·인증·파트너 표현을 사용하지 않는다. 각 상표의 권리는 해당 권리자에게 있다. 이 문서는 영화·상영 데이터의 저작권·데이터베이스권, 약관·계약, 개인정보 또는 접근 방식의 적법성을 판단하지 않는다.
8
+
9
+ 전체 검토: [제3자 상표의 기능 설명·호환 대상 표시 검토](https://github.com/NomaDamas/k-skill/blob/dev/docs/legal/trademark-use-review.md)
@@ -0,0 +1,9 @@
1
+ # 상표 사용 법적 고지 — `korean-transit-route`
2
+
3
+ 이 스킬에서 `ODsay`와 `카카오` 명칭은 대중교통 경로 조회 및 주소 좌표 변환에 사용하는 **대상 API와 서비스**를 식별하기 위해 사용한다. k-skill의 출처를 해당 운영사로 표시하려는 사용이 아니다.
4
+
5
+ 대법원 2005. 6. 10. 선고 [2005도1637 판결](https://www.law.go.kr/LSW/precInfoP.do?precSeq=83920)은 타인의 표장을 출처표시가 아니라 상품 기능 또는 적용 기종을 밝히기 위해 사용하고 상표 사용으로 인식될 수 없는 경우 침해가 아니라고 판시했다. [상표법 제2조](https://www.law.go.kr/법령/상표법/제2조), [제89조](https://www.law.go.kr/법령/상표법/제89조), [제90조](https://www.law.go.kr/법령/상표법/제90조), [제108조](https://www.law.go.kr/법령/상표법/제108조)와 대법원 [2011다18802](https://www.law.go.kr/LSW/precInfoP.do?precSeq=167457), [2019후10418](https://law.go.kr/LSW/precInfoP.do?mode=0&precSeq=230725) 판결에 따라 실제 거래계에서 출처표시로 기능하는지는 표시 태양과 사용 경위 등을 종합해 판단해야 한다.
6
+
7
+ 따라서 이 명칭은 필요한 범위의 평문으로만 사용하고, 별도 근거 없이 로고, 공식·제휴·후원·인증·파트너 표현을 사용하지 않는다. 각 상표의 권리는 해당 권리자에게 있다. 이 문서는 API 이용약관, 저작권, 데이터베이스권, 부정경쟁방지법, 개인정보 또는 접근 방식의 적법성을 판단하지 않는다.
8
+
9
+ 전체 검토: [제3자 상표의 기능 설명·호환 대상 표시 검토](https://github.com/NomaDamas/k-skill/blob/dev/docs/legal/trademark-use-review.md)
@@ -132,12 +132,19 @@ npx -y @nomadamas/k-skill@0 exec kosis-stats scripts/run_kosis_stats.py -- searc
132
132
 
133
133
  ### 3. Inspect the table meta before fetching data
134
134
 
135
- 데이터를 받기 전에 분류/단위/주기를 확인한다.
135
+ 데이터를 받기 전에 분류/단위를 확인한다.
136
136
 
137
137
  ```bash
138
138
  npx -y @nomadamas/k-skill@0 exec kosis-stats scripts/run_kosis_stats.py -- meta --table-id DT_1JC1501 --text
139
139
  ```
140
140
 
141
+ **수록주기는 `meta` 로 확정되지 않는다.** `meta --meta-type TBL` 은 표 명칭(국/영문) 위주라 `--prd-se` 에 넣을 주기를 돌려주지 않고, `search` 응답의 `PRD_SE` 는 `--prd-se` 와 코드 체계가 달라(예: `DT_1IN0001` → `PRD_SE=A` 이지만 실제 조회는 `F`) 그대로 쓰면 안 된다. `STRT_PRD_DE`~`END_PRD_DE` 도 수록 범위일 뿐 간격을 알려주지 않는다. 조사주기는 `explain` 으로 확인하거나 §4 의 프로브로 확정한다.
142
+
143
+ ```bash
144
+ npx -y @nomadamas/k-skill@0 exec kosis-stats scripts/run_kosis_stats.py -- explain \
145
+ --org-id 101 --table-id DT_1IN0001 --meta-itm All --text
146
+ ```
147
+
141
148
  ### 4. Fetch a small bounded slice first
142
149
 
143
150
  `--prd-se`, `--start`, `--end`, `--obj-l` 으로 범위를 좁혀 작은 슬라이스를 먼저 조회한다.
@@ -148,6 +155,16 @@ npx -y @nomadamas/k-skill@0 exec kosis-stats scripts/run_kosis_stats.py -- data
148
155
  --obj-l 1=ALL --json
149
156
  ```
150
157
 
158
+ **`--prd-se` 를 먼저 확정한다.** 주기를 틀리면 다른 파라미터가 전부 맞아도 KOSIS는 코드 `30`(결과 없음)만 돌려주며, 메시지로는 원인을 알 수 없다. `explain`(§3)으로 조사주기를 확인하거나, 좁은 기간·최소 분류로 `Y` → `F` → `IR` → `M`/`Q`/`S` 순으로 프로브해 데이터가 나오는 코드를 찾은 뒤 본 조회를 한다. 총조사·인구주택총조사처럼 5년 간격인 표는 연 단위로 보여도 `F`(다년)다.
159
+
160
+ ```bash
161
+ for p in Y F IR; do
162
+ npx -y @nomadamas/k-skill@0 exec kosis-stats scripts/run_kosis_stats.py -- data \
163
+ --org-id 101 --table-id DT_1IN0001 --prd-se "$p" \
164
+ --start 2010 --end 2010 --itm-id ALL --obj-l 1=00 --obj-l 2=00 --text
165
+ done
166
+ ```
167
+
151
168
  표마다 필수 분류 차원 수가 다르다. **default `--obj-l 1=ALL` 만으로는 부족한 표가 많다.** KOSIS가 코드 `20` (필수요청변수값 누락 objL)을 돌려주면, `meta --table-id <ID> --meta-type ITM --json` 으로 ITM 안에 들어 있는 `OBJ_ID`(분류 차원)와 코드를 확인한 뒤 `--obj-l 1=<코드> --obj-l 2=<코드>` 형태로 필요한 차원을 모두 지정한다. (많은 표가 OBJ 메타는 비어 있고 분류가 ITM 안에 들어 있음.)
152
169
 
153
170
  40,000셀을 초과하면 KOSIS는 에러 코드 `31` 또는 `41` 을 반환한다. 기간을 좁히거나(예: 5년→1년) 분류 필터의 ALL 을 특정 코드로 바꿔(예: `--obj-l 1=11` 서울만) 호출을 분할한다. 그래도 부족하면 사용자별 통계자료(`userStatsId`)를 등록해 `bigdata` 서브커맨드를 사용한다.
@@ -171,7 +188,7 @@ npx -y @nomadamas/k-skill@0 exec kosis-stats scripts/run_kosis_stats.py -- bigda
171
188
  ## Done when
172
189
 
173
190
  - 사용자 질문에 대응하는 통계표 ID(`org_id`/`tbl_id`)가 명확하다.
174
- - 메타데이터를 1회 이상 조회해 분류·단위·주기를 확인했다.
191
+ - 메타데이터를 1회 이상 조회해 분류·단위를 확인했고, `--prd-se` 는 실제 데이터가 나오는 코드로 확정했다.
175
192
  - 작은 슬라이스부터 단계적으로 데이터를 받았다.
176
193
  - 결과에 출처(table id, 기간, 단위, endpoint)를 명시했다.
177
194
  - 한도 초과 시 분할 또는 `bigdata` 안내로 처리했다.
@@ -182,7 +199,10 @@ npx -y @nomadamas/k-skill@0 exec kosis-stats scripts/run_kosis_stats.py -- bigda
182
199
  - KOSIS 에러 코드 `10`/`11`: 인증키 누락/만료 → 키 점검. `bigdata` 에서 `11` 이 나오면 `userStatsId` 가 본인 KOSIS 계정에 등록된 것이 아닐 가능성이 크다.
183
200
  - 코드 `20`: 필수 분류 누락 → `meta --meta-type OBJ` (또는 비어 있으면 `ITM`) 으로 필요한 차원 수와 코드를 확인하고 `--obj-l 1=... --obj-l 2=...` 모두 지정 후 재시도
184
201
  - 코드 `21`: 잘못된 요청 변수 → `org_id`/`tbl_id`/기간 형식 재확인. tblId 의심 시 `search` 로 정확한 ID 다시 찾기
185
- - 코드 `30`: 결과 없음 키워드를 짧게 또는 다른 표현으로 바꾸거나 기간/분류 완화. **meta 호출에서 30 이 나오면** 표가 해당 메타 타입을 지원하지 않는 경우이므로 다른 `--meta-type` 시도
202
+ - 코드 `30`: 결과 없음. 어느 서브커맨드에서 났는지로 원인이 갈린다.
203
+ - **`data` 에서 30 → 먼저 `--prd-se` 오지정을 의심한다.** 표의 실제 수록주기와 다른 코드를 주면 `--start`/`--end`/`--obj-l` 이 전부 맞아도 항상 30 이다. 연 단위처럼 보이는 표라도 총조사·센서스류는 다년주기 `F`(2·3·4·5·10년) 또는 부정기 `IR` 인 경우가 많다. `explain` 으로 조사주기를 확인하거나 `Y` → `F` → `IR` → `M`/`Q`/`S` 순으로 프로브해 확정한다 (§4 참고).
204
+ - `search` 에서 30 → 키워드를 더 짧게 또는 다른 표현으로 바꾸거나 기간/분류 완화
205
+ - **`meta` 에서 30** → 표가 해당 메타 타입을 지원하지 않는 경우이므로 다른 `--meta-type` 시도
186
206
  - 코드 `31`/`41`: 한도 초과 → 기간 좁히기, 분류 ALL 을 특정 코드로 바꾸기, 또는 `bigdata` 사용
187
207
  - 코드 `40`: 분당 1,000건 호출 한도 → 잠시 대기
188
208
  - 코드 `50`: KOSIS 서버 오류 → 1~2초 후 재시도
@@ -194,6 +214,7 @@ npx -y @nomadamas/k-skill@0 exec kosis-stats scripts/run_kosis_stats.py -- bigda
194
214
 
195
215
  - 코드 20 회복: `data --table-id DT_1J22001 --prd-se M --start 202401 --end 202401` → 코드 20 → `meta --table-id DT_1J22001 --meta-type ITM --json` 으로 차원 확인 → `data ... --obj-l 1=T10 --obj-l 2=0` 재호출 → 성공
196
216
  - 코드 31 회복: `data --table-id DT_1B26001 --prd-se Y --start 2020 --end 2024 --obj-l 1=ALL --obj-l 2=ALL --obj-l 3=ALL` → 코드 31 → `... --start 2024 --end 2024 --obj-l 1=11 --obj-l 2=ALL --obj-l 3=ALL` (서울만) 재호출 → 성공
217
+ - 코드 30 회복(수록주기 오지정): `data --org-id 101 --table-id DT_1IN0001 --prd-se Y --start 1990 --end 2010 --itm-id ALL --obj-l 1=00 --obj-l 2=00` → 코드 30 → 연도를 2015·2010·2005·2000·1995·1990 으로 바꿔 재시도해도 전부 코드 30, `--prd-se IR` 도 코드 30 → `--prd-se F --start 1925 --end 2010` 으로 재호출 → 성공(수록 시점 18개, 72셀). `DT_1IN0001`(총조사인구 총괄)은 연 단위 표처럼 보이지만 5년 간격 총조사라 `F` 로만 조회된다. 이 표는 `meta --meta-type TBL` 에도 주기가 없고 `search` 응답 `PRD_SE` 는 `A` 로 나와 둘 다 `--prd-se` 값으로 쓸 수 없었다.
197
218
 
198
219
  ## Maintainer review notes
199
220