NomaDamas/k-skill

k-skill – 面向 AI 代理的韓國專用工具箱

是什麼

• k-skill 是一組 125 個即用型「技能」（小型命令列工具），讓基於大語言模型的 AI 代理能與韓國公共服務、電商網站、政府資料、交通 API、金融平台等互動。
• 每個技能都是小型程式（主要為 Node.js，部分為 Python），執行單一且明確的操作——例如「取得 KTX 時刻表」、「在 Coupang 搜尋商品」、「查詢韓國房地產交易價格」或「執行韓語拼字檢查」。
• 倉儲附帶一個 代理伺服器（k-skill-proxy），可透過簡單的 HTTP 請求呼叫，因此 AI 模型只需知道端點與技能名稱即可。
• 同時提供一個 Claude Code 插件，讓 Claude 代理可透過一個市場命令一鍵安裝整個工具集。

為何重要

• 現代 AI 代理（Claude、Codex、Claude Code 等）可呼叫外部工具，但大多公開可用的工具包都聚焦於英語服務。k-skill 透過開放數十個官方韓國 API（KTX、KBO、政府門戶、公共資料門戶資料集等）與流行商業服務（Coupang、Naver 購物、Daangn 等），彌補了韓國使用者的需求缺口。
• 透過將這些服務統一封裝為 CLI / HTTP 接口，開發者可建構 以韓國為中心的自主代理，例如預訂巴士票、查詢房產官方價格，或在不編寫自訂爬蟲的情況下生成韓語隱私政策。

如何開始

1. 安裝 – 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 套件管理器。
2. 設定 – 執行 k-skill-setup 以取得所需的 API 金鑰（如 Kakao、公共資料門戶或商業服務）並設定環境變數。
3. 呼叫技能 – 從 AI 代理或腳本中，向代理發送 HTTP 請求，例如：

   POST https://k-skill-proxy.example.com/railway-timetable
   { "origin": "서울", "destination": "부산", "date": "2024-10-01" }
   

   代理將轉發請求，取得資料，並回傳 JSON 回應。
4. 與 Claude Code 搭配使用 – 透過 Claude 市場新增插件，並使用 /k-skill:<name> 語法呼叫技能，例如 /k-skill:lotto-results。

你可以用它做什麼

• 旅行與交通 – 實時 KTX 時刻表、巴士座位可用性、航班價格查詢、首爾地鐵到站資訊、交通壅塞、高速公路 CCTV 流。
• 房地產與法律 – 官方交易價格、地籍登記、LH 住宅公告、法院拍賣清單、韓國法律與專利搜尋、自動隱私政策生成。
• 金融與商業 – 公司註冊核可、稅務欠款名單、股票報價、DART 公示、政府採購搜尋。
• 購物與日常生活 – 在 Coupang、Naver、Danawa、market-kurly 搜尋商品、價格比較、配送追蹤、附近加油站、電動車充電狀態。
• 健康、天氣、文化 – 急診室病床可用性、食品安全警告、韓國天氣預報、馬拉松賽程、彩票結果、韓語拼字檢查與 AI 人性化。
• 開發者工具 – HWP 文件轉換、韓語 WHOIS 查詢、韓語字元計數。

適合誰

• 為建構自主代理或聊天機器人而開發的韓語開發者。
• 希望其 LLM 助手無需手動網頁爬蟲即可執行具體韓語任務的高階使用者。
• 需要為 AI 代理提供標準化方式存取公共資料門戶 API 與商業韓國服務的組織。

限制

• 多數技能為 唯讀（如時刻表查詢、價格搜尋）。預訂或付款操作因安全考量明確排除。
• 部分資料來源因原始 API 無認證或存在 CORS 限制，需透過代理存取。
• 准確性取決於上游服務；若公共 API 變更，對應技能可能需更新。

總結 k-skill 是一個實用且文件完善的工具箱，將廣泛的韓國網路服務轉化為機器可讀的操作，使建構能為韓國使用者 真正做事 的 AI 代理變得更容易。