← 返回 Skills 市场
Ncloud Maps
作者
Beomsu Lee
· GitHub ↗
· v1.0.8
697
总下载
0
收藏
1
当前安装
9
版本数
在 OpenClaw 中安装
/install ncloud-maps
功能描述
Query Naver Cloud Maps APIs for route navigation. Smart routing: Directions5 by default, auto-switches to Directions15 for 5+ waypoints.
安全使用建议
This skill's code and docs require NCLOUD_API_KEY_ID and NCLOUD_API_KEY (Naver Cloud API credentials) and will call Naver's Maps API endpoints — that is expected for a Naver Maps routing skill. The problem is the registry metadata did not declare those required environment variables or a primary credential, which is an authoring inconsistency you should resolve before installing. Before you proceed: (1) Confirm you are comfortable providing Naver Cloud API keys and that you will store them securely (do not commit them to git). (2) Ask the publisher/registry to update the metadata to list NCLOUD_API_KEY_ID / NCLOUD_API_KEY as required credentials. (3) Review package.json and package-lock.json (already present) and run npm audit / use non-production credentials to test. (4) Verify network egress policy allows calls to https://maps.apigw.ntruss.com and that no other unknown endpoints are contacted. If the maintainer cannot explain the metadata omission, treat the package as untrusted until that is fixed.
功能分析
Type: OpenClaw Skill
Name: ncloud-maps
Version: 1.0.8
The OpenClaw skill `ncloud-maps` is designed to query Naver Cloud Maps APIs for route navigation. The code consistently aligns with this stated purpose, utilizing `axios` to make requests to legitimate Naver Cloud API endpoints (`https://maps.apigw.ntruss.com/map-direction-15/v1/driving` and `https://maps.apigw.ntruss.com/map-direction/v1/driving`). API keys are securely read from environment variables (`NCLOUD_API_KEY_ID`, `NCLOUD_API_KEY`) and passed in HTTP headers. Input coordinates are validated for format and range, mitigating common injection risks. There is no evidence of data exfiltration, unauthorized remote execution, persistence mechanisms, or prompt injection attempts against the AI agent in the `SKILL.md` or `README.md` files. All dependencies are standard and legitimate.
能力评估
Purpose & Capability
The skill's name/description (Naver Cloud Maps routing) matches the included source code and behavior: it calls Naver Maps Directions5/15 endpoints and returns distance/duration/cost estimates. However, the registry metadata claims no required env vars or primary credential while the SKILL.md and code clearly expect NCLOUD_API_KEY_ID and NCLOUD_API_KEY. That metadata omission is an inconsistency (likely an authoring error) but the capabilities themselves align with the stated purpose.
Instruction Scope
SKILL.md and the scripts are narrowly scoped to routing: validate coordinates, call Naver Maps Directions endpoints, and return route summaries. The runtime instructions ask the user to set NCLOUD API keys and run npm install / the CLI; there are no instructions to read unrelated system files, other credentials, or to post data to unexpected endpoints. All network calls in code target Naver's map gateway (maps.apigw.ntruss.com).
Install Mechanism
This is effectively an instruction-and-code package with no special install spec in the registry. The code uses standard npm dependencies (axios) listed in package-lock.json; there are no download-from-arbitrary-URLs or extract steps. Asking users to run npm install and run the included CLI is normal for a JS/TS skill.
Credentials
The SKILL.md and all CLI code expect two environment variables (NCLOUD_API_KEY_ID and NCLOUD_API_KEY) for authentication. Yet the registry metadata lists no required env vars and no primary credential. Requesting those two Naver Cloud keys is proportionate for this functionality, but the registry omission is misleading and increases risk if users install without realizing they must supply secrets. No other unrelated credentials are requested.
Persistence & Privilege
The skill does not request always:true and is user-invocable only; it does not attempt to modify other skills or system-wide agent settings. Autonomous invocation is allowed (platform default) but is not combined with other concerning privileges here.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install ncloud-maps - 安装完成后，直接呼叫该 Skill 的名称或使用
/ncloud-maps触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.8
**Added concise usage prompt for direct skill invocation.**
- Added a "Prompt" section at the top of SKILL.md with example commands and usage guidance for address and coordinate input.
- Clarified coordinate and address handling, emphasizing the need for address-to-coordinate conversion.
- Kept all routing behavior and API usage unchanged.
- No changes to logic or dependencies; documentation improvement only.
v1.0.7
ncloud-maps v1.0.7
- Added new compiled output files to the `dist/lib` and `dist/scripts` directories.
- README and SKILL documentation updated to reflect version bump to v1.0.7 and clarify smart routing default.
- No compatibility changes; existing behavior of auto-switching between Directions5 and Directions15 is maintained.
v1.0.6
ncloud-maps v1.0.6
- Documentation updated: "Smart Routing" feature headline and description now reference v1.0.6+.
- No code or API behavior changes; only README and SKILL.md documentation revised.
v1.0.5
ncloud-maps v1.0.5
- Added extensive documentation on using address-to-coordinate skills with ncloud-maps, including example workflows for Google Places (goplaces) and Naver Local Search.
- Clarified that coordinates must be provided in longitude,latitude format; now lists compatible skills for address conversion.
- No changes to core API usage, smart routing, or environment setup—documentation improvements only.
v1.0.4
ncloud-maps v1.0.4
- Updated documentation to reflect version bump from v1.0.3 to v1.0.4, including "Key Feature: Smart Routing" section.
- No functional code changes; only documentation and metadata updated.
- Maintenance release to ensure version and docs alignment.
v1.0.3
- Clarified that this skill only supports vehicle (car) route navigation—public transport and walking routes are not included.
- Added a new "Limitations" section to SKILL.md for clear scope communication.
- Updated "How It Works" to emphasize route types supported (vehicle only).
- Bumped version to 1.0.3 in documentation and package files.
v1.0.2
- Removed support for geocoding and all address-based route queries; only accepts coordinates (longitude,latitude) as input.
- Updated documentation to reflect coordinates-only input and dropped geocoding examples.
- Cleaned up environment and usage instructions to focus on Directions5/Directions15 APIs.
- Removed geocoding code and related files from the codebase.
v1.0.1
**Smart Routing with Directions5/Directions15 added**
- Introduced automatic "smart routing": uses Directions5 API for up to 4 waypoints, switches to Directions15 for 5 or more, no manual API selection needed.
- Added support for explicit API selection via `--api` flag (directions5 or directions15) as an override.
- Updated documentation to reflect smart routing behavior and usage.
- Added new modules for Directions5 and smart routing logic.
v1.0.0
Initial release: Naver Cloud Maps Directions15 + Geocoding API integration for route planning and address lookup
元数据
常见问题
Ncloud Maps 是什么？
Query Naver Cloud Maps APIs for route navigation. Smart routing: Directions5 by default, auto-switches to Directions15 for 5+ waypoints. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 697 次。
如何安装 Ncloud Maps？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install ncloud-maps」即可一键安装，无需额外配置。
Ncloud Maps 是免费的吗？
是的，Ncloud Maps 完全免费（开源免费），可自由下载、安装和使用。
Ncloud Maps 支持哪些平台？
Ncloud Maps 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Ncloud Maps？
由 Beomsu Lee（@beomsu317）开发并维护，当前版本 v1.0.8。
推荐 Skills