核心功能
Kakao Local API Skill 是一款专为韩国地区设计的地理位置服务工具，基于 Kakao Developers 官方 API 提供两大核心能力：
1. 地址标准化 (NormalizeAddress)：将用户输入的韩文地址解析为规范的 도로명주소(道路名地址) / 지번주소(地番地址)，并返回精确的 WGS84 坐标 (经度 x, 纬度 y)、区域层级信息(시/구/동)、건물명(建筑名)、우편번호(邮编)等结构化数据。
2. 关键词地点搜索 (SearchPlace)：支持模糊关键词检索韩国本地商户与设施，提供地理位置半径过滤(반경 검색, 最大 20km)、17 种 카테고리 그룹 코드(카페/음식점/지하철역/약국等)精准筛选、分页查询(最大 45 页)等功能。
显著优点
- 官方权威数据源：直接调用 Kakao 地图核心数据库，覆盖韩国全境数千万 POI，地址解析准确率高
- 结构化输出：返回 JSON 格式的标准化数据，便于下游系统(ERP、CRM、RPA)直接消费
- 灵活的空间查询：支持基于当前坐标的 반경 검색，适用于 LBS 推荐场景
- 企业级密钥管理：支持 환경변수 和 config.json 双重配置，明确禁止命令行传参以防密钥泄露
- 完善的错误体系：区分 MissingApiKey / InvalidApiKey / ApiError / 空结果等场景，便于调试
局限性与风险
- 地域限制：仅覆盖韩国境内数据，海外地址无法解析
- API Key 依赖：必须注册 Kakao Developers 并获取 REST API Key，免费额度存在调用限制(일일 제한)
- Windows/PowerShell 绑定：当前实现依赖 PowerShell 5.0+ 与 curl.exe，跨平台兼容性有限
- 无内置缓存机制：虽有 cache.json 示例，但需用户自行实现 TTL 管理
- 语言门槛：文档与 API 响应均为韩语，需具备韩文处理能力或额外本地化层
适合人群
- 面向韩国市场的电商、物流、外卖平台开发者
- 需要批量地址清洗、坐标补全的数据工程师
- 构建韩文客服机器人、地理位置推荐系统的 AI 应用开发者
- 使用 PowerShell 生态的 Windows 企业环境运维人员
安全建议
- 务必将
config.json加入.gitignore，避免 API Key 误提交 - 生产环境优先使用 환경변수 方式注入密钥，而非配置文件
- 定期轮换 Kakao REST API Key，监控调用配额以防服务中断