NomaDamas/k-skill

k-skill – AIエージェント向けの韓国向けツールボックス

何であるか

k-skill は、韓国政府サービス、ECサイト、政府データ、交通API、金融ポータルなどと対話できる 125の即時利用可能な「スキル」（小さなコマンドラインツール）のコレクションです。
各スキルは、単一で明確な動作を行う小さなプログラム（主にNode.js、一部Python）です。たとえば「KTX時刻表の取得」「Coupangでの商品検索」「韓国不動産取引価格の確認」「韓国語のスペルチェック実行」などです。
リポジトリには プロキシサーバー（k-skill-proxy） が同梱されており、シンプルなHTTPリクエストで呼び出せます。AIモデルはエンドポイントとスキル名さえ知っていればOKです。
また、Claude Codeプラグインも提供されており、Claudeエージェントが1つのマーケットプレイスコマンドで全スキルをインストールできます。

なぜ重要か

現代のAIエージェント（Claude、Codex、Claude Codeなど）は外部ツールを呼び出せますが、公開されているツールキットの多くは英語サービスに焦点を当てています。k-skillは、KTX、KBO、政府ポータル、公共データポータルのデータセットなど、多数の公式韓国APIと、Coupang、ナバーディッショナリー、ダアンなど人気の商業サービスを韓国ユーザー向けに開放することで、そのギャップを埋めます。
これらのサービスを一貫したCLI / HTTPインターフェースでラップすることで、開発者は 韓国中心の自律エージェント を構築でき、たとえばバスチケットの予約、物件の公式価格の照会、カスタムスクレイピングなしで韓国語のプライバシーポリシーの生成などが可能になります。

導入方法

インストール – READMEにnpxを使ったワンライナーが記載されています：
```
npx --yes skills add NomaDamas/k-skill --all -g   # すべてのスキルをインストール
# または単一のスキルをインストール、例：
npx --yes skills add NomaDamas/k-skill --skill railway-timetable -g
```
Node 18+ と npx が必要です。一部のスキル（例：KTX時刻表ヘルパー）はPython 3.11+ と uv パッケージマネージャも必要です。
設定 – k-skill-setup を実行して、Kakao、公共データポータル、商業サービスなどに必要なAPIキーを取得し、環境変数を設定します。
スキルの呼び出し – AIエージェントやスクリプトから、プロキシにHTTPリクエストを送信します。例：
```
POST https://k-skill-proxy.example.com/railway-timetable
{ "origin": "서울", "destination": "부산", "date": "2024-10-01" }
```
プロキシはリクエストを転送し、データを取得してJSONレスポンスを返します。
Claude Codeとの連携 – Claudeマーケットプレイスからプラグインを追加し、/k-skill:<name>構文でスキルを呼び出します。たとえば /k-skill:lotto-results です。

できること

旅行・交通 – 実時間KTX時刻表、バス座席空き状況、フライト価格照会、ソウル地下鉄到着情報、交通渋滞、高速道路CCTV配信。
不動産・法務 – 公式取引価格、地籍登記簿、LH住宅公告、裁判所オークションリスト、韓国法・特許検索、自動プライバシーポリシー生成。
金融・ビジネス – 法人登録照会、税金未納リスト、株価、DART開示情報、政府調達検索。
ショッピング・日常 – Coupang、ナバー、Danawa、market-kurlyでの商品検索、価格比較、配送追跡、近隣のガソリンスタンド、EV充電ステーション状態。
健康・天気・文化 – 急患病床空き状況、食品安全警告、韓国天気予報、マラソンスケジュール、ロト結果、韓国語スペルチェックとAI人間らしさ向上。
開発者ユーティリティ – HWPドキュメント変換、韓国WHOIS照会、韓国語文字数カウント。

対象ユーザー

制限事項

まとめ k-skillは実用的で、しっかりドキュメント化されたツールボックスであり、幅広い韓国Webサービスを機械可読なアクションに変換します。これにより、韓国ユーザーに実際に何かを実行できるAIエージェントの構築がはるかに容易になります。