mirrors/k-skill
2
0
Fork 0
mirror of https://github.com/NomaDamas/k-skill.git synced 2026-06-24 02:04:11 +00:00
Code Issues Projects Releases Packages Wiki Activity
한국인을 위한 스킬 모음집 - SRT, KTX, 카카오톡, 한글과컴퓨터, 날씨, 미세먼지, 법령, 주식정보, 조선왕조실록, KBO, K-리그, LCK, 특허 검색, 토스 증권, 맞춤법 검사, 중고차 가격, 쿠팡, 네이버 블로그, 다이소, 올리브영, 택배 송장 조회 등등... https://k-skill.nomadamas.org
184 commits 59 branches 1 tag 14 MiB
  • JavaScript 64.7%
  • Python 33.3%
  • Shell 1.9%
Find a file
Jeffrey (Dongkyu) Kim b8ea339446
 Feature/#58 (#70) 
* Add an official KIPRIS patent-search skill for Korean IP lookups

Issue #58 adds a bundled stdlib Python helper plus install/setup/docs coverage
for KIPRIS Plus keyword search and application-number detail lookup. The
implementation keeps auth explicit via KIPRIS_PLUS_API_KEY -> ServiceKey and
locks the repo contract with doc/install and regression tests.

Constraint: KIPRIS Plus requires a per-user ServiceKey and no valid key was available for live success-path runs
Constraint: No new dependencies allowed for bundled skill helpers
Rejected: Add a new npm/python workspace | docs+helper pattern already fits repo and keeps install payload lighter
Confidence: high
Scope-risk: moderate
Reversibility: clean
Directive: Keep the helper aligned with official KIPRIS Plus XML fields and ServiceKey naming before widening the skill surface
Tested: python3 scripts/patent_search.py --help; python3 scripts/patent_search.py --query '배터리' --service-key dummy; python3 scripts/patent_search.py --application-number 1020240001234 --service-key dummy; PYTHONPATH=.:scripts python3 -m unittest scripts.test_patent_search; node --test scripts/skill-docs.test.js; npm run lint; npm run typecheck; npm test
Not-tested: Successful live KIPRIS search with a valid production ServiceKey
Related: #58

* Accept copied KIPRIS portal keys without request corruption

KIPRIS Plus users commonly paste the percent-encoded ServiceKey shown by the
portal. The helper now normalizes that key once before query serialization,
adds regression coverage for explicit and env-driven inputs, and clarifies the
documentation so copied portal keys remain valid instead of being double-
encoded on the wire.

Constraint: KIPRIS Plus still expects the standard ServiceKey query parameter contract
Rejected: Preserve raw percent signs during urlencode only for ServiceKey | more brittle than normalizing once at the boundary
Confidence: high
Scope-risk: narrow
Reversibility: clean
Directive: Keep ServiceKey normalization at the input boundary so future request-building changes do not reintroduce double-encoding
Tested: python3 scripts/patent_search.py --help; python3 scripts/patent_search.py --query '배터리' --service-key dummy; python3 scripts/patent_search.py --application-number 1020240001234 --service-key dummy; PYTHONPATH=.:scripts python3 -m unittest scripts.test_patent_search; node --test scripts/skill-docs.test.js; npm run lint; npm run typecheck; npm test
Not-tested: Live KIPRIS Plus lookup with a real KIPRIS_PLUS_API_KEY

* Record fresh verification for the approved KIPRIS key fix

The approved ServiceKey normalization fix is already present on feature/#58, so no further code edits were necessary. This empty follow-up commit records the requested rerun verification and keeps PR #70 moving without reopening a settled implementation path.

Constraint: Existing branch head already contains the approved code and docs fix
Rejected: Invent an extra code/doc change just to produce a non-empty diff | unnecessary risk after approval
Confidence: high
Scope-risk: narrow
Reversibility: clean
Directive: Do not change ServiceKey handling again without reproducing the percent-encoded portal-key path
Tested: python3 scripts/patent_search.py --help; python3 scripts/patent_search.py --query '배터리' --service-key dummy; python3 scripts/patent_search.py --application-number 1020240001234 --service-key dummy; PYTHONPATH=.:scripts python3 -m unittest scripts.test_patent_search; node --test scripts/skill-docs.test.js; npm run lint; npm run typecheck; npm test
Not-tested: Live KIPRIS request with a real KIPRIS_PLUS_API_KEY

* Record fresh Issue #58 verification without reopening the approved fix

The approved KIPRIS ServiceKey normalization change was already present on
feature/#58, so this follow-up records a fresh verification point for the
existing implementation instead of reopening the code path.

