mij-kakao-local

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

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

收藏
23.5k
安装
4.8k
版本
v1.0.0
CLS 安全性认证2026-05-02
点击查看完整报告 >

使用说明

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

安全解读

核心用法

Kakao Local API Skill 是面向韩国地区的地址查询与本地商户搜索工具,基于 Kakao 官方 Local API 封装。主要提供两大功能模块:

1. 地址标准化 (NormalizeAddress):将模糊输入的韩国地址转换为规范的 도로명주소(道路名地址) 和 지번주소(地番地址),同时返回 WGS84 坐标
2. 关键词商户搜索 (SearchPlace):支持按关键词、地理位置、半径、类别群组等多维度搜索本地商户

技术实现上采用纯 Markdown 文档形式(T-MD 分类),用户需手动提取 PowerShell 脚本到本地执行。API Key 管理采用环境变量优先的安全策略,避免敏感信息泄露。

显著优点

  • 官方数据源:直接调用 Kakao dapi.kakao.com,数据覆盖韩国全境,更新及时
  • 功能完整:支持18种商户类别过滤(MT1~PM9)、分页查询、地理位置半径搜索
  • 安全设计:API Key 不通过参数传递,优先从环境变量读取,其次本地配置文件
  • 结构化输出:返回 JSON 格式标准化结果,包含道路/地番双地址、坐标、电话、网页链接等完整字段
  • 无依赖负担:仅需 Windows 10+ 内置 curl.exe,无需额外安装运行库

潜在缺点与局限性

  • 地域限制:仅支持韩国地区地址查询,海外地址无返回
  • 手动部署:T-MD 分类意味着无自动安装机制,需用户手动复制代码文件
  • T3 来源风险:个人开发者维护,未经企业级安全审计,建议人工审查代码
  • API 配额限制:Kakao Developers 免费额度有限(日调用量限制),商业使用需付费升级
  • 无离线能力:完全依赖网络连接,无本地缓存数据库

适合人群

  • 需要集成韩国地址服务的自动化工作流开发者
  • 在韩企业/个人的位置信息处理需求
  • 已拥有 Kakao Developers 账号并熟悉 REST API 的技术用户
  • 能接受手动部署和代码审查的安全敏感型用户

常规风险

  • API Key 泄露:若误将 config.json 提交至版本控制,可能导致密钥暴露
  • 个人开发者维护:更新频率和长期维护存在不确定性
  • 网络稳定性:Kakao API 服务中断将直接导致功能失效
  • 误报扫描:UTF-8 BOM 文件头和 Get-Date 时间戳功能可能被部分安全工具误报

mij-kakao-local 内容

references文件夹
手动下载zip · 7.2 kB
config.json.template.mdtext/markdown
请选择文件