韩国本地智能地址与地点搜索

基于 Kakao 官方 API 的 PowerShell 技能，提供韩国地址正规化与地点搜索服务，支持坐标转换与类别过滤，API Key 安全隔离存储。

基本信息

• 技能名称?mij-kakao-local
• 中文名称?韩国本地智能地址与地点搜索
• 作者?MunInJun
• 分类?专业技能
• 版本?v1.0.0
• 标签?api, data-analytics, automation, backend, productivity

使用方法

使用说明
Kakao Local API Skill 是一款专为韩国地区地理信息处理设计的 PowerShell 自动化工具，通过调用 Kakao 官方本地 API 提供地址正规化与场所搜索两大核心功能。用户可通过简单的命令行参数调用，将模糊地址转换为标准道路名/地号地址及地理坐标，或基于关键词、地理位置、类别代码搜索特定场所（如餐厅、咖啡馆、银行等）。
该技能的显著优势在于其 严格的安全规范 。代码层面完全避免了 eval/exec/system 等危险函数，通过 [ValidateSet] 严格限定操作类型，使用 [System.Uri]::EscapeDataString() 对 URL 参数进行编码，有效防范命令注入攻击。API Key 管理采用业界最佳实践，支持通过环境变量或本地配置文件安全获取，明确避免通过参数传递导致日志泄露风险。所有错误处理均返回结构化 JSON 响应，不暴露敏感系统信息。
功能方面，技能支持丰富的搜索维度，包括基于坐标的半径搜索（最大 20km）、18 种类别分组代码过滤（MT1 大卖场至 PM9 药店）、分页查询等，满足从简单地址查找到复杂 LBS 应用的多种需求。输出格式标准化为 JSON，便于上层 Agent 或聊天机器人集成，文档中还提供了完整的缓存与收藏夹管理示例代码。
潜在局限性主要包括： 地域限制 （仅支持韩国地区地址与场所）、 环境依赖 （需 Windows PowerShell 5.0+ 及系统内置 curl.exe）、 配置门槛 （用户需自行前往 Kakao Developers 申请 REST API Key）。此外，作为 T3 来源（个人开发者仓库）的代码资产，虽然当前审计通过，但长期维护更新能力存在不确定性。
适用目标群体包括：需要处理韩国客户地址的跨境电商运营人员、构建本地化服务的开发者、需要地址数据清洗的数据分析师，以及在 Claude Code 环境中需要快速验证韩国地理信息的客服人员。
使用风险方面，主要需注意： 网络依赖 （必须能访问 dapi.kakao.com）、 数据隐私 （查询关键词将上传至 Kakao 服务器，敏感地址信息需谨慎处理）、以及 API 配额限制 （Kakao API 有默认调用频率限制，高频使用需申请提升配额）。