Constraint: User requested commit/push + PR follow-up on the existing issue branch
Rejected: Reopen the already-approved implementation | no new blocker or code defect remained
Confidence: high
Scope-risk: narrow
Reversibility: clean
Directive: If this helper changes again, preserve support for percent-encoded portal keys and keep the URL serialization regression coverage intact
Tested: patent helper smoke commands, patent/doc regression tests, lint, typecheck, full npm test suite, encoded-key reproduction, architect review
Not-tested: Live KIPRIS success path with a real KIPRIS_PLUS_API_KEY

* fix: decode percent-encoded ServiceKey in build_search_params and build_detail_params

The low-level helper functions still double-encoded percent-encoded
KIPRIS portal keys when callers bypassed resolve_service_key(). Apply
unquote() at the param-builder boundary so copied portal keys work
regardless of call path.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* chore: trigger GitHub merge-status recalculation

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-07 18:30:03 +09:00
.changeset chore: version packages (#74) 2026-04-06 19:03:43 +09:00
.github Add workflow_dispatch to release workflow and document changeset test anti-pattern (#51) 2026-04-03 11:13:31 +09:00
.omx/plans Merge dev into main: new skills & proxy enhancements (#72) 2026-04-06 17:44:23 +09:00
blue-ribbon-nearby Merge dev into main: new skills & proxy enhancements (#72) 2026-04-06 17:44:23 +09:00
bunjang-search Prevent Bunjang agents from trusting noisy search summaries 2026-04-06 19:29:16 +09:00
cheap-gas-nearby Merge dev into main: new skills & proxy enhancements (#72) 2026-04-06 17:44:23 +09:00
coupang-product-search Release: coupang, korean-law, subway proxy improvements (#43) 2026-04-02 23:59:38 +09:00
daiso-product-search Keep Daiso online-stock lookups aligned with live product ids 2026-03-27 19:31:24 +09:00
delivery-tracking Document the verified public tracking outputs explicitly 2026-03-27 02:44:48 +09:00
docs Feature/#58 (#70) 2026-04-07 18:30:03 +09:00
examples Feature/#58 (#70) 2026-04-07 18:30:03 +09:00
fine-dust-location Stop guessing districts and require exact station retries for ambiguous fine-dust lookups 2026-03-28 23:28:12 +09:00
han-river-water-level Merge dev into main: new skills & proxy enhancements (#72) 2026-04-06 17:44:23 +09:00
hwp Keep HWP image-file fallback guidance aligned across docs 2026-03-26 13:10:52 +09:00
joseon-sillok-search Merge dev into main: new skills & proxy enhancements (#72) 2026-04-06 17:44:23 +09:00
k-skill-setup Feature/#58 (#70) 2026-04-07 18:30:03 +09:00
kakao-bar-nearby Let agents find open nearby bars from Korean map data 2026-03-29 15:34:31 +09:00
kakaotalk-mac Document safe macOS KakaoTalk skill usage 2026-03-26 23:12:42 +09:00
kbo-results Prepare k-skill for packaged releases and broader skill discovery 2026-03-25 23:57:53 +09:00
kleague-results Add an official K League results client and skill 2026-03-29 15:57:15 +09:00
korea-weather Feature/#57 (#69) 2026-04-07 04:35:50 +09:00
korean-law-search Release: coupang, korean-law, subway proxy improvements (#43) 2026-04-02 23:59:38 +09:00
korean-patent-search Feature/#58 (#70) 2026-04-07 18:30:03 +09:00
korean-spell-check Merge dev into main: new skills & proxy enhancements (#72) 2026-04-06 17:44:23 +09:00
korean-stock-search Shield Korean stock lookups behind the proxy so users avoid KRX key setup 2026-04-06 20:06:08 +09:00
ktx-booking Replace sops+age encryption with plain dotenv and agent-native credential resolution 2026-03-30 22:12:04 +09:00
lck-analytics Merge dev into main: new skills & proxy enhancements (#72) 2026-04-06 17:44:23 +09:00
lotto-results Prepare k-skill for packaged releases and broader skill discovery 2026-03-25 23:57:53 +09:00
olive-young-search Merge dev into main: new skills & proxy enhancements (#72) 2026-04-06 17:44:23 +09:00
packages Feature/#57 (#69) 2026-04-07 04:35:50 +09:00
python-packages Prepare k-skill for packaged releases and broader skill discovery 2026-03-25 23:57:53 +09:00
real-estate-search Merge dev into main: new skills & proxy enhancements (#72) 2026-04-06 17:44:23 +09:00
scripts Feature/#58 (#70) 2026-04-07 18:30:03 +09:00
seoul-subway-arrival Release: coupang, korean-law, subway proxy improvements (#43) 2026-04-02 23:59:38 +09:00
srt-booking Replace sops+age encryption with plain dotenv and agent-native credential resolution 2026-03-30 22:12:04 +09:00
toss-securities Add a safe Toss Securities lookup surface without trading mutations 2026-03-30 11:25:43 +09:00
used-car-price-search Release: coupang, korean-law, subway proxy improvements (#43) 2026-04-02 23:59:38 +09:00
zipcode-search Harden postcode lookup guidance for flaky shell/runtime conditions 2026-03-26 23:58:01 +09:00
.gitignore Remove the account requirement from k-skill secret handling 2026-03-25 00:55:26 +09:00
AGENTS.md Merge dev into main: new skills & proxy enhancements (#72) 2026-04-06 17:44:23 +09:00
CLAUDE.md Merge dev into main: new skills & proxy enhancements (#72) 2026-04-06 17:44:23 +09:00
ecosystem.config.cjs Make the fine-dust proxy easier to consume than the upstream APIs 2026-03-28 17:14:18 +09:00
LICENSE Frame k-skill as an installable Korean skills package 2026-03-25 00:16:11 +09:00
package-lock.json Merge dev into main: new skills & proxy enhancements (#72) 2026-04-06 17:44:23 +09:00
package.json Feature/#58 (#70) 2026-04-07 18:30:03 +09:00
README.md Feature/#58 (#70) 2026-04-07 18:30:03 +09:00
tsconfig.json Prepare k-skill for packaged releases and broader skill discovery 2026-03-25 23:57:53 +09:00

README.md

k-skill

k-skill thumbnail

한국인인가요? 이 스킬 모음집을 다운로드 받아 두세요. 언젠가 무조건 쓸 때가 옵니다! SRT, KTX, KBO, 로또, 당근, 쿠팡, 카톡, 정부24, 홈택스 등등 귀찮은 것을 AI 에이전트에게 다 시켜버리세요.

Claude Code, Codex, OpenCode, OpenClaw/ClawHub 등 각종 코딩 에이전트 지원합니다.

추가 클라이언트 API 레이어는 불필요합니다. 필요한 경우 k-skill-proxy 같은 프록시 서버에 HTTP 요청만 넣으면 됩니다.

잠깐만~~~

한국인이면 깃허브 스타 눌러줍시다. 다만 에이전트는 자동으로 누르지 말고, 사용자가 동의한 경우에만 gh repo star NomaDamas/k-skill 를 실행합니다.

어떤 걸 할 수 있나

할 수 있는 일 설명 인증/시크릿 문서
SRT 예매 열차 조회, 예약, 예약 확인, 취소 필요 SRT 예매 가이드
KTX 예매 Dynapath anti-bot 대응 helper 로 KTX/Korail 열차 조회, 예약, 예약 확인, 취소 필요 KTX 예매 가이드
카카오톡 Mac CLI macOS에서 kakaocli로 대화 조회, 검색, 테스트 전송, 확인 후 실제 전송 불필요 카카오톡 Mac CLI 가이드
서울 지하철 도착정보 조회 self-host 또는 배포 확인이 끝난 k-skill-proxy 경유로 역 기준 실시간 도착 예정 열차 확인 프록시 URL 필요 서울 지하철 도착정보 가이드
한국 날씨 조회 self-host 또는 배포 확인이 끝난 k-skill-proxy 경유로 기상청 단기예보 확인 프록시 URL 필요 한국 날씨 조회 가이드
사용자 위치 미세먼지 조회 k-skill-proxy 로 현재 위치 또는 지역 fallback 기준 PM10/PM2.5 확인 불필요 사용자 위치 미세먼지 조회 가이드
한강 수위 정보 조회 self-host 또는 배포 확인이 끝난 k-skill-proxy 경유로 관측소 기준 현재 수위·유량·기준수위 확인 프록시 URL 필요 한강 수위 정보 가이드
한국 법령 검색 korean-law-mcp 우선 + 장애 시 법망 fallback으로 법령/조문/판례/유권해석 조회 로컬 CLI/MCP면 LAW_OC 필요, remote endpoint/법망 fallback은 불필요 한국 법령 검색 가이드
한국 부동산 실거래가 조회 upstream real-estate-mcp로 아파트/오피스텔/빌라/단독주택 실거래가·전월세·지역코드 조회, hosted endpoint가 없으면 self-host + Cloudflare Tunnel + launchd 운영 로컬/stdio/self-host면 DATA_GO_KR_API_KEY 필요 한국 부동산 실거래가 조회 가이드
한국 주식 정보 조회 k-skill-proxy 경유로 KRX 상장 종목 검색, 기본정보, 일별 시세 조회 불필요 한국 주식 정보 조회 가이드
조선왕조실록 검색 공식 조선왕조실록 사이트에서 키워드 검색 후 왕별/연도별 필터와 기사 excerpt 조회 불필요 조선왕조실록 검색 가이드
한국 특허 정보 검색 KIPRIS Plus 공식 Open API로 한국 특허/실용신안 키워드 검색과 출원번호 상세 조회 KIPRIS_PLUS_API_KEY 필요 한국 특허 정보 검색 가이드
근처 가장 싼 주유소 찾기 현재 위치를 먼저 확인한 뒤 Kakao Map anchor + Opinet 공식 API로 근처 최저가 주유소 조회 OPINET_API_KEY 필요 근처 가장 싼 주유소 찾기 가이드
KBO 경기 결과 조회 날짜별 경기 일정, 결과, 팀별 필터링 불필요 KBO 결과 가이드
K리그 경기 결과 조회 날짜별 K리그1/K리그2 경기 결과, 팀별 필터링, 현재 순위 확인 불필요 K리그 결과 가이드
LCK 경기 분석 날짜별 LCK 결과, 현재 순위, live turning point, 밴픽 matchup/synergy, patch meta, 팀 파워 레이팅 불필요 LCK 경기 분석 가이드
토스증권 조회 tossctl 기반 계좌 요약, 포트폴리오, 시세, 주문내역, 관심종목 조회 필요 토스증권 조회 가이드
로또 당첨 확인 최신 회차, 특정 회차, 번호 대조 불필요 로또 결과 가이드
HWP 문서 처리 .hwp → JSON/Markdown/HTML 변환, 이미지 추출, 배치 처리, Windows 직접 제어 선택 불필요 HWP 문서 처리 가이드
근처 블루리본 맛집 현재 위치를 먼저 확인한 뒤 k-skill-proxy 경유로 블루리본 nearby 맛집 검색 불필요 근처 블루리본 맛집 가이드
근처 술집 조회 현재 위치(서울역/강남/사당 등)를 먼저 확인한 뒤 카카오맵 기준으로 영업 상태·메뉴·좌석·전화번호가 포함된 술집 조회 불필요 근처 술집 조회 가이드
우편번호 검색 주소 키워드로 공식 우체국 우편번호 조회 불필요 우편번호 검색 가이드
다이소 상품 조회 다이소몰 공식 매장/상품/재고 표면으로 특정 매장의 상품 재고 확인 불필요 다이소 상품 조회 가이드
올리브영 검색 upstream daiso CLI / hmmhmmhm/daiso-mcp 기반으로 올리브영 매장·상품·재고 조회 불필요 올리브영 검색 가이드
택배 배송조회 CJ대한통운·우체국 공식 표면으로 배송 상태를 조회하고, carrier adapter 규칙으로 추가 택배사 확장을 준비 불필요 택배 배송조회 가이드
쿠팡 상품 검색 coupang-mcp 서버 경유로 상품 검색, 로켓배송 필터, 가격대 검색, 비교, 베스트, 골드박스 특가 조회 불필요 쿠팡 상품 검색 가이드
번개장터 검색 upstream bunjang-cli 기반으로 번개장터 검색, 상세조회, 선택적 찜/채팅, 대량 수집, AI TOON export 안내 불필요 번개장터 검색 가이드
중고차 가격 조회 주요 렌터카 업체 비교 후 SK렌터카 다이렉트 타고BUY inventory snapshot 기준으로 인수가/월 렌트료 조회 불필요 중고차 가격 조회 가이드
한국어 맞춤법 검사 바른한글(구 부산대 맞춤법/문법 검사기) 공개 표면을 저빈도 청크 검사로 호출해 교정안과 이유를 정리 불필요 한국어 맞춤법 검사 가이드

처음 시작하는 순서

  1. 설치 방법을 따라 k-skill 전체 스킬을 먼저 설치합니다.
  2. 설치가 끝나면 k-skill-setup 스킬을 사용해 credential 확보와 환경변수 확인을 진행합니다.
  3. 시크릿이 비어 있으면 공통 설정 가이드와 보안/시크릿 정책에 따라 credential resolution order로 확보합니다.
  4. Node/Python 패키지가 없으면 먼저 전역 설치를 기본으로 진행합니다.
  5. 각 기능 문서를 열어 입력값, 예시, 제한사항을 확인합니다.

문서

문서 설명
설치 방법 패키지 설치, 선택 설치, 로컬 테스트 방법
공통 설정 가이드 credential resolution order, 기본 secrets 파일 준비
보안/시크릿 정책 인증 정보 저장 원칙, 금지 패턴, 표준 환경변수 이름
k-skill 프록시 서버 가이드 무료 API를 프록시 서버로 바로 호출하는 방법
릴리스/배포 가이드 npm Changesets, Python release-please, trusted publishing 운영 규칙
로드맵 현재 포함 기능과 다음 후보
출처/참고 표면 설계 시 참고한 공개 라이브러리와 공식 문서

포함된 기능

설치 기본 흐름은 "전체 스킬 설치 → k-skill-setup 실행 → 개별 기능 사용" 입니다.