mij-kakao-local

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 有默认调用频率限制，高频使用需申请提升配额）。