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 代理变得容易得多。