← Back to Skills Marketplace
Ncloud Maps
by
Beomsu Lee
· GitHub ↗
· v1.0.8
697
Downloads
0
Stars
1
Active Installs
9
Versions
Install in OpenClaw
/install ncloud-maps
Description
Query Naver Cloud Maps APIs for route navigation. Smart routing: Directions5 by default, auto-switches to Directions15 for 5+ waypoints.
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install ncloud-maps - After installation, invoke the skill by name or use
/ncloud-maps - Provide required inputs per the skill's parameter spec and get structured output
Version History
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
Metadata
Frequently Asked Questions
What is Ncloud Maps?
Query Naver Cloud Maps APIs for route navigation. Smart routing: Directions5 by default, auto-switches to Directions15 for 5+ waypoints. It is an AI Agent Skill for Claude Code / OpenClaw, with 697 downloads so far.
How do I install Ncloud Maps?
Run "/install ncloud-maps" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Ncloud Maps free?
Yes, Ncloud Maps is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Ncloud Maps support?
Ncloud Maps is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Ncloud Maps?
It is built and maintained by Beomsu Lee (@beomsu317); the current version is v1.0.8.
More Skills