@nomadamas/k-skill 0.3.0 → 0.4.0

package/skills/ticket-availability/references/DISCLAIMER.md

@@ -0,0 +1,13 @@
+# DISCLAIMER — `ticket-availability`
+
+이 스킬은 YES24·인터파크·공연기획사·예매처의 공식 기능 또는 공식 지원 도구가 아니며, 공식 제휴·후원·승인·인증 또는 협업한 사실이 전혀 없습니다. 상표와 서비스명은 공연·좌석 조회 기능과 대상을 설명하기 위해서만 사용합니다.
+
+대법원 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조)에 따른 출처 혼동 판단은 별도입니다.
+
+대법원 2022. 5. 12. 선고 [2021도1533 판결](https://www.law.go.kr/LSW/precInfoP.do?precSeq=221765)은 공개정보 수집만으로 곧바로 [정보통신망법 제48조](https://www.law.go.kr/법령/정보통신망이용촉진및정보보호등에관한법률/제48조) 위반이 되는 것은 아닌 사정을 제시했지만, 좌석 선점·구매 자동화나 차단 우회를 허용하지 않습니다. [저작권법 제93조](https://www.law.go.kr/법령/저작권법/제93조)과 [형법 제314조 제2항](https://www.law.go.kr/법령/형법/제314조)은 별도입니다.
+
+- 공개 일정·잔여석 자동 수집은 반드시 개인의 정보 조회용으로만 사용합니다.
+- 조직적·대량 크롤링, 지속 감시, 별도 DB 구축, 반복 선점·자동 구매를 하지 않습니다.
+- CAPTCHA·anti-bot·접근통제·차단·rate limit을 우회하거나 예매처의 정상 영업을 방해하지 않습니다.
+
+이 문서는 적법성을 보증하는 법률 자문이 아닙니다.

package/skills/{toss-securities → toss-investment}/instruction.md

@@ -42,7 +42,7 @@ const {
   getPrices,
   listOfficialAccounts,
   getHoldings
-} = require("toss-securities");
+} = require("toss-investment");
 
 async function main() {
   const prices = await getPrices(["005930", "AAPL"]);

package/skills/toss-investment/references/DISCLAIMER.md

@@ -0,0 +1,14 @@
+# DISCLAIMER — `toss-investment`
+
+이 스킬은 토스증권 또는 금융기관의 공식 기능 또는 공식 지원 도구가 아니며, 공식 제휴·후원·승인·인증 또는 협업한 사실이 전혀 없습니다. 상표와 서비스명은 공식 API 호환 기능과 조회 대상을 설명하기 위해서만 사용합니다.
+
+대법원 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조)에 따른 출처 혼동 판단은 별도입니다.
+
+대법원 2022. 5. 12. 선고 [2021도1533 판결](https://www.law.go.kr/LSW/precInfoP.do?precSeq=221765)은 공개정보 접근에 관한 판단이며, 인증된 계좌·보유자산 데이터에 대한 권한을 부여하지 않습니다. 공개되어 누구나 얻을 수 있는 정보의 기계적 수집만으로 곧바로 [정보통신망법 제48조](https://www.law.go.kr/법령/정보통신망이용촉진및정보보호등에관한법률/제48조) 위반이 되는 것은 아니지만, 금융정보·API 계약·[저작권법 제93조](https://www.law.go.kr/법령/저작권법/제93조)·[형법 제314조 제2항](https://www.law.go.kr/법령/형법/제314조)은 별도입니다.
+
+- 공개 시세정보 자동 수집 부분은 개인의 정보 조회용으로만 사용합니다. 계좌 데이터는 본인의 정당한 OAuth 권한 범위에서만 조회합니다.
+- 조직적·대량 크롤링, 계좌·보유자산 DB 구축·외부 공유를 하지 않습니다.
+- 인증·quota·접근통제·차단을 우회하거나 서비스 장애·영업 방해를 일으키지 않습니다.
+- 결과는 투자 권유·자문이나 수익 보장이 아닙니다.
+
+이 문서는 적법성을 보증하는 법률 자문이 아닙니다.

package/skills/{toss-securities → toss-investment}/references/TRADEMARK-LEGAL-STATEMENT.md

@@ -1,4 +1,4 @@
-# 상표 사용 법적 고지 — `toss-securities`
+# 상표 사용 법적 고지 — `toss-investment`
 
 이 스킬에서 `토스증권` 및 `Toss Securities` 명칭은 계좌·보유주식·시세·주문 조회의 **대상 증권 서비스**를 식별하기 위해 사용한다. k-skill의 출처를 토스증권으로 표시하려는 사용이 아니다.
 

package/skills/{toss-securities → toss-investment}/skill.json

@@ -1,9 +1,9 @@
 {
-  "name": "toss-securities",
+  "name": "toss-investment",
   "description": "토스증권 공식 Open API(OAuth2)로 계좌, 보유주식, 시세/종목/시장정보, 주문조회를 안전한 read-only 흐름으로 조회한다. 공식 credentials가 없거나 공식 API가 지원하지 않는 기능은 비공식 경로로 우회하지 않는다.",
   "profiles": [
     "vault",
     "action:account"
   ],
-  "frontmatter": "name: toss-securities\ndescription: 토스증권 공식 Open API(OAuth2)로 계좌, 보유주식, 시세/종목/시장정보, 주문조회를 안전한 read-only 흐름으로 조회한다. 공식 credentials가 없거나 공식 API가 지원하지 않는 기능은 비공식 경로로 우회하지 않는다.\nlicense: MIT\nmetadata:\n  category: finance\n  locale: ko-KR\n  phase: v1"
+  "frontmatter": "name: toss-investment\ndescription: 토스증권 공식 Open API(OAuth2)로 계좌, 보유주식, 시세/종목/시장정보, 주문조회를 안전한 read-only 흐름으로 조회한다. 공식 credentials가 없거나 공식 API가 지원하지 않는 기능은 비공식 경로로 우회하지 않는다.\nlicense: MIT\nmetadata:\n  category: finance\n  locale: ko-KR\n  phase: v1"
 }

package/skills/lovebug-report/instruction.md

@@ -1,185 +0,0 @@
-# Lovebug Report
-
-## What this skill does
-
-`러브버그.com`(`https://xn--2i0bt2q2wd1wb.com/`)의 공개 지도/제보 표면을 이용해 러브버그(붉은등우단털파리) 관련 지역 정보를 취득하고, 사용자가 제공한 현재 위치 좌표로 익명 제보를 제출한다.
-
-- 수도권 시·구별 러브버그 스코어와 최근 제보량을 조회한다.
-- 동/읍/면 단위 area snapshot을 함께 조회해 어느 동네 제보인지 좁힌다.
-- 사이트가 쓰는 익명 Supabase RPC 표면으로 제보를 보낸다.
-- 좌표가 선택한 구 밖이거나 정확도가 낮거나 오늘 이미 같은 익명 기기에서 제보한 경우 upstream 거절을 그대로 알린다.
-
-## When to use
-
-- "우리 동네 러브버그 많아?"
-- "중랑구 러브버그 현황 알려줘"
-- "러브버그 지도에서 동안구 제보량 확인해줘"
-- "현재 위치로 러브버그 많다고 제보해줘"
-
-## Prerequisites
-
-- 인터넷 연결
-- Node.js 18+
-- 이 저장소의 `lovebug-report` npm package 또는 동일 로직
-- 제보 제출 시: 사용자가 제공한 현재 좌표(`lng`, `lat`), GPS 정확도, 구 코드(`gu_code`), 안정적인 익명 device hash
-
-## Public access path discovered
-
-### Primary source: lovebug.com public map JSON
-
-- site: `https://xn--2i0bt2q2wd1wb.com/`
-- gu score: `GET https://xn--2i0bt2q2wd1wb.com/api/map/gu-score`
-- weekly report count: `GET https://xn--2i0bt2q2wd1wb.com/api/map/weekly-report-count`
-- cluster snapshot: `GET https://xn--2i0bt2q2wd1wb.com/api/map/clusters?level=sigungu&historicalYear=2026`
-- area snapshot: `GET https://xn--2i0bt2q2wd1wb.com/api/map/areas?historicalYear=2026&includePolygon=false`
-- boundary GeoJSON: `GET https://xn--2i0bt2q2wd1wb.com/api/map/boundaries?level=sigungu`
-
-Discovery result: the Next.js page loads these unauthenticated JSON endpoints directly. A live smoke on 2026-06-24 returned current `gu-score`, `weekly-report-count`, `clusters`, `areas`, and `boundaries` JSON.
-
-No `k-skill-proxy` route is used because these upstream surfaces are public and do not require an API key.
-
-### Anonymous report surface
-
-The site bundle calls Supabase RPC `submit_anonymous_report` for logged-out reporting:
-
-```http
-POST https://sewrbxfawkmusnyzjoab.supabase.co/rest/v1/rpc/submit_anonymous_report
-Content-Type: application/json
-apikey: <site anon key>
-Authorization: Bearer <site anon key>
-```
-
-Body:
-
-```json
-{
-  "p_gu_code": "11070",
-  "p_lng": 127.09,
-  "p_lat": 37.59,
-  "p_accuracy_m": 25,
-  "p_level": 2,
-  "p_device_hash": "stable-anonymous-device-id",
-  "p_context": "street",
-  "p_image_url": null,
-  "p_indoor": false
-}
-```
-
-Official level labels:
-
-| `p_level` | Label |
-| --- | --- |
-| `0` | 잠잠해요 |
-| `1` | 살짝 보임 |
-| `2` | 많아요 |
-| `3` | 매우 많아요 |
-
-Official context labels:
-
-| `p_context` | Label |
-| --- | --- |
-| `indoor` | 실내 |
-| `street` | 길거리 |
-| `park` | 공원 |
-| `transit` | 지하철·버스 |
-| `shop` | 상가 |
-| `other` | 기타 |
-
-## Workflow
-
-### 1. Resolve the region
-
-Use `searchLovebugRegions` first. It combines gu score and area snapshot rows.
-
-```js
-const { searchLovebugRegions } = require("lovebug-report")
-
-const result = await searchLovebugRegions({
-  query: "중랑",
-  includeAreas: true,
-  limit: 5
-})
-
-console.log(result.items)
-```
-
-CLI:
-
-```bash
-node packages/lovebug-report/src/cli.js search --query 중랑 --include-areas
-node packages/lovebug-report/src/cli.js list --limit 10
-node packages/lovebug-report/src/cli.js find --query 동안
-```
-
-Returned gu fields include:
-
-- `gu_code`, `gu_name`, `sido`
-- `score`, `score_label`, `level`, `level_label`, `advisory`
-- `counts.report`, `counts.report_24h`, `counts.spotted`, `counts.quiet`, `counts.low`, `counts.medium`, `counts.high`
-- `coordinates`
-- `areas[]` when `includeAreas` is enabled
-
-### 2. Answer conservatively
-
-State that the score is based on recent lovebug.com user reports, not government-certified pest density.
-
-Good answer shape:
-
-- 지역: `중랑구`
-- 러브버그 스코어: `77` / `엄청 많아요, 조심!`
-- 최근 제보: `14일 439건`, `24시간 105건`
-- 동네 detail: area rows that matched the query
-- 출처: `러브버그.com 공개 지도 JSON`
-
-### 3. Submit a report only when required inputs are known
-
-Do not invent coordinates or device hash. If the user asks to report but the automation environment has no current location, state that `lng`, `lat`, and GPS accuracy are required.
-
-```js
-const { reportLovebug } = require("lovebug-report")
-
-await reportLovebug({
-  guCode: "11070",
-  level: "많아요",
-  context: "길거리",
-  lng: 127.09,
-  lat: 37.59,
-  accuracyM: 25,
-  deviceHash: "stable-anonymous-device-id"
-})
-```
-
-CLI:
-
-```bash
-node packages/lovebug-report/src/cli.js report \
-  --gu-code 11070 \
-  --level 많아요 \
-  --context 길거리 \
-  --lng 127.09 \
-  --lat 37.59 \
-  --accuracy 25 \
-  --device-hash stable-anonymous-device-id
-```
-
-## Done when
-
-- Region status was fetched from `러브버그.com` public JSON.
-- Region ambiguity was resolved with `gu_code`/`gu_name` when needed.
-- Report submission used real current coordinates and the upstream RPC returned success.
-- Source URL and user-report nature were disclosed.
-
-## Failure modes
-
-- `ANON_DAILY_DUPLICATE`: the same anonymous device already reported that region today.
-- `OUTSIDE_GU_AREA`: supplied coordinates are outside `p_gu_code`.
-- `ACCURACY_TOO_LOW`: GPS accuracy is too low for the upstream validation.
-- Public Next.js/Supabase bundle keys, routes, table names, or RPC names can change.
-- The map is user-report-based and can lag or be noisy.
-- The site may add stricter rate limits, bot checks, login requirements, or image-upload restrictions.
-
-## Notes
-
-- No login, CAPTCHA bypass, queue bypass, or privileged workflow automation.
-- No `k-skill-proxy` because upstream is public and keyless from the user's machine.
-- Image upload is not handled by this skill; pass `imageUrl` only when a site-compatible image URL already exists.

package/skills/lovebug-report/skill.json

@@ -1,9 +0,0 @@
-{
-  "name": "lovebug-report",
-  "description": "러브버그.com 공개 지도 표면으로 수도권 시·구별 러브버그 출몰 지수·동네별 제보 현황을 조회하고, 사용자가 제공한 현재 좌표로 익명 러브버그 제보를 제출한다. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.",
-  "profiles": [
-    "proxy",
-    "action:submission"
-  ],
-  "frontmatter": "name: lovebug-report\ndescription: 러브버그.com 공개 지도 표면으로 수도권 시·구별 러브버그 출몰 지수·동네별 제보 현황을 조회하고, 사용자가 제공한 현재 좌표로 익명 러브버그 제보를 제출한다. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.\nlicense: MIT\nmetadata:\n  category: local-info\n  locale: ko-KR\n  phase: v1"
-